2006-12-06 17:25:32 -06:00
|
|
|
.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
|
|
|
|
.\" May be distributed under the GNU General Public License
|
2014-07-16 16:09:50 -05:00
|
|
|
.TH IPCS "1" "July 2014" "util-linux" "User Commands"
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH NAME
|
2014-07-16 16:09:50 -05:00
|
|
|
ipcs \- show information on IPC facilities
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH SYNOPSIS
|
2009-07-22 04:18:14 -05:00
|
|
|
.B ipcs
|
2014-07-16 16:09:50 -05:00
|
|
|
[options]
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH DESCRIPTION
|
|
|
|
.B ipcs
|
2014-07-16 16:09:50 -05:00
|
|
|
shows information on the inter-process communication facilities
|
2013-01-27 07:40:19 -06:00
|
|
|
for which the calling process has read access.
|
2014-07-16 16:09:50 -05:00
|
|
|
By default it shows information about all three resources:
|
|
|
|
shared memory segments, message queues, and semaphore arrays.
|
2011-09-05 15:05:37 -05:00
|
|
|
.SH OPTIONS
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2011-09-05 15:05:37 -05:00
|
|
|
\fB\-i\fR, \fB\-\-id\fR \fIid\fR
|
2014-07-16 16:09:50 -05:00
|
|
|
Show full details on just the one resource element identified by
|
2011-09-05 15:05:37 -05:00
|
|
|
.IR id .
|
2014-07-16 16:09:50 -05:00
|
|
|
This option needs to be combined with one of the three resource options:
|
|
|
|
.BR \-m ,
|
|
|
|
.BR \-q " or"
|
|
|
|
.BR \-s .
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2011-09-05 15:05:37 -05:00
|
|
|
\fB\-h\fR, \fB\-\-help\fR
|
2013-10-14 14:34:39 -05:00
|
|
|
Display help text and exit.
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2011-09-05 15:05:37 -05:00
|
|
|
\fB\-V\fR, \fB\-\-version\fR
|
2013-01-27 07:40:19 -06:00
|
|
|
Display version information and exit.
|
|
|
|
.SS "Resource options"
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2013-01-27 07:40:19 -06:00
|
|
|
\fB\-m\fR, \fB\-\-shmems\fR
|
|
|
|
Write information about active shared memory segments.
|
|
|
|
.TP
|
2014-07-16 16:09:50 -05:00
|
|
|
\fB\-q\fR, \fB\-\-queues\fR
|
|
|
|
Write information about active message queues.
|
|
|
|
.TP
|
2011-09-05 15:05:37 -05:00
|
|
|
\fB\-s\fR, \fB\-\-semaphores\fR
|
|
|
|
Write information about active semaphore sets.
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2011-09-05 15:05:37 -05:00
|
|
|
\fB\-a\fR, \fB\-\-all\fR
|
2013-01-27 07:40:19 -06:00
|
|
|
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.
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2011-09-05 15:05:37 -05:00
|
|
|
\fB\-t\fR, \fB\-\-time\fR
|
2013-01-27 07:40:19 -06:00
|
|
|
Write time information. The time of the last control operation that changed
|
|
|
|
the access permissions for all facilities, the time of the last
|
2016-11-10 04:59:37 -06:00
|
|
|
.BR msgsnd (2)
|
2011-09-05 15:05:37 -05:00
|
|
|
and
|
2016-11-10 04:59:37 -06:00
|
|
|
.BR msgrcv (2)
|
2013-01-27 07:40:19 -06:00
|
|
|
operations on message queues, the time of the last
|
2016-11-10 04:59:37 -06:00
|
|
|
.BR shmat (2)
|
2011-09-05 15:05:37 -05:00
|
|
|
and
|
2016-11-10 04:59:37 -06:00
|
|
|
.BR shmdt (2)
|
2013-01-27 07:40:19 -06:00
|
|
|
operations on shared memory, and the time of the last
|
2016-11-10 04:59:37 -06:00
|
|
|
.BR semop (2)
|
2011-09-05 15:05:37 -05:00
|
|
|
operation on semaphores.
|
2006-12-06 17:25:32 -06:00
|
|
|
.TP
|
2011-09-05 15:05:37 -05:00
|
|
|
\fB\-u\fR, \fB\-\-summary\fR
|
|
|
|
Show status summary.
|
2013-01-27 07:40:19 -06:00
|
|
|
.SS "Representation"
|
|
|
|
These affect only the \fB\-l\fR (\fB\-\-limits\fR) option.
|
2012-12-16 04:43:52 -06:00
|
|
|
.TP
|
|
|
|
\fB\-b\fR, \fB\-\-bytes\fR
|
|
|
|
Print sizes in bytes.
|
2013-01-27 07:40:19 -06:00
|
|
|
.TP
|
|
|
|
.B \-\-human
|
|
|
|
Print sizes in human-readable format.
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH SEE ALSO
|
2011-09-05 15:05:37 -05:00
|
|
|
.BR ipcmk (1),
|
2016-11-10 04:59:27 -06:00
|
|
|
.BR ipcrm (1),
|
2011-09-05 15:05:37 -05:00
|
|
|
.BR msgrcv (2),
|
|
|
|
.BR msgsnd (2),
|
|
|
|
.BR semget (2),
|
|
|
|
.BR semop (2),
|
|
|
|
.BR shmat (2),
|
|
|
|
.BR shmdt (2),
|
|
|
|
.BR shmget (2)
|
2008-02-07 17:51:04 -06:00
|
|
|
.SH CONFORMING TO
|
|
|
|
The Linux ipcs utility is not fully compatible to the POSIX ipcs utility.
|
2013-01-27 07:40:19 -06:00
|
|
|
The Linux version does not support the POSIX
|
|
|
|
.BR \-a ,
|
2008-02-07 17:51:04 -06:00
|
|
|
.B \-b
|
|
|
|
and
|
|
|
|
.B \-o
|
|
|
|
options, but does support the
|
|
|
|
.B \-l
|
|
|
|
and
|
|
|
|
.B \-u
|
2013-01-27 07:40:19 -06:00
|
|
|
options not defined by POSIX. A portable application shall not use the
|
|
|
|
.BR \-a ,
|
2009-07-22 04:18:14 -05:00
|
|
|
.BR \-b ,
|
|
|
|
.BR \-o ,
|
|
|
|
.BR \-l ,
|
2008-02-07 17:51:04 -06:00
|
|
|
and
|
2009-07-22 04:18:14 -05:00
|
|
|
.B \-u
|
|
|
|
options.
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH AUTHOR
|
2011-09-05 15:05:37 -05:00
|
|
|
.UR balasub@cis.ohio-state.edu
|
|
|
|
Krishna Balasubramanian
|
|
|
|
.UE
|
2007-07-02 18:17:04 -05:00
|
|
|
.SH AVAILABILITY
|
2010-11-30 04:41:59 -06:00
|
|
|
The ipcs command is part of the util-linux package and is available from
|
2016-12-17 02:06:57 -06:00
|
|
|
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
|
2011-09-05 15:05:37 -05:00
|
|
|
Linux Kernel Archive
|
|
|
|
.UE .
|