(split) LDP: Update original to LDP v3.65

[linuxjm/LDP_man-pages.git] / original / man2 / msgctl.2

diff --git a/original/man2/msgctl.2 b/original/man2/msgctl.2
index 85527f2..51e81fe 100644 (file)
--- a/original/man2/msgctl.2
+++ b/original/man2/msgctl.2
@@ -34,7 +34,7 @@
 .\"    Added msqid_ds and ipc_perm structure definitions
 .\" 2005-08-02, mtk: Added IPC_INFO, MSG_INFO, MSG_STAT descriptions
 .\"
-.TH MSGCTL 2 2012-05-31 "Linux" "Linux Programmer's Manual"
+.TH MSGCTL 2 2014-02-24 "Linux" "Linux Programmer's Manual"
 .SH NAME
 msgctl \- System V message control operations
 .SH SYNOPSIS
@@ -129,7 +129,7 @@ or creator
 .RI ( msg_perm.cuid )
 of the message queue, or the caller must be privileged.
 Appropriate privilege (Linux: the
-.B CAP_IPC_RESOURCE
+.B CAP_SYS_RESOURCE
 capability) is required to raise the
 .I msg_qbytes
 value beyond the system parameter
@@ -145,6 +145,9 @@ set to
 The calling process must have appropriate privileges
 or its effective user ID must be either that of the creator or owner
 of the message queue.
+The third argument to
+.BR msgctl ()
+is ignored in this case.
 .TP
 .BR IPC_INFO " (Linux-specific)"
 Returns information about system-wide message queue limits and
@@ -305,9 +308,20 @@ or the owner
 (as found in
 .IR msg_perm.uid )
 of the message queue,
-and the process is not privileged (Linux: it does not have the
+and the caller is not privileged (Linux: does not have the
 .B CAP_SYS_ADMIN
 capability).
+.TP
+.B EPERM
+An attempt
+.RB ( IPC_SET )
+was made to increase
+.I msg_qbytes
+beyond the system parameter
+.BR MSGMNB ,
+but the caller is not privileged (Linux: does not have the
+.B CAP_SYS_RESOURCE
+capability).
 .SH CONFORMING TO
 SVr4, POSIX.1-2001.
 .\" SVID does not document the EIDRM error condition.
@@ -333,8 +347,9 @@ and
 operations are used by the
 .BR ipcs (1)
 program to provide information on allocated resources.
-In the future these may modified or moved to a /proc file system
-interface.
+In the future these may modified or moved to a
+.I /proc
+filesystem interface.
 
 Various fields in the \fIstruct msqid_ds\fP were
 typed as
@@ -356,3 +371,11 @@ flag in
 .BR capabilities (7),
 .BR mq_overview (7),
 .BR svipc (7)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.