summaryrefslogtreecommitdiffstats
path: root/man2/msgctl.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/msgctl.2')
-rw-r--r--man2/msgctl.265
1 files changed, 34 insertions, 31 deletions
diff --git a/man2/msgctl.2 b/man2/msgctl.2
index bfdc7f25d..432ecd7a9 100644
--- a/man2/msgctl.2
+++ b/man2/msgctl.2
@@ -60,19 +60,16 @@ data structure is defined in \fI<sys/msg.h>\fP as follows:
.in +4n
.EX
struct msqid_ds {
- struct ipc_perm msg_perm; /* Ownership and permissions */
- time_t msg_stime; /* Time of last msgsnd(2) */
- time_t msg_rtime; /* Time of last msgrcv(2) */
- time_t msg_ctime; /* Creation time/time of last
- modification via msgctl() */
- unsigned long __msg_cbytes; /* Current number of bytes in
- queue (nonstandard) */
- msgqnum_t msg_qnum; /* Current number of messages
- in queue */
- msglen_t msg_qbytes; /* Maximum number of bytes
- allowed in queue */
- pid_t msg_lspid; /* PID of last msgsnd(2) */
- pid_t msg_lrpid; /* PID of last msgrcv(2) */
+ struct ipc_perm msg_perm; /* Ownership and permissions */
+ time_t msg_stime; /* Time of last msgsnd(2) */
+ time_t msg_rtime; /* Time of last msgrcv(2) */
+ time_t msg_ctime; /* Time of creation or last
+ modification by msgctl() */
+ unsigned long msg_cbytes; /* # of bytes in queue */
+ msgqnum_t msg_qnum; /* # number of messages in queue */
+ msglen_t msg_qbytes; /* Maximum # of bytes in queue */
+ pid_t msg_lspid; /* PID of last msgsnd(2) */
+ pid_t msg_lrpid; /* PID of last msgrcv(2) */
};
.EE
.in
@@ -87,6 +84,26 @@ This is an
structure (see below) that specifies the access permissions on the message
queue.
.TP
+.I msg_stime
+Time of the last
+.BR msgsnd (2)
+system call.
+.TP
+.I msg_rtime
+Time of the last
+.BR msgrcv (2)
+system call.
+.TP
+.I msg_ctime
+Time of creation of queue or time of last
+.BR msgctl ()
+.BR IPC_SET
+operation.
+.TP
+.I msg_cbytes
+Number of bytes in all messages currently on the message queue.
+This is a nonstandard Linux extension that is not specified in POSIX.
+.TP
.I msg_qnum
Number of messages currently on the message queue.
.TP
@@ -103,22 +120,6 @@ system call.
ID of the process that performed the last
.BR msgrcv (2)
system call.
-.TP
-.I msg_stime
-Time of the last
-.BR msgsnd (2)
-system call.
-.TP
-.I msg_rtime
-Time of the last
-.BR msgrcv (2)
-system call.
-.TP
-.I msg_ctime
-Time of creation of queue or time of last
-.BR msgctl ()
-.BR IPC_SET
-operation.
.PP
The
.I ipc_perm
@@ -180,12 +181,14 @@ to the kernel data structure associated with this message queue,
updating also its
.I msg_ctime
member.
+.IP
The following members of the structure are updated:
.IR msg_qbytes ,
.IR msg_perm.uid ,
.IR msg_perm.gid ,
and (the least significant 9 bits of)
.IR msg_perm.mode .
+.IP
The effective UID of the calling process must match the owner
.RI ( msg_perm.uid )
or creator
@@ -421,7 +424,7 @@ to include these header files.
.PP
The
.BR IPC_INFO ,
-.B MSG_STAT
+.BR MSG_STAT ,
and
.B MSG_INFO
operations are used by the
@@ -452,7 +455,7 @@ flag in
.BR mq_overview (7),
.BR sysvipc (7)
.SH COLOPHON
-This page is part of release 5.09 of the Linux
+This page is part of release 5.10 of the Linux
.I man-pages
project.
A description of the project,