Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
pkill(1)
Edit
PageHistory
Diff
Info
LikePages
PGREP !!!PGREP NAME SYNOPSIS DESCRIPTION OPTIONS OPERANDS EXAMPLES EXIT STATUS NOTES BUGS SEE ALSO STANDARDS AUTHOR ---- !!NAME pgrep, pkill - look up or signal processes based on name and other attributes !!SYNOPSIS pgrep [[-flnvx] [[-d ''delimiter''] [[-P ''ppid'',...] [[-g ''pgrp'',...] [[-s ''sid'',...] [[-u ''euid'',...] [[-U ''uid'',...] [[-G ''gid'',...] [[-t ''term'',...] [[''pattern''] pkill [[-''signal''] [[-fnvx] [[-P ''ppid'',...] [[-g ''pgrp'',...] [[-s ''sid'',...] [[-u ''euid'',...] [[-U ''uid'',...] [[-G ''gid'',...] [[-t ''term'',...] [[''pattern''] !!DESCRIPTION __pgrep__ looks through the currently running processes and lists the process IDs which matches 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 -d ''delimiter'' Sets the string used to delimit each process ID in the output (by default a newline). (__pgrep__ only.) -f The ''pattern'' is normally only matched against the process name. When -f is set, the full command line is used. -g ''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 ''gid'',... Only match processes whose real group ID is listed. Either the numerical or symbolical value may be used. -l List the process name as well as the process ID. (__pgrep__ only.) -n Select only the newest (most recently started) of the matching processes. -P ''ppid'',... Only match processes whose parent process ID is listed. -s ''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 ''term'',... Only match processes whose controlling terminal is listed. The terminal name should be specified without the -u ''euid'',... Only match processes whose effective user ID is listed. Either the numerical or symbolical value may be used. -U ''uid'',... Only match processes whose real user ID is listed. Either the numerical or symbolical value may be used. -v Negates the matching. -x Only match processes whose name (or command line if -f is specified) __exactly__ match the ''pattern''. -''signal'' Defines the signal to send to each matched process. Either the numeric or the symbolic signal name can be used. (__pkill__ only.) !!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: unix$ pgrep -u root named Example 2: Make __syslog__ reread its configuration file: unix$ pkill -HUP syslogd Example 3: Give detailed information on all __xterm__ processes: unix$ ps -fp $(pgrep -d, -x xterm) Example 4: Make all __netscape__ processes run nicer: unix$ 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 -v can not be combined. Let me know if you need to do this. Defunct processes are reported. !!SEE ALSO ps(1) proc(5) regex(5) !!STANDARDS __pkill__ and __pgrep__ were introduced in Sun's Solaris 7. This implementation is fully compatible. !!AUTHOR Kjetil Torgrim Homme Michael K. Johnson Please send bug reports to ----
One page links to
pkill(1)
:
Man1p
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.