a0859be5c7
Source is current git content. Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z [ "test-groff" is a developmental version of "groff" ] Input file is ././disk-utils/sfdisk.8 troff: backtrace: file '<./disk-utils/sfdisk.8>':67 troff: <./disk-utils/sfdisk.8>:67: warning: trailing space Input file is ././misc-utils/kill.1 troff: backtrace: '/home/bg/git/groff/build/s-tmac/an-ext.tmac':133: macro 'EE' troff: backtrace: file '<./misc-utils/kill.1>':167 troff: <./misc-utils/kill.1>:167: warning: macro 'mF' not defined troff: backtrace: '/home/bg/git/groff/build/s-tmac/an-ext.tmac':134: macro 'EE' troff: backtrace: file '<./misc-utils/kill.1>':167 troff: <./misc-utils/kill.1>:167: warning: number register 'mE' not defined troff: backtrace: '/home/bg/git/groff/build/s-tmac/an-ext.tmac':134: macro 'EE' troff: backtrace: file '<./misc-utils/kill.1>':167 troff: <./misc-utils/kill.1>:167: warning: bad font number troff: backtrace: '/home/bg/git/groff/build/s-tmac/an-ext.tmac':135: macro 'EE' troff: backtrace: file '<./misc-utils/kill.1>':167 troff: <./misc-utils/kill.1>:167: warning: number register 'sP' not defined troff: backtrace: '/home/bg/git/groff/build/s-tmac/an-ext.tmac':134: macro 'EE' troff: backtrace: file '<./misc-utils/kill.1>':170 troff: <./misc-utils/kill.1>:170: warning: bad font number Input file is ././sys-utils/ipcs.1 <./sys-utils/ipcs.1>:103 (macro BR): only 1 argument, but more are expected Input file is ././sys-utils/mount.8 <./sys-utils/mount.8>:68 (macro RB): only 1 argument, but more are expected troff: backtrace: '/home/bg/git/groff/build/s-tmac/an-old.tmac':467: macro 'RB' troff: backtrace: file '<./sys-utils/mount.8>':68 troff: <./sys-utils/mount.8>:68: warning [p 1, 3.5i]: can't break line an-old.tmac: <./sys-utils/mount.8>:201 (.RE): warning: extra .RE or .RS is missing before it; "an-RS-open" is 0. <./sys-utils/mount.8>:453 (macro BR): only 1 argument, but more are expected <./sys-utils/mount.8>:500 (macro BR): only 1 argument, but more are expected <./sys-utils/mount.8>:1050 (macro BR): only 1 argument, but more are expected Input file is ././sys-utils/setpriv.1 <./sys-utils/setpriv.1>:17 (macro BR): only 1 argument, but more are expected <./sys-utils/setpriv.1>:154 (macro BR): only 1 argument, but more are expected <./sys-utils/setpriv.1>:166 (macro BR): only 1 argument, but more are expected Input file is ././sys-utils/umount.8 <./sys-utils/umount.8>:145 (macro IR): only 1 argument, but more are expected Input file is ././sys-utils/unshare.1 <./sys-utils/unshare.1>:266 (macro BR): only 1 argument, but more are expected [kzak@redhat.com: - add .RS to fix extra .RE in mount.8] Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Karel Zak <kzak@redhat.com>
135 lines
3.3 KiB
Groff
135 lines
3.3 KiB
Groff
.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
|
|
.\" May be distributed under the GNU General Public License
|
|
.TH IPCS "1" "July 2014" "util-linux" "User Commands"
|
|
.SH NAME
|
|
ipcs \- show information on IPC facilities
|
|
.SH SYNOPSIS
|
|
.B ipcs
|
|
[options]
|
|
.SH DESCRIPTION
|
|
.B ipcs
|
|
shows information on System V inter-process communication facilities.
|
|
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
|
|
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 help text and exit.
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
Display version information and exit.
|
|
.SS "Resource options"
|
|
.TP
|
|
\fB\-m\fR, \fB\-\-shmems\fR
|
|
Write information about active shared memory segments.
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-queues\fR
|
|
Write information about active message queues.
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-semaphores\fR
|
|
Write information about active semaphore sets.
|
|
.TP
|
|
\fB\-a\fR, \fB\-\-all\fR
|
|
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.
|
|
.TP
|
|
\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 CONFORMING TO
|
|
The Linux ipcs utility is not fully compatible to the POSIX ipcs utility.
|
|
The Linux version does not support the POSIX
|
|
.BR \-a ,
|
|
.B \-b
|
|
and
|
|
.B \-o
|
|
options, but does support the
|
|
.B \-l
|
|
and
|
|
.B \-u
|
|
options not defined by POSIX. A portable application shall not use the
|
|
.BR \-a ,
|
|
.BR \-b ,
|
|
.BR \-o ,
|
|
.BR \-l ,
|
|
and
|
|
.B \-u
|
|
options.
|
|
.SH NOTES
|
|
The current implementation of
|
|
.B ipcs
|
|
obtains information about available IPC resources by parsing the files in
|
|
.IR /proc/sysvipc .
|
|
Before util-linux version v2.23, an alternate mechanism was used: the
|
|
.B IPC_STAT
|
|
command of
|
|
.BR msgctl (2),
|
|
.BR semctl (2),
|
|
and
|
|
.BR shmctl (2).
|
|
This mechanism is also used in later util-linux versions in the case where
|
|
.I /proc
|
|
is unavailable.
|
|
A limitation of the
|
|
.B IPC_STAT
|
|
mechanism is that it can only be used to retrieve information about
|
|
IPC resources for which the user has read permission.
|
|
.SH AUTHORS
|
|
.UR balasub@cis.ohio-state.edu
|
|
Krishna Balasubramanian
|
|
.UE
|
|
.SH SEE ALSO
|
|
.BR ipcmk (1),
|
|
.BR ipcrm (1),
|
|
.BR msgrcv (2),
|
|
.BR msgsnd (2),
|
|
.BR semget (2),
|
|
.BR semop (2),
|
|
.BR shmat (2),
|
|
.BR shmdt (2),
|
|
.BR shmget (2),
|
|
.BR sysvipc (7)
|
|
.SH AVAILABILITY
|
|
The ipcs command is part of the util-linux package and is available from
|
|
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
|
|
Linux Kernel Archive
|
|
.UE .
|