pSOSystem System Calls - Read

sm_ident pSOS+ System Calls
sm_ident Obtains the semaphore identifier of a named semaphore.
#include
unsigned long sm_ident(
char name[4], /* semaphore name */
unsigned long node, /* node selector */
unsigned long *smid /* semaphore ID */
)
Description
Arguments
Return Value
Error Codes
This system call enables the calling task to obtain the semaphore ID of a semaphore
it only knows by name. The semaphore ID can then be used in all other operations
relating to this semaphore.
Most system calls, except sm_create() and sm_ident(), reference a semaphore
by the semaphore ID. sm_create() returns the semaphore ID to the semaphore
creator. For other tasks, one way to obtain the semaphore ID is to use sm_ident().
name Specifies the user-assigned name of the semaphore.
node In multiprocessor systems, is a search order specifier. See
“Multiprocessor Considerations.” In a single node system,
this argument must be 0.
smid Points to the variable where sm_ident() stores the
semaphore ID of the named semaphore.
This system call returns 0 on success, or an error code on failure.
Hex Mnemonic Description
0x04 ERR_NODENO Node specifier out of range.
0x09 ERR_OBJNF Named semaphore not found.
1-126 pSOSystem System Calls