Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
KILL(1)			FreeBSD	General	Commands Manual		       KILL(1)

NAME
     kill -- terminate or signal a process

SYNOPSIS
     kill [-s signal_name] pid ...
     kill -l [exit_status]
     kill -signal_name pid ...
     kill -signal_number pid ...

DESCRIPTION
     The kill utility sends a signal to	the process(es)	specified by the pid
     operand(s).  If no	signal is specified, SIGTERM is	used.

     Only the superuser	may send signals to other users' processes.

     The options are as	follows:

     -l	[exit_status]
	     Display the name of the signal corresponding to exit_status.
	     exit_status may be	the exit status	of a command killed by a sig-
	     nal (see the special sh(1)	parameter `?') or a signal number.

	     If	no operand is given, display the names of all the signals.

     -s	signal_name
	     A symbolic	signal name specifying the signal to be	sent instead
	     of	the default SIGTERM.

     -signal_name
	     A symbolic	signal name specifying the signal to be	sent instead
	     of	the default SIGTERM.

     -signal_number
	     A non-negative decimal integer specifying the signal to be	sent
	     instead of	the default SIGTERM.

     The following PIDs	have special meanings:

	   -1	   If superuser, broadcast the signal to all processes;	other-
		   wise, broadcast to all processes belonging to the user.

	   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.

	   -pgid   Send	the signal to all processes within the specified
		   process group.

     Some of the more commonly used signals:

	   1	   HUP (hang up)
	   2	   INT (interrupt)
	   3	   QUIT	(quit)
	   6	   ABRT	(abort)
	   9	   KILL	(non-catchable,	non-ignorable kill)
	   14	   ALRM	(alarm clock)
	   15	   TERM	(software termination signal)

     For a more	complete list, consult the sigaction(2)	manual page.

     A signal number of	0 (kill	-0 pid)	checks the validity of a certain PID,
     to	see if it exists.  An exit code	of 0 means that	the specified process
     exists.

EXIT STATUS
     The kill utility exits 0 on success, and >0 if an error occurs.

EXAMPLES
     Forcibly terminate	process	ID 1234:

	   $ kill -9 1234

     Send the init(8) process the hangup signal, instructing it	to re-read
     ttys(5):

	   # kill -HUP 1

SEE ALSO
     csh(1), ksh(1), pkill(1), ps(1), kill(2), sigaction(2)

STANDARDS
     The kill utility is compliant with	the IEEE Std 1003.1-2008 ("POSIX.1")
     specification.

     The -signal_name and -signal_number syntax	is marked by IEEE Std
     1003.1-2008 ("POSIX.1") as	being an X/Open	System Interfaces option.

     kill also exists as a built-in to csh(1) and ksh(1), though with a	dif-
     ferent syntax.

HISTORY
     A kill command appeared in	Version	3 AT&T UNIX.

FreeBSD	13.0		       February	9, 2020			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | SEE ALSO | STANDARDS | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=kill&sektion=1&manpath=OpenBSD+6.9>

home | help