140 lines
3.4 KiB
Groff
140 lines
3.4 KiB
Groff
.\" Copyright 2015 Ondrej Oprala(ooprala@redhat.com)
|
|
.\" May be distributed under the GNU General Public License
|
|
.TH LSIPC "1" "November 2015" "util-linux" "User Commands"
|
|
.SH NAME
|
|
lsipc \- show information on IPC facilities currently employed in the system
|
|
.SH SYNOPSIS
|
|
.B lsipc
|
|
[options]
|
|
.SH DESCRIPTION
|
|
.B lsipc
|
|
shows information on the inter-process communication facilities
|
|
for which the calling process has read access.
|
|
.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 .
|
|
It is possible to override the default output format for this option with the
|
|
\fB\-\-list\fR, \fB\-\-raw\fR, \fB\-\-json\fR or \fB\-\-export\fR option.
|
|
.TP
|
|
\fB\-g\fR, \fB\-\-global\fR
|
|
Show system-wide usage and limits of IPC resources.
|
|
This option may be combined with one of the three resource options:
|
|
.BR \-m ,
|
|
.BR \-q " or"
|
|
.BR \-s .
|
|
The default is to show information about all resources.
|
|
.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.
|
|
.SS "Output formatting"
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-creator\fR
|
|
Show creator and owner.
|
|
.TP
|
|
\fB\-e\fR, \fB\-\-export\fR
|
|
Output data in the format of NAME=VALUE.
|
|
.TP
|
|
\fB\-J\fR, \fB\-\-json\fR
|
|
Use the JSON output format.
|
|
.TP
|
|
\fB\-l\fR, \fB\-\-list\fR
|
|
Use the list output format. This is the default, except when \fB\-\-id\fR
|
|
is used.
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-newline\fR
|
|
Display each piece of information on a separate line.
|
|
.TP
|
|
\fB\-\-noheadings\fR
|
|
Do not print a header line.
|
|
.TP
|
|
\fB\-\-notruncate\fR
|
|
Don't truncate output.
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output \fIlist\fP
|
|
Specify which output columns to print. Use
|
|
.B \-\-help
|
|
to get a list of all supported columns.
|
|
.TP
|
|
\fB\-b\fR, \fB\-\-bytes\fR
|
|
Print size in bytes rather than in human readable format.
|
|
.TP
|
|
\fB\-r\fR, \fB\-\-raw\fR
|
|
Raw output (no columnation).
|
|
.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\-\-time\-format\fR \fItype\fP
|
|
Display dates in short, full or iso format. The default is short, this time
|
|
format is designed to be space efficient and human readable.
|
|
.TP
|
|
\fB\-P\fR, \fB\-\-numeric\-perms\fR
|
|
Print numeric permissions in PERMS column.
|
|
|
|
.SH EXIT STATUS
|
|
.TP
|
|
0
|
|
if OK,
|
|
.TP
|
|
1
|
|
if incorrect arguments specified,
|
|
.TP
|
|
2
|
|
if a serious error occurs.
|
|
.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)
|
|
.SH HISTORY
|
|
The \fBlsipc\fP utility is inspired by the \fBipcs\fP utility.
|
|
.SH AUTHORS
|
|
.MT ooprala@redhat.com
|
|
Ondrej Oprala
|
|
.ME
|
|
.br
|
|
.MT kzak@redhat.com
|
|
Karel Zak
|
|
.ME
|
|
|
|
.SH AVAILABILITY
|
|
The lsipc 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 .
|