👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for pgrep (opensolaris section 1)

pgrep(1)				  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 system 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  criteria
       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 be speci-
       fied as the first command line option to pkill.

OPTIONS
       The following options are supported:

       -c ctidlist	Matches only processes whose process contract 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  char-
			acter. 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 executable 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.

       -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 session ID is in in the given list.
			If ID 0 is included in the list, this is interpreted 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 following "/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.

       -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 matching processes. The pat-
			tern match is considered 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 the given list. Each zone ID
			may be specified as either a zone name	or  a  numerical  zone	ID.  This
			option	is  only  useful  when	executed in the global zone. If the pkill
			utility is used to send signals to processes in  other zones, the process
			must have asserted the {PRIV_PROC_ZONE} privilege (see privileges(5)).

       -signal		Specifies  the	signal	to  send to each matched process. If no signal is
			specified, SIGTERM is sent by default. The value of signal can be one  of
			the  symbolic names defined in signal.h(3HEAD) without the SIG prefix, or
			the corresponding signal number as a decimal value. The -signal option is
			only valid when specified as the first option to pkill.

OPERANDS
       The following operand is supported:

       pattern	  Specifies  an Extended Regular Expression (ERE) pattern to match against either
		  the executable file name or full process argument string. See  regex(5)  for	a
		  complete description of the ERE syntax.

EXAMPLES
       Example 1 Obtaining a Process ID

       Obtain the process ID of sendmail:

	 example% pgrep -x -u root sendmail
	 283

       Example 2 Terminating a Process

       Terminate the most recently created xterm:

	 example% pkill -n xterm

EXIT STATUS
       The following exit values are returned:

       0    One or more processes were matched.

       1    No processes were matched.

       2    Invalid command line options were specified.

       3    A fatal error occurred.

FILES
       /proc/nnnnn/psinfo    Process information files

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       kill(1), proc(1), ps(1), truss(1), kill(2), signal.h(3HEAD), proc(4), attributes(5), priv-
       ileges(5), regex(5), zones(5)

NOTES
       Both utilities match the ERE pattern argument against either  the  pr_fname  or	pr_psargs
       fields of the /proc/nnnnn/psinfo files. The lengths of these strings are limited according
       to definitions in <sys/procfs.h>. Patterns which can match strings longer than the current
       limits may fail to match the intended set of processes.

       If the pattern argument contains ERE meta-characters which are also shell meta-characters,
       it may be necessary to enclose the pattern with appropriate shell quotes.

       Defunct processes are never matched by either pgrep or pkill.

       The current pgrep or pkill process will never consider itself a potential match.

SunOS 5.11				    6 May 2004					 pgrep(1)


All times are GMT -4. The time now is 05:31 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?