Reformatting page.  Please Wait... done


User Commands                                            PGREP(1)


NAME
     pgrep, pkill - find or signal processes by  name  and  other
     attributes

SYNOPSIS
     pgrep [-flvx] [-n | -o] [-d delim] [-P ppidlist]
          [-g pgrplist] [-s sidlist] [-u euidlist] [-U uidlist]
          [-G gidlist] [-J projidlist] [-t termlist]
          [-T taskidlist] [-c ctidlist] [-z zoneidlist]
          [pattern]


     pkill [-signal] [-fvx] [-n | -o] [-P ppidlist]
          [-g pgrplist] [-s sidlist] [-u euidlist] [-U uidlist]
          [-G gidlist] [-J projidlist] [-t termlist]
          [-T taskidlist] [-c ctidlist] [-z zoneidlist]
          [pattern]


DESCRIPTION
     The pgrep utility examines the active processes on the  sys-
     tem  and  reports  the  process  IDs  of the processes whose
     attributes match the criteria specified on the command line.
     Each  process  ID  is  printed  as  a  decimal  value and is
     separated from the next ID  by  a  delimiter  string,  which
     defaults  to  a newline. For each attribute option, the user
     can specify a set of possible values separated by commas  on
     the command line. For example,

       pgrep -G other,daemon


     matches processes whose real group ID is other OR daemon. If
     multiple  criteria  options  are  specified,  pgrep  matches
     processes whose attributes match the logical AND of the cri-
     teria options.  For example,

       pgrep -G other,daemon -U root,daemon


     matches processes whose attributes are:
       (real group ID is other OR daemon) AND
       (real user ID is root OR daemon)


     pkill functions  identically  to  pgrep,  except  that  each
     matching  process  is  signaled  as if by kill(1) instead of
     having its process ID printed. A signal name or  number  may


Illumos             Last change: May 6, 2004                    1


User Commands                                            PGREP(1)


     be specified as the first command line option to pkill.

OPTIONS
     The following options are supported:

     -c ctidlist
                      Matches only processes whose  process  con-
                      tract ID is in the given list.


     -d delim
                      Specifies the output delimiter string to be
                      printed  between  each matching process ID.
                      If no -d option is specified,  the  default
                      is  a  newline  character. The -d option is
                      only valid when specified as an  option  to
                      pgrep.


     -f
                      The regular expression  pattern  should  be
                      matched  against  the full process argument
                      string (obtained from the  pr_psargs  field
                      of  the  /proc/nnnnn/psinfo file). If no -f
                      option  is  specified,  the  expression  is
                      matched  only  against the name of the exe-
                      cutable file (obtained  from  the  pr_fname
                      field of the /proc/nnnnn/psinfo file).


     -g pgrplist
                      Matches only processes whose process  group
                      ID  is  in  the  given  list. If group 0 is
                      included in the list, this  is  interpreted
                      as  the  process  group  ID of the pgrep or
                      pkill process.


     -G gidlist
                      Matches only processes whose real group  ID
                      is  in the given list. Each group ID may be
                      specified as  either  a  group  name  or  a
                      numerical group ID.


     -J projidlist
                      Matches only processes whose project ID  is
                      in  the  given list. Each project ID may be
                      specified as either a  project  name  or  a
                      numerical project ID.


Illumos             Last change: May 6, 2004                    2


User Commands                                            PGREP(1)


     -l
                      Long output format. Prints the process name
                      along  with the process ID of each matching
                      process. The process name is obtained  from
                      the  pr_psargs or pr_fname field, depending
                      on whether the -f option was specified (see
                      above).  The  -l  option is only valid when
                      specified as an option to pgrep.


     -n
                      Matches  only  the  newest  (most  recently
                      created)   process  that  meets  all  other
                      specified matching criteria. Cannot be used
                      with option -o.


     -o
                      Matches only the oldest (earliest  created)
                      process  that  meets  all  other  specified
                      matching  criteria.  Cannot  be  used  with
                      option -n.


     -P ppidlist
                      Matches only processes whose parent process
                      ID is in the given list.


     -s sidlist
                      Matches only processes whose  process  ses-
                      sion  ID  is in in the given list.  If ID 0
                      is included in the  list,  this  is  inter-
                      preted  as  the  session ID of the pgrep or
                      pkill process.


     -t termlist
                      Matches only processes which are associated
                      with  a  terminal  in the given list.  Each
                      terminal is specified as the suffix follow-
                      ing  "/dev/"  of the terminal's device path
                      name in /dev. For example, term/a or pts/0.


     -T taskidlist
                      Matches only processes whose task ID is  in
                      the  given list. If ID 0 is included in the
                      list, this is interpreted as the task ID of
                      the pgrep or pkill process.


Illumos             Last change: May 6, 2004                    3


User Commands                                            PGREP(1)


     -u euidlist
                      Matches only processes whose effective user
                      ID  is  in the given list. Each user ID may
                      be specified as either a login  name  or  a
                      numerical user ID.


     -U uidlist
                      Matches only processes whose real  user  ID
                      is  in  the given list. Each user ID may be
                      specified as  either  a  login  name  or  a
                      numerical user ID.


     -v
                      Reverses the sense of the matching. Matches
                      all  processes  except those which meet the
                      specified matching criteria.


     -x
                      Considers  only  processes  whose  argument
                      string  or  executable  file  name  exactly
                      matches the specified pattern to be  match-
                      ing  processes.  The  pattern match is con-
                      sidered to be exact when all characters  in
                      the  process  argument string or executable
                      file name match the pattern.


     -z zoneidlist
                      Matches only processes whose zone ID is  in