This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
manual: Complete @standards in ipc.texi.
- From: Rical Jasan <ricaljasan at pacific dot net>
- To: libc-alpha at sourceware dot org
- Cc: Joseph Myers <joseph at codesourcery dot com>, Zack Weinberg <zackw at panix dot com>, Carlos O'Donell <carlos at redhat dot com>, Michael Kerrisk <mtk dot manpages at gmail dot com>
- Date: Fri, 16 Jun 2017 04:09:50 -0700
- Subject: manual: Complete @standards in ipc.texi.
- Authentication-results: sourceware.org; auth=none
* manual/ipc.texi (semctl): Add header and standard
annotation.
(semget): Likewise.
(semop): Likewise.
(semtimedop): Likewise.
(sem_init): Likewise.
(sem_destroy): Likewise.
(sem_open): Likewise.
(sem_close): Likewise.
(sem_unlink): Likewise.
(sem_wait): Likewise.
(sem_timedwait): Likewise.
(sem_trywait): Likewise.
(sem_post): Likewise.
(sem_getvalue): Likewise.
---
manual/ipc.texi | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/manual/ipc.texi b/manual/ipc.texi
index 081b98fe29..13038d1b33 100644
--- a/manual/ipc.texi
+++ b/manual/ipc.texi
@@ -21,6 +21,7 @@ by @theglibc{}.
@subsection System V Semaphores
@deftypefun int semctl (int @var{semid}, int @var{semnum}, int @var{cmd});
+@standards{SVID, sys/sem.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acunsafe{@acucorrupt{/linux}}}
@c syscall(ipc) ok
@c
@@ -31,16 +32,19 @@ by @theglibc{}.
@end deftypefun
@deftypefun int semget (key_t @var{key}, int @var{nsems}, int @var{semflg});
+@standards{SVID, sys/sem.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c syscall(ipc) ok
@end deftypefun
@deftypefun int semop (int @var{semid}, struct sembuf *@var{sops}, size_t @var{nsops});
+@standards{SVID, sys/sem.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c syscall(ipc) ok
@end deftypefun
@deftypefun int semtimedop (int @var{semid}, struct sembuf *@var{sops}, size_t @var{nsops}, const struct timespec *@var{timeout});
+@standards{GNU, sys/sem.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c syscall(ipc) ok
@end deftypefun
@@ -48,17 +52,20 @@ by @theglibc{}.
@subsection POSIX Semaphores
@deftypefun int sem_init (sem_t *@var{sem}, int @var{pshared}, unsigned int @var{value});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acunsafe{@acucorrupt{}}}
@c Does not atomically update sem_t therefore AC-unsafe
@c because it can leave sem_t partially initialized.
@end deftypefun
@deftypefun int sem_destroy (sem_t *@var{sem});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Function does nothing and is therefore always safe.
@end deftypefun
@deftypefun sem_t *sem_open (const char *@var{name}, int @var{oflag}, ...);
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@asunsafe{@asuinit{}}@acunsafe{@acuinit{}}}
@c pthread_once asuinit
@c
@@ -68,6 +75,7 @@ by @theglibc{}.
@end deftypefun
@deftypefun int sem_close (sem_t *@var{sem});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}}
@c lll_lock asulock aculock
@c twalk mtsrace{:root}
@@ -78,12 +86,14 @@ by @theglibc{}.
@end deftypefun
@deftypefun int sem_unlink (const char *@var{name});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@asunsafe{@asuinit{}}@acunsafe{@acucorrupt{}}}
@c pthread_once asuinit acucorrupt aculock
@c mempcpy acucorrupt
@end deftypefun
@deftypefun int sem_wait (sem_t *@var{sem});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acunsafe{@acucorrupt{}}}
@c atomic_increment (nwaiters) acucorrupt
@c
@@ -96,21 +106,25 @@ by @theglibc{}.
@end deftypefun
@deftypefun int sem_timedwait (sem_t *@var{sem}, const struct timespec *@var{abstime});
+@standards{POSIX.1-2001, semaphore.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acunsafe{@acucorrupt{}}}
@c Same safety issues as sem_wait.
@end deftypefun
@deftypefun int sem_trywait (sem_t *@var{sem});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c All atomic operations are safe in all contexts.
@end deftypefun
@deftypefun int sem_post (sem_t *@var{sem});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Same safety as sem_trywait.
@end deftypefun
@deftypefun int sem_getvalue (sem_t *@var{sem}, int *@var{sval});
+@standards{POSIX.1, semaphore.h}
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Atomic write of a value is safe in all contexts.
@end deftypefun
--
2.12.2