Index for Section 3

Alphabetical listing for S

Bottom of page

sem_unlink(3)
NAME
  sem_unlink - Removes the specified named semaphore (P1003.1b)

SYNOPSIS
  #include <semaphore.h>

  int sem_unlink (
  const char *name) ;

PARAMETERS
  *name	    The semaphore name.

DESCRIPTION
  The sem_unlink function remove a semaphore named by the string name.	If
  the semaphore is referenced by other processes, sem_unlink does not change
  the state of the semaphore.

  If other processes have the semaphore open when sem_unlink is called, the
  semaphore is not destroyed until all references to the semaphore have been
  destroyed by calls to sem_close.  The sem_unlink function returns
  immediately; it does not wait untill all references have been destroyed.

  Calls to sem_open to recreate or reconnect to the semaphore refer to a new
  semaphore after sem_unlink is called.

RETURN VALUES
  On a successful call, a value of 0 is returned. Otherwise, a value of -1 is
  returned and errno is set to indicate that an error occurred.

ERRORS
  The  sem_unlink function fails under the following conditions:

  [EACCES]	 Permission is denied to unlink the named semaphore.

  [ENAMETOOLONG] The length of the name string exceeds {NAME_MAX} while
		 {_POSIX_NO_TRUNC} is in effect.

  [ENOENT]	 The named semaphore does not exist.

RELATED INFORMATION
  Functions: sem_close(3), sem_open(3)

Index for Section 3

Alphabetical listing for S

Top of page