share/man/man1/ipcrm.1

   1 '\" te
   2 .\" Copyright 1989 AT&T
   3 .\" Copyright (c) 2004, Sun Microsystems, Inc.  All Rights Reserved
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH IPCRM 1 "Jan 9, 2004"
   8 .SH NAME
   9 ipcrm \- remove a message queue, semaphore set, or shared memory ID
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBipcrm\fR [\fB-z\fR \fIzone\fR] [\fB-m\fR \fIshmid\fR] [\fB-q\fR \fImsqid\fR] [\fB-s\fR \fIsemid\fR]
  14      [\fB-M\fR \fIshmkey\fR] [\fB-Q\fR \fImsgkey\fR] [\fB-S\fR \fIsemkey\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 \fBipcrm\fR removes one or more messages, semaphores, or shared memory
  21 identifiers.
  22 .SH OPTIONS
  23 .sp
  24 .LP
  25 The following option is supported:
  26 .sp
  27 .ne 2
  28 .na
  29 \fB\fB-z\fR \fIzone\fR\fR
  30 .ad
  31 .RS 11n
  32 Keys specified by other options refer to facilities in the specified zone (see
  33 \fBzones\fR(5)). The default is the zone in which the command is executing.
  34 This option is only useful when the command is executed in the global zone.
  35 .RE
  36
  37 .sp
  38 .LP
  39 The identifiers are specified by the following options:
  40 .sp
  41 .ne 2
  42 .na
  43 \fB\fB-m\fR \fIshmid\fR\fR
  44 .ad
  45 .RS 13n
  46 Removes the shared memory identifier \fIshmid\fR from the system. The shared
  47 memory segment and data structure associated with it are destroyed after the
  48 last detach.
  49 .RE
  50
  51 .sp
  52 .ne 2
  53 .na
  54 \fB\fB-q\fR \fImsqid\fR\fR
  55 .ad
  56 .RS 13n
  57 Removes the message queue identifier \fImsqid\fR from the system and destroys
  58 the message queue and data structure associated with it.
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fB-s\fR \fIsemid\fR\fR
  65 .ad
  66 .RS 13n
  67 Removes the semaphore identifier \fIsemid\fR from the system and destroys the
  68 set of semaphores and data structure associated with it.
  69 .RE
  70
  71 .sp
  72 .ne 2
  73 .na
  74 \fB\fB-M\fR \fIshmkey\fR\fR
  75 .ad
  76 .RS 13n
  77 Removes the shared memory identifier, created with key \fIshmkey\fR, from the
  78 system. The shared memory segment and data structure associated with it are
  79 destroyed after the last detach.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fB-Q\fR \fImsgkey\fR\fR
  86 .ad
  87 .RS 13n
  88 Removes the message queue identifier, created with key \fImsgkey\fR, from the
  89 system and destroys the message queue and data structure associated with it.
  90 .RE
  91
  92 .sp
  93 .ne 2
  94 .na
  95 \fB\fB-S\fR \fIsemkey\fR\fR
  96 .ad
  97 .RS 13n
  98 Removes the semaphore identifier, created with key \fIsemkey\fR, from the
  99 system and destroys the set of semaphores and data structure associated with
 100 it.
 101 .RE
 102
 103 .sp
 104 .LP
 105 The details of the removes are described in \fBmsgctl\fR(2), \fBshmctl\fR(2),
 106 and \fBsemctl\fR(2). Use the \fBipcs\fR command to find the identifiers and
 107 keys.
 108 .SH ENVIRONMENT VARIABLES
 109 .sp
 110 .LP
 111 See  \fBenviron\fR(5) for descriptions of the following environment variables
 112 that affect the execution of  \fBipcrm\fR: \fBLANG\fR, \fBLC_ALL\fR,
 113 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 114 .SH ATTRIBUTES
 115 .sp
 116 .LP
 117 See \fBattributes\fR(5) for descriptions of the following attributes:
 118 .sp
 119
 120 .sp
 121 .TS
 122 box;
 123 c | c
 124 l | l .
 125 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 126 _
 127 Interface Stability     Standard
 128 .TE
 129
 130 .SH SEE ALSO
 131 .sp
 132 .LP
 133 \fBipcs\fR(1), \fBmsgctl\fR(2), \fBmsgget\fR(2), \fBmsgrcv\fR(2),
 134 \fBmsgsnd\fR(2), \fBsemctl\fR(2), \fBsemget\fR(2), \fBsemop\fR(2),
 135 \fBshmctl\fR(2), \fBshmget\fR(2), \fBshmop\fR(2), \fBattributes\fR(5),
 136 \fBenviron\fR(5), \fBstandards\fR(5), \fBzones\fR(5)