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	 shut-
		   down	 scripts and between the sending the various kill sig-
		   nals. The default is	3 seconds.

       -v	   Show	the output of shutdown or startup scripts on the  con-
		   sole. 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 ex-
       ists.

       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.0>

home | help