]>
Commit | Line | Data |
---|---|---|
9d20ffda KZ |
1 | .\" Copyright 2015 Ondrej Oprala(ooprala@redhat.com) |
2 | .\" May be distributed under the GNU General Public License | |
25b3c04f | 3 | .TH LSIPC "1" "November 2015" "util-linux" "User Commands" |
9d20ffda KZ |
4 | .SH NAME |
5 | lsipc \- show information on IPC facilities currently employed in the system | |
6 | .SH SYNOPSIS | |
7 | .B lsipc | |
8 | [options] | |
9 | .SH DESCRIPTION | |
10 | .B lsipc | |
79a0cc9d | 11 | shows information on the System V inter-process communication facilities |
9d20ffda KZ |
12 | for which the calling process has read access. |
13 | .SH OPTIONS | |
14 | .TP | |
15 | \fB\-i\fR, \fB\-\-id\fR \fIid\fR | |
16 | Show full details on just the one resource element identified by | |
17 | .IR id . | |
18 | This option needs to be combined with one of the three resource options: | |
19 | .BR \-m , | |
20 | .BR \-q " or" | |
21 | .BR \-s . | |
25b3c04f BS |
22 | It is possible to override the default output format for this option with the |
23 | \fB\-\-list\fR, \fB\-\-raw\fR, \fB\-\-json\fR or \fB\-\-export\fR option. | |
9d20ffda KZ |
24 | .TP |
25 | \fB\-g\fR, \fB\-\-global\fR | |
25b3c04f | 26 | Show system-wide usage and limits of IPC resources. |
65607d4b | 27 | This option may be combined with one of the three resource options: |
9d20ffda KZ |
28 | .BR \-m , |
29 | .BR \-q " or" | |
30 | .BR \-s . | |
65607d4b | 31 | The default is to show information about all resources. |
9d20ffda KZ |
32 | .TP |
33 | \fB\-h\fR, \fB\-\-help\fR | |
34 | Display help text and exit. | |
35 | .TP | |
36 | \fB\-V\fR, \fB\-\-version\fR | |
37 | Display version information and exit. | |
38 | .SS "Resource options" | |
39 | .TP | |
40 | \fB\-m\fR, \fB\-\-shmems\fR | |
41 | Write information about active shared memory segments. | |
42 | .TP | |
43 | \fB\-q\fR, \fB\-\-queues\fR | |
44 | Write information about active message queues. | |
45 | .TP | |
46 | \fB\-s\fR, \fB\-\-semaphores\fR | |
47 | Write information about active semaphore sets. | |
25b3c04f | 48 | .SS "Output formatting" |
9d20ffda KZ |
49 | .TP |
50 | \fB\-c\fR, \fB\-\-creator\fR | |
51 | Show creator and owner. | |
52 | .TP | |
9d20ffda KZ |
53 | \fB\-e\fR, \fB\-\-export\fR |
54 | Output data in the format of NAME=VALUE. | |
55 | .TP | |
56 | \fB\-J\fR, \fB\-\-json\fR | |
57 | Use the JSON output format. | |
58 | .TP | |
2916afa3 | 59 | \fB\-l\fR, \fB\-\-list\fR |
25b3c04f BS |
60 | Use the list output format. This is the default, except when \fB\-\-id\fR |
61 | is used. | |
2916afa3 | 62 | .TP |
9d20ffda KZ |
63 | \fB\-n\fR, \fB\-\-newline\fR |
64 | Display each piece of information on a separate line. | |
65 | .TP | |
66 | \fB\-\-noheadings\fR | |
67 | Do not print a header line. | |
68 | .TP | |
69 | \fB\-\-notruncate\fR | |
70 | Don't truncate output. | |
71 | .TP | |
72 | \fB\-o\fR, \fB\-\-output \fIlist\fP | |
73 | Specify which output columns to print. Use | |
74 | .B \-\-help | |
75 | to get a list of all supported columns. | |
76 | .TP | |
1b71d08c SK |
77 | \fB\-b\fR, \fB\-\-bytes\fR |
78 | Print size in bytes rather than in human readable format. | |
9d20ffda KZ |
79 | .TP |
80 | \fB\-r\fR, \fB\-\-raw\fR | |
81 | Raw output (no columnation). | |
82 | .TP | |
83 | \fB\-t\fR, \fB\-\-time\fR | |
84 | Write time information. The time of the last control operation that changed | |
85 | the access permissions for all facilities, the time of the last | |
a7bbc2f3 | 86 | .BR msgsnd (2) |
9d20ffda | 87 | and |
a7bbc2f3 | 88 | .BR msgrcv (2) |
9d20ffda | 89 | operations on message queues, the time of the last |
a7bbc2f3 | 90 | .BR shmat (2) |
9d20ffda | 91 | and |
a7bbc2f3 | 92 | .BR shmdt (2) |
9d20ffda | 93 | operations on shared memory, and the time of the last |
a7bbc2f3 | 94 | .BR semop (2) |
9d20ffda KZ |
95 | operation on semaphores. |
96 | .TP | |
97 | \fB\-\-time\-format\fR \fItype\fP | |
98 | Display dates in short, full or iso format. The default is short, this time | |
99 | format is designed to be space efficient and human readable. | |
1b71d08c SK |
100 | .TP |
101 | \fB\-P\fR, \fB\-\-numeric\-perms\fR | |
102 | Print numeric permissions in PERMS column. | |
9d20ffda KZ |
103 | |
104 | .SH EXIT STATUS | |
105 | .TP | |
106 | 0 | |
107 | if OK, | |
108 | .TP | |
109 | 1 | |
110 | if incorrect arguments specified, | |
111 | .TP | |
112 | 2 | |
113 | if a serious error occurs. | |
9d20ffda KZ |
114 | .SH HISTORY |
115 | The \fBlsipc\fP utility is inspired by the \fBipcs\fP utility. | |
116 | .SH AUTHORS | |
117 | .MT ooprala@redhat.com | |
118 | Ondrej Oprala | |
119 | .ME | |
120 | .br | |
121 | .MT kzak@redhat.com | |
122 | Karel Zak | |
123 | .ME | |
124 | ||
ade04bb8 MK |
125 | .SH SEE ALSO |
126 | .BR ipcmk (1), | |
127 | .BR ipcrm (1), | |
128 | .BR msgrcv (2), | |
129 | .BR msgsnd (2), | |
130 | .BR semget (2), | |
131 | .BR semop (2), | |
132 | .BR shmat (2), | |
133 | .BR shmdt (2), | |
fdd6a44f MK |
134 | .BR shmget (2), |
135 | .BR sysvipc (7) | |
9d20ffda KZ |
136 | .SH AVAILABILITY |
137 | The lsipc command is part of the util-linux package and is available from | |
d673b74e | 138 | .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
9d20ffda KZ |
139 | Linux Kernel Archive |
140 | .UE . |