msgctl.2, msgget.2, msgop.2, semctl.2, semget.2, semop.2, shmctl.2, shmget.2: NOTES...

Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
header files aren't required by Linux or the standards, but may
be needed for portability to old systems.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/msgctl.2 b/man2/msgctl.2
index 2cdb8762598911de2f53256c48225fcf9a66ce14..a74bb23716b7193689be09dcccc1f394ce2f7f1f 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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 1b304ba5d498e3b07da02125063904a783e12f78..fba66a3548a6e81b821d53f60a1f437082aa3e0c 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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 673c0d2e44bd820498df246533f39d47ead95668..fe27c2154fda5c209eac7fd515f93ed5affd4fc1 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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 f16e94144da81e4ff5ab5da75e661dfa3b02c9d3..bf08e4c3a2d6edd67bf0a6eef9910bde6843d125 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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 7b1ddf099d7c8c37a804da29afc537289789182c..a216c21a376e112dc88f03008d9d676d09507b65 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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 0790e877838fb523638ffda522a135ba1295e4bb..6d9c145edcaec1461204be097e15d579ed57e6bc 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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 18b9c096e85cb6ae3034762ddbd8c6664bf2f62a..25eb9cc1e868594a6a776d5c8ed5a599bc1ff2b4 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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 9e479b6591ba04b135d9aa3fed42084d551e2d71..e8e375bbc83bd3db239d9a01377997aa5acf76b7 100644 (file)
--- 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 <sys/types.h>
+and
+.I <sys/ipc.h>
+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