summaryrefslogtreecommitdiff
path: root/man5/ezjail.conf.5
blob: 36b27c431798fe4ff91c4221b521ff24dda0e054 (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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
.TH ezjail.conf 5
.SH NAME
ezjail.conf \- configuration file for ezjail script
.SH DESCRIPTION
The file
.B ezjail.conf
contains settings that control the operation of the ezjail rc script. It is 
also read by the
.B ezjail-admin
utility to figure out where it should perform its actions.
.SH PATH OPTIONS
.TP
.B ezjail_jaildir (str)
Location of jail root directories
.br
.I default: /usr/jails
.TP
.B ezjail_jailtemplate (str)
Location of template jail used to create a new jail
.br
.I default: /usr/jails/newjail
.TP
.B ezjail_jailbase (str)
Location of base jail, the one that is mounted to all jails
.br
.I default: /usr/jails/basejail
.TP
.B ezjail_sourcetree (str)
Location of your copy of FreeBSD's source tree (refer to the
.B ezjail-admin(1)
utility for more information)
.br
.I default: /usr/src
.TP
.B ezjail_portscvsroot (str)
Cvs root to use when checking out or updating the ports tree in base jail
.br
.I default: :pserver:anoncvs@anoncvs.at.FreeBSD.org:/home/ncvs
.TP
.B ezjail_ftphost (str)
This is where the install subcommand defaults to fetch its packages from
.br
.I default: ftp.freebsd.org
.TP
.B ezjail_archivedir (str)
This is the default archive location for the \fIezjail-admin archive\fR command.
.br
.I default: `pwd -P`
.SH JAIL ADMIN OPTIONS
.TP
.B ezjail_default_execute (str)
This is the default command executed in a jail by ezjail-admin console.
.br
.I default: YES
.SH JAIL CREATION OPTIONS
Default options for newly created jails. Used by the
.B ezjail-admin(1)
utility. Be careful about disabling ezjail_mount_enable. (Refer to
.B ezjail-admin(1)
for more information).
.TP
.B ezjail_mount_enable (bool)
Controls whether /etc/fstab.hostname should be executed at jail startup 
time.
.br
.I default: "YES"
.TP
.B ezjail_devfs_enable (bool)
Controls whether newly created jails are given a working
.I /dev
directory. (Refer to
.B devfs(5)
and
.B jail(8)
for more information).
.br
.I default: "YES"
.TP
.B ezjail_devfs_ruleset (str)
Specifies which devfs ruleset should apply for newly created jails. 
(Refer to
.B devfs(5)
and
.N jail(8)
for more information).
.br
.I default: "devfsrules_jail"
.TP
.B ezjail_procfs_enable (bool)
Controls whether newly created jails are given a working
.I /proc
directory. (Refer to
.B procfs(5)
and
.B jail(8)
for more information).
.br
.I default: "YES"
.TP
.B ezjail_fdescfs_enable (bool)
Controls whether newly created jails are given a working
.I /dev/fd/
directory. (Refer to
.B fdescfs(5)
and
.B jail(8)
for more information).
.br
.I default: "YES"
.TP
.B ezjail_uglyperlhack (bool)
Set to YES, if ezjail should provide a soft link from /usr/bin/perl to /usr/local/bin/perl in base jail.
.br
.I default: YES
.TP
.B ezjail_default_flavour (str)
Controls which flavour should be used for newly created jails.
.br
.I default: none
.SH ZFS OPTIONS
.TP
.B ezjail_use_zfs (bool)
Set to YES, if ezjail should manage basejail and newjail in a seperate ZFS-datasets.
.br
.I default: NO
.TP
.B ezjail_jailzfs (str)
The name of the parent ZFS-dataset which ezjail will use to create jails on. It will be mounted at the ezjail_jaildir. Setting this will automaticly enable ezjail managing jails in seperate ZFS-datasets.
.br
.I default: none
.TP
.B ezjail_zfs_properties (str)
Default properties ZFS will use for creating datasets. See zfs(1m) for details. ADVANCED, be very careful!
.br
.I default: none
.SH FILES
EZJAIL_PREFIX/etc/ezjail.conf
.br
EZJAIL_PREFIX/etc/rc.d/ezjail.sh
.SH "SEE ALSO"
ezjail-admin(1), ezjail(5), jail(8), devfs(5), fdescfs(5), procfs(5)
.SH AUTHOR
Dirk Engling <erdgeist@erdgeist.org>