xref: /openbsd-src/usr.bin/ipcrm/ipcrm.1 (revision 49901277148c8c417470e0c914cdf22624441888)
1*49901277Sschwarze.\" $OpenBSD: ipcrm.1,v 1.17 2015/09/09 21:23:31 schwarze Exp $
22e394382Saaron.\"
3df930be7Sderaadt.\" Copyright (c) 1994 Adam Glass
4df930be7Sderaadt.\" All rights reserved.
5df930be7Sderaadt.\"
6df930be7Sderaadt.\" Redistribution and use in source and binary forms, with or without
7df930be7Sderaadt.\" modification, are permitted provided that the following conditions
8df930be7Sderaadt.\" are met:
9df930be7Sderaadt.\" 1. Redistributions of source code must retain the above copyright
10df930be7Sderaadt.\"    notice, this list of conditions and the following disclaimer.
11df930be7Sderaadt.\" 2. The name of the Author may not be used to endorse or promote products
12df930be7Sderaadt.\"    derived from this software without specific prior written permission.
13df930be7Sderaadt.\"
14df930be7Sderaadt.\" THIS SOFTWARE IS PROVIDED BY Adam Glass ``AS IS'' AND
15df930be7Sderaadt.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16df930be7Sderaadt.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17df930be7Sderaadt.\" ARE DISCLAIMED.  IN NO EVENT SHALL Adam Glass BE LIABLE
18df930be7Sderaadt.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19df930be7Sderaadt.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20df930be7Sderaadt.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21df930be7Sderaadt.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22df930be7Sderaadt.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23df930be7Sderaadt.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24df930be7Sderaadt.\" SUCH DAMAGE.
25df930be7Sderaadt.\"
26df930be7Sderaadt.\""
27*49901277Sschwarze.Dd $Mdocdate: September 9 2015 $
28aea1524aSaaron.Dt IPCRM 1
29df930be7Sderaadt.Os
30df930be7Sderaadt.Sh NAME
31df930be7Sderaadt.Nm ipcrm
32*49901277Sschwarze.Nd remove the specified message queues, semaphore sets, and shared \
332bd702dbSjmcmemory segments
34df930be7Sderaadt.Sh SYNOPSIS
35df930be7Sderaadt.Nm ipcrm
3643b84c5aSjmc.Bk -words
37df930be7Sderaadt.Op Fl M Ar shmkey
383a1a7bb1Sjmc.Op Fl m Ar shmid
393a1a7bb1Sjmc.Op Fl Q Ar msgkey
403a1a7bb1Sjmc.Op Fl q Ar msqid
41df930be7Sderaadt.Op Fl S Ar semkey
423a1a7bb1Sjmc.Op Fl s Ar semid
43df930be7Sderaadt.Ar ...
4443b84c5aSjmc.Ek
45df930be7Sderaadt.Sh DESCRIPTION
46581190f2Saaron.Nm
473a1a7bb1Sjmcremoves the specified message queues, semaphores, and shared memory
482e394382Saaronsegments.
492e394382SaaronThese System V IPC objects can be specified by their
50aea1524aSaaroncreation ID or any associated key.
51df930be7Sderaadt.Pp
522e394382SaaronThe options are as follows:
53f1ba3473Saaron.Bl -tag -width Ds
54df930be7Sderaadt.It Fl M Ar shmkey
55df930be7SderaadtMark the shared memory segment associated with key
56df930be7Sderaadt.Nm shmkey
57df930be7Sderaadtfor removal.
58df930be7SderaadtThis marked segment will be destroyed after the last detach.
593a1a7bb1Sjmc.It Fl m Ar shmid
603a1a7bb1SjmcMark the shared memory segment associated with ID
613a1a7bb1Sjmc.Nm shmid
623a1a7bb1Sjmcfor removal.
633a1a7bb1SjmcThis marked segment will be destroyed after the last detach.
643a1a7bb1Sjmc.It Fl Q Ar msgkey
653a1a7bb1SjmcRemove the message queue associated with key
663a1a7bb1Sjmc.Nm msgkey
673a1a7bb1Sjmcfrom the system.
683a1a7bb1Sjmc.It Fl q Ar msqid
693a1a7bb1SjmcRemove the message queue associated with the ID
703a1a7bb1Sjmc.Nm msqid
713a1a7bb1Sjmcfrom the system.
72df930be7Sderaadt.It Fl S Ar semkey
73df930be7SderaadtRemove the semaphore set associated with key
74df930be7Sderaadt.Nm semkey
75df930be7Sderaadtfrom the system.
763a1a7bb1Sjmc.It Fl s Ar semid
773a1a7bb1SjmcRemoves the semaphore set associated with ID
783a1a7bb1Sjmc.Nm semid
793a1a7bb1Sjmcfrom the system.
80df930be7Sderaadt.El
81df930be7Sderaadt.Pp
82df930be7SderaadtThe identifiers and keys associated with these System V IPC objects can be
83df930be7Sderaadtdetermined by using
84aea1524aSaaron.Xr ipcs 1 .
85f1c64ac4Sjmc.Sh EXIT STATUS
8611fbf7b0Sjmc.Ex -std ipcrm
87df930be7Sderaadt.Sh SEE ALSO
88df930be7Sderaadt.Xr ipcs 1
8984d757f3Sjmc.Sh STANDARDS
9084d757f3SjmcThe
9184d757f3Sjmc.Nm
9284d757f3Sjmcutility is compliant with the
93f47b231cSjmcX/Open System Interfaces option of the
94f47b231cSjmc.St -p1003.1-2008
9584d757f3Sjmcspecification.
96