.\" Copyright (c) 2001 BalaBit IT Ltd.
.TH JAILER 5 "December 4, 2001"
.SH NAME
jailer.conf \- configuration file of jailer
.SH SYNOPSIS
jailer.conf
.SH DESCRIPTION

.I jailer
is a script for creating chrooted environments for Debian packages.

.I jailer.conf
is the configuration file for jailer.conf

Every configuration definition has to start and end with a jail identifier,
which should be
.I unique
and
.I be in brackets.

.TP
.B <apache>
For example, an Apache chroot identifier should look like this:
.TP
.B </apache>
The identifier use needs to be closed.

The configuration for the chroot instance is defined inside 
these identifiers. The following lines can be used to describe
the configuration:

.TP
.B Root: /var/chroot/apache

This line describes the
.B PATH
of the chrooted enviroment.

.TP
.B Conf:

This line describes the
.B PATH
or
.B PATH/filename
which should be copied over to the chrooted environment. For
example
.B Conf: /etc/apache/*
, which uses a wild card.

.TP
.B Debs:

This line contains the name of those Debian
packages which should be installed into the chrooted environment.

.TP
.B Junk-Debs:

This line contains those
.B deb
packages which should not be installed into the chrooted environment.

.TP
.B Junk:

This line contains those
.B files
or
.B directories
which should not be installed. For example
.B /lib/*
means all files and links under /lib should not be installed, while
.B /lib/libconsole.so.0.0.0
means a file which should not to be installed.

.TP
.B Extra:

This line contains those files or directories which should 
be installed into the chrooted environment. For example: 
.B /var/run
will install that a directory which is needed for the chrooted service.

.SH WARNING

Do not configure your daemon inside your jail, because
.I updatejail
script will wipe out all the data inside the jail. If you would
want to change any settings inside the jail, make the changes in the
original location and then run
.I updatejail
\&. This makes it possible to place a jail even to a ramdisk.


.SH SEE ALSO

updatejail(8) jailer.conf(5), dpkg(8)

.SH AUTHOR

This manual page was written by Péter Höltzl <peter.holtzl@balabit.hu>.