ipcrm(1)                                                           ipcrm(1)

NAME
     ipcrm - remove interprocess communication facilities

SYNOPSIS
     ipcrm [option ...]

DESCRIPTION
     The command ipcrm can be used to remove one or more semaphores, mes-
     sage queues, shared memory segments, or interprocess communication
     facilities. These can be specified either by their identifiers or by
     the key with which each such IPC facility was created.

     The identifiers and keys of IPC facilities can be listed with the help
     of the ipcs command (ID and KEY columns).

     You will find detailed information on the removal of a message queue,
     a shared memory segment, or a semaphore in the Programmer's Reference
     Manual under the descriptions of msgctl(2), shmctl(2) and semctl(2),
     respectively.

OPTIONS
     -q msgqid
          Removes the message queue identified as msgqid from the system
          and destroys the data structures associated with it.

          msgqid
               Identifier of the message queue to be removed. This identif-
               ier is displayed by the ipcs command in the ID column.

     -Q msgkey
          Removes the message queue identifier msgkey from the system and
          destroys the data structures associated with it.

          msgkey
               Key of the message queue to be removed. This key is
               displayed by the ipcs command in the KEY column.

     -s semid
          Removes the semaphore identifier semid from the system and des-
          troys the data structures associated with it.

          semid
               Identifier of the semaphore set to be removed. This identif-
               ier is displayed by the ipcs command in the KID column.

     -S semkey
          Removes the semaphore set identified as semkey from the system
          and destroys the data structures associated with it.







Page 1                       Reliant UNIX 5.44                Printed 11/98

ipcrm(1)                                                           ipcrm(1)

          semkey
               Key of the semaphore set to be removed. This key is
               displayed by the ipcs command in the KEY column.

     -m shmid
          Removes the shared memory identifier shmid from the system and
          destroys the shared memory segment and data structures associated
          with it.

          shmid
               Identifier of the shared memory segment to be removed. This
               identifier is displayed by the ipcs command in the ID
               column.

     -M shmkey
          Removes the shared memory segment identified by shmkey from the
          system and destroys the data structures associated with it.

          shmkey
               Key of the shared memory segment to be removed. This key is
               displayed by the ipcs command in the KEY column.

EXAMPLES
     Using ipcs to produce a report on the status of the interprocess com-
     munication facilities and then removing the message queue with the
     identifier 40 from the system:

     $ ipcs
     Time is 248bc52b
     IPC status from /dev/kmem as of Tue Jun  6 13:35:55 1989
     T     ID     KEY        MODE       OWNER    GROUP
     Message Queues:
     q     40 0x0000004b -Rrw-rw-rw-  michael    qm234
     Semaphores:
     $ ipcrm -q 40

SEE ALSO
     ipcs(1), msgctl(2), msgget(2), msgop(2), semctl(2), semget(2),
     semop(2), shmctl(2), shmget(2), shmop(2).















Page 2                       Reliant UNIX 5.44                Printed 11/98