sem_unlink(3)

sem_unlink3

Remove a named semaphore

Usage

#include <semaphore.h>

int sem_unlink(const char *name);

Library

POSIX threads library (libpthread, -lpthread)

Overview

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

InterfaceAttributeValue
sem_unlink()Thread safetyMT-Safe

Releases

11 releases since Debian 4.0 (Etch); the text changed 10 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10
  8. 11
  9. 12
  10. 13
  11. Arch

Standards

POSIX.1-2008.

History

POSIX.1-2001.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.