sys-utils/ipcs.1

   1 .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
   2 .\" May be distributed under the GNU General Public License
   3 .TH IPCS "1" "January 2013" "util-linux" "User Commands"
   4 .SH NAME
   5 ipcs \- provide information on IPC facilities
   6 .SH SYNOPSIS
   7 .B ipcs
   8 .RB [ resource\-option "] [" output\-format ]
   9 .br
  10 .B ipcs
  11 .RB [ resource\-option ]
  12 .BI \-i " id"
  13 .SH DESCRIPTION
  14 .B ipcs
  15 provides information on the inter-process communication facilities
  16 for which the calling process has read access.
  17 .SH OPTIONS
  18 .TP
  19 \fB\-i\fR, \fB\-\-id\fR \fIid\fR
  20 Print details only on the resource identified by
  21 .IR id .
  22 .TP
  23 \fB\-h\fR, \fB\-\-help\fR
  24 Display a help text and exit.
  25 .TP
  26 \fB\-V\fR, \fB\-\-version\fR
  27 Display version information and exit.
  28 .SS "Resource options"
  29 .TP
  30 \fB\-q\fR, \fB\-\-queues\fR
  31 Write information about active message queues.
  32 .TP
  33 \fB\-m\fR, \fB\-\-shmems\fR
  34 Write information about active shared memory segments.
  35 .TP
  36 \fB\-s\fR, \fB\-\-semaphores\fR
  37 Write information about active semaphore sets.
  38 .TP
  39 \fB\-a\fR, \fB\-\-all\fR
  40 Write information about all three resources (default).
  41 .SS "Output formats"
  42 Of these options only one takes effect: the last one specified.
  43 .TP
  44 \fB\-c\fR, \fB\-\-creator\fR
  45 Show creator and owner.
  46 .TP
  47 \fB\-l\fR, \fB\-\-limits\fR
  48 Show resource limits.
  49 .TP
  50 \fB\-p\fR, \fB\-\-pid\fR
  51 Show PIDs of creator and last operator.
  52 .TP
  53 \fB\-t\fR, \fB\-\-time\fR
  54 Write time information.  The time of the last control operation that changed
  55 the access permissions for all facilities, the time of the last
  56 .I msgsnd()
  57 and
  58 .I msgrcv()
  59 operations on message queues, the time of the last
  60 .I shmat()
  61 and
  62 .I shmdt()
  63 operations on shared memory, and the time of the last
  64 .I semop()
  65 operation on semaphores.
  66 .TP
  67 \fB\-u\fR, \fB\-\-summary\fR
  68 Show status summary.
  69 .SS "Representation"
  70 These affect only the \fB\-l\fR (\fB\-\-limits\fR) option.
  71 .TP
  72 \fB\-b\fR, \fB\-\-bytes\fR
  73 Print sizes in bytes.
  74 .TP
  75 .B \-\-human
  76 Print sizes in human-readable format.
  77 .SH SEE ALSO
  78 .BR ipcrm (1),
  79 .BR ipcmk (1),
  80 .BR msgrcv (2),
  81 .BR msgsnd (2),
  82 .BR semget (2),
  83 .BR semop (2),
  84 .BR shmat (2),
  85 .BR shmdt (2),
  86 .BR shmget (2)
  87 .SH CONFORMING TO
  88 The Linux ipcs utility is not fully compatible to the POSIX ipcs utility.
  89 The Linux version does not support the POSIX
  90 .BR \-a ,
  91 .B \-b
  92 and
  93 .B \-o
  94 options, but does support the
  95 .B \-l
  96 and
  97 .B \-u
  98 options not defined by POSIX.  A portable application shall not use the
  99 .BR \-a ,
 100 .BR \-b ,
 101 .BR \-o ,
 102 .BR \-l ,
 103 and
 104 .B \-u
 105 options.
 106 .SH AUTHOR
 107 .UR balasub@cis.ohio-state.edu
 108 Krishna Balasubramanian
 109 .UE
 110 .SH AVAILABILITY
 111 The ipcs command is part of the util-linux package and is available from
 112 .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
 113 Linux Kernel Archive
 114 .UE .