HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

191

192

193

194

195

196

197

198

199

200

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man2/!!!intro.2

________________________________________________________________

___ ___

msem_remove(2) msem_remove(2)

NAME

msem_remove - remove a semaphore in mapped ﬁle or anonymous region

SYNOPSIS

#include <sys/mman.h>

int *msem_remove(msemaphore *sem);

DESCRIPTION

msem_remove() removes a binary semaphore.

sem points to an msemaphore structure that speciﬁes the semaphore to be removed. Any subsequent

use of the msemaphore structure before it is again initialized by calling msem_init() produces

undeﬁned results.

msem_remove() also causes any process waiting in the msem_lock() function on the removed sema-

phore to return with an error.

If the msemaphore structure contains any value not resulting from a call to msem_init() followed by

a (possibly empty) sequence of calls to msem_lock()

and msem_unlock(), the results are undeﬁned.

The address of an

msemaphore uniquely identiﬁes the semaphore. If the

msemaphore structure con-

tains any value copied from a

msemaphore structure at a different address, the result is undeﬁned.

RETURN VALUE

Upon success,

msem_remove() returns zero; otherwise, it returns −1 and sets

errno to indicate the

error.

ERRORS

msem_remove() fails if any of the following conditions are encountered:

[EINVAL] sem points to an msemaphore structure that has been removed.

[EFAULT] sem is an invalid pointer.

AUTHOR

msem_remove() was developed by HP and OSF.