pkill(1)


NAME

   pgrep,  pkill  -  look  up  or signal processes based on name and other
   attributes

SYNOPSIS

   pgrep [options] pattern
   pkill [options] pattern

DESCRIPTION

   pgrep looks through the  currently  running  processes  and  lists  the
   process  IDs  which  match  the  selection criteria to stdout.  All the
   criteria have to match.  For example,

          $ pgrep -u root sshd

   will only list the processes called sshd AND owned  by  root.   On  the
   other hand,

          $ pgrep -u root,daemon

   will list the processes owned by root OR daemon.

   pkill  will  send  the  specified  signal  (by default SIGTERM) to each
   process instead of listing them on stdout.

OPTIONS

   -signal
   --signal signal
          Defines the signal to send to each matched process.  Either  the
          numeric or the symbolic signal name can be used.  (pkill only.)

   -c, --count
          Suppress  normal  output;  instead  print  a  count  of matching
          processes.  When count does not  match  anything,  e.g.  returns
          zero, the command will return non-zero value.

   -d, --delimiter delimiter
          Sets  the  string  used to delimit each process ID in the output
          (by default a newline).  (pgrep only.)

   -f, --full
          The pattern is normally only matched against the  process  name.
          When -f is set, the full command line is used.

   -g, --pgroup pgrp,...
          Only  match  processes in the process group IDs listed.  Process
          group 0 is translated into pgrep's or pkill's own process group.

   -G, --group gid,...
          Only match processes whose real group ID is listed.  Either  the
          numerical or symbolical value may be used.

   -i, --ignore-case
          Match processes case-insensitively.

   -l, --list-name
          List the process name as well as the process ID.  (pgrep only.)

   -a, --list-full
          List  the  full  command line as well as the process ID.  (pgrep
          only.)

   -n, --newest
          Select only the newest (most recently started) of  the  matching
          processes.

   -o, --oldest
          Select  only the oldest (least recently started) of the matching
          processes.

   -P, --parent ppid,...
          Only match processes whose parent process ID is listed.

   -s, --session sid,...
          Only  match  processes  whose  process  session  ID  is  listed.
          Session  ID  0 is translated into pgrep's or pkill's own session
          ID.

   -t, --terminal term,...
          Only match processes whose controlling terminal is listed.   The
          terminal name should be specified without the "/dev/" prefix.

   -u, --euid euid,...
          Only  match processes whose effective user ID is listed.  Either
          the numerical or symbolical value may be used.

   -U, --uid uid,...
          Only match processes whose real user ID is listed.   Either  the
          numerical or symbolical value may be used.

   -v, --inverse
          Negates  the  matching.   This option is usually used in pgrep's
          context.  In pkill's context the short  option  is  disabled  to
          avoid accidental usage of the option.

   -w, --lightweight
          Shows  all  thread  ids  instead of pids in pgrep's context.  In
          pkill's context this option is disabled.

   -x, --exact
          Only match processes whose names  (or  command  line  if  -f  is
          specified) exactly match the pattern.

   -F, --pidfile file
          Read  PID's  from  file.  This option is perhaps more useful for
          pkill than pgrep.

   -L, --logpidfile
          Fail if pidfile (see -F) not locked.

   --ns pid
          Match processes that belong to the same namespaces. Required  to
          run  as  root  to match processes from other users. See --nslist
          for how to limit which namespaces to match.

   --nslist name,...
          Match only the provided namespaces. Available  namespaces:  ipc,
          mnt, net, pid, user,uts.

   -V, --version
          Display version information and exit.

   -h, --help
          Display help and exit.

OPERANDS

   pattern
          Specifies  an  Extended  Regular Expression for matching against
          the process names or command lines.

EXAMPLES

   Example 1: Find the process ID of the named daemon:

          $ pgrep -u root named

   Example 2: Make syslog reread its configuration file:

          $ pkill -HUP syslogd

   Example 3: Give detailed information on all xterm processes:

          $ ps -fp $(pgrep -d, -x xterm)

   Example 4: Make all netscape processes run nicer:

          $ renice +4 $(pgrep netscape)

