2021-03-20 10:42:47 -05:00
//po4a: entry man manual
2021-03-12 14:10:37 -06:00
= lsipc(1)
:doctype: manpage
2021-03-21 04:00:16 -05:00
:man manual: User Commands
2021-03-12 14:10:37 -06:00
:man source: util-linux {release-version}
:page-layout: base
:command: lsipc
== NAME
lsipc - show information on IPC facilities currently employed in the system
== SYNOPSIS
2021-03-19 12:25:50 -05:00
*lsipc* [options]
2021-03-12 14:10:37 -06:00
== DESCRIPTION
*lsipc* shows information on the System V inter-process communication facilities for which the calling process has read access.
== OPTIONS
*-i*, *--id* _id_::
2021-03-26 11:19:27 -05:00
Show full details on just the one resource element identified by _id_. This option needs to be combined with one of the three resource options: *-m*, *-q* or *-s*. It is possible to override the default output format for this option with the *--list*, *--raw*, *--json* or *--export* option.
2021-03-12 14:10:37 -06:00
*-g*, *--global*::
2021-03-26 11:19:27 -05:00
Show system-wide usage and limits of IPC resources. This option may be combined with one of the three resource options: *-m*, *-q* or *-s*. The default is to show information about all resources.
2021-03-12 14:10:37 -06:00
*-h*, *--help*::
2021-03-26 11:19:27 -05:00
Display help text and exit.
2021-03-12 14:10:37 -06:00
*-V*, *--version*::
2021-03-26 11:19:27 -05:00
Display version information and exit.
2021-03-12 14:10:37 -06:00
=== Resource options
*-m*, *--shmems*::
2021-03-26 11:19:27 -05:00
Write information about active shared memory segments.
2021-03-12 14:10:37 -06:00
*-q*, *--queues*::
2021-03-26 11:19:27 -05:00
Write information about active message queues.
2021-03-12 14:10:37 -06:00
*-s*, *--semaphores*::
2021-03-26 11:19:27 -05:00
Write information about active semaphore sets.
2021-03-12 14:10:37 -06:00
=== Output formatting
*-c*, *--creator*::
2021-03-26 11:19:27 -05:00
Show creator and owner.
2021-03-12 14:10:37 -06:00
*-e*, *--export*::
2021-03-26 11:19:27 -05:00
Produce output in the form of key="value" pairs. All potentially unsafe value characters are hex-escaped (\x<code>). The key (variable name) will be modified to contain only characters allowed for a shell variable identifiers, for example, USE_PCT instead of USE%.
2021-03-12 14:10:37 -06:00
*-J*, *--json*::
2021-03-26 11:19:27 -05:00
Use the JSON output format.
2021-03-12 14:10:37 -06:00
*-l*, *--list*::
2021-03-26 11:19:27 -05:00
Use the list output format. This is the default, except when *--id* is used.
2021-03-12 14:10:37 -06:00
*-n*, *--newline*::
2021-03-26 11:19:27 -05:00
Display each piece of information on a separate line.
2021-03-12 14:10:37 -06:00
*--noheadings*::
2021-03-26 11:19:27 -05:00
Do not print a header line.
2021-03-12 14:10:37 -06:00
*--notruncate*::
2021-03-26 11:19:27 -05:00
Don't truncate output.
2021-03-12 14:10:37 -06:00
2021-03-20 03:45:23 -05:00
*-o*, *--output* _list_::
2021-03-26 11:19:27 -05:00
Specify which output columns to print. Use *--help* to get a list of all supported columns.
2021-03-12 14:10:37 -06:00
*-b*, *--bytes*::
2021-03-26 11:19:27 -05:00
Print size in bytes rather than in human readable format.
2021-03-12 14:10:37 -06:00
*-r*, *--raw*::
2021-03-26 11:19:27 -05:00
Raw output (no columnation).
2021-03-12 14:10:37 -06:00
*-t*, *--time*::
2021-03-26 11:19:27 -05:00
Write time information. The time of the last control operation that changed the access permissions for all facilities, the time of the last *msgsnd*(2) and *msgrcv*(2) operations on message queues, the time of the last *shmat*(2) and *shmdt*(2) operations on shared memory, and the time of the last *semop*(2) operation on semaphores.
2021-03-12 14:10:37 -06:00
*--time-format* _type_::
2021-03-26 11:19:27 -05:00
Display dates in short, full or iso format. The default is short, this time format is designed to be space efficient and human readable.
2021-03-12 14:10:37 -06:00
*-P*, *--numeric-perms*::
2021-03-26 11:19:27 -05:00
Print numeric permissions in PERMS column.
2021-03-12 14:10:37 -06:00
== EXIT STATUS
0::
2021-03-26 11:19:27 -05:00
if OK,
2021-03-12 14:10:37 -06:00
1::
2021-03-26 11:19:27 -05:00
if incorrect arguments specified,
2021-03-12 14:10:37 -06:00
2::
2021-03-26 11:19:27 -05:00
if a serious error occurs.
2021-03-12 14:10:37 -06:00
== HISTORY
2021-03-19 12:25:50 -05:00
The *lsipc* utility is inspired by the *ipcs*(1) utility.
2021-03-12 14:10:37 -06:00
== AUTHORS
2021-03-26 11:19:27 -05:00
mailto:ooprala@redhat.com[Ondrej Oprala],
2021-03-12 14:10:37 -06:00
mailto:kzak@redhat.com[Karel Zak]
== SEE ALSO
*ipcmk*(1),
*ipcrm*(1),
*msgrcv*(2),
*msgsnd*(2),
*semget*(2),
*semop*(2),
*shmat*(2),
*shmdt*(2),
*shmget*(2),
*sysvipc*(7)
2021-03-31 04:33:06 -05:00
include::man-common/bugreports.adoc[]
2021-03-12 14:10:37 -06:00
2021-03-31 04:33:06 -05:00
include::man-common/footer.adoc[]
2021-03-12 14:10:37 -06:00
ifdef::translation[]
2021-03-31 04:33:06 -05:00
include::man-common/translation.adoc[]
2021-03-12 14:10:37 -06:00
endif::[]