546 lines
18 KiB
HTML
546 lines
18 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content="HTML Tidy, see www.w3.org">
|
|
<meta http-equiv="Content-Type" content=
|
|
"text/html; charset=utf-8">
|
|
<title>ipcs - Report interprocess communication status</title>
|
|
<LINK rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</HEAD>
|
|
<body bgcolor="#FFFFFF">
|
|
<!-- Java sync-link -->
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
|
|
|
|
|
<h2>ipcs - Report interprocess communication status</h2>
|
|
|
|
|
|
<p><strong>Synopsis</strong></p>
|
|
|
|
<p><img src="delta.gif" alt="Start of change">
|
|
<strong>ipcs [-ETabcjmnopqstu]</strong>
|
|
<img src="deltaend.gif" alt="End of change"></p>
|
|
|
|
<p><strong>Description</strong></p>
|
|
|
|
<p>The <strong>ipcs</strong> utility reports information
|
|
about existing interprocess communication (IPC) entries on the system and
|
|
displays the output on standard output.
|
|
The <strong>ipcs</strong> utility is shipped with public authority
|
|
set to *EXCLUDE. The user must have *SERVICE
|
|
special authority to run <strong>ipcs</strong>.</p>
|
|
|
|
<p><strong>ipcs</strong> automatically reports some information
|
|
for all entries that match the IPC mechanism specified.
|
|
Additional information is reported based on the specified options.</p>
|
|
|
|
<p>If no IPC mechanism is specified, all five mechanisms are
|
|
reported. An IPC mechanism is specified by using the <strong>-m</strong> option
|
|
for shared memory, <strong>-n</strong> option of named semaphores,
|
|
<strong>-s</strong> option for semaphores sets, <strong>-q</strong> option
|
|
for message queues, or <strong>-u</strong> option for unnamed sempahores.</p>
|
|
|
|
<p>The following information is reported for every shared memory, semaphore
|
|
set, and message queue entry:</p>
|
|
<ul>
|
|
<li>The type of the mechanism (column T).</li>
|
|
<li>The id of the entry in decimal form (column ID).</li>
|
|
<li>The key of the entry in hexadecimal form (column KEY).</li>
|
|
<li>The entry's access modes and flags (column MODE).</li>
|
|
<li>The user profile of the owner of the entry (column OWNER).</li>
|
|
<li>The group profile of the owner of the entry (column GROUP).</li>
|
|
</ul>
|
|
|
|
|
|
<p>The following information is reported for every named semaphore entry:</p>
|
|
<ul>
|
|
<li>The type of the mechanism (column T).</li>
|
|
<li>The title for the semaphore (column TITLE).</li>
|
|
<li>The entry's access modes and flags (column MODE).</li>
|
|
</ul>
|
|
|
|
|
|
<p>The following information is reported for every unnamed semaphore entry:</p>
|
|
<ul>
|
|
<li>The type of the mechanism (column T).</li>
|
|
<li>The title for the semaphore (column TITLE).</li>
|
|
</ul>
|
|
|
|
|
|
<p><strong>Warning:</strong> Running <strong>ipcs</strong> locks system-scoped resources
|
|
that can affect the performance of other IPC operations.</p>
|
|
|
|
<p><strong>Options</strong></p>
|
|
|
|
<p>The following options are used to select the IPC mechanism to report on.</p>
|
|
|
|
<dl>
|
|
<dt><strong>-m</strong></dt>
|
|
|
|
<dd>Show the shared memory entries on the system.</dd>
|
|
|
|
<dt><strong>-n</strong></dt>
|
|
|
|
<dd>Show the named semaphore entries on the system.</dd>
|
|
|
|
<dt><strong>-q</strong></dt>
|
|
|
|
<dd>Show the message queue entries on the system.</dd>
|
|
|
|
<dt><strong>-s</strong></dt>
|
|
|
|
<dd>Show the semaphore set entries on the system.</dd>
|
|
|
|
<dt><strong>-u</strong></dt>
|
|
|
|
<dd>Show the unnamed semaphore entries on the system.</dd>
|
|
|
|
</dl>
|
|
|
|
<p>The following options select the additional information that
|
|
is reported for the IPC mechanism.</p>
|
|
|
|
<dl>
|
|
<dt><strong>-a</strong></dt>
|
|
|
|
<dd>Report all information as if the <strong>-b</strong>, <strong>-c</strong>,
|
|
<strong>-o</strong>, <strong>-p</strong>, and <strong>-t</strong> options were specified.</dd>
|
|
|
|
<dt><strong>-b</strong></dt>
|
|
<dd>Display the maximum allowable size. If message queues are specified,
|
|
the report includes the QBYTES column. If shared memory is specified,
|
|
the report includes the SEGSZ column. If semaphore sets are specified,
|
|
the report includes the NSEMS column. If named semaphores or unnamed
|
|
semaphores are specified, the report includes the VALUE and NWAITERS columns.</dd>
|
|
|
|
<dt><strong>-c</strong></dt>
|
|
|
|
<dd>Display the user profile and group profile of the creator of the entry.
|
|
For all mechanisms, the report includes the CREATOR and CGROUP columns.</dd>
|
|
|
|
<dt><strong>-E</strong></dt>
|
|
|
|
<dd>Display extended information. If message queues are specified,
|
|
the report includes the WPID, WTID, MSGTYPE, and SIZE columns. If shared memory is specified, the report includes the APID and NUMATT columns. If semaphore sets are specified, the report includes the SEMNUM, SEMVAL, LOPID, WAITZ, WAITP, and WAITVAL columns. If named
|
|
semaphores are specified, the report includes the NAME, LPOST, LWAIT,
|
|
WAITER, JOB, and THREAD columns. If unnamed semaphores are specified,
|
|
the report includes the LPOST, LWAIT, WAITER, JOB, and THREAD columns.
|
|
|
|
<p>Since this level of detail is not available on other
|
|
systems, this option is kept separate from the <strong>-a</strong> option.
|
|
When this option is specified, at least one row is added
|
|
for each entry.</p>
|
|
</dd>
|
|
|
|
<dt><img src="delta.gif" alt="Start of change"><strong>-j</strong></dt>
|
|
<dd>Display the qualified job name instead of the process ID when the
|
|
<strong>-E</strong> option is also specified. If message queues are
|
|
specified, the report includes the WJOBID column instead of WPID. If
|
|
shared memory is specifed, the report includes the AJOBID column instead
|
|
of APID. If semaphore sets are specified, the report includes the
|
|
LOJOBID column instead of LOPID, the WAITZJID column instead of WAITZ,
|
|
and the WAITPJID column instead of WAITP.
|
|
<img src="deltaend.gif" alt="End of change"></dd>
|
|
|
|
<dt><strong>-o</strong></dt>
|
|
|
|
<dd>Display information about outstanding usage. If message queues are specified,
|
|
the report includes the CBYTES and QNUM columns. If shared memory is specified,
|
|
the report includes the NATTCH column.</dd>
|
|
|
|
<dt><strong>-p</strong></dt>
|
|
|
|
<dd>Display process ID information. If message queues are specified,
|
|
the report includes the LSPID and LRPID columns. If shared memory is specified,
|
|
the report includes the CPID and LPID columns.</dd>
|
|
|
|
<dt><strong>-t</strong></dt>
|
|
|
|
<dd>Display time information. If message queues are specified,
|
|
the report includes the CTIME, RTIME, and STIME columns. If shared
|
|
memory is specified, the report includes the CTIME, ATIME, and DTIME
|
|
columns. If semaphore sets are specified, the report includes the
|
|
CTIME and OTIME columns.</dd>
|
|
|
|
<dt><strong>-T</strong></dt>
|
|
|
|
<dd>
|
|
Display thread information. If message queues are specified, the report
|
|
includes the LSTID and LRTID columns. If shared memory is specified,
|
|
the report includes the CTID and LTID columns.
|
|
If semaphore sets are specified and the
|
|
<strong>-E</strong> option is specified, the report includes the
|
|
LOTID, WAITZTID, and WAITPTID columns.
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
<p><strong>Operands</strong></p>
|
|
|
|
<p>There are no operands.</p>
|
|
|
|
<p><strong>Extended Description</strong></p>
|
|
|
|
<p>Listed below are descriptions for all of the columns that can be
|
|
reported in the output. After the column name, the options that display
|
|
the column are shown. A value of "default"
|
|
means that the column is always displayed, no matter
|
|
what option is specified.</p>
|
|
|
|
<dl>
|
|
|
|
<dt><img src="delta.gif" alt="Start of change"><strong>AJOBID</strong> (-Ej)</dt>
|
|
|
|
<dd>The qualified job name of the jobs attached to the
|
|
shared memory segment.<img src="deltaend.gif" alt="End of change"></dd>
|
|
|
|
<dt><strong>ATIME</strong> (-t, -a)</dt>
|
|
|
|
<dd>The last time a job attached to the shared
|
|
memory segment.</dd>
|
|
|
|
<dt><strong>APID</strong> (-E)</dt>
|
|
|
|
<dd>The process ID of the job or jobs attached to the
|
|
shared memory segment.</dd>
|
|
|
|
<dt><strong>CBYTES</strong> (-o, -a)</dt>
|
|
|
|
<dd>The total number of bytes in the messages
|
|
currently on the message queue.</dd>
|
|
|
|
<dt><strong>CGROUP</strong> (-c, -a)</dt>
|
|
|
|
<dd>The group profile of the creator of the entry.</dd>
|
|
|
|
<dt><strong>CPID</strong> (-p, -a)</dt>
|
|
|
|
<dd>The process ID of the job that created the
|
|
shared memory segment.</dd>
|
|
|
|
<dt><strong>CTID</strong> (-T)</dt>
|
|
|
|
<dd>The thread ID of the thread that created the
|
|
shared memory segment.</dd>
|
|
|
|
<dt><strong>CREATOR</strong> (-c, -a)</dt>
|
|
|
|
<dd>The user profile of the creator of the entry.</dd>
|
|
|
|
<dt><strong>CTIME</strong> (-t, -a)</dt>
|
|
|
|
<dd>The last time the entry was either created or
|
|
the owner or permissions, or both, were changed.</dd>
|
|
|
|
<dt><strong>DTIME</strong> (-t, -a)</dt>
|
|
|
|
<dd>The last time a job detached from the
|
|
shared memory segment.</dd>
|
|
|
|
<dt><strong>GROUP</strong> (default)</dt>
|
|
|
|
<dd>The group profile of the owner of the entry.</dd>
|
|
|
|
<dt><strong>ID</strong> (default)</dt>
|
|
|
|
<dd>The id of the entry in decimal.</dd>
|
|
|
|
<dt><strong>JOB</strong> (-E)</dt>
|
|
|
|
<dd>The fully-qualified job name of the job waiting on the named semaphore
|
|
or unnamed semaphore.</dd>
|
|
|
|
<dt><strong>KEY</strong> (default)</dt>
|
|
|
|
<dd>The key of the entry in hexadecimal.</dd>
|
|
|
|
<dt><img src="delta.gif" alt="Start of change"><strong>LOJOBID</strong> (-Ej)</dt>
|
|
|
|
<dd>The qualified job name of the last job to change the value of the semaphore
|
|
using semop().<img src="deltaend.gif" alt="End of change"></dd>
|
|
|
|
<dt><strong>LOPID</strong> (-E)</dt>
|
|
|
|
<dd>The process ID of the last job to change the value of the semaphore
|
|
using semop().</dd>
|
|
|
|
<dt><strong>LOTID</strong> (-TE)</dt>
|
|
|
|
<dd>The thread ID of the last thread to change the value of the
|
|
semaphore using semop().</dd>
|
|
|
|
<dt><strong>LPID</strong> (-p, -a)</dt>
|
|
|
|
<dd>The process ID of the last job to attach
|
|
or detach from the shared memory segment or change the semaphore value.</dd>
|
|
|
|
<dt><strong>LPOST</strong> (-E)</dt>
|
|
|
|
<dd>The fully-qualified job name and thread id of the last thread to
|
|
post the named semaphore or unnamed semaphore.</dd>
|
|
|
|
<dt><strong>LRPID</strong> (-p, -a)</dt>
|
|
|
|
<dd>The process ID of the last job to receive a message from the message
|
|
queue using msgrcv().</dd>
|
|
|
|
<dt><strong>LRTID</strong> (-T)</dt>
|
|
|
|
<dd>The thread ID of the last thread to receive a message from the message
|
|
queue using msgrcv().</dd>
|
|
|
|
<dt><strong>LSPID</strong> (-p, -a)</dt>
|
|
|
|
<dd>The process ID of the last job to send a message to the message
|
|
queue using msgsnd().</dd>
|
|
|
|
<dt><strong>LSTID</strong> (-T)</dt>
|
|
|
|
<dd>The thread ID of the last thread to send a message to the message
|
|
queue using msgsnd().</dd>
|
|
|
|
<dt><strong>LTID</strong> (-T)</dt>
|
|
|
|
<dd>The thread ID of the last thread to attach or detach from the shared memory
|
|
segment.</dd>
|
|
|
|
<dt><strong>LWAIT</strong> (-E)</dt>
|
|
|
|
<dd>The fully-qualified job name and thread id of the last thread to
|
|
wait for the named semaphore or unnamed semaphore.</dd>
|
|
|
|
<dt><strong>MODE</strong> (default)</dt>
|
|
|
|
<dd>An 11 character field that provides information
|
|
about the state and permissions of the entry.
|
|
|
|
<p>The first character can be one of the following:</p>
|
|
<dl>
|
|
<dt><strong>D</strong></dt>
|
|
<dd>The entry has sustained damage, and no
|
|
operations can be performed on it.
|
|
The entry should only be marked damaged if
|
|
an internal error has occurred.</dd>
|
|
<dt><strong>T</strong></dt>
|
|
<dd>The entry is a shared memory segment and
|
|
the segment uses teraspace storage.</dd>
|
|
<dt><strong>Y</strong></dt>
|
|
<dd>The entry is a shared memory segment and
|
|
the segment uses teraspace storage and the entry
|
|
has sustained damage.</dd>
|
|
<dt><strong>-</strong>
|
|
<dd>None of the above applies.</dd>
|
|
</dl>
|
|
|
|
|
|
<p>
|
|
The second character can be one of the
|
|
following:</p>
|
|
|
|
<dl>
|
|
<dt><strong>R</strong></dt>
|
|
<dd>The entry is a message queue and a
|
|
thread is waiting on a call to msgrcv().</dd>
|
|
<dt><strong>S</strong></dt>
|
|
<dd>The entry is a message queue and a
|
|
thread is waiting on a call to msgsnd().</dd>
|
|
<dt><strong>D</strong></dt>
|
|
<dd>The entry is a shared memory segment
|
|
and the shared memory segment is marked to
|
|
be removed when all the jobs
|
|
detach from the shared memory.</dd>
|
|
<dt><strong>-</strong></dt>
|
|
<dd>None of the above applies.</dd>
|
|
</dl>
|
|
|
|
|
|
<p>The next nine characters are interpreted as
|
|
three sets of three permissions each. The first set
|
|
refers to the owner's permissions, the second set
|
|
to group's permissions, and
|
|
the third set to other's permissions. Within each set, the
|
|
first character indicates permission to read,
|
|
the second character indicates permission to
|
|
write, and the last character is
|
|
currently unused.</p>
|
|
|
|
<p>The permissions are indicated as follows:</p>
|
|
|
|
<dl>
|
|
<dt><strong>r</strong></dt>
|
|
<dd>If read permission is granted.</dd>
|
|
<dt><strong>w</strong></dt>
|
|
<dd>If write permission is granted.</dd>
|
|
<dt><strong>-</strong></dt>
|
|
<dd>If the indicated permission is not granted.</dd>
|
|
</dl>
|
|
</dd>
|
|
|
|
|
|
<dt><strong>MSGTYPE</strong> (-E)</dt>
|
|
|
|
<dd>The type of the messages that are currently on
|
|
the message queue.</dd>
|
|
|
|
<dt><strong>NAME</strong> (-E)</dt>
|
|
|
|
<dd>The path name of the named semaphore.</dd>
|
|
|
|
<dt><strong>NATTCH</strong> (-o, -a)</dt>
|
|
|
|
<dd>The current number of attaches to the shared
|
|
memory segment.</dd>
|
|
|
|
<dt><strong>NUMATT</strong> (-E)</dt>
|
|
|
|
<dd>The number of times the job is attached to the
|
|
shared memory segment.</dd>
|
|
|
|
<dt><strong>NSEMS</strong> (-b, -a)</dt>
|
|
|
|
<dd>The number of semaphores in the semaphore set.</dd>
|
|
|
|
<dt><strong>NWAITERS</strong> (-b, -a)</dt>
|
|
|
|
<dd>The number of threads waiting on the named semaphore or
|
|
unnamed semaphore.</dd>
|
|
|
|
<dt><strong>OTIME</strong> (-t, -a)</dt>
|
|
|
|
<dd>The last time that semop() was called using
|
|
the semaphore set.</dd>
|
|
|
|
<dt><strong>OWNER</strong> (default)</dt>
|
|
|
|
<dd>The user profile of the owner of the entry.</dd>
|
|
|
|
<dt><strong>QBYTES</strong> (-b, -a)</dt>
|
|
|
|
<dd>The maximum number of bytes allowed on the
|
|
message queue.</dd>
|
|
|
|
<dt><strong>QNUM</strong> (-o, -a)</dt>
|
|
|
|
<dd>The number of messages currently on the message
|
|
queue.</dd>
|
|
|
|
<dt><strong>RTIME</strong> (-t, -a)</dt>
|
|
|
|
<dd>The last time a msgrcv() was called using the message queue.</dd>
|
|
|
|
<dt><strong>SEGSZ</strong> (-b, -a)</dt>
|
|
|
|
<dd>The size of the shared memory segment.</dd>
|
|
|
|
<dt><strong>SEMNUM</strong> (-E)</dt>
|
|
|
|
<dd>The semaphore number in the semaphore set.</dd>
|
|
|
|
<dt><strong>SEMVAL</strong> (-E)</dt>
|
|
|
|
<dd>The value of the semaphore.</dd>
|
|
|
|
<dt><strong>SIZE</strong> (-E)</dt>
|
|
|
|
<dd>The size of the message on the message queue.</dd>
|
|
|
|
<dt><strong>STIME</strong> (-t, -a)</dt>
|
|
|
|
<dd>The last time a msgsnd() was called using the message queue.</dd>
|
|
|
|
<dt><strong>T</strong> (default)</dt>
|
|
|
|
<dd>The entry type. The value is M for a shared memory segment, N for a
|
|
named semaphore, Q for a message queue, S for a semaphore set, or
|
|
U for an unnamed semaphore.</dd>
|
|
|
|
<dt><strong>THREAD</strong> (-E)</dt>
|
|
|
|
<dd>The thread ID of the thread waiting on the named semaphore
|
|
or unnamed semaphore.</dd>
|
|
|
|
<dt><strong>TITLE</strong> (default)</dt>
|
|
|
|
<dd>The title of the named semaphore or unnamed semaphore.</dd>
|
|
|
|
<dt><strong>VALUE</strong> (-b, -a)</dt>
|
|
|
|
<dd>The current value of the named semaphore or unnamed semaphore.</dd>
|
|
|
|
<dt><strong>WAITER</strong> (-E)</dt>
|
|
|
|
<dd>The index number of the thread waiting on the named semaphore or
|
|
unnamed semaphore.</dd>
|
|
|
|
<dt><strong>WAITP</strong> (-E)</dt>
|
|
|
|
<dd>The process ID
|
|
of the job waiting for the semaphore value
|
|
to reach a positive number.</dd>
|
|
|
|
<dt><img src="delta.gif" alt="Start of change"><strong>WAITPJID</strong> (-Ej)</dt>
|
|
|
|
<dd>The qualified job name of the job waiting for the semaphore value to reach
|
|
a positive number.<img src="deltaend.gif" alt="End of change"></dd>
|
|
|
|
<dt><strong>WAITPTID</strong> (-ET)</dt>
|
|
|
|
<dd>The thread ID of the thread or threads waiting for the semaphore
|
|
value to reach a positive number.</dd>
|
|
|
|
<dt><strong>WAITVAL</strong> (-E)</dt>
|
|
|
|
<dd>The value that the thread is waiting for the semaphore to reach.</dd>
|
|
|
|
<dt><strong>WAITZ</strong> (-E)</dt>
|
|
|
|
<dd>The process ID
|
|
of the job waiting for the semaphore value
|
|
to reach zero.</dd>
|
|
|
|
<dt><img src="delta.gif" alt="Start of change"><strong>WAITZJID</strong> (-Ej)</dt>
|
|
|
|
<dd>The qualified job name of the job waiting for the semaphore value to reach zero.
|
|
<img src="deltaend.gif" alt="End of change"></dd>
|
|
|
|
<dt><strong>WAITZTID</strong> (-ET)</dt>
|
|
|
|
<dd>The thread ID of the thread or thread waiting for the semaphore value
|
|
to reach zero.</dd>
|
|
|
|
<dt><img src="delta.gif" alt="Start of change"><strong>WJOBID</strong> (-Ej)</dt>
|
|
|
|
<dd>The qualified job names of the jobs waiting to receive a message.
|
|
<img src="deltaend.gif" alt="End of change"></dd>
|
|
|
|
<dt><strong>WPID</strong> (-E)</dt>
|
|
|
|
<dd>The process ID of the job or jobs waiting to receive
|
|
a message.</dd>
|
|
|
|
<dt><strong>WTID</strong> (-E)</dt>
|
|
|
|
<dd>The thread ID of the thread waiting to receive
|
|
a message.</dd>
|
|
|
|
</dl>
|
|
|
|
<p><strong>Exit Status</strong></p>
|
|
<ul>
|
|
<li>0 on success</li>
|
|
|
|
<li>>0 if an error occurs</li>
|
|
</ul>
|
|
|
|
<p><strong>Related Information</strong></p>
|
|
<ul>
|
|
<li><a href="ipcrm.htm">ipcrm - Remove interprocess communication identifier</a></li>
|
|
</ul>
|
|
|
|
|
|
|
|
<!-- end ibmbody========================================================= -->
|
|
</body>
|
|
</html>
|
|
|