pgrep.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

pgrep(1) pgrep(1)

NAME

pgrep, pkill - search or kill processes based on process name and attributes

SYNOPSIS

pgrep [-flvx][-n

|-o][-d dlim][-e etimelist ][-g

pgrplist ][-G grouplist ]

[

-P ppidlist ][-R

prmgrplist ][-s sidlist ][-S statelist ][-t termlist ][

-u userlist ]

[

-U ruserlist ][-z

vszlist ][-Z psetlist ][pattern ]

pkill [-signal][-fvx

][-n|-o] [-e etimelist ][-g pgrplist ][

-G grouplist ]

[

-P ppidlist ][-R

prmgrplist ][-s sidlist ][-S statelist ][-t termlist ][

-u userlist ]

[

-U ruserlist ][-z

vszlist ][-Z psetlist ][pattern ]

DESCRIPTION

pgrep searches for processes having attributes matching the selection criteria speciﬁed by its arguments.

The process ID numbers of the matched processes are printed, separated by a delimiter, the default being

the newline. Each attribute option can take multiple values separated by comma.

pgrep will select

those processes that match all the attribute options speciﬁed. If an attribute option has multiple values,

then the process needs to match one of the values.

For example:

pgrep -u root,daemon -G sys,daemon

matches processes having effective user ID (root OR daemon) AND real group ID (

sys OR daemon).

pkill selects processes similar to pgrep, but instead of printing the process ID numbers, it signals the

matched processes. The user can specify the signal to be sent to the matched process as the ﬁrst argu-

ment to pkill. By default SIGTERM is assumed.

Options

The following options can be used to specify processes to be selected.

-signal Speciﬁes the signal to be sent to each matched process (pkill only). If no signal is

speciﬁed,

SIGTERM is sent by default. The value of signal follows the same syntax as

that of the kill command; see kill (1). This option, if speciﬁed, should be the ﬁrst argu-

ment to pkill.

-d dlim Speciﬁes the delimiter to be used while printing the matched entries (

pgrep only). The

default delimiter is a newline.

-e timelist Selects processes whose elapsed time matches the time limits speciﬁed in timelist . This

time limit can be speciﬁed as given below:

gtime1 ltime2

which will be interpreted as elapsed time

greater than time1 and less than time2 . If the

argument is only time , then

gtime is assumed. The syntax for specifying time is:

D:H:m:s

for D days, H hours, m minutes and s seconds. If one of the ﬁelds is empty, then 0 is

assumed for that ﬁeld.

For example:

-e 300

will be interpreted as elapsed time greater than 300 seconds, and

-e g30:10l2:::,g3:::,l10

will be interpreted as elapsed time (greater than 30 minutes and 10 seconds AND less

than 2 days, speciﬁed by ’el’2) OR (greater than 3 days) OR (less than 10 seconds,

speciﬁed by ’el’10).

-f Perform pattern matching on the entire command line rather than the command name.

-G grouplist Select processes whose real group ID numbers or group names are given in grouplist .

-g pgrplist Select processes whose process group ID numbers are given in pgrplist .

-l Long listing (pgrep only). Print the command name along with the PID. If used with

the -f option, the command line argument is printed instead of command name.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
pgrep(1) pgrep(1) NAME pgrep, pkill - search or kill processes based on process name and attributes SYNOPSIS pgrep [-flvx] [-n|-o] [-d dlim ] [-e etimelist ] [-g pgrplist ] [-G grouplist ] [-P ppidlist ] [-R prmgrplist ] [-s sidlist ] [-S statelist ] [-t termlist ] [-u userlist ] [-U ruserlist ] [-z vszlist ] [-Z psetlist ] [pattern ] pkill [-signal] [-fvx] [-n|-o] [-e etimelist ] [-g pgrplist ] [-G grouplist ] [-P ppidlist ] [-R prmgrplist ] [-s sidlist ] [-S statelist ] [-t termlist ] [-u userlist ] [-
PAGE 2
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.
PAGE 3
pgrep(1) pgrep(1) pgrep -u root cron Send SIGHUP signal to syslogd: pkill -HUP -u root syslogd Print PIDs of telnet sessions that are active for more than 2 days: pgrep -e 2::: telnet$ WARNINGS Process information can change while pgrep or pkill is running; the picture it gives is only a snapshot in time. With the -f option, pgrep and pkill matches only up to the initial 1020 bytes of command line with the pattern string. pgrep and pkill will not match itself.
PAGE 4
(Notes) A (Notes) pA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010