d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
0cf4978129
freebsd-skq/usr.bin/killall/killall.1

162 lines
4.3 KiB
Groff
Raw Normal View History

Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.\" Copyright (C) 1995 by Joerg Wunsch, Dresden
.\" All rights reserved.
.\"
.\" 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.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``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 AUTHOR(S) 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.
.\"
$Id$ -> $FreeBSD$
1999-08-28 01:08:13 +00:00
.\" $FreeBSD$
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.\"
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
.Dd November 9, 2007
mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10 14:16:33 +00:00
.Os
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.Dt KILLALL 1
.Sh NAME
.Nm killall
.Nd kill processes by name
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 19:21:22 +00:00
.Nm
New -e flag, modifies the behavior of the -u uid flag to use the effective user id, instead of the real user id. MFC after: 2 weeks
2004-01-26 11:11:36 +00:00
.Op Fl delmsvz
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.Op Fl help
o Add jls(8) for listing active jails. o Add jexec(8) to execute a command in an existing jail. o Add -j option for killall(1) to kill all processes in a specified jail. o Add -i option to jail(8) to output jail ID of newly created jail.
2003-04-09 03:04:12 +00:00
.Op Fl j Ar jid
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
.Op Fl u Ar user
.Op Fl t Ar tty
.Op Fl c Ar procname
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
.Op Fl Ar SIGNAL
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
.Op Ar procname ...
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.Sh DESCRIPTION
Use `The .Nm utility'
2002-04-20 12:18:28 +00:00
The
.Nm
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
utility kills processes selected by name, as opposed to the selection by PID
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
as done by
.Xr kill 1 .
By default, it will send a
.Dv TERM
killall operates on all processes owned by the real uid, not the effective uid. MFC after: 3 days
2001-11-30 00:30:28 +00:00
signal to all processes with a real UID identical to the
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
caller of
.Nm
that match the name
.Ar procname .
The super-user is allowed to kill any process.
.Pp
The options are as follows:
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
.Bl -tag -width ".Fl c Ar procname"
Prepare for mdoc(7)NG.
2000-12-19 16:00:12 +00:00
.It Fl d | v
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
Be more verbose about what will be done.
For a single
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.Fl d
option, a list of the processes that will be sent the signal will be
printed, or a message indicating that no matching processes have been
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
found.
New -e flag, modifies the behavior of the -u uid flag to use the effective user id, instead of the real user id. MFC after: 2 weeks
2004-01-26 11:11:36 +00:00
.It Fl e
Bump document date on behalf of the -e option. Spell "ID" correctly.
2004-05-18 20:45:32 +00:00
Use the effective user ID instead of the (default) real user ID for matching
New -e flag, modifies the behavior of the -u uid flag to use the effective user id, instead of the real user id. MFC after: 2 weeks
2004-01-26 11:11:36 +00:00
processes specified with the
.Fl u
option.
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.It Fl help
Give a help on the command usage and exit.
.It Fl l
List the names of the available signals and exit, like in
.Xr kill 1 .
.It Fl m
Match the argument
.Ar procname
o -m flags contructs case sensitive RE, not case insensitive. MFC after: 1 week
2004-01-18 17:51:34 +00:00
as a (case sensitive) regular expression against the names
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
of processes found.
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
CAUTION!
This is dangerous, a single dot will match any process
killall operates on all processes owned by the real uid, not the effective uid. MFC after: 3 days
2001-11-30 00:30:28 +00:00
running under the real UID of the caller.
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.It Fl s
Typo. PR: docs/4911 Submitted by: Vasim Valejev <vasim@uddias.diaspro.com>
1997-11-01 15:06:40 +00:00
Show only what would be done, but do not send any signal.
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
.It Fl Ar SIGNAL
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
Send a different signal instead of the default
.Dv TERM .
The signal may be specified either as a name
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(with or without a leading
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
.Dq Li SIG ) ,
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
or numerically.
o Add jls(8) for listing active jails. o Add jexec(8) to execute a command in an existing jail. o Add -j option for killall(1) to kill all processes in a specified jail. o Add -i option to jail(8) to output jail ID of newly created jail.
2003-04-09 03:04:12 +00:00
.It Fl j Ar jid
Kill processes in the jail specified by
.Ar jid .
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
.It Fl u Ar user
Limit potentially matching processes to those belonging to
the specified
.Ar user .
Fix typo: -c -> -t
2001-01-21 01:07:26 +00:00
.It Fl t Ar tty
Remove whitespace at EOL.
2001-07-15 08:06:20 +00:00
Limit potentially matching processes to those running on
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
the specified
.Ar tty .
.It Fl c Ar procname
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
Limit potentially matching processes to those matching
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
the specified
s/progname/procname/ to be consistent with the other occurrences of the option -c argument in SYNOPSIS and DESCRIPTION.
2002-07-15 11:33:30 +00:00
.Ar procname .
Skip zombies. Add an option (-z) to revert to the historical behaviour of trying to kill zombies (which has no effect except emit a few error messages)
2002-04-14 22:25:57 +00:00
.It Fl z
mdoc(7) police: lint.
2002-05-29 18:53:22 +00:00
Do not skip zombies.
Skip zombies. Add an option (-z) to revert to the historical behaviour of trying to kill zombies (which has no effect except emit a few error messages)
2002-04-14 22:25:57 +00:00
This should not have any effect except to print a few error messages
if there are zombie processes that match the specified pattern.
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.El
Support killing of suid programs. Now ``killall xterm'' works :-) Don't fail for processes with meta chars (c+++)
1996-02-03 22:52:27 +00:00
.Sh ALL PROCESSES
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
Sending a signal to all processes with then given UID
Support killing of suid programs. Now ``killall xterm'' works :-) Don't fail for processes with meta chars (c+++)
1996-02-03 22:52:27 +00:00
is already supported by
Remove whitespace at EOL.
2001-07-15 08:06:20 +00:00
.Xr kill 1 .
So use
Support killing of suid programs. Now ``killall xterm'' works :-) Don't fail for processes with meta chars (c+++)
1996-02-03 22:52:27 +00:00
.Xr kill 1
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
for this job (e.g.\&
.Dq Li "kill -TERM -1
or as root
.Dq Li "echo kill -TERM -1 | su -m <user>" ) .
Added the EXIT STATUS section where appropriate.
2005-01-17 07:44:44 +00:00
.Sh EXIT STATUS
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
The
.Nm
- Fix documentation to match code. Specifically, -c doesn't have to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
2007-11-09 16:02:10 +00:00
utility exits 0 if some processes have been found and
signalled successfully.
Otherwise, a status of 1 will be
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
returned.
Added the EXIT STATUS section where appropriate.
2005-01-17 07:44:44 +00:00
.Sh DIAGNOSTICS
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
Diagnostic messages will only be printed if requested by
.Fl d
options.
.Sh SEE ALSO
.Xr kill 1 ,
Add a cross-reference to pkill(1), now that pkill is hooked up to the build.
2004-03-27 23:45:33 +00:00
.Xr pkill 1 ,
o Add jls(8) for listing active jails. o Add jexec(8) to execute a command in an existing jail. o Add -j option for killall(1) to kill all processes in a specified jail. o Add -i option to jail(8) to output jail ID of newly created jail.
2003-04-09 03:04:12 +00:00
.Xr sysctl 3 ,
.Xr jail 8
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.Sh HISTORY
The
.Nm
Use the .Fx macro where appropriate.
1996-08-23 00:57:08 +00:00
command appeared in
.Fx 2.1 .
It has been modeled after the
Our Perl oracle hit again: Wolfram Schneider's killall utility. Kills processes by name instead of by UID. (Man page by me.) Submitted by: wosch@cs.tu-berlin.de (Wolfram Schneider)
1995-06-25 18:08:27 +00:00
.Nm
command as available on other platforms.
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.
1998-03-23 07:48:45 +00:00
.Sh AUTHORS
mdoc(7) police: do not split author names in the AUTHORS section.
2000-11-22 09:35:58 +00:00
.An -nosplit
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
The
.Nm
program was originally written in Perl and was contributed by
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.
1998-03-23 07:48:45 +00:00
.An Wolfram Schneider ,
this manual page has been written by
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.An J\(:org Wunsch .
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
The current version of
.Nm
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
was rewritten in C by
.An Peter Wemm
using
After positive feedback from a few folks, activate a switchover to using killall.c instead of the perl version that depends on procfs. The C version uses sysctl(). The program is based on a hack that was originally written about 6 years ago and has evolved somewhat since then. (which is why it is a superset of killall.pl, rather than being a clone.) With apologies to: wosch
2000-08-28 22:09:38 +00:00
.Xr sysctl 3 .
Reference in New Issue Copy Permalink