summaryrefslogtreecommitdiffstats
path: root/man2/msgctl.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/msgctl.2')
-rw-r--r--man2/msgctl.240
1 files changed, 20 insertions, 20 deletions
diff --git a/man2/msgctl.2 b/man2/msgctl.2
index b905b0f..27aca82 100644
--- a/man2/msgctl.2
+++ b/man2/msgctl.2
@@ -16,7 +16,7 @@
.\" 2005-08-02, mtk: Added IPC_INFO, MSG_INFO, MSG_STAT descriptions
.\" 2018-03-20, dbueso: Added MSG_STAT_ANY description.
.\"
-.TH msgctl 2 2023-03-30 "Linux man-pages 6.05.01"
+.TH msgctl 2 2024-03-03 "Linux man-pages 6.7"
.SH NAME
msgctl \- System V message control operations
.SH LIBRARY
@@ -25,20 +25,20 @@ Standard C library
.SH SYNOPSIS
.nf
.B #include <sys/msg.h>
-.PP
-.BI "int msgctl(int " msqid ", int " cmd ", struct msqid_ds *" buf );
+.P
+.BI "int msgctl(int " msqid ", int " op ", struct msqid_ds *" buf );
.fi
.SH DESCRIPTION
.BR msgctl ()
performs the control operation specified by
-.I cmd
+.I op
on the System\ V message queue with identifier
.IR msqid .
-.PP
+.P
The
.I msqid_ds
data structure is defined in \fI<sys/msg.h>\fP as follows:
-.PP
+.P
.in +4n
.EX
struct msqid_ds {
@@ -55,7 +55,7 @@ struct msqid_ds {
};
.EE
.in
-.PP
+.P
The fields of the
.I msqid_ds
structure are as follows:
@@ -102,13 +102,13 @@ system call.
ID of the process that performed the last
.BR msgrcv (2)
system call.
-.PP
+.P
The
.I ipc_perm
structure is defined as follows
(the highlighted fields are settable using
.BR IPC_SET ):
-.PP
+.P
.in +4n
.EX
struct ipc_perm {
@@ -122,7 +122,7 @@ struct ipc_perm {
};
.EE
.in
-.PP
+.P
The least significant 9 bits of the
.I mode
field of the
@@ -138,11 +138,11 @@ l l.
0004 Read by others
0002 Write by others
.TE
-.PP
+.P
Bits 0100, 0010, and 0001 (the execute bits) are unused by the system.
-.PP
+.P
Valid values for
-.I cmd
+.I op
are:
.TP
.B IPC_STAT
@@ -312,7 +312,7 @@ or
.B MSG_STAT_ANY
operation returns the identifier of the queue whose index was given in
.IR msqid .
-.PP
+.P
On failure, \-1 is returned and
.I errno
is set to indicate the error.
@@ -320,7 +320,7 @@ is set to indicate the error.
.TP
.B EACCES
The argument
-.I cmd
+.I op
is equal to
.B IPC_STAT
or
@@ -333,7 +333,7 @@ capability in the user namespace that governs its IPC namespace.
.TP
.B EFAULT
The argument
-.I cmd
+.I op
has the value
.B IPC_SET
or
@@ -347,7 +347,7 @@ The message queue was removed.
.TP
.B EINVAL
Invalid value for
-.I cmd
+.I op
or
.IR msqid .
Or: for a
@@ -358,7 +358,7 @@ referred to an array slot that is currently unused.
.TP
.B EPERM
The argument
-.I cmd
+.I op
has the value
.B IPC_SET
or
@@ -389,7 +389,7 @@ POSIX.1-2008.
.SH HISTORY
POSIX.1-2001, SVr4.
.\" SVID does not document the EIDRM error condition.
-.PP
+.P
Various fields in the \fIstruct msqid_ds\fP were
typed as
.I short
@@ -402,7 +402,7 @@ a recompilation under glibc-2.1.91 or later should suffice.
(The kernel distinguishes old and new calls by an
.B IPC_64
flag in
-.IR cmd .)
+.IR op .)
.SH NOTES
The
.BR IPC_INFO ,