diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:54:44 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:54:44 -0400 |
| commit | a9157ce950dfe2fc30795d43b9d79b9d1bffc48b (patch) | |
| tree | 9df484304b560466d145e662c1c254ff0e9ae0ba /static/openbsd/man1/kill.1 | |
| parent | 160aa82b2d39c46ad33723d7d909cb4972efbb03 (diff) | |
docs: Added All OpenBSD Manuals
Diffstat (limited to 'static/openbsd/man1/kill.1')
| -rw-r--r-- | static/openbsd/man1/kill.1 | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/static/openbsd/man1/kill.1 b/static/openbsd/man1/kill.1 new file mode 100644 index 00000000..c1ba12c2 --- /dev/null +++ b/static/openbsd/man1/kill.1 @@ -0,0 +1,164 @@ +.\" $OpenBSD: kill.1,v 1.43 2025/04/24 14:15:29 schwarze Exp $ +.\" $NetBSD: kill.1,v 1.8 1995/09/07 06:30:26 jtc Exp $ +.\" +.\" Copyright (c) 1980, 1990, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Institute of Electrical and Electronics Engineers, Inc. +.\" +.\" 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. Neither the name of the University 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 REGENTS 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 REGENTS 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. +.\" +.\" @(#)kill.1 8.2 (Berkeley) 4/28/95 +.\" +.Dd $Mdocdate: April 24 2025 $ +.Dt KILL 1 +.Os +.Sh NAME +.Nm kill +.Nd terminate or signal a process +.Sh SYNOPSIS +.Nm kill +.Op Fl Ar signal_number | Fl Ar signal_name | Fl s Ar signal_name +.Ar pid ... +.Nm kill +.Fl l +.Op Ar exit_status +.Sh DESCRIPTION +The +.Nm +utility sends a signal to the process(es) specified +by the +.Ar pid +operand(s). +If no signal is specified, the +.Cm TERM +signal is used. +.Pp +Only the superuser may send signals to other users' processes. +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl l Op Ar exit_status +Display the name of the signal corresponding to +.Ar exit_status . +.Ar exit_status +may be the exit status of a command killed by a signal +(see the +special +.Xr sh 1 +parameter +.Sq ?\& ) +or a signal number. +.Pp +If no operand is given, display the names of all the signals. +.It Fl Ar signal_number | Fl Ar signal_name | Fl s Ar signal_name +A non-negative decimal integer or a symbolic name +specifying the signal to be sent instead of the default +.Cm TERM . +.El +.Pp +The following PIDs have special meanings: +.Bl -tag -width Ds -offset indent +.It \-1 +If superuser, broadcast the signal to all processes; otherwise, broadcast +to all processes belonging to the user. +.It 0 +Send the signal to all processes whose group ID is equal to the +process group ID of the sender, and for which the process has permission. +.It \- Ns Ar pgid +Send the signal to all processes within the specified process group. +.El +.Pp +Some of the more commonly used signals: +.Pp +.Bl -column MM MMMM -compact -offset indent +.It 1 Ta Cm HUP Ta Pq hang up +.It 2 Ta Cm INT Ta Pq interrupt +.It 3 Ta Cm QUIT Ta Pq quit +.It 6 Ta Cm ABRT Ta Pq abort +.It 9 Ta Cm KILL Ta Pq non-catchable, non-ignorable kill +.It 14 Ta Cm ALRM Ta Pq alarm clock +.It 15 Ta Cm TERM Ta Pq software termination signal +.El +.Pp +For a complete list, consult the +.Xr signal 3 +manual page. +.Pp +A signal number of 0 +.Pq Nm kill Fl 0 Ar pid +does not send a signal, but only checks the validity of a certain PID. +It succeeds if +.Ar pid +exists or raises an error otherwise. +.Sh EXIT STATUS +.Ex -std kill +.Sh EXAMPLES +Forcibly terminate process ID 1234: +.Pp +.Dl $ kill -9 1234 +.Pp +Send the +.Xr init 8 +process the hangup signal, instructing it to re-read +.Xr ttys 5 : +.Pp +.Dl # kill -HUP 1 +.Sh SEE ALSO +.Xr csh 1 , +.Xr ksh 1 , +.Xr pkill 1 , +.Xr ps 1 , +.Xr kill 2 , +.Xr signal 3 +.Sh STANDARDS +The +.Nm +utility is compliant with the +.St -p1003.1-2008 +specification. +.Pp +The +.Fl Ar signal_name +and +.Fl Ar signal_number +syntax is marked by +.St -p1003.1-2008 +as being an +X/Open System Interfaces +option. +.Pp +.Nm +also exists as a built-in to +.Xr csh 1 +and +.Xr ksh 1 , +though with a different syntax. +.Sh HISTORY +A +.Nm +command appeared in +.At v3 . |
