unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 msem_remove(2)						      msem_remove(2)




 NAME
      msem_remove - remove a semaphore in mapped file or anonymous region

 SYNOPSIS
      #include <&lt&lt&lt;sys/mman.h>&gt&gt&gt;

      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.

      msem_remove() also causes any process waiting in the msem_lock()
      function on the removed semaphore 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 undefined.  The
      address of an msemaphore uniquely identifies the semaphore.  If the
      msemaphore structure contains any value copied from a msemaphore
      structure at a different address, the result is undefined.

 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.

 SEE ALSO
      msem_init(2), msem_lock(2), msem_remove(2), mman(5).

 STANDARDS CONFORMANCE
      msem_remove(): AES







 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000