1SEM_UNLINK(P) POSIX Programmer's Manual SEM_UNLINK(P)
2
3
4
6 sem_unlink - remove a named semaphore (REALTIME)
7
9 #include <semaphore.h>
10
11 int sem_unlink(const char *name);
12
13
15 The sem_unlink() function shall remove the semaphore named by the
16 string name. If the semaphore named by name is currently referenced by
17 other processes, then sem_unlink() shall have no effect on the state of
18 the semaphore. If one or more processes have the semaphore open when
19 sem_unlink() is called, destruction of the semaphore is postponed until
20 all references to the semaphore have been destroyed by calls to
21 sem_close(), _exit(), or exec. Calls to sem_open() to recreate or
22 reconnect to the semaphore refer to a new semaphore after sem_unlink()
23 is called. The sem_unlink() call shall not block until all references
24 have been destroyed; it shall return immediately.
25
27 Upon successful completion, the sem_unlink() function shall return a
28 value of 0. Otherwise, the semaphore shall not be changed and the func‐
29 tion shall return a value of -1 and set errno to indicate the error.
30
32 The sem_unlink() function shall fail if:
33
34 EACCES Permission is denied to unlink the named semaphore.
35
36 ENAMETOOLONG
37 The length of the name argument exceeds {PATH_MAX} or a pathname
38 component is longer than {NAME_MAX}.
39
40 ENOENT The named semaphore does not exist.
41
42
43 The following sections are informative.
44
46 None.
47
49 The sem_unlink() function is part of the Semaphores option and need not
50 be available on all implementations.
51
53 None.
54
56 None.
57
59 semctl() , semget() , semop() , sem_close() , sem_open() , the Base
60 Definitions volume of IEEE Std 1003.1-2001, <semaphore.h>
61
63 Portions of this text are reprinted and reproduced in electronic form
64 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
65 -- Portable Operating System Interface (POSIX), The Open Group Base
66 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
67 Electrical and Electronics Engineers, Inc and The Open Group. In the
68 event of any discrepancy between this version and the original IEEE and
69 The Open Group Standard, the original IEEE and The Open Group Standard
70 is the referee document. The original Standard can be obtained online
71 at http://www.opengroup.org/unix/online.html .
72
73
74
75IEEE/The Open Group 2003 SEM_UNLINK(P)