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

FreeBSD Manual Pages

  
 
  

home | help
jkill(8)		FreeBSD	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 pro-
     cesses.  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 ac-
     tions in the jail.

OPTIONS
     -f		 Force the processes to	quit. If processes remain after	send-
		 ing 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 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 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			       February	26, 2021			 jkill

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | FILES | SEE ALSO | AUTHOR

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

home | help