From d46d82cf12e890891fcd790d32f57bbf12a982aa Mon Sep 17 00:00:00 2001 From: erdgeist Date: Mon, 21 Nov 2005 17:37:12 +0000 Subject: Flavours introduced --- man1/ezjail-admin.1 | 67 +++++++++++++++++++++++++++++++++++++++++++++++------ 1 file 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 .SH SYNOPSIS .T .B ezjail-admin create -[-r jailroot] [-x] +[-f flavour] [-r jailroot] [-x] .I hostname jailip .T @@ -38,21 +38,36 @@ in situations where you just want to alter some of a jail properties and called ezjail-admin delete without the -w option before. However, sanity checks are being performed. -It then creates an entry in its etc/ezjail/ resource directory allowing -the jail to be brought up after next reboot. +It then creates an entry in its +.I EZJAIL_PREFIX/etc/ezjail/ +resource directory allowing the jail to be brought up after next reboot. -If the ezjail_mount_enable option is set, a /etc/fstab.hostname is -generated, allowing the basejail to be auto-mounted when the jail starts +If the ezjail_mount_enable option is set, a +.I /etc/fstab.hostname +is generated, allowing the basejail to be auto-mounted when the jail starts up. +The newly created Jail can perform some initializiation actions, if the +-f option is given, where flavour is a path to a flavour configuration +file or a short name expanding to +.I EZJAIL_PREFIX/etc/ezjail.flavour. . + +See section +.B FLAVOURS +below for more details. + Options for newly created jails are read from .B ezjail.conf, refer to ezjail.conf(5) for more information. .SH ezjail-admin delete -removes a jail from ezjails etc/ezjail/ resource directory thus preventing +removes a jail from ezjails +.I EZJAIL_PREFIX/etc/ezjail/ +resource directory thus preventing it from being brought up on next reboot. -It then removes the /etc/fstab.hostname entry, if it exists. +It then removes the +.I /etc/fstab.hostname +entry, if it exists. If the -w (wipe) option is given, the directory pointed to by the jail root 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 host system with .B ezjail-admin update is considered a good idea. +.SH FLAVOURS +.B ezjail-admin +provides an easy way to create many Jails with similar or identical +properties. Currently it supports creating users, installing files and +installing packages. + +A sample flavour config file resides under +.I EZJAIL_PREFIX/share/examples/ezjail/ezjail.flavour.default, +the corresponding root is at +.I EZJAIL_PREFIX/share/examples/ezjail/default/. +Some typical Jail initialization actions are demonstrated and you are +encouraged to use it as a template for your flavour configs. + +If a flavour is selected on Jail creation, the Jail executes a config +script on its first startup. This looks for packages under +.I /basejail/config/pkg. +Usually it copies files from +.I /basejail/config/, +you can specify the path in your flavour config file. +.SH EXAMPLES +ezjail-admin update +.br +ezjail-admin create -f httpd -r /jails/web12 web12.test.org 10.0.1.12 +.br +EZJAIL_PREFIX/etc/rc.d/ezjail.sh start web12.test.org +.br +EZJAIL_PREFIX/etc/rc.d/ezjail.sh stop ns.test.org +.br +ezjail-admin delete ns.test.org +.br +ezjail-admin create -x -r /jails/ns ns.test.org 10.0.2.1 +.SH BUGS +.B ezjail-admin +does not perform paranoid checks on its variables. .SH FILES .T4 EZJAIL_PREFIX/etc/ezjail.conf .br EZJAIL_PREFIX/etc/rc.d/ezjail.sh +.br +EZJAIL_PREFIX/share/examples/ezjail/ +.br +EZJAIL_PREFIX/etc/ezjail.flavour.* .SH "SEE ALSO" ezjail(5), ezjail.conf(5), jail(8), devfs(5), fdescfs(5), procfs(5) .SH AUTHOR -- cgit v1.2.3