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

FreeBSD Manual Pages

  
 
  

home | help
jkill(8)		     System Manager's Manual			jkill(8)

NAME
     jkill -- stop or restart a jail

SYNOPSIS
     jkill [-fkqv] [-t timeout] jail ...
     jkill -r [-fqv] [-t timeout] jail ...
     halt
     reboot

DESCRIPTION
     The  jkill  utility stops one or more jails in an orderly fashion. It calls
     the  shutdown  scripts  inside  the  jail	and  then  kills  all  remaining
     processes.  When used with the -r option it can also restart the jail.

     jkill  can also be run from within a jail, to shutdown or restart the jail.
     Replace the halt or reboot binaries in your jails	with  jkill  as  a  hard
     link.  Each of these commands will then perform their respective actions in
     the jail.

OPTIONS
     -f 	 Force the processes to quit. If processes remain after  sending
		 them  a  SIGTERM then kill them with SIGKILL which forces the a
		 process exit.

     -k 	 Don't call the shutdown scripts, just kill the processes.

     -q 	 Supress warnings.

     -r 	 After shutting down the jail, restart it by running the /etc/rc
		 startup script.

     -t timeout  Specify a maximum timeout to wait after  running  the	shutdown
		 scripts  and  between the sending the various kill signals. The
		 default is 3 seconds.

     -v 	 Show the output of shutdown or startup scripts on the	console.
		 This also enables all warnings.

     jail	 Either a jail id (which is an integer) or a jail host name.

NOTES
     It's  generally  assumed  that  the  jail in question is a 'full jail' with
     startup and shutdown scripts. If that's not the case use the -k option.

     The startup and shutdown scripts inside the jail must be shell scripts  and
     must be owned by root in order to be executed.

     The  environment  is purged properly before running the scripts in the jail
     in order to prevent unwanted information from leaking into the jail.

     Both startup and shutdown are logged to the jail's console if it exists.

     jkill needs a valid /dev/null device in the jail. If it  doesn't  exit  for
     some reason it is automatically created.

FILES
     /etc/rc /etc/rc.shutdown /dev/console

SEE ALSO
     jail(8), jails(8), jls(8), jstart(8), kill(1)

AUTHOR
     Stef Walter <stef@memberwebs.com>

jkill				   April, 2004				jkill(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=jkill&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help