]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man3/sem_unlink.3
fuse.4: fuse_entry_out: rework discussion of uniqueness of nodeid + generation
[thirdparty/man-pages.git] / man3 / sem_unlink.3
CommitLineData
2c731798 1'\" t
c11b1abf 2.\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
2c731798 3.\"
93015253 4.\" %%%LICENSE_START(VERBATIM)
2c731798
MK
5.\" Permission is granted to make and distribute verbatim copies of this
6.\" manual provided the copyright notice and this permission notice are
7.\" preserved on all copies.
8.\"
9.\" Permission is granted to copy and distribute modified versions of this
10.\" manual under the conditions for verbatim copying, provided that the
11.\" entire resulting derived work is distributed under the terms of a
12.\" permission notice identical to this one.
c13182ef 13.\"
2c731798
MK
14.\" Since the Linux kernel and libraries are constantly changing, this
15.\" manual page may be incorrect or out-of-date. The author(s) assume no
16.\" responsibility for errors or omissions, or for damages resulting from
10d76543
MK
17.\" the use of the information contained herein. The author(s) may not
18.\" have taken the same level of care in the production of this manual,
19.\" which is licensed free of charge, as they might when working
20.\" professionally.
c13182ef 21.\"
2c731798
MK
22.\" Formatted or processed versions of this manual, if unaccompanied by
23.\" the source, must acknowledge the copyright and authors of this work.
4b72fb64 24.\" %%%LICENSE_END
2c731798 25.\"
460495ca 26.TH SEM_UNLINK 3 2015-08-08 "Linux" "Linux Programmer's Manual"
2c731798
MK
27.SH NAME
28sem_unlink \- remove a named semaphore
29.SH SYNOPSIS
30.nf
31.B #include <semaphore.h>
32.sp
33.BI "int sem_unlink(const char *" name );
34.fi
fce1dd17 35.sp
2c5f8c8c 36Link with \fI\-pthread\fP.
2c731798
MK
37.SH DESCRIPTION
38.BR sem_unlink ()
39removes the named semaphore referred to by
c030aa56 40.IR name .
2c731798 41The semaphore name is removed immediately.
c13182ef 42The semaphore is destroyed once all other processes that have
2c731798
MK
43the semaphore open close it.
44.SH RETURN VALUE
45On success
46.BR sem_unlink ()
47returns 0; on error, \-1 is returned, with
c13182ef 48.I errno
2c731798
MK
49set to indicate the error.
50.SH ERRORS
51.TP
52.B EACCES
53The caller does not have permission to unlink this semaphore.
54.TP
55.B ENAMETOOLONG
0daa9e92 56.I name
2c731798
MK
57was too long.
58.TP
59.B ENOENT
60There is no semaphore with the given
61.IR name .
ef0a5e73 62.SH ATTRIBUTES
ee9482f4
PH
63For an explanation of the terms used in this section, see
64.BR attributes (7).
65.TS
66allbox;
67lb lb lb
68l l l.
69Interface Attribute Value
70T{
ef0a5e73 71.BR sem_unlink ()
ee9482f4
PH
72T} Thread safety MT-Safe
73.TE
2c731798 74.SH CONFORMING TO
14375f3f 75POSIX.1-2001, POSIX.1-2008.
47297adb 76.SH SEE ALSO
2c731798
MK
77.BR sem_getvalue (3),
78.BR sem_open (3),
79.BR sem_post (3),
80.BR sem_wait (3),
81.BR sem_overview (7)