System Grab Bag

View all man pages from Linux (or from all projects)

Name

sem_unlink - remove a named semaphore

Library

POSIX threads library ( libpthread ", " -lpthread )

Synopsis

#include <semaphore.h> 
int sem_unlink(const char * name );

Description

sem_unlink() removes the named semaphore referred to by name. The semaphore name is removed immediately. The semaphore is destroyed once all other processes that have the semaphore open close it.

Return Value

On success sem_unlink() returns 0; on error, -1 is returned, with errno set to indicate the error.

Errors

EACCES The caller does not have permission to unlink this semaphore.

ENAMETOOLONG name was too long.

ENOENT There is no semaphore with the given name.

Attributes

For an explanation of the terms used in this section, see attributes(7). allbox; lbx lb lb T{ sem_unlink()
InterfaceAttributeValue
T}Thread safetyMT-Safe

Standards

POSIX.1-2008.

History

POSIX.1-2001.

See Also

  1. sem_getvalue(3),
  2. sem_open(3),
  3. sem_post(3),
  4. sem_wait(3),
  5. sem_overview(7)