pipcs.1 (2010 09)

p
pipcs(1) pipcs(1)
NAME
pipcs - report status of POSIX interprocess communication facilities
SYNOPSIS
pipcs [-q [-P-T
][-N qname]][-s][-abo]
DESCRIPTION
pipcs displays certain information on active POSIX interprocess communication facilities. When no
options are specified, pipcs displays information in short format for the POSIX message queues and
POSIX named semaphores that are currently active in the system.
Options
The following options restrict the display to the corresponding facilities.
(none) This is equivalent to -qs.
-N qname Display details for the POSIX message queue specified in the qname argument.
-P Display the list of processes and users using the POSIX message queues.
-q Display information on active POSIX message queues.
-s Display information on active POSIX named semaphores.
-T Display the creation time and last modification time of the POSIX message queues.
The options,
-N, -P, and -T can be used only with the -q option. The options
-P and -T are mutu-
ally exclusive.
The following options add columns of data to the display. See "Column Description" below.
(none) Display default columns: for all facilities:
T, MODE, OWNER, GROUP, REFCNT
,
NAME.
-a Display all columns, as appropriate. This is equivalent to -bo.
-b Display largest-allowable-size information: for POSIX message queues:
QBYTES.
-o Display information on outstanding usage: for POSIX message queues: QNUM,
MNUM; for POSIX named semaphores: VAL, IVAL.
Column Descriptions
The column headings and the meaning of the columns in an
pipcs listing are given below. The columns
are printed from left to right in the order shown below.
T Facility type:
q POSIX message queue
s POSIX named semaphore
MODE The facility access modes and flags. The mode consists of nine characters that are
interpreted as three sets of three characters each. The first set refers to the owner’s
permissions, the next to permissions of others in the group of the facility entry, and
the last to all others.
Within each set, the first character indicates permission to read, the second charac-
ter indicates permission to write or alter the facility entry, and the last character is
currently unused.
r Read permission is granted.
w Write permission is granted.
a Alter permission is granted.
- The indicated permission is not granted.
OWNER The login name of the owner of the facility entry.
GROUP The group name of the group of the owner of the facility entry.
REFCNT The reference count value of the facility entry. Reference count of the POSIX mes-
sage queue represents number of simultaneous open for the associated one. Simi-
larly reference count of the POSIX named semaphore represents number of process
referencing the associated one.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1