1IPCRM(P) POSIX Programmer's Manual IPCRM(P)
2
6 ipcrm - remove an XSI message queue, semaphore set, or shared memory
7 segment identifier
8
10 ipcrm [ -q msgid | -Q msgkey | -s semid | -S semkey |
11 -m shmid | -M shmkey ] ...
12
14 The ipcrm utility shall remove zero or more message queues, semaphore
15 sets, or shared memory segments. The interprocess communication facili‐
16 ties to be removed are specified by the options.
17 Only a user with appropriate privilege shall be allowed to remove an
19 interprocess communication facility that was not created by or owned by
20 the user invoking ipcrm.
21
23 The ipcrm facility supports the Base Definitions volume of
24 IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.
25 The following options shall be supported:
27 -q msgid
29 Remove the message queue identifier msgid from the system and
30 destroy the message queue and data structure associated with it.
31 -m shmid
33 Remove the shared memory identifier shmid from the system. The
34 shared memory segment and data structure associated with it
35 shall be destroyed after the last detach.
36 -s semid
38 Remove the semaphore identifier semid from the system and
39 destroy the set of semaphores and data structure associated with
40 it.
41 -Q msgkey
43 Remove the message queue identifier, created with key msgkey,
44 from the system and destroy the message queue and data structure
45 associated with it.
46 -M shmkey
48 Remove the shared memory identifier, created with key shmkey,
49 from the system. The shared memory segment and data structure
50 associated with it shall be destroyed after the last detach.
51 -S semkey
53 Remove the semaphore identifier, created with key semkey, from
54 the system and destroy the set of semaphores and data structure
55 associated with it.
56
59 None.
60
62 Not used.
63
65 None.
66
68 The following environment variables shall affect the execution of
69 ipcrm:
70 LANG Provide a default value for the internationalization variables
72 that are unset or null. (See the Base Definitions volume of
73 IEEE Std 1003.1-2001, Section 8.2, Internationalization Vari‐
74 ables for the precedence of internationalization variables used
75 to determine the values of locale categories.)
76 LC_ALL If set to a non-empty string value, override the values of all
78 the other internationalization variables.
79 LC_CTYPE
81 Determine the locale for the interpretation of sequences of
82 bytes of text data as characters (for example, single-byte as
83 opposed to multi-byte characters in arguments).
84 LC_MESSAGES
86 Determine the locale that should be used to affect the format
87 and contents of diagnostic messages written to standard error.
88 NLSPATH
90 Determine the location of message catalogs for the processing of
91 LC_MESSAGES .
92
95 Default.
96
98 Not used.
99
101 The standard error shall be used only for diagnostic messages.
102
104 None.
105
107 None.
108
110 The following exit values shall be returned:
111 0 Successful completion.
113 >0 An error occurred.
115
118 Default.
119 The following sections are informative.
121
123 None.
124
126 None.
127
129 None.
130
132 None.
133
135 ipcs , the System Interfaces volume of IEEE Std 1003.1-2001, msgctl(),
136 semctl(), shmctl()
137
139 Portions of this text are reprinted and reproduced in electronic form
140 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
141 -- Portable Operating System Interface (POSIX), The Open Group Base
142 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
143 Electrical and Electronics Engineers, Inc and The Open Group. In the
144 event of any discrepancy between this version and the original IEEE and
145 The Open Group Standard, the original IEEE and The Open Group Standard
146 is the referee document. The original Standard can be obtained online
147 at http://www.opengroup.org/unix/online.html .
148IEEE/The Open Group 2003 IPCRM(P)