HP-UX Reference (11i v3 07/02) - 1 User Commands N-Z (vol 2)

p
pgrep(1) pgrep(1)
-n Select the most recently created process matching the criteria. This option is mutually
exclusive with the -o option.
-o Select the oldest process matching the criteria. This option is mutually exclusive with the
-n option.
-P ppidlist Select processes whose parent process ID numbers are given in ppidlist.
-R pgrmgrplist
Select processes belonging to PRM process resource groups whose names or ID numbers
are given in prmgrplist. See DEPENDENCIES.
-S statelist Selects processes whose current state is given in the statelist. The values for statelist can
be:
R Running
S Sleeping
T Stopped
Z Zombie
-s sidlist Select processes whose session ID numbers are given in sidlist.
-t termlist Select processes associated with the terminals given in termlist. Terminal identifiers can
be specified in one of two forms:
• the device’s file name (such as tty04), or
• if the device’s file name starts with
tty
, just the rest of it (such as 04).
If the device’s file is in a directory other than
/dev or /dev/pty, the terminal identifier
must include the name of the directory under
/dev that contains the device file (such as
pts/5).
-U ruserlist Select processes whose real user ID numbers or login names are given in ruserlist.
-u userlist Select processes whose real user ID numbers or login names are given in userlist.
-v Reverse selection. Select processes that do not meet the matching criteria.
-x Perform an exact match of the pattern string.
-Z psetidlist Select processes whose processor set IDs are given in psetlist.
-z sizelist Selects processes whose virtual size matches the size limits specified in sizelist. The syntax
for specifying size limit is as given below:
glowerlimitlupperlimit
which will be interpreted as virtual size in kilobytes greater than lowerlimit and less than
upperlimit. If the argument is only limit then
glimit is assumed.
Operands
pattern Expression (ERE) pattern to match against either the basename or full process argument
string. See regexp(5) for a complete description of the ERE syntax.
EXTERNAL INFLUENCES
Environment Variables
If LANG is not specified or is null, it defaults to C (see lang(5)).
RETURN VALUE
pgrep and pkill exits with one of the following values:
0 One or more processes matched the criteria.
1 No process matched the criteria.
2 Syntax error in command line.
3 Other errors
EXAMPLES
Print PID of the cron daemon:
122 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: February 2007