summaryrefslogtreecommitdiff
path: root/man5/ezjail.5
blob: 842af30a78f965606a75947372c426ed33ef1d42 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.TH ezjail 5
.SH NAME
ezjail \- A simple jail setup framework
.SH SYNOPSIS
EZJAIL_PREFIX/etc/rc.d/ezjail.sh
.SH DESCRIPTION
The ezjail framework provides a simple way to create many virtual FreeBSD 
servers by using FreeBSD's jail system. It requires little administration 
effort and aims for minimum system resource usage.

If you are not familiar with the FreeBSD jail concept, please refer to 
jail(8) before continuing.
.SH OVERVIEW
One
.I base jail
is filled with most userland binaries and libraries and then mounted 
read only into a number of stripped down jails via
.B mount_nullfs(8)
- thus saving lots of inodes and memory resources.

.SH INVOCATION
The ezjail script
.B EZJAIL_PREFIX/etc/rc.d/ezjail.sh
takes parameters
.I start, restart
and
.I stop.
It may be passed an additional list of jails. If no jail name is 
specified (usually when the script is being called by rc.local at boot 
and shutdown time), all jails in ezjails config directory are being
started/stopped.

The script then examines its config directory, sets config variables 
for each jail in the jail_list before passing its command on to the
.B /etc/rc.d/jail
script.
.SH NOTES
.B ezjail.sh
enforces the execution of
.B /etc/rc.d/jail,
by prepending
.I "one"
to the start, restart and stop commands so it is
.B NOT NECESSARY
to set
.I jail_enable
in the
.B /etc/rc.conf
config file.
.SH FILES
EZJAIL_PREFIX/etc/ezjail.conf
.br
EZJAIL_PREFIX/etc/rc.d/ezjail.sh
.SH "SEE ALSO"
ezjail-admin(1), ezjail.conf(5), jail(8), mount_nullfs(8)
.SH AUTHOR
Dirk Engling <erdgeist@erdgeist.org>