msem_remove.2 (2010 09)

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 contains 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.

PAGE 1
msem_remove(2) msem_remove(2) NAME msem_remove - remove a semaphore in mapped file or anonymous region SYNOPSIS #include int *msem_remove(msemaphore *sem); DESCRIPTION msem_remove() removes a binary semaphore. sem points to an msemaphore structure that specifies the semaphore to be removed. Any subsequent use of the msemaphore structure before it is again initialized by calling msem_init() produces undefined results.
PAGE 2
(Notes) A (Notes) mA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010