.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
.\" May be distributed under the GNU General Public License
-.TH IPCS "1" "September 2011" "util-linux" "User Commands"
+.TH IPCS "1" "July 2014" "util-linux" "User Commands"
.SH NAME
-ipcs \- provide information on ipc facilities
+ipcs \- show information on IPC facilities
.SH SYNOPSIS
.B ipcs
-[resource] [...] [output\-format]
-.br
-.B ipcs
-[resource]
-.I \-i id
+[options]
.SH DESCRIPTION
.B ipcs
-provides information on the ipc facilities for which the calling process
-has read access.
+shows information on the inter-process communication facilities
+for which the calling process has read access.
+By default it shows information about all three resources:
+shared memory segments, message queues, and semaphore arrays.
.SH OPTIONS
.TP
\fB\-i\fR, \fB\-\-id\fR \fIid\fR
-Print details only on resource identified by
+Show full details on just the one resource element identified by
.IR id .
+This option needs to be combined with one of the three resource options:
+.BR \-m ,
+.BR \-q " or"
+.BR \-s .
.TP
\fB\-h\fR, \fB\-\-help\fR
-Display this help and exit.
+Display help text and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
-Output version information and exit.
-.SH "RESOURCE OPTIONS"
+Display version information and exit.
+.SS "Resource options"
.TP
\fB\-m\fR, \fB\-\-shmems\fR
Write information about active shared memory segments.
Write information about active semaphore sets.
.TP
\fB\-a\fR, \fB\-\-all\fR
-Write information about all resources (default).
-.SH "OUTPUT FORMATS"
-.TP
-\fB\-t\fR, \fB\-\-time\fR
-Write time information. Time of the last control operation that changed the
-access permissions for all facilities, time of the last
-.I msgsnd()
-and
-.I msgrcv()
-operations on message queues, time of the last
-.I shmat()
-and
-.I shmdt()
-operations on shared memory, and time of the last
-.I semop()
-operation on semaphores.
-.TP
-\fB\-p\fR, \fB\-\-pid\fR
-Show creator and last operations PIDs.
+Write information about all three resources (default).
+.SS "Output formats"
+Of these options only one takes effect: the last one specified.
.TP
\fB\-c\fR, \fB\-\-creator\fR
Show creator and owner.
\fB\-l\fR, \fB\-\-limits\fR
Show resource limits.
.TP
+\fB\-p\fR, \fB\-\-pid\fR
+Show PIDs of creator and last operator.
+.TP
+\fB\-t\fR, \fB\-\-time\fR
+Write time information. The time of the last control operation that changed
+the access permissions for all facilities, the time of the last
+.BR msgsnd (2)
+and
+.BR msgrcv (2)
+operations on message queues, the time of the last
+.BR shmat (2)
+and
+.BR shmdt (2)
+operations on shared memory, and the time of the last
+.BR semop (2)
+operation on semaphores.
+.TP
\fB\-u\fR, \fB\-\-summary\fR
Show status summary.
+.SS "Representation"
+These affect only the \fB\-l\fR (\fB\-\-limits\fR) option.
+.TP
+\fB\-b\fR, \fB\-\-bytes\fR
+Print sizes in bytes.
+.TP
+.B \-\-human
+Print sizes in human-readable format.
.SH SEE ALSO
-.BR ipcrm (1),
.BR ipcmk (1),
+.BR ipcrm (1),
.BR msgrcv (2),
.BR msgsnd (2),
.BR semget (2),
.BR shmget (2)
.SH CONFORMING TO
The Linux ipcs utility is not fully compatible to the POSIX ipcs utility.
-The Linux version does not support the
+The Linux version does not support the POSIX
+.BR \-a ,
.B \-b
and
.B \-o
.B \-l
and
.B \-u
-options not defined by POSIX. The portable application shall not use the
+options not defined by POSIX. A portable application shall not use the
+.BR \-a ,
.BR \-b ,
.BR \-o ,
.BR \-l ,
.UE
.SH AVAILABILITY
The ipcs command is part of the util-linux package and is available from
-.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
Linux Kernel Archive
.UE .
projects / thirdparty / util-linux.git / blobdiff