comparison src/nucleus/mb_extr.h @ 7:0f80e1e4dce4

src/nucleus: library C code import from FreeNucleus package
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 15 Jul 2018 20:57:33 +0000
parents
children
comparison
equal deleted inserted replaced
6:8b2a9a374324 7:0f80e1e4dce4
1 /*************************************************************************/
2 /* */
3 /* Copyright Mentor Graphics Corporation 2002 */
4 /* All Rights Reserved. */
5 /* */
6 /* THIS WORK CONTAINS TRADE SECRET AND PROPRIETARY INFORMATION WHICH IS */
7 /* THE PROPERTY OF MENTOR GRAPHICS CORPORATION OR ITS LICENSORS AND IS */
8 /* SUBJECT TO LICENSE TERMS. */
9 /* */
10 /*************************************************************************/
11
12 /*************************************************************************/
13 /* */
14 /* FILE NAME VERSION */
15 /* */
16 /* mb_extr.h Nucleus PLUS 1.14 */
17 /* */
18 /* COMPONENT */
19 /* */
20 /* MB - Mailbox Management */
21 /* */
22 /* DESCRIPTION */
23 /* */
24 /* This file contains function prototypes of all functions */
25 /* accessible to other components. */
26 /* */
27 /* DATA STRUCTURES */
28 /* */
29 /* None */
30 /* */
31 /* FUNCTIONS */
32 /* */
33 /* None */
34 /* */
35 /* DEPENDENCIES */
36 /* */
37 /* mb_defs.h Mailbox Management constants */
38 /* */
39 /* HISTORY */
40 /* */
41 /* DATE REMARKS */
42 /* */
43 /* 03-01-1993 Created initial version 1.0 */
44 /* 04-19-1993 Verified version 1.0 */
45 /* 03-01-1994 Moved include files outside of */
46 /* the file #ifndef to allow the */
47 /* use of actual data structures, */
48 /* changed the names of several */
49 /* mailboxes services to reflect */
50 /* the new file structure, */
51 /* modified function interface to */
52 /* exactly match the prototype, */
53 /* resulting in version 1.1 */
54 /* */
55 /* 03-18-1994 Verified version 1.1 */
56 /* 04-17-1996 updated to version 1.2 */
57 /* 03-24-1998 Released version 1.3 */
58 /* 03-26-1999 Released 1.11m (new release */
59 /* numbering scheme) */
60 /* 04-17-2002 Released version 1.13m */
61 /* 11-07-2002 Released version 1.14 */
62 /*************************************************************************/
63
64 #include "mb_defs.h" /* Include MB constants */
65
66
67 /* Check to see if the file has been included already. */
68
69 #ifndef MB_EXTR
70 #define MB_EXTR
71
72
73 /* Initialization functions. */
74
75 VOID MBI_Initialize(VOID);
76
77
78 /* Core error checking functions. */
79
80 STATUS MBCE_Create_Mailbox(NU_MAILBOX *mailbox_ptr, CHAR *name,
81 OPTION suspend_type);
82 STATUS MBCE_Delete_Mailbox(NU_MAILBOX *mailbox_ptr);
83 STATUS MBCE_Send_To_Mailbox(NU_MAILBOX *mailbox_ptr, VOID *message,
84 UNSIGNED suspend);
85 STATUS MBCE_Receive_From_Mailbox(NU_MAILBOX *mailbox_ptr,
86 VOID *message, UNSIGNED suspend);
87
88 /* Supplemental error checking functions. */
89
90 STATUS MBSE_Reset_Mailbox(NU_MAILBOX *mailbox_ptr);
91 STATUS MBSE_Broadcast_To_Mailbox(NU_MAILBOX *mailbox_ptr,
92 VOID *message, UNSIGNED suspend);
93
94 /* Core processing functions. */
95
96 STATUS MBC_Create_Mailbox(NU_MAILBOX *mailbox_ptr, CHAR *name,
97 OPTION suspend_type);
98 STATUS MBC_Delete_Mailbox(NU_MAILBOX *mailbox_ptr);
99 STATUS MBC_Send_To_Mailbox(NU_MAILBOX *mailbox_ptr, VOID *message,
100 UNSIGNED suspend);
101 STATUS MBC_Receive_From_Mailbox(NU_MAILBOX *mailbox_ptr,
102 VOID *message, UNSIGNED suspend);
103
104 /* Supplemental mailbox functions. */
105
106 STATUS MBS_Reset_Mailbox(NU_MAILBOX *mailbox_ptr);
107 STATUS MBS_Broadcast_To_Mailbox(NU_MAILBOX *mailbox_ptr,
108 VOID *message, UNSIGNED suspend);
109
110 /* Mailbox fact retrieval functions. */
111
112 UNSIGNED MBF_Established_Mailboxes(VOID);
113 STATUS MBF_Mailbox_Information(NU_MAILBOX *mailbox_ptr, CHAR *name,
114 OPTION *suspend_type, DATA_ELEMENT *message_present,
115 UNSIGNED *tasks_waiting, NU_TASK **first_task);
116 UNSIGNED MBF_Mailbox_Pointers(NU_MAILBOX **pointer_list,
117 UNSIGNED maximum_pointers);
118
119 #endif
120
121
122
123
124