Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
IPCRM(1)		  BSD General Commands Manual		      IPCRM(1)

NAME
     ipcrm -- remove the specified message queues, semaphore sets, and shared
     segments

SYNOPSIS
     ipcrm [-W]	[-v] [-q msqid]	[-m shmid] [-s semid] [-Q msgkey] [-M shmkey]
	   [-S semkey] ...

DESCRIPTION
     The ipcrm utility removes the specified message queues, semaphores	and
     shared memory segments.  These System V IPC objects can be	specified by
     their creation ID or any associated key.

     The following options are generic:

     -v	     If	specified once with -W or with -1 for an object, it will show
	     all removed objects.  If specified	twice with -W or with -1 for
	     an	objects, it will show all removed objects and all failed re-
	     movals.

     -W	     Try to wipe all specified message queues, semaphores and shared
	     memory segments.

     -y	     Use the kvm(3) interface instead of the sysctl(3) interface to
	     extract the required information.	If ipcrm is to operate on the
	     running system, using kvm(3) will require read privileges to
	     /dev/kmem.

     The following options are used to specify which IPC objects will be re-
     moved.  Any number	and combination	of these options can be	used:

     -q	msqid
	     Remove the	message	queue associated with the ID msqid from	the
	     system.

     -m	shmid
	     Mark the shared memory segment associated with ID shmid for re-
	     moval.  This marked segment will be destroyed after the last de-
	     tach.

     -s	semid
	     Remove the	semaphore set associated with ID semid from the	sys-
	     tem.

     -Q	msgkey
	     Remove the	message	queue associated with key msgkey from the sys-
	     tem.

     -M	shmkey
	     Mark the shared memory segment associated with key	shmkey for re-
	     moval.  This marked segment will be destroyed after the last de-
	     tach.

     -S	semkey
	     Remove the	semaphore set associated with key semkey from the sys-
	     tem.

     The identifiers and keys associated with these System V IPC objects can
     be	determined by using ipcs(1).  If the identifier	or the key is -1, it
     will remove all these objects.

SEE ALSO
     ipcs(1)

HISTORY
     The wiping	of all System V	IPC objects was	first implemented in
     FreeBSD 6.4 and 7.1.

AUTHORS
     The original author was Adam Glass.  The wiping of	all System V IPC ob-
     jects was thought up by
     Callum Gibson and extended	and implemented	by
     Edwin Groothuis.

BSD			       December	12, 2007			   BSD

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ipcrm&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help