1IPCRM(1P)                  POSIX Programmer's Manual                 IPCRM(1P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       ipcrm — remove an XSI message queue, semaphore set,  or  shared  memory
13       segment identifier
14

SYNOPSIS

16       ipcrm [-q msgid|-Q msgkey|-s semid|-S semkey|-m shmid|-M shmkey]...
17

DESCRIPTION

19       The  ipcrm  utility shall remove zero or more message queues, semaphore
20       sets, or shared memory segments. The interprocess communication facili‐
21       ties to be removed are specified by the options.
22
23       Only  a  user with appropriate privileges shall be allowed to remove an
24       interprocess communication facility that was not created by or owned by
25       the user invoking ipcrm.
26

OPTIONS

28       The  ipcrm  utility  shall  conform  to  the Base Definitions volume of
29       POSIX.1‐2017, Section 12.2, Utility Syntax Guidelines.
30
31       The following options shall be supported:
32
33       -q msgid  Remove the message queue identifier msgid from the system and
34                 destroy  the message queue and data structure associated with
35                 it.
36
37       -m shmid  Remove the shared memory identifier shmid  from  the  system.
38                 The  shared memory segment and data structure associated with
39                 it shall be destroyed after the last detach.
40
41       -s semid  Remove the semaphore identifier semid  from  the  system  and
42                 destroy  the  set of semaphores and data structure associated
43                 with it.
44
45       -Q msgkey Remove the message queue identifier, created with key msgkey,
46                 from the system and destroy the message queue and data struc‐
47                 ture associated with it.
48
49       -M shmkey Remove the shared memory identifier, created with key shmkey,
50                 from the system. The shared memory segment and data structure
51                 associated with it shall be destroyed after the last detach.
52
53       -S semkey Remove the semaphore identifier,  created  with  key  semkey,
54                 from  the  system  and destroy the set of semaphores and data
55                 structure associated with it.
56

OPERANDS

58       None.
59

STDIN

61       Not used.
62

INPUT FILES

64       None.
65

ENVIRONMENT VARIABLES

67       The following environment  variables  shall  affect  the  execution  of
68       ipcrm:
69
70       LANG      Provide  a  default  value for the internationalization vari‐
71                 ables that are unset or null. (See the Base Definitions  vol‐
72                 ume  of POSIX.1‐2017, Section 8.2, Internationalization Vari‐
73                 ables for the precedence  of  internationalization  variables
74                 used to determine the values of locale categories.)
75
76       LC_ALL    If  set  to  a non-empty string value, override the values of
77                 all the other internationalization variables.
78
79       LC_CTYPE  Determine the locale for the interpretation of  sequences  of
80                 bytes of text data as characters (for example, single-byte as
81                 opposed to multi-byte characters in arguments).
82
83       LC_MESSAGES
84                 Determine the locale that should be used to affect the format
85                 and  contents  of  diagnostic  messages  written  to standard
86                 error.
87
88       NLSPATH   Determine the location of message catalogs for the processing
89                 of LC_MESSAGES.
90

ASYNCHRONOUS EVENTS

92       Default.
93

STDOUT

95       Not used.
96

STDERR

98       The standard error shall be used only for diagnostic messages.
99

OUTPUT FILES

101       None.
102

EXTENDED DESCRIPTION

104       None.
105

EXIT STATUS

107       The following exit values shall be returned:
108
109        0    Successful completion.
110
111       >0    An error occurred.
112

CONSEQUENCES OF ERRORS

114       Default.
115
116       The following sections are informative.
117

APPLICATION USAGE

119       None.
120

EXAMPLES

122       None.
123

RATIONALE

125       None.
126

FUTURE DIRECTIONS

128       None.
129

SEE ALSO

131       ipcs
132
133       The  Base  Definitions  volume  of POSIX.1‐2017, Chapter 8, Environment
134       Variables, Section 12.2, Utility Syntax Guidelines
135
136       The System Interfaces volume of POSIX.1‐2017, msgctl(), semctl(),  shm‐
137       ctl()
138
140       Portions  of  this text are reprinted and reproduced in electronic form
141       from IEEE Std 1003.1-2017, Standard for Information Technology --  Por‐
142       table  Operating System Interface (POSIX), The Open Group Base Specifi‐
143       cations Issue 7, 2018 Edition, Copyright (C) 2018 by the  Institute  of
144       Electrical  and  Electronics Engineers, Inc and The Open Group.  In the
145       event of any discrepancy between this version and the original IEEE and
146       The  Open Group Standard, the original IEEE and The Open Group Standard
147       is the referee document. The original Standard can be  obtained  online
148       at http://www.opengroup.org/unix/online.html .
149
150       Any  typographical  or  formatting  errors that appear in this page are
151       most likely to have been introduced during the conversion of the source
152       files  to  man page format. To report such errors, see https://www.ker
153       nel.org/doc/man-pages/reporting_bugs.html .
154
155
156
157IEEE/The Open Group                  2017                            IPCRM(1P)
Impressum