1ipcs(1) User Commands ipcs(1)
2
3
4
6 ipcs - report inter-process communication facilities status
7
9 ipcs [-aAbciJmopqstZ] [-D mtype] [-z zone]
10
11
13 The ipcs utility prints information about active inter-process communi‐
14 cation facilities. The information that is displayed is controlled by
15 the options supplied. Without options, information is printed in short
16 format for message queues, shared memory, and semaphores that are cur‐
17 rently active in the system.
18
20 The following options are supported:
21
22 -m Prints information about active shared memory segments.
23
24
25 -q Prints information about active message queues.
26
27
28 -s Prints information about active semaphores.
29
30
31
32 If -m, -q, or -s are specified, information about only those indicated
33 is printed. If none of these three is specified, information about all
34 three is printed subject to these options:
35
36 -a Uses all XCU5 print options. (This is a shorthand notation
37 for -b, -c, -o, -p, and -t.)
38
39
40 -A Uses all print options. (This is a shorthand notation for
41 -b, -c, -i, -J, -o, -p, and -t.)
42
43
44 -b Prints information on biggest allowable size: maximum num‐
45 ber of bytes in messages on queue for message queues, size
46 of segments for shared memory, and number of semaphores in
47 each set for semaphores. See below for meaning of columns
48 in a listing.
49
50
51 -c Prints creator's login name and group name. See below.
52
53
54 -D mtype Displays, in hexadecimal and ASCII, the contents of all
55 messages of type mtype found on any message queue that the
56 user invoking ipcs has permission to read. If mtype is 0,
57 all messages are displayed. If mtype is negative, all mes‐
58 sages with type less than or equal to the absolute value of
59 mtype are displayed. (See msgrcv(2) and msgsnap(2)).
60
61
62 -i Prints number of ISM attaches to shared memory segments.
63
64
65 -J Prints the creator's project.
66
67
68 -o Prints information on outstanding usage: number of messages
69 on queue and total number of bytes in messages on queue for
70 message queues and number of processes attached to shared
71 memory segments.
72
73
74 -p Prints process number information: process ID of last
75 process to send a message, process ID of last process to
76 receive a message on message queues, process ID of creating
77 process, and process ID of last process to attach or detach
78 on shared memory segments. See below.
79
80
81 -t Prints time information: time of the last control operation
82 that changed the access permissions for all facilities,
83 time of last msgsnd(2) and last msgrcv(2) on message
84 queues, time of last shmat(2) and last shmdt(2) on shared
85 memory (see shmop(2)), time of last semop(2) on semaphores.
86 See below.
87
88
89 -z zone Prints information about facilities associated with the
90 specified zone (see zones(5)). The zone can be specified as
91 either a name or a numeric id. The default is to display
92 information about the zone in which the command is execut‐
93 ing. Notice that this option is only useful when executing
94 in the global zone.
95
96
97 -Z When executing in the global zone, prints information about
98 all zones. Otherwise, prints information about the zone in
99 which the command is executing. The output includes the
100 zone associated with each facility.
101
102
103
104 The column headings and the meaning of the columns in an ipcs listing
105 are given below. The letters in parentheses indicate the options that
106 cause the corresponding heading to appear and "all" means that the
107 heading always appears. Note: These options only determine what infor‐
108 mation is provided for each facility; they do not determine which
109 facilities are listed.
110
111 T (all) Type of the facility:
112
113 q message queue
114
115
116 m shared memory segment
117
118
119 s semaphore
120
121
122
123 ID (all) The identifier for the facility entry.
124
125
126 KEY (all) The key used as an argument to msgget(2), semget(2),
127 or shmget(2) to create the facility entry. (Note:
128 The key of a shared memory segment is changed to
129 IPC_PRIVATE when the segment has been removed until
130 all processes attached to the segment detach it.)
131
132
133 MODE (all) The facility access modes and flags: The mode con‐
134 sists of 11 characters that are interpreted as fol‐
135 lows. The first two characters are:
136
137 R A process is waiting on a msgrcv(2).
138
139
140 S A process is waiting on a msgsnd(2).
141
142
143 - The corresponding special flag is not set.
144
145 The next nine characters are interpreted as three
146 sets of three bits each. The first set refers to the
147 owner's permissions; the next to permissions of oth‐
148 ers in the user-group of the facility entry; and the
149 last to all others. Within each set, the first char‐
150 acter indicates permission to read, the second char‐
151 acter indicates permission to write or alter the
152 facility entry, and the last character is currently
153 unused.
154
155 The permissions are indicated as follows:
156
157 r Read permission is granted.
158
159
160 w Write permission is granted.
161
162
163 a Alter permission is granted.
164
165
166 − The indicated permission is not granted.
167
168
169
170 OWNER (all) The login name of the owner of the facility entry.
171
172
173 GROUP (all) The group name of the group of the owner of the
174 facility entry.
175
176
177 CREATOR (a,A,c) The login name of the creator of the facility entry.
178
179
180 CGROUP (a,A,c) The group name of the group of the creator of the
181 facility entry.
182
183
184 CBYTES (a,A,o) The number of bytes in messages currently outstand‐
185 ing on the associated message queue.
186
187
188 QNUM (a,A,o) The number of messages currently outstanding on the
189 associated message queue.
190
191
192 QBYTES (a,A,b) The maximum number of bytes allowed in messages out‐
193 standing on the associated message queue.
194
195
196 LSPID (a,A,p) The process ID of the last process to send a message
197 to the associated queue.
198
199
200 LRPID (a,A,p) The process ID of the last process to receive a mes‐
201 sage from the associated queue.
202
203
204 STIME (a,A,t) The time the last message was sent to the associated
205 queue.
206
207
208 RTIME (a,A,t) The time the last message was received from the
209 associated queue.
210
211
212 CTIME (a,A,t) The time when the associated entry was created or
213 changed.
214
215
216 ISMATTCH (a,i) The number of ISM attaches to the associated shared
217 memory segments.
218
219
220 NATTCH (a,A,o) The number of processes attached to the associated
221 shared memory segment.
222
223
224 SEGSZ (a,A,b) The size of the associated shared memory segment.
225
226
227 CPID (a,A,p) The process ID of the creator of the shared memory
228 entry.
229
230
231 LPID (a,A,p) The process ID of the last process to attach or
232 detach the shared memory segment.
233
234
235 ATIME (a,A,t) The time the last attach was completed to the asso‐
236 ciated shared memory segment.
237
238
239 DTIME (a,A,t) The time the last detach was completed on the asso‐
240 ciated shared memory segment.
241
242
243 NSEMS (a,A,b) The number of semaphores in the set associated with
244 the semaphore entry.
245
246
247 OTIME (a,A,t) The time the last semaphore operation was completed
248 on the set associated with the semaphore entry.
249
250
251 PROJECT (J,A) The project name of the creator of the facility
252 entry.
253
254
255 ZONE (Z) The zone with which the facility is associated.
256
257
259 See environ(5) for descriptions of the following environment variables
260 that affect the execution of ipcs: LANG, LC_ALL, LC_CTYPE, LC_MES‐
261 SAGES, and NLSPATH.
262
263 TZ Determine the timezone for the time strings written by ipcs.
264
265
267 /etc/group group names
268
269
270 /etc/passwd user names
271
272
274 See attributes(5) for descriptions of the following attributes:
275
276
277
278
279 ┌─────────────────────────────┬─────────────────────────────┐
280 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
281 ├─────────────────────────────┼─────────────────────────────┤
282 │Availability │SUNWipc │
283 ├─────────────────────────────┼─────────────────────────────┤
284 │Interface Stability │Committed │
285 ├─────────────────────────────┼─────────────────────────────┤
286 │Standard │See standards(5). │
287 └─────────────────────────────┴─────────────────────────────┘
288
290 ipcrm(1), msgget(2), msgids(2), msgrcv(2), msgsnap(2), msgsnd(2),
291 semget(2), semids(2), semop(2), shmctl(2), shmget(2), shmids(2),
292 shmop(2), attributes(5), environ(5), standards(5), zones(5)
293
295 Things can change while ipcs is running. The information it gives is
296 guaranteed to be accurate only when it was retrieved.
297
298
299
300SunOS 5.11 17 Jan 2008 ipcs(1)