sys-utils/ipcs.1.adoc

   1 //po4a: entry man manual
   2 ////
   3 Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
   4 May be distributed under the GNU General Public License
   5 ////
   6 = ipcs(1)
   7 :doctype: manpage
   8 :man manual: User Commands
   9 :man source: util-linux {release-version}
  10 :page-layout: base
  11 :command: ipcs
  12
  13 == NAME
  14
  15 ipcs - show information on IPC facilities
  16
  17 == SYNOPSIS
  18
  19 *ipcs* [options]
  20
  21 == DESCRIPTION
  22
  23 *ipcs* shows information on System V inter-process communication facilities. By default it shows information about all three resources: shared memory segments, message queues, and semaphore arrays.
  24
  25 == OPTIONS
  26
  27 *-i*, *--id* _id_::
  28 Show full details on just the one resource element identified by _id_. This option needs to be combined with one of the three resource options: *-m*, *-q* or *-s*.
  29
  30 include::man-common/help-version.adoc[]
  31
  32 === Resource options
  33
  34 *-m*, *--shmems*::
  35 Write information about active shared memory segments.
  36
  37 *-q*, *--queues*::
  38 Write information about active message queues.
  39
  40 *-s*, *--semaphores*::
  41 Write information about active semaphore sets.
  42
  43 *-a*, *--all*::
  44 Write information about all three resources (default).
  45
  46 === Output formats
  47
  48 Of these options only one takes effect: the last one specified.
  49
  50 *-c*, *--creator*::
  51 Show creator and owner.
  52
  53 *-l*, *--limits*::
  54 Show resource limits.
  55
  56 *-p*, *--pid*::
  57 Show PIDs of creator and last operator.
  58
  59 *-t*, *--time*::
  60 Write time information. The time of the last control operation that changed the access permissions for all facilities, the time of the last *msgsnd*(2) and *msgrcv*(2) operations on message queues, the time of the last *shmat*(2) and *shmdt*(2) operations on shared memory, and the time of the last *semop*(2) operation on semaphores.
  61
  62 *-u*, *--summary*::
  63 Show status summary.
  64
  65 === Representation
  66
  67 These affect only the *-l* (*--limits*) option.
  68
  69 *-b*, *--bytes*::
  70 include::man-common/in-bytes.adoc[]
  71
  72
  73 *--human*::
  74 Print sizes in human-readable format.
  75
  76 == CONFORMING TO
  77
  78 The Linux *ipcs* utility is not fully compatible to the POSIX *ipcs* utility. The Linux version does not support the POSIX *-a*, *-b* and *-o* options, but does support the *-l* and *-u* options not defined by POSIX. A portable application shall not use the *-a*, *-b*, *-o*, *-l*, and *-u* options.
  79
  80 == NOTES
  81
  82 The current implementation of *ipcs* obtains information about available IPC resources by parsing the files in _/proc/sysvipc_. Before util-linux version v2.23, an alternate mechanism was used: the *IPC_STAT* command of *msgctl*(2), *semctl*(2), and *shmctl*(2). This mechanism is also used in later util-linux versions in the case where _/proc_ is unavailable. A limitation of the *IPC_STAT* mechanism is that it can only be used to retrieve information about IPC resources for which the user has read permission.
  83
  84 == AUTHORS
  85
  86 mailto:balasub@cis.ohio-state.edu[Krishna Balasubramanian]
  87
  88 == SEE ALSO
  89
  90 *ipcmk*(1),
  91 *ipcrm*(1),
  92 *msgrcv*(2),
  93 *msgsnd*(2),
  94 *semget*(2),
  95 *semop*(2),
  96 *shmat*(2),
  97 *shmdt*(2),
  98 *shmget*(2),
  99 *sysvipc*(7)
 100
 101 include::man-common/bugreports.adoc[]
 102
 103 include::man-common/footer.adoc[]
 104
 105 ifdef::translation[]
 106 include::man-common/translation.adoc[]
 107 endif::[]