]>
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 MB |
28 | |
29 | *-h*, *--help*:: | |
4eab78d3 | 30 | Display help text and exit. |
6d5b6948 MB |
31 | |
32 | *-V*, *--version*:: | |
4eab78d3 | 33 | Display version information and exit. |
6d5b6948 MB |
34 | |
35 | === Resource options | |
36 | ||
37 | *-m*, *--shmems*:: | |
4eab78d3 | 38 | Write information about active shared memory segments. |
6d5b6948 MB |
39 | |
40 | *-q*, *--queues*:: | |
4eab78d3 | 41 | Write information about active message queues. |
6d5b6948 MB |
42 | |
43 | *-s*, *--semaphores*:: | |
4eab78d3 | 44 | Write information about active semaphore sets. |
6d5b6948 MB |
45 | |
46 | === Output formatting | |
47 | ||
48 | *-c*, *--creator*:: | |
4eab78d3 | 49 | Show creator and owner. |
6d5b6948 MB |
50 | |
51 | *-e*, *--export*:: | |
4eab78d3 | 52 | 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%. |
6d5b6948 MB |
53 | |
54 | *-J*, *--json*:: | |
4eab78d3 | 55 | Use the JSON output format. |
6d5b6948 MB |
56 | |
57 | *-l*, *--list*:: | |
4eab78d3 | 58 | Use the list output format. This is the default, except when *--id* is used. |
6d5b6948 MB |
59 | |
60 | *-n*, *--newline*:: | |
4eab78d3 | 61 | Display each piece of information on a separate line. |
6d5b6948 MB |
62 | |
63 | *--noheadings*:: | |
4eab78d3 | 64 | Do not print a header line. |
6d5b6948 MB |
65 | |
66 | *--notruncate*:: | |
4eab78d3 | 67 | Don't truncate output. |
6d5b6948 | 68 | |
5723eae7 | 69 | *-o*, *--output* _list_:: |
4eab78d3 | 70 | Specify which output columns to print. Use *--help* to get a list of all supported columns. |
6d5b6948 MB |
71 | |
72 | *-b*, *--bytes*:: | |
4eab78d3 | 73 | Print size in bytes rather than in human readable format. |
6d5b6948 MB |
74 | |
75 | *-r*, *--raw*:: | |
4eab78d3 | 76 | Raw output (no columnation). |
6d5b6948 MB |
77 | |
78 | *-t*, *--time*:: | |
4eab78d3 | 79 | 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 |
80 | |
81 | *--time-format* _type_:: | |
4eab78d3 | 82 | 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 |
83 | |
84 | *-P*, *--numeric-perms*:: | |
4eab78d3 | 85 | Print numeric permissions in PERMS column. |
6d5b6948 MB |
86 | |
87 | == EXIT STATUS | |
88 | ||
89 | 0:: | |
4eab78d3 | 90 | if OK, |
6d5b6948 MB |
91 | |
92 | 1:: | |
4eab78d3 | 93 | if incorrect arguments specified, |
6d5b6948 MB |
94 | |
95 | 2:: | |
4eab78d3 | 96 | if a serious error occurs. |
6d5b6948 MB |
97 | |
98 | == HISTORY | |
99 | ||
4d297435 | 100 | The *lsipc* utility is inspired by the *ipcs*(1) utility. |
6d5b6948 MB |
101 | |
102 | == AUTHORS | |
103 | ||
4eab78d3 | 104 | mailto:ooprala@redhat.com[Ondrej Oprala], |
6d5b6948 MB |
105 | mailto:kzak@redhat.com[Karel Zak] |
106 | ||
107 | == SEE ALSO | |
108 | ||
109 | *ipcmk*(1), | |
110 | *ipcrm*(1), | |
111 | *msgrcv*(2), | |
112 | *msgsnd*(2), | |
113 | *semget*(2), | |
114 | *semop*(2), | |
115 | *shmat*(2), | |
116 | *shmdt*(2), | |
117 | *shmget*(2), | |
118 | *sysvipc*(7) | |
119 | ||
120 | include::../man-common/bugreports.adoc[] | |
121 | ||
122 | include::../man-common/footer.adoc[] | |
123 | ||
124 | ifdef::translation[] | |
125 | include::../man-common/translation.adoc[] | |
126 | endif::[] |