]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
6d5b6948 MB |
2 | = lsipc(1) |
3 | :doctype: manpage | |
f42ed819 | 4 | :man manual: User Commands |
6d5b6948 MB |
5 | :man source: util-linux {release-version} |
6 | :page-layout: base | |
7 | :command: lsipc | |
8 | ||
9 | == NAME | |
10 | ||
11 | lsipc - show information on IPC facilities currently employed in the system | |
12 | ||
13 | == SYNOPSIS | |
14 | ||
4d297435 | 15 | *lsipc* [options] |
6d5b6948 MB |
16 | |
17 | == DESCRIPTION | |
18 | ||
19 | *lsipc* shows information on the System V inter-process communication facilities for which the calling process has read access. | |
20 | ||
21 | == OPTIONS | |
22 | ||
23 | *-i*, *--id* _id_:: | |
4eab78d3 | 24 | 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. |
6d5b6948 MB |
25 | |
26 | *-g*, *--global*:: | |
4eab78d3 | 27 | 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. |
6d5b6948 | 28 | |
2b2d3172 | 29 | include::man-common/help-version.adoc[] |
6d5b6948 MB |
30 | |
31 | === Resource options | |
32 | ||
33 | *-m*, *--shmems*:: | |
4eab78d3 | 34 | Write information about active shared memory segments. |
6d5b6948 MB |
35 | |
36 | *-q*, *--queues*:: | |
4eab78d3 | 37 | Write information about active message queues. |
6d5b6948 MB |
38 | |
39 | *-s*, *--semaphores*:: | |
4eab78d3 | 40 | Write information about active semaphore sets. |
6d5b6948 MB |
41 | |
42 | === Output formatting | |
43 | ||
44 | *-c*, *--creator*:: | |
4eab78d3 | 45 | Show creator and owner. |
6d5b6948 MB |
46 | |
47 | *-e*, *--export*:: | |
eba05f30 | 48 | Produce output in the form of key="value" pairs. All potentially unsafe value characters are hex-escaped (\x<code>). See also option *--shell*. |
6d5b6948 MB |
49 | |
50 | *-J*, *--json*:: | |
4eab78d3 | 51 | Use the JSON output format. |
6d5b6948 MB |
52 | |
53 | *-l*, *--list*:: | |
4eab78d3 | 54 | Use the list output format. This is the default, except when *--id* is used. |
6d5b6948 MB |
55 | |
56 | *-n*, *--newline*:: | |
4eab78d3 | 57 | Display each piece of information on a separate line. |
6d5b6948 MB |
58 | |
59 | *--noheadings*:: | |
4eab78d3 | 60 | Do not print a header line. |
6d5b6948 MB |
61 | |
62 | *--notruncate*:: | |
4eab78d3 | 63 | Don't truncate output. |
6d5b6948 | 64 | |
5723eae7 | 65 | *-o*, *--output* _list_:: |
4eab78d3 | 66 | Specify which output columns to print. Use *--help* to get a list of all supported columns. |
6d5b6948 MB |
67 | |
68 | *-b*, *--bytes*:: | |
4eab78d3 | 69 | Print size in bytes rather than in human readable format. |
6d5b6948 MB |
70 | |
71 | *-r*, *--raw*:: | |
4eab78d3 | 72 | Raw output (no columnation). |
6d5b6948 MB |
73 | |
74 | *-t*, *--time*:: | |
4eab78d3 | 75 | 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. |
6d5b6948 MB |
76 | |
77 | *--time-format* _type_:: | |
4eab78d3 | 78 | Display dates in short, full or iso format. The default is short, this time format is designed to be space efficient and human readable. |
6d5b6948 MB |
79 | |
80 | *-P*, *--numeric-perms*:: | |
4eab78d3 | 81 | Print numeric permissions in PERMS column. |
6d5b6948 | 82 | |
eba05f30 KZ |
83 | *-y*, *--shell*:: |
84 | The column name will be modified to contain only characters allowed for shell variable identifiers. This is usable, for example, with *--export*. Note that this feature has been automatically enabled for *--export* in version 2.37, but due to compatibility issues, now it's necessary to request this behavior by *--shell*. | |
85 | ||
6d5b6948 MB |
86 | == EXIT STATUS |
87 | ||
88 | 0:: | |
4eab78d3 | 89 | if OK, |
6d5b6948 MB |
90 | |
91 | 1:: | |
4eab78d3 | 92 | if incorrect arguments specified, |
6d5b6948 MB |
93 | |
94 | 2:: | |
4eab78d3 | 95 | if a serious error occurs. |
6d5b6948 MB |
96 | |
97 | == HISTORY | |
98 | ||
4d297435 | 99 | The *lsipc* utility is inspired by the *ipcs*(1) utility. |
6d5b6948 MB |
100 | |
101 | == AUTHORS | |
102 | ||
4eab78d3 | 103 | mailto:ooprala@redhat.com[Ondrej Oprala], |
6d5b6948 MB |
104 | mailto:kzak@redhat.com[Karel Zak] |
105 | ||
106 | == SEE ALSO | |
107 | ||
108 | *ipcmk*(1), | |
109 | *ipcrm*(1), | |
110 | *msgrcv*(2), | |
111 | *msgsnd*(2), | |
112 | *semget*(2), | |
113 | *semop*(2), | |
114 | *shmat*(2), | |
115 | *shmdt*(2), | |
116 | *shmget*(2), | |
117 | *sysvipc*(7) | |
118 | ||
625e9c61 | 119 | include::man-common/bugreports.adoc[] |
6d5b6948 | 120 | |
625e9c61 | 121 | include::man-common/footer.adoc[] |
6d5b6948 MB |
122 | |
123 | ifdef::translation[] | |
625e9c61 | 124 | include::man-common/translation.adoc[] |
6d5b6948 | 125 | endif::[] |