Guardian Programming Reference Summary for C

Functions Summary (A-C)
Guardian Programming Reference Summary for C—522630-001
4-9
BINSEM_OPEN_
Opens a binary semaphore.
return value:
BINSEM_UNLOCK_
Unlocks a binary semaphore.
#include <cextdecs(BINSEM_OPEN_)>
short BINSEM_OPEN_ ( long *semid /* o */
,short *processhandle /* i */
,long proc-semid ); /* i */
0=No error.
22 = Bounds error. The semid parameter cannot be written by the calling
process, or processhandle cannot be read from the calling process.
29 = Required parameter missing. The semid, processhandle, and proc-
semid parameters must be specified.
4002 = No entry. The proc-semid and processhandle parameters do not
identify a binary semaphore in the processor. The corresponding OSS
errno value is ENOENT.
4013 = Invalid access. The calling process does not have access to the binary
semaphore because of its security. The security for a binary semaphore is
set by the BINSEM_CREATE_ procedure. The corresponding OSS
errno value is EACCESS.
4022 = Invalid parameter. The processhandle parameter does not specify a
process. A process that is being created or is terminating is treated as
though it does not exist. The corresponding OSS errno value is EINVAL.
4024 = Process cannot open the binary semaphore. The process has reached the
maximum number of binary semaphores it can open, or the process file
segment (PFS) has reached the maximum limit of available space. The
corresponding OSS errno value is EMFILE.
#include <cextdecs(BINSEM_UNLOCK_)>
short BINSEM_UNLOCK_ ( long semid ); /* i */