summaryrefslogtreecommitdiff
path: root/man5/ezjail.5
blob: aaef3f004150557e4fff09aaad780cb17e752330 (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
58
59
.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, startcrypto, 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 scope, except crypto image
jails, are being started/stopped. To start all crytpo image jails, use
the
.I startcrypto
parameter.

The script examines its config, sets 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>