man3/sem_unlink.3

   1 '\" t
   2 .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
   3 .\"
   4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   5 .\"
   6 .TH sem_unlink 3 (date) "Linux man-pages (unreleased)"
   7 .SH NAME
   8 sem_unlink \- remove a named semaphore
   9 .SH LIBRARY
  10 POSIX threads library
  11 .RI ( libpthread ", " \-lpthread )
  12 .SH SYNOPSIS
  13 .nf
  14 .B #include <semaphore.h>
  15 .PP
  16 .BI "int sem_unlink(const char *" name );
  17 .fi
  18 .SH DESCRIPTION
  19 .BR sem_unlink ()
  20 removes the named semaphore referred to by
  21 .IR name .
  22 The semaphore name is removed immediately.
  23 The semaphore is destroyed once all other processes that have
  24 the semaphore open close it.
  25 .SH RETURN VALUE
  26 On success
  27 .BR sem_unlink ()
  28 returns 0; on error, \-1 is returned, with
  29 .I errno
  30 set to indicate the error.
  31 .SH ERRORS
  32 .TP
  33 .B EACCES
  34 The caller does not have permission to unlink this semaphore.
  35 .TP
  36 .B ENAMETOOLONG
  37 .I name
  38 was too long.
  39 .TP
  40 .B ENOENT
  41 There is no semaphore with the given
  42 .IR name .
  43 .SH ATTRIBUTES
  44 For an explanation of the terms used in this section, see
  45 .BR attributes (7).
  46 .ad l
  47 .nh
  48 .TS
  49 allbox;
  50 lbx lb lb
  51 l l l.
  52 Interface       Attribute       Value
  53 T{
  54 .BR sem_unlink ()
  55 T}      Thread safety   MT-Safe
  56 .TE
  57 .hy
  58 .ad
  59 .sp 1
  60 .SH STANDARDS
  61 POSIX.1-2001, POSIX.1-2008.
  62 .SH SEE ALSO
  63 .BR sem_getvalue (3),
  64 .BR sem_open (3),
  65 .BR sem_post (3),
  66 .BR sem_wait (3),
  67 .BR sem_overview (7)