diff options
Diffstat (limited to 'usr.bin/pkill/pkill.1')
| -rw-r--r-- | usr.bin/pkill/pkill.1 | 197 |
1 files changed, 0 insertions, 197 deletions
diff --git a/usr.bin/pkill/pkill.1 b/usr.bin/pkill/pkill.1 deleted file mode 100644 index aeda347cf2a9..000000000000 --- a/usr.bin/pkill/pkill.1 +++ /dev/null @@ -1,197 +0,0 @@ -.\" $NetBSD: pkill.1,v 1.7 2002/03/06 12:03:48 ad Exp $ -.\" -.\" Copyright (c) 2002 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Andrew Doran. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the NetBSD -.\" Foundation, Inc. and its contributors. -.\" 4. Neither the name of The NetBSD Foundation nor the names of its -.\" contributors may be used to endorse or promote products derived -.\" from this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd March 1, 2002 -.Dt PKILL 1 -.Os -.Sh NAME -.Nm pkill -.Nd find or signal processes by name -.Sh SYNOPSIS -.Nm pgrep -.Op Fl flnvx -.Op Fl G Ar gid -.Op Fl P Ar ppid -.Op Fl U Ar uid -.Op Fl d Ar delim -.Op Fl g Ar pgrp -.Op Fl s Ar sid -.Op Fl t Ar tty -.Op Fl u Ar euid -.Op Ar pattern Op ... -.Nm pkill -.Op Fl signal -.Op Fl fnvx -.Op Fl G Ar gid -.Op Fl P Ar ppid -.Op Fl U Ar uid -.Op Fl g Ar pgrp -.Op Fl s Ar sid -.Op Fl t Ar tty -.Op Fl u Ar euid -.Op Ar pattern Op ... -.Sh DESCRIPTION -The -.Nm pgrep -command searches the process table on the running system and prints the -process IDs of all processes that match the criteria given on the command -line. -.Pp -The -.Nm pkill -command searches the process table on the running system and signals all -processes that match the criteria given on the command line. -.Pp -The following options are available: -.Bl -tag -width xxxxxxxx -.It Fl G Ar gid -Restrict matches to processes with a real group ID in the comma-separated -list -.Ar gid . -.It Fl P Ar ppid -Restrict matches to processes with a parent process ID in the -comma-separated list -.Ar ppid . -.It Fl U Ar uid -Restrict matches to processes with a real user ID in the comma-separated -list -.Ar uid . -.It Fl d Ar delim -Specify a delimiter to be printed between each process ID. -The default is a newline. -This option can only be used with the -.Nm pgrep -command. -.It Fl f -Match against full argument lists. -The default is to match against process names. -.It Fl g Ar pgrp -Restrict matches to processes with a process group ID in the comma-separated -list -.Ar pgrp . -The value zero is taken to mean the process group ID of the running -.Nm pgrep -or -.Nm pkill -command. -.It Fl l -Long output. -Print the process name in addition to the process ID for each matching -process. -If used in conjunction with -.Fl f , -print the process ID and the full argument list for each matching process. -This option can only be used with the -.Nm pgrep -command. -.It Fl n -Match only the most recently created process, if any. -.It Fl s Ar sid -Restrict matches to processes with a session ID in the comma-separated -list -.Ar sid . -The value zero is taken to mean the session ID of the running -.Nm pgrep -or -.Nm pkill -command. -.It Fl t Ar tty -Restrict matches to processes associated with a terminal in the -comma-separated list -.Ar tty . -Terminal names may be of the form -.Sq ttyxx -or the shortened form -.Sq xx . -A single dash (`-') matches processes not associated with a terminal. -.It Fl u Ar euid -Restrict matches to processes with an effective user ID in the -comma-separated list -.Ar euid . -.It Fl v -Reverse the sense of the matching; display processes that do not match the -given criteria. -.It Fl x -Require an exact match of the process name, or argument list if -.Fl f -is given. -The default is to match any substring. -.It Fl signal -A non-negative decimal number or symbolic signal name specifying the signal -to be sent instead of the default TERM. -This option is valid only when given as the first argument to -.Nm pkill . -.El -.Pp -Note that a running -.Nm pgrep -or -.Nm pkill -process will never consider itself nor system processes (kernel threads) as -a potential match. -.Sh EXIT STATUS -.Nm pgrep -and -.Nm pkill -return one of the following values upon exit: -.Bl -tag -width foo -.It 0 -One or more processes were matched. -.It 1 -No processes were matched. -.It 2 -Invalid options were specified on the command line. -.It 3 -An internal error occurred. -.El -.Sh SEE ALSO -.Xr kill 1 , -.Xr ps 1 , -.Xr kill 2 , -.Xr sigaction 2 , -.Xr re_format 7 , -.Xr signal 7 -.Sh HISTORY -.Nm pkill -and -.Nm pgrep -first appeared in -.Nx 1.6 . -They are modelled after utilities of the same name that appeared in Sun -Solaris 7. -.Sh AUTHORS -.An Andrew Doran -.Aq ad@NetBSD.org . |
