]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
6d5b6948 MB |
2 | //// |
3 | Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) | |
4 | May be distributed under the GNU General Public License | |
5 | //// | |
6 | = ipcs(1) | |
7 | :doctype: manpage | |
f42ed819 | 8 | :man manual: User Commands |
6d5b6948 MB |
9 | :man source: util-linux {release-version} |
10 | :page-layout: base | |
11 | :command: ipcs | |
12 | ||
13 | == NAME | |
14 | ||
15 | ipcs - show information on IPC facilities | |
16 | ||
17 | == SYNOPSIS | |
18 | ||
4d297435 | 19 | *ipcs* [options] |
6d5b6948 MB |
20 | |
21 | == DESCRIPTION | |
22 | ||
23 | *ipcs* shows information on System V inter-process communication facilities. By default it shows information about all three resources: shared memory segments, message queues, and semaphore arrays. | |
24 | ||
25 | == OPTIONS | |
26 | ||
27 | *-i*, *--id* _id_:: | |
4eab78d3 | 28 | 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*. |
6d5b6948 | 29 | |
2b2d3172 | 30 | include::man-common/help-version.adoc[] |
6d5b6948 MB |
31 | |
32 | === Resource options | |
33 | ||
34 | *-m*, *--shmems*:: | |
4eab78d3 | 35 | Write information about active shared memory segments. |
6d5b6948 MB |
36 | |
37 | *-q*, *--queues*:: | |
4eab78d3 | 38 | Write information about active message queues. |
6d5b6948 MB |
39 | |
40 | *-s*, *--semaphores*:: | |
4eab78d3 | 41 | Write information about active semaphore sets. |
6d5b6948 MB |
42 | |
43 | *-a*, *--all*:: | |
4eab78d3 | 44 | Write information about all three resources (default). |
6d5b6948 MB |
45 | |
46 | === Output formats | |
47 | ||
48 | Of these options only one takes effect: the last one specified. | |
49 | ||
50 | *-c*, *--creator*:: | |
4eab78d3 | 51 | Show creator and owner. |
6d5b6948 MB |
52 | |
53 | *-l*, *--limits*:: | |
4eab78d3 | 54 | Show resource limits. |
6d5b6948 MB |
55 | |
56 | *-p*, *--pid*:: | |
4eab78d3 | 57 | Show PIDs of creator and last operator. |
6d5b6948 MB |
58 | |
59 | *-t*, *--time*:: | |
4eab78d3 | 60 | 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 |
61 | |
62 | *-u*, *--summary*:: | |
4eab78d3 | 63 | Show status summary. |
6d5b6948 MB |
64 | |
65 | === Representation | |
66 | ||
67 | These affect only the *-l* (*--limits*) option. | |
68 | ||
69 | *-b*, *--bytes*:: | |
4c989ad4 KZ |
70 | include::man-common/in-bytes.adoc[] |
71 | ||
6d5b6948 MB |
72 | |
73 | *--human*:: | |
4eab78d3 | 74 | Print sizes in human-readable format. |
6d5b6948 MB |
75 | |
76 | == CONFORMING TO | |
77 | ||
4eab78d3 | 78 | The Linux *ipcs* utility is not fully compatible to the POSIX *ipcs* utility. The Linux version does not support the POSIX *-a*, *-b* and *-o* options, but does support the *-l* and *-u* options not defined by POSIX. A portable application shall not use the *-a*, *-b*, *-o*, *-l*, and *-u* options. |
6d5b6948 MB |
79 | |
80 | == NOTES | |
81 | ||
82 | The current implementation of *ipcs* obtains information about available IPC resources by parsing the files in _/proc/sysvipc_. Before util-linux version v2.23, an alternate mechanism was used: the *IPC_STAT* command of *msgctl*(2), *semctl*(2), and *shmctl*(2). This mechanism is also used in later util-linux versions in the case where _/proc_ is unavailable. A limitation of the *IPC_STAT* mechanism is that it can only be used to retrieve information about IPC resources for which the user has read permission. | |
83 | ||
84 | == AUTHORS | |
85 | ||
86 | mailto:balasub@cis.ohio-state.edu[Krishna Balasubramanian] | |
87 | ||
88 | == SEE ALSO | |
89 | ||
90 | *ipcmk*(1), | |
91 | *ipcrm*(1), | |
92 | *msgrcv*(2), | |
93 | *msgsnd*(2), | |
94 | *semget*(2), | |
95 | *semop*(2), | |
96 | *shmat*(2), | |
97 | *shmdt*(2), | |
98 | *shmget*(2), | |
99 | *sysvipc*(7) | |
100 | ||
625e9c61 | 101 | include::man-common/bugreports.adoc[] |
6d5b6948 | 102 | |
625e9c61 | 103 | include::man-common/footer.adoc[] |
6d5b6948 MB |
104 | |
105 | ifdef::translation[] | |
625e9c61 | 106 | include::man-common/translation.adoc[] |
6d5b6948 | 107 | endif::[] |