1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
/*
* Copyright (c) 2000-2007 Apple Inc. All rights reserved.
*
* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
*
* This file contains Original Code and/or Modifications of Original Code
* as defined in and that are subject to the Apple Public Source License
* Version 2.0 (the 'License'). You may not use this file except in
* compliance with the License. The rights granted to you under the License
* may not be used to create, or enable the creation or redistribution of,
* unlawful or unlicensed copies of an Apple operating system, or to
* circumvent, violate, or enable the circumvention or violation of, any
* terms of an Apple operating system software license agreement.
*
* Please obtain a copy of the License at
* http://www.opensource.apple.com/apsl/ and read it before using this file.
*
* The Original Code and all software distributed under the License are
* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
* Please see the License for the specific language governing rights and
* limitations under the License.
*
* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
/* $NetBSD: sem.h,v 1.5 1994/06/29 06:45:15 cgd Exp $ */
/*
* SVID compatible sem.h file
*
* Author: Daniel Boulet
* John Bellardo modified the implementation for Darwin. 12/2000
*/
#ifndef _SYS_SEM_H_
#define _SYS_SEM_H_
#include <sys/cdefs.h>
#include <sys/_types.h>
#include <machine/types.h> /* __int32_t */
/*
* [XSI] All of the symbols from <sys/ipc.h> SHALL be defined
* when this header is included
*/
#include <sys/ipc.h>
/*
* [XSI] The pid_t, time_t, key_t, and size_t types shall be defined as
* described in <sys/types.h>.
*
* NOTE: The definition of the key_t type is implicit from the
* inclusion of <sys/ipc.h>
*/
#include <sys/_types/_pid_t.h>
#include <sys/_types/_time_t.h>
#include <sys/_types/_size_t.h>
/*
* Technically, we should force all code references to the new structure
* definition, not in just the standards conformance case, and leave the
* legacy interface there for binary compatibility only. Currently, we
* are only forcing this for programs requesting standards conformance.
*/
#if __DARWIN_UNIX03 || defined(KERNEL)
#pragma pack(4)
/*
* Structure used internally.
*
* This structure is exposed because standards dictate that it is used as
* the semun union member 'buf' as the fourth argment to semctl() when the
* third argument is IPC_STAT or IPC_SET.
*
* Note: only the fields sem_perm, sem_nsems, sem_otime, and sem_ctime
* are meaningful in user space.
*/
#if (defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE))
struct semid_ds
#else
#define semid_ds __semid_ds_new
struct __semid_ds_new
#endif
{
struct __ipc_perm_new sem_perm; /* [XSI] operation permission struct */
__int32_t sem_base; /* 32 bit base ptr for semaphore set */
unsigned short sem_nsems; /* [XSI] number of sems in set */
time_t sem_otime; /* [XSI] last operation time */
__int32_t sem_pad1; /* RESERVED: DO NOT USE! */
time_t sem_ctime; /* [XSI] last change time */
/* Times measured in secs since */
/* 00:00:00 GMT, Jan. 1, 1970 */
__int32_t sem_pad2; /* RESERVED: DO NOT USE! */
__int32_t sem_pad3[4]; /* RESERVED: DO NOT USE! */
};
#pragma pack()
#else /* !__DARWIN_UNIX03 */
#define semid_ds __semid_ds_old
#endif /* __DARWIN_UNIX03 */
#if !__DARWIN_UNIX03
struct __semid_ds_old {
struct __ipc_perm_old sem_perm; /* [XSI] operation permission struct */
__int32_t sem_base; /* 32 bit base ptr for semaphore set */
unsigned short sem_nsems; /* [XSI] number of sems in set */
time_t sem_otime; /* [XSI] last operation time */
__int32_t sem_pad1; /* RESERVED: DO NOT USE! */
time_t sem_ctime; /* [XSI] last change time */
/* Times measured in secs since */
/* 00:00:00 GMT, Jan. 1, 1970 */
__int32_t sem_pad2; /* RESERVED: DO NOT USE! */
__int32_t sem_pad3[4]; /* RESERVED: DO NOT USE! */
};
#endif /* !__DARWIN_UNIX03 */
/*
* Possible values for the third argument to semctl()
*/
#define GETNCNT 3 /* [XSI] Return the value of semncnt {READ} */
#define GETPID 4 /* [XSI] Return the value of sempid {READ} */
#define GETVAL 5 /* [XSI] Return the value of semval {READ} */
#define GETALL 6 /* [XSI] Return semvals into arg.array {READ} */
#define GETZCNT 7 /* [XSI] Return the value of semzcnt {READ} */
#define SETVAL 8 /* [XSI] Set the value of semval to arg.val {ALTER} */
#define SETALL 9 /* [XSI] Set semvals from arg.array {ALTER} */
/* A semaphore; this is an anonymous structure, not for external use */
struct sem {
unsigned short semval; /* semaphore value */
pid_t sempid; /* pid of last operation */
unsigned short semncnt; /* # awaiting semval > cval */
unsigned short semzcnt; /* # awaiting semval == 0 */
};
/*
* Structure of array element for second argument to semop()
*/
struct sembuf {
unsigned short sem_num; /* [XSI] semaphore # */
short sem_op; /* [XSI] semaphore operation */
short sem_flg; /* [XSI] operation flags */
};
/*
* Possible flag values for sem_flg
*/
#define SEM_UNDO 010000 /* [XSI] Set up adjust on exit entry */
#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
/*
* Union used as the fourth argment to semctl() in all cases. Specific
* member values are used for different values of the third parameter:
*
* Command Member
* ------------------------------------------- ------
* GETALL, SETALL array
* SETVAL val
* IPC_STAT, IPC_SET buf
*
* The union definition is intended to be defined by the user application
* in conforming applications; it is provided here for two reasons:
*
* 1) Historical source compatability for non-conforming applications
* expecting this header to declare the union type on their behalf
*
* 2) Documentation; specifically, 64 bit applications that do not pass
* this structure for 'val', or, alternately, a 64 bit type, will
* not function correctly
*/
union semun {
int val; /* value for SETVAL */
struct semid_ds *buf; /* buffer for IPC_STAT & IPC_SET */
unsigned short *array; /* array for GETALL & SETALL */
};
typedef union semun semun_t;
/*
* Permissions
*/
#define SEM_A 0200 /* alter permission */
#define SEM_R 0400 /* read permission */
#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
__BEGIN_DECLS
#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
int semsys(int, ...);
#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
int semctl(int, int, int, ...) __DARWIN_ALIAS(semctl);
int semget(key_t, int, int);
int semop(int, struct sembuf *, size_t);
__END_DECLS
#endif /* !_SEM_H_ */
|