EXIT STATUS

   0      One or more processes matched the criteria.
   1      No processes matched.
   2      Syntax error in the command line.
   3      Fatal error: out of memory etc.

NOTES

   The process name used for matching is  limited  to  the  15  characters
   present  in  the  output of /proc/pid/stat.  Use the -f option to match
   against the complete command line, /proc/pid/cmdline.

   The running pgrep or pkill process will never report itself as a match.

BUGS

   The options -n and -o and -v can not be combined.  Let me know  if  you
   need to do this.

   Defunct processes are reported.

SEE ALSO

   ps(1), regex(7), signal(7), killall(1), skill(1), kill(1), kill(2)

AUTHOR

   Kjetil Torgrim Homme ⟨kjetilho@ifi.uio.no

REPORTING BUGS

   Please send bug reports to ⟨procps@freelists.org


More Linux Commands

manpages/mytool.1.html
mytool(1) - manipulate map files for yudit, uniconv and unip
mytool is a my map file manipulation program in the yudit distribution. It can generates so-called binary nbit ( my ) map file that can map any sequences of byt

manpages/ObjCmdWrite.3.html
ObjCmdWrite(3) - Writing C language extensions to Tcl. '....
ObjCmdWrite.3 - This document is intended to help the programmer who wishes to extend Tcl with C language routines. It should also be useful to someone wishing

manpages/clear.3ncurses.html
clear(3ncurses) - clear all or part of a curses window......
The erase and werase routines copy blanks to every position in the window, clearing the screen. The clear and wclear routines are like erase and werase, but the

manpages/SDL_SetGamma.3.html
SDL_SetGamma(3) - Sets the color gamma function for the disp
Sets the gamma function for the display of each color component. Gamma controls the brightness/contrast of colors displayed on the screen. A gamma value of 1.0

manpages/immedok.3ncurses.html
immedok(3ncurses) - curses output options - Linux man page
These routines set options that change the style of output within curses. All options are initially FALSE, unless otherwise stated. It is not necessary to turn

manpages/perlfaq.1.html
perlfaq(1) - frequently asked questions about Perl (ManPage)
The perlfaq comprises several documents that answer the most commonly asked questions about Perl and Perl programming. Its divided by topic into nine major sect

manpages/Tcl_WaitForEvent.3.html
Tcl_WaitForEvent(3) - the event queue and notifier interface
The interfaces described here are used to customize the Tcl event loop. The two most common customizations are to add new sources of events and to merge Tcls ev

manpages/Tcl_GetObjResult.3.html
Tcl_GetObjResult(3) - manipulate Tcl result - Linux man page
The procedures described here are utilities for manipulating the result value in a Tcl interpreter. The interpreter result may be either a Tcl object or a strin

manpages/gnutls_pubkey_get_key_usage.3.html
gnutls_pubkey_get_key_usage(3) - API function (Man Page)....
This function will return the key usage of the public key. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. SINCE 2.12.0

manpages/xgi.4.html
xgi(4) - XGI video driver (Special files - Linux man page)
xgi is an XFree86 driver for XGI video chips. The driver is accelerated, and provides support for colordepths of 8, 16 and 24 bpp. XVideo, Render and other exte

manpages/tsort.1.html
tsort(1) - perform topological sort - Linux manual page.....
Write totally ordered list consistent with the partial ordering in FILE. With no FILE, or when FILE is -, read standard input. --help display this help and exit

manpages/Tcl_RegExpGetInfo.3.html
Tcl_RegExpGetInfo(3) - Pattern matching with regular express
Tcl_RegExpMatch determines whether its pattern argument matches regexp, where regexp is interpreted as a regular expression using the rules in the re_syntax ref





We can't live, work or learn in freedom unless the software we use is free.