pgrep.1 (2010 09)

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 syn-
tax for specifying size limit is as given below:
glowerlimit lupperlimit
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:
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010