summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorerdgeist <erdgeist@erdgeist.org>2005-11-21 17:37:12 +0000
committererdgeist <erdgeist@erdgeist.org>2005-11-21 17:37:12 +0000
commitd46d82cf12e890891fcd790d32f57bbf12a982aa (patch)
tree3b2f1a967c5a78ee470eaeb822fc9cf44569897c
parent3ba822a7c3a92e0e052881dbc5a786702e1bd973 (diff)
Flavours introduced
-rwxr-xr-xman1/ezjail-admin.167
1 files changed, 60 insertions, 7 deletions
diff --git a/man1/ezjail-admin.1 b/man1/ezjail-admin.1
index 8e42e46..a4d3109 100755
--- a/man1/ezjail-admin.1
+++ b/man1/ezjail-admin.1
@@ -4,7 +4,7 @@ ezjail-admin \- Administrate ezjail
4.SH SYNOPSIS 4.SH SYNOPSIS
5.T 5.T
6.B ezjail-admin create 6.B ezjail-admin create
7[-r jailroot] [-x] 7[-f flavour] [-r jailroot] [-x]
8.I hostname jailip 8.I hostname jailip
9 9
10.T 10.T
@@ -38,21 +38,36 @@ in situations where you just want to alter some of a jail properties and
38called ezjail-admin delete without the -w option before. However, sanity 38called ezjail-admin delete without the -w option before. However, sanity
39checks are being performed. 39checks are being performed.
40 40
41It then creates an entry in its etc/ezjail/ resource directory allowing 41It then creates an entry in its
42the jail to be brought up after next reboot. 42.I EZJAIL_PREFIX/etc/ezjail/
43resource directory allowing the jail to be brought up after next reboot.
43 44
44If the ezjail_mount_enable option is set, a /etc/fstab.hostname is 45If the ezjail_mount_enable option is set, a
45generated, allowing the basejail to be auto-mounted when the jail starts 46.I /etc/fstab.hostname
47is generated, allowing the basejail to be auto-mounted when the jail starts
46up. 48up.
47 49
50The newly created Jail can perform some initializiation actions, if the
51-f <flavour> option is given, where flavour is a path to a flavour configuration
52file or a short name expanding to
53.I EZJAIL_PREFIX/etc/ezjail.flavour.<flavour> .
54
55See section
56.B FLAVOURS
57below for more details.
58
48Options for newly created jails are read from 59Options for newly created jails are read from
49.B ezjail.conf, 60.B ezjail.conf,
50refer to ezjail.conf(5) for more information. 61refer to ezjail.conf(5) for more information.
51.SH ezjail-admin delete 62.SH ezjail-admin delete
52removes a jail from ezjails etc/ezjail/ resource directory thus preventing 63removes a jail from ezjails
64.I EZJAIL_PREFIX/etc/ezjail/
65resource directory thus preventing
53it from being brought up on next reboot. 66it from being brought up on next reboot.
54 67
55It then removes the /etc/fstab.hostname entry, if it exists. 68It then removes the
69.I /etc/fstab.hostname
70entry, if it exists.
56 71
57If the -w (wipe) option is given, the directory pointed to by the jail 72If the -w (wipe) option is given, the directory pointed to by the jail
58root entry is removed as well as the soft link in ezjails root dir. 73root entry is removed as well as the soft link in ezjails root dir.
@@ -89,11 +104,49 @@ host systems world, or at least its kernel. Combining a make world in the
89host system with 104host system with
90.B ezjail-admin update 105.B ezjail-admin update
91is considered a good idea. 106is considered a good idea.
107.SH FLAVOURS
108.B ezjail-admin
109provides an easy way to create many Jails with similar or identical
110properties. Currently it supports creating users, installing files and
111installing packages.
112
113A sample flavour config file resides under
114.I EZJAIL_PREFIX/share/examples/ezjail/ezjail.flavour.default,
115the corresponding root is at
116.I EZJAIL_PREFIX/share/examples/ezjail/default/.
117Some typical Jail initialization actions are demonstrated and you are
118encouraged to use it as a template for your flavour configs.
119
120If a flavour is selected on Jail creation, the Jail executes a config
121script on its first startup. This looks for packages under
122.I /basejail/config/pkg.
123Usually it copies files from
124.I /basejail/config/<flavour>,
125you can specify the path in your flavour config file.
126.SH EXAMPLES
127ezjail-admin update
128.br
129ezjail-admin create -f httpd -r /jails/web12 web12.test.org 10.0.1.12
130.br
131EZJAIL_PREFIX/etc/rc.d/ezjail.sh start web12.test.org
132.br
133EZJAIL_PREFIX/etc/rc.d/ezjail.sh stop ns.test.org
134.br
135ezjail-admin delete ns.test.org
136.br
137ezjail-admin create -x -r /jails/ns ns.test.org 10.0.2.1
138.SH BUGS
139.B ezjail-admin
140does not perform paranoid checks on its variables.
92.SH FILES 141.SH FILES
93.T4 142.T4
94EZJAIL_PREFIX/etc/ezjail.conf 143EZJAIL_PREFIX/etc/ezjail.conf
95.br 144.br
96EZJAIL_PREFIX/etc/rc.d/ezjail.sh 145EZJAIL_PREFIX/etc/rc.d/ezjail.sh
146.br
147EZJAIL_PREFIX/share/examples/ezjail/
148.br
149EZJAIL_PREFIX/etc/ezjail.flavour.*
97.SH "SEE ALSO" 150.SH "SEE ALSO"
98ezjail(5), ezjail.conf(5), jail(8), devfs(5), fdescfs(5), procfs(5) 151ezjail(5), ezjail.conf(5), jail(8), devfs(5), fdescfs(5), procfs(5)
99.SH AUTHOR 152.SH AUTHOR