1ipcs(1)                          User Commands                         ipcs(1)
2
3
4

NAME

6       ipcs - report inter-process communication facilities status
7

SYNOPSIS

9       ipcs [-aAbciJmopqstZ] [-D mtype] [-z zone]
10
11

DESCRIPTION

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

OPTIONS

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

ENVIRONMENT VARIABLES

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

FILES

267       /etc/group     group names
268
269
270       /etc/passwd    user names
271
272

ATTRIBUTES

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

SEE ALSO

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

NOTES

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)
Impressum