From 2c5e151c7fd489b1e144e582975743745ac724c7 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 21 Apr 2006 03:53:43 +0000 Subject: [PATCH] ipc.7 --> svipc.7 --- man2/msgctl.2 | 4 ++-- man2/msgget.2 | 4 ++-- man2/msgop.2 | 4 ++-- man2/semctl.2 | 4 ++-- man2/semget.2 | 18 ++++++++++++++---- man2/semop.2 | 4 ++-- man2/shmget.2 | 2 +- man2/shmop.2 | 2 +- man3/ftok.3 | 2 +- man5/ipc.5 | 2 +- man5/proc.5 | 2 +- man7/svipc.7 | 4 ++-- 12 files changed, 31 insertions(+), 21 deletions(-) diff --git a/man2/msgctl.2 b/man2/msgctl.2 index c5f14f505..73e81159a 100644 --- a/man2/msgctl.2 +++ b/man2/msgctl.2 @@ -329,5 +329,5 @@ SVr4, SVID. SVID does not document the EIDRM error condition. .BR msgrcv (2), .BR msgsnd (2), .BR capabilities (7), -.BR ipc (7), -.BR mq_overview (7) +.BR mq_overview (7), +.BR svipc (7) diff --git a/man2/msgget.2 b/man2/msgget.2 index 8b09b5714..fef60f645 100644 --- a/man2/msgget.2 +++ b/man2/msgget.2 @@ -216,5 +216,5 @@ on a message queue scheduled for deletion. .BR msgsnd (2), .BR ftok (3), .BR capabilities (7), -.BR ipc (7), -.BR mq_overview (7) +.BR mq_overview (7), +.BR svipc (7) diff --git a/man2/msgop.2 b/man2/msgop.2 index 0554514de..8bfc7a115 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -435,5 +435,5 @@ and for the system wide maximum size in bytes of the message pool .BR msgrcv (2), .BR msgsnd (2), .BR capabilities (7), -.BR ipc (7), -.BR mq_overview (7) +.BR mq_overview (7), +.BR svipc (7) diff --git a/man2/semctl.2 b/man2/semctl.2 index 89e7b65c1..e146d9cb2 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -506,5 +506,5 @@ SVr4, SVID. SVr4 documents more error conditions EINVAL and EOVERFLOW. .BR semget (2), .BR semop (2), .BR capabilities (7), -.BR ipc (7), -.BR sem_overview (7) +.BR sem_overview (7), +.BR svipc (7) diff --git a/man2/semget.2 b/man2/semget.2 index 0a8fcf71b..985d23423 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -98,12 +98,22 @@ argument of not meaningful for semaphores, and write permissions mean permission to alter semaphore values). .PP +The values of the semaphores in a newly created set are indeterminate. +(POSIX.1 is explicit on this point.) +Although Linux, like many other implementations, +initialises the semaphore values to 0, +a portable application cannot rely on this: +it should explicitly initialise the semaphores to the desired values. +.\" In truth, every one of the many implementations that I've tested sets +.\" the values to zero, but I suppose there is/was some obscure +.\" implementation out there that does not. +.PP When creating a new semaphore set, .BR semget () -initialises the set's associated data structure +initialises the set's associated data structure, .I semid_ds (see -.BR semctl (2)) +.BR semctl (2)), as follows: .IP .I sem_perm.cuid @@ -271,5 +281,5 @@ ERANGE, EFAULT. .BR semop (2), .BR ftok (3), .BR capabilities (7), -.BR ipc (7), -.BR sem_overview (7) +.BR sem_overview (7), +.BR svipc (7) diff --git a/man2/semop.2 b/man2/semop.2 index e303b51c4..989e437aa 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -481,5 +481,5 @@ ENOSPC. .BR semget (2), .BR sigaction (2), .BR capabilities (7), -.BR ipc (7), -.BR sem_overview (7) +.BR sem_overview (7), +.BR svipc (7) diff --git a/man2/shmget.2 b/man2/shmget.2 index 8676b24f7..b092cbb6f 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -283,4 +283,4 @@ is a non-portable Linux extension. .BR shmdt (2), .BR ftok (3), .BR capabilities (7), -.BR ipc (7) +.BR svipc (7) diff --git a/man2/shmop.2 b/man2/shmop.2 index 258660074..9f51e21e0 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -288,4 +288,4 @@ prototypes; glibc2 has .BR shmctl (2), .BR shmget (2), .BR capabilities (7), -.BR ipc (7) +.BR svipc (7) diff --git a/man3/ftok.3 b/man3/ftok.3 index dc4832e89..7553c5bae 100644 --- a/man3/ftok.3 +++ b/man3/ftok.3 @@ -97,4 +97,4 @@ and files on .BR semget (2), .BR shmget (2), .BR stat (2), -.BR ipc (7) +.BR svipc (7) diff --git a/man5/ipc.5 b/man5/ipc.5 index 182a37866..8ce1c37b8 100644 --- a/man5/ipc.5 +++ b/man5/ipc.5 @@ -1,2 +1,2 @@ -.so man7/ipc.7 +.so man7/svipc.7 .\" FIXME . this link will eventually be removed (created Apr 2006) diff --git a/man5/proc.5 b/man5/proc.5 index 45c63348f..e4322311a 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -1632,7 +1632,7 @@ providing similar information to that available via .BR ipcs (1). These files have headers and are formatted (one IPC object per line) for easy understanding. -.BR ipc (7) +.BR svipc (7) provides further background on the information shown by these files. .TP .I /proc/tty diff --git a/man7/svipc.7 b/man7/svipc.7 index 1ecde423d..edd571cfd 100644 --- a/man7/svipc.7 +++ b/man7/svipc.7 @@ -22,9 +22,9 @@ .\" .\" FIXME There is now duplication of some of the information .\" below in semctl.2, msgctl.2, and shmctl.2 -- MTK, Nov 04 -.TH IPC 7 1993-11-01 "Linux 0.99.13" "Linux Programmer's Manual" +.TH SVIPC 7 1993-11-01 "Linux 0.99.13" "Linux Programmer's Manual" .SH NAME -ipc \- System V interprocess communication mechanisms +svipc \- System V interprocess communication mechanisms .SH SYNOPSIS .nf .B