From f66524636d339199ee717a78ce504a9ef07e01b8 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 1 Jun 2012 00:55:28 +1200 Subject: [PATCH] msgctl.2, msgget.2, msgop.2, semctl.2, semget.2, semop.2, shmctl.2, shmget.2: NOTES: and aren't strictly needed Add text to NOTES to say that the and header files aren't required by Linux or the standards, but may be needed for portability to old systems. Signed-off-by: Michael Kerrisk --- man2/msgctl.2 | 15 ++++++++++++++- man2/msgget.2 | 15 ++++++++++++++- man2/msgop.2 | 15 ++++++++++++++- man2/semctl.2 | 15 ++++++++++++++- man2/semget.2 | 15 ++++++++++++++- man2/semop.2 | 15 ++++++++++++++- man2/shmctl.2 | 15 ++++++++++++++- man2/shmget.2 | 15 ++++++++++++++- 8 files changed, 112 insertions(+), 8 deletions(-) diff --git a/man2/msgctl.2 b/man2/msgctl.2 index 2cdb87625..a74bb2371 100644 --- a/man2/msgctl.2 +++ b/man2/msgctl.2 @@ -32,7 +32,7 @@ .\" Added msqid_ds and ipc_perm structure definitions .\" 2005-08-02, mtk: Added IPC_INFO, MSG_INFO, MSG_STAT descriptions .\" -.TH MSGCTL 2 2008-08-06 "Linux" "Linux Programmer's Manual" +.TH MSGCTL 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME msgctl \- message control operations .SH SYNOPSIS @@ -310,6 +310,19 @@ capability). SVr4, POSIX.1-2001. .\" SVID does not document the EIDRM error condition. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + The .BR IPC_INFO , .B MSG_STAT diff --git a/man2/msgget.2 b/man2/msgget.2 index 1b304ba5d..fba66a354 100644 --- a/man2/msgget.2 +++ b/man2/msgget.2 @@ -30,7 +30,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH MSGGET 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH MSGGET 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME msgget \- get a message queue identifier .SH SYNOPSIS @@ -181,6 +181,19 @@ would be exceeded. .SH "CONFORMING TO" SVr4, POSIX.1-2001. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + .B IPC_PRIVATE isn't a flag field but a .I key_t diff --git a/man2/msgop.2 b/man2/msgop.2 index 673c0d2e4..fe27c2154 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -35,7 +35,7 @@ .\" Added notes on /proc files .\" FIXME . Add example programs to this page. .\" -.TH MSGOP 2 2008-04-23 "Linux" "Linux Programmer's Manual" +.TH MSGOP 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME msgrcv, msgsnd \- message operations .SH SYNOPSIS @@ -397,6 +397,19 @@ and no message of the requested type existed on the message queue. .SH "CONFORMING TO" SVr4, POSIX.1-2001. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + The .I msgp argument is declared as \fIstruct msgbuf *\fP with diff --git a/man2/semctl.2 b/man2/semctl.2 index f16e94144..bf08e4c3a 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -36,7 +36,7 @@ .\" Added semid_ds and ipc_perm structure definitions .\" 2005-08-02, mtk: Added IPC_INFO, SEM_INFO, SEM_STAT descriptions. .\" -.TH SEMCTL 2 2009-09-27 "Linux" "Linux Programmer's Manual" +.TH SEMCTL 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME semctl \- semaphore control operations .SH SYNOPSIS @@ -461,6 +461,19 @@ or greater than the implementation limit SVr4, POSIX.1-2001. .\" SVr4 documents more error conditions EINVAL and EOVERFLOW. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + The .BR IPC_INFO , .B SEM_STAT diff --git a/man2/semget.2 b/man2/semget.2 index 7b1ddf099..a216c21a3 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -31,7 +31,7 @@ .\" Rewrote BUGS note about semget()'s failure to initialize .\" semaphore values .\" -.TH SEMGET 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH SEMGET 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME semget \- get a semaphore set identifier .SH SYNOPSIS @@ -219,6 +219,19 @@ SVr4, POSIX.1-2001. .\" SVr4 documents additional error conditions EFBIG, E2BIG, EAGAIN, .\" ERANGE, EFAULT. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + .B IPC_PRIVATE isn't a flag field but a .I key_t diff --git a/man2/semop.2 b/man2/semop.2 index 0790e8778..6d9c145ed 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -30,7 +30,7 @@ .\" 2005-04-08, mtk, Noted kernel version numbers for semtimedop() .\" 2007-07-09, mtk, Added an EXAMPLE code segment. .\" -.TH SEMOP 2 2012-05-10 "Linux" "Linux Programmer's Manual" +.TH SEMOP 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME semop, semtimedop \- semaphore operations .SH SYNOPSIS @@ -401,6 +401,19 @@ first appeared in version 2.3.3. SVr4, POSIX.1-2001. .\" SVr4 documents additional error conditions EINVAL, EFBIG, ENOSPC. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + The .I sem_undo structures of a process aren't inherited by the child produced by diff --git a/man2/shmctl.2 b/man2/shmctl.2 index 18b9c096e..25eb9cc1e 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -40,7 +40,7 @@ .\" attaches to a segment that has already been marked for deletion. .\" 2005-08-02, mtk: Added IPC_INFO, SHM_INFO, SHM_STAT descriptions. .\" -.TH SHMCTL 2 2008-08-07 "Linux" "Linux Programmer's Manual" +.TH SHMCTL 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME shmctl \- shared memory control .SH SYNOPSIS @@ -369,6 +369,19 @@ SVr4, POSIX.1-2001. .\" ENOENT, ENOSPC, ENOMEM, EEXIST. Neither SVr4 nor SVID documents .\" an EIDRM error condition. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + The .BR IPC_INFO , .B SHM_STAT diff --git a/man2/shmget.2 b/man2/shmget.2 index 9e479b659..e8e375bbc 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -33,7 +33,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH SHMGET 2 2006-05-02 "Linux" "Linux Programmer's Manual" +.TH SHMGET 2 2012-05-31 "Linux" "Linux Programmer's Manual" .SH NAME shmget \- allocates a shared memory segment .SH SYNOPSIS @@ -233,6 +233,19 @@ SVr4, POSIX.1-2001. .B SHM_HUGETLB is a nonportable Linux extension. .SH NOTES +The inclusion of +.I +and +.I +isn't required on Linux or by any version of POSIX. +However, +some old implementations required the inclusion of these header files, +and the SVID also documented their inclusion. +Applications intended to be portable to such old systems may need +to include these header files. +.\" Like Linux, the FreeBSD man pages still document +.\" the inclusion of these header files. + .B IPC_PRIVATE isn't a flag field but a .I key_t