sys-utils/lsipc.1

   1 .\" Copyright 2015 Ondrej Oprala(ooprala@redhat.com)
   2 .\" May be distributed under the GNU General Public License
   3 .TH LSIPC "1" "November 2015" "util-linux" "User Commands"
   4 .SH NAME
   5 lsipc \- show information on IPC facilities currently employed in the system
   6 .SH SYNOPSIS
   7 .B lsipc
   8 [options]
   9 .SH DESCRIPTION
  10 .B lsipc
  11 shows information on the inter-process communication facilities
  12 for which the calling process has read access.
  13 .SH OPTIONS
  14 .TP
  15 \fB\-i\fR, \fB\-\-id\fR \fIid\fR
  16 Show full details on just the one resource element identified by
  17 .IR id .
  18 This option needs to be combined with one of the three resource options:
  19 .BR \-m ,
  20 .BR \-q " or"
  21 .BR \-s .
  22 It is possible to override the default output format for this option with the
  23 \fB\-\-list\fR, \fB\-\-raw\fR, \fB\-\-json\fR or \fB\-\-export\fR option.
  24 .TP
  25 \fB\-g\fR, \fB\-\-global\fR
  26 Show system-wide usage and limits of IPC resources.
  27 This option may be combined with one of the three resource options:
  28 .BR \-m ,
  29 .BR \-q " or"
  30 .BR \-s .
  31 The default is to show information about all resources.
  32 .TP
  33 \fB\-h\fR, \fB\-\-help\fR
  34 Display help text and exit.
  35 .TP
  36 \fB\-V\fR, \fB\-\-version\fR
  37 Display version information and exit.
  38 .SS "Resource options"
  39 .TP
  40 \fB\-m\fR, \fB\-\-shmems\fR
  41 Write information about active shared memory segments.
  42 .TP
  43 \fB\-q\fR, \fB\-\-queues\fR
  44 Write information about active message queues.
  45 .TP
  46 \fB\-s\fR, \fB\-\-semaphores\fR
  47 Write information about active semaphore sets.
  48 .SS "Output formatting"
  49 .TP
  50 \fB\-c\fR, \fB\-\-creator\fR
  51 Show creator and owner.
  52 .TP
  53 \fB\-e\fR, \fB\-\-export\fR
  54 Output data in the format of NAME=VALUE.
  55 .TP
  56 \fB\-J\fR, \fB\-\-json\fR
  57 Use the JSON output format.
  58 .TP
  59 \fB\-l\fR, \fB\-\-list\fR
  60 Use the list output format.  This is the default, except when \fB\-\-id\fR
  61 is used.
  62 .TP
  63 \fB\-n\fR, \fB\-\-newline\fR
  64 Display each piece of information on a separate line.
  65 .TP
  66 \fB\-\-noheadings\fR
  67 Do not print a header line.
  68 .TP
  69 \fB\-\-notruncate\fR
  70 Don't truncate output.
  71 .TP
  72 \fB\-o\fR, \fB\-\-output \fIlist\fP
  73 Specify which output columns to print.  Use
  74 .B \-\-help
  75 to get a list of all supported columns.
  76 .TP
  77 \fB\-b\fR, \fB\-\-bytes\fR
  78 Print size in bytes rather than in human readable format.
  79 .TP
  80 \fB\-r\fR, \fB\-\-raw\fR
  81 Raw output (no columnation).
  82 .TP
  83 \fB\-t\fR, \fB\-\-time\fR
  84 Write time information.  The time of the last control operation that changed
  85 the access permissions for all facilities, the time of the last
  86 .BR msgsnd (2)
  87 and
  88 .BR msgrcv (2)
  89 operations on message queues, the time of the last
  90 .BR shmat (2)
  91 and
  92 .BR shmdt (2)
  93 operations on shared memory, and the time of the last
  94 .BR semop (2)
  95 operation on semaphores.
  96 .TP
  97 \fB\-\-time\-format\fR \fItype\fP
  98 Display dates in short, full or iso format.  The default is short, this time
  99 format is designed to be space efficient and human readable.
 100 .TP
 101 \fB\-P\fR, \fB\-\-numeric\-perms\fR
 102 Print numeric permissions in PERMS column.
 103
 104 .SH EXIT STATUS
 105 .TP
 106 0
 107 if OK,
 108 .TP
 109 1
 110 if incorrect arguments specified,
 111 .TP
 112 2
 113 if a serious error occurs.
 114 .SH HISTORY
 115 The \fBlsipc\fP utility is inspired by the \fBipcs\fP utility.
 116 .SH AUTHORS
 117 .MT ooprala@redhat.com
 118 Ondrej Oprala
 119 .ME
 120 .br
 121 .MT kzak@redhat.com
 122 Karel Zak
 123 .ME
 124
 125 .SH SEE ALSO
 126 .BR ipcmk (1),
 127 .BR ipcrm (1),
 128 .BR msgrcv (2),
 129 .BR msgsnd (2),
 130 .BR semget (2),
 131 .BR semop (2),
 132 .BR shmat (2),
 133 .BR shmdt (2),
 134 .BR shmget (2),
 135 .BR sysvipc (7)
 136 .SH AVAILABILITY
 137 The lsipc command is part of the util-linux package and is available from
 138 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
 139 Linux Kernel Archive
 140 .UE .