.\" Process this file with 
.\" groff -mdoc -Tascii jkill.8
.\"
.Dd April, 2004
.Dt jkill 8
.Os jkill 
.Sh NAME
.Nm jkill
.Nd stop or restart a jail
.Sh SYNOPSIS
.Nm
.Op Fl fkqv
.Op Fl t Ar timeout
.Ar jail ...
.Nm
.Fl r
.Op Fl fqv
.Op Fl t Ar timeout
.Ar jail ...
.Sh DESCRIPTION
The 
.Nm 
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 
.Fl r
option it can also restart the jail. 
.Pp
.Sh OPTIONS
.Bl -tag -width ".Fl u Ar timeout"
.It Fl 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.
.It Fl k
Don't call the shutdown scripts, just kill the processes.
.It Fl q
Supress warnings.
.It Fl r
After shutting down the jail, restart it by running the
.Pa /etc/rc
startup script.
.It Fl t Ar 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.
.It Fl v 
Show the output of shutdown or startup scripts on the console. This also
enables all warnings. 
.It Ar jail
Either a jail id (which is an integer) or a jail host name.
.El
.Sh 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 
.Fl k
option.
.Pp
The startup and shutdown scripts inside the jail must be shell scripts 
and must be owned by root in order to be executed.
.Pp
The environment is purged properly before running the scripts in the 
jail in order to prevent unwanted information from leaking into the
jail.
.Sh FILES
.Pa /etc/rc
.Pa /etc/rc.shutdown
.Sh SEE ALSO
.Xr jail 8 ,
.Xr jails 8 ,
.Xr jls 8 ,
.Xr jstart 8 ,
.Xr kill 1
.Sh AUTHOR
.An Nate Nielsen Aq nielsen@memberwebs.com