summaryrefslogtreecommitdiffstats
path: root/usr.bin/pkill/pkill.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr.bin/pkill/pkill.1')
-rw-r--r--usr.bin/pkill/pkill.1284
1 files changed, 0 insertions, 284 deletions
diff --git a/usr.bin/pkill/pkill.1 b/usr.bin/pkill/pkill.1
deleted file mode 100644
index 725f27e..0000000
--- a/usr.bin/pkill/pkill.1
+++ /dev/null
@@ -1,284 +0,0 @@
-.\" $NetBSD: pkill.1,v 1.8 2003/02/14 15:59:18 grant Exp $
-.\"
-.\" $FreeBSD$
-.\"
-.\" 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 November 23, 2006
-.Dt PKILL 1
-.Os
-.Sh NAME
-.Nm pgrep , pkill
-.Nd find or signal processes by name
-.Sh SYNOPSIS
-.Nm pgrep
-.Op Fl LSfilnovx
-.Op Fl F Ar pidfile
-.Op Fl G Ar gid
-.Op Fl M Ar core
-.Op Fl N Ar system
-.Op Fl P Ar ppid
-.Op Fl U Ar uid
-.Op Fl d Ar delim
-.Op Fl g Ar pgrp
-.Op Fl j Ar jid
-.Op Fl s Ar sid
-.Op Fl t Ar tty
-.Op Fl u Ar euid
-.Ar pattern ...
-.Nm pkill
-.Op Fl Ar signal
-.Op Fl ILfinovx
-.Op Fl F Ar pidfile
-.Op Fl G Ar gid
-.Op Fl M Ar core
-.Op Fl N Ar system
-.Op Fl P Ar ppid
-.Op Fl U Ar uid
-.Op Fl g Ar pgrp
-.Op Fl j Ar jid
-.Op Fl s Ar sid
-.Op Fl t Ar tty
-.Op Fl u Ar euid
-.Ar pattern ...
-.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 ".Fl F Ar pidfile"
-.It Fl F Ar pidfile
-Restrict matches to a process whose PID is stored in the
-.Ar pidfile
-file.
-.It Fl G Ar gid
-Restrict matches to processes with a real group ID in the comma-separated
-list
-.Ar gid .
-.It Fl I
-Request confirmation before attempting to signal each process.
-.It Fl L
-The
-.Ar pidfile
-file given for the
-.Fl F
-option must be locked with the
-.Xr flock 2
-syscall or created with
-.Xr pidfile 3 .
-.It Fl M Ar core
-Extract values associated with the name list from the specified core
-instead of the currently running system.
-.It Fl N Ar system
-Extract the name list from the specified system instead of the default,
-which is the kernel image the system has booted from.
-.It Fl P Ar ppid
-Restrict matches to processes with a parent process ID in the
-comma-separated list
-.Ar ppid .
-.It Fl S
-Search also in system processes (kernel threads).
-.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 i
-Ignore case distinctions in both the process table and the supplied pattern.
-.It Fl j Ar jid
-Restrict matches to processes inside jails with a jail ID in the comma-separated
-list
-.Ar jid .
-The value
-.Dq Li any
-matches processes in any jail.
-The value
-.Dq Li none
-matches processes not in jail.
-.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
-Select only the newest (most recently started) of the matching processes.
-.It Fl o
-Select only the oldest (least recently started) of the matching processes.
-.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
-.Pa tty Ns Ar xx
-or the shortened form
-.Ar xx .
-A single dash
-.Pq Ql -
-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 Ns Ar signal
-A non-negative decimal number or symbolic signal name specifying the signal
-to be sent instead of the default
-.Dv TERM .
-This option is valid only when given as the first argument to
-.Nm pkill .
-.El
-.Pp
-If any
-.Ar pattern
-operands are specified, they are used as regular expressions to match
-the command name or full argument list of each process.
-If the
-.Fl f
-option is not specified, then the
-.Ar pattern
-will attempt to match the command name.
-However, presently
-.Fx
-will only keep track of the first 19 characters of the command
-name for each process.
-Attempts to match any characters after the first 19 of a command name
-will quietly fail.
-.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
-The
-.Nm pgrep
-and
-.Nm pkill
-utilities
-return one of the following values upon exit:
-.Bl -tag -width indent
-.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 COMPATIBILITY
-Historically the option
-.Dq Fl j Li 0
-means any jail, although in other utilities such as
-.Xr ps 1
-jail ID
-.Li 0
-has the opposite meaning, not in jail.
-Therefore
-.Dq Fl j Li 0
-is deprecated, and its use is discouraged in favor of
-.Dq Fl j Li any .
-.Sh SEE ALSO
-.Xr kill 1 ,
-.Xr killall 1 ,
-.Xr ps 1 ,
-.Xr flock 2 ,
-.Xr kill 2 ,
-.Xr sigaction 2 ,
-.Xr pidfile 3 ,
-.Xr re_format 7
-.\" Xr signal 7
-.Sh HISTORY
-The
-.Nm pkill
-and
-.Nm pgrep
-utilities
-first appeared in
-.Nx 1.6 .
-They are modelled after utilities of the same name that appeared in Sun
-Solaris 7.
-They made their first appearance in
-.Fx 5.3 .
-.Sh AUTHORS
-.An Andrew Doran
-.Aq ad@NetBSD.org
OpenPOWER on IntegriCloud