.\" $Id$
.TH PKG_JAIL 1 "April 2010" "FreeBSD" "User Manuals"
.SH NAME
pkg_jail \- Easy handling of a jail for package-builds.
.SH SYNOPSIS
.TP
.B pkg_jail [command]
.SH DESCRIPTION
.B pkg_jail
is a script to handle an clean jail for package-builds.
.SH ARGUMENTS
.TP
.B init
Creates or updates a clean jail with "installworld" and populate /etc inside the jail.
You need to have a sucessful "buildword" made in /usr/src before this.
.TP
.B start
Start the jail as a guest server.
You should have setup sshd inside the jail to login and maintain it with this option.
.TP
.B shell
Start the jail and give a shell back. You can build packages now.
.TP
.B list
Show processes running in the jail.
You need to have /proc mounted (readonly) in the host.
.TP
.B stop
Kill processes running in the jail.
You need to have /proc mounted (readonly) in the host.
.TP
.B restart
Same as "stop" and "start"
.SH "IMPLEMENTATION NOTES"
.TP
.B /proc
/proc will be mounted readonly via procfs inside the jail.
.TP
.B /usr/src
if /usr/src/Makefile does not exists inside the jail,
/usr/src will be mounted readonly via nullfs from the the host into the jail.
.TP
.B pkg_jail_hostname
The hostname of the jail.
.TP
.B pkg_jail_short
A short name for the jail.
.TP
.B pkg_jail_ip
The ip-address for the jail.
.TP
.B pkg_jail_dir
The new root for the jail.
.TP
.B pkg_jail_rule
The rulset number the script uses for the devfs inside the jail.
.SH RETURN VALUES
undefined.
.SH "FILES"
The variables can be set in /etc/rc.conf or in $PREFIX/etc/pkg_jail.conf.
.SH "EXAMPLES"
.B Setting up the Jail Directory Tree
.P
Install all Files with the following comands on the host:
.IP
cd /usr/src && make buildworld
.br
pkg_jail init
.TP
.B Creating a Package
.P
Change to your management directory and execute pkg_upgrade:
.IP
cd /usr/ports/local/update
.br
sh pkg_update make-packages devel/gmake
.SH "SEE ALSO"
.TP
.B pkg_update(1)
The tool to create packages inside the jail.
.SH "HISTORY"
http://www.dinoex.net/training/package.html
.SH "AUTHOR"
Dirk Meyer, dinoex@FreeBSD.org