diff options
Diffstat (limited to 'man1')
| -rwxr-xr-x | man1/ezjail-admin.1 | 50 |
1 files changed, 6 insertions, 44 deletions
diff --git a/man1/ezjail-admin.1 b/man1/ezjail-admin.1 index fd19f55..cb82e85 100755 --- a/man1/ezjail-admin.1 +++ b/man1/ezjail-admin.1 | |||
| @@ -114,8 +114,7 @@ values for having ports in jails is created in the template jail. | |||
| 114 | .SH FLAVOURS | 114 | .SH FLAVOURS |
| 115 | .B ezjail-admin | 115 | .B ezjail-admin |
| 116 | provides an easy way to create many jails with similar or identical | 116 | provides an easy way to create many jails with similar or identical |
| 117 | properties. Currently it supports creating users, installing files and | 117 | properties. |
| 118 | installing packages. | ||
| 119 | 118 | ||
| 120 | A sample flavour config directory resides under | 119 | A sample flavour config directory resides under |
| 121 | .I EZJAIL_PREFIX/share/examples/ezjail/default/. | 120 | .I EZJAIL_PREFIX/share/examples/ezjail/default/. |
| @@ -125,49 +124,12 @@ encouraged to use it as a template for your flavours. | |||
| 125 | If a flavour is selected on jail creation, the flavour root is being | 124 | If a flavour is selected on jail creation, the flavour root is being |
| 126 | copied to the new Jails root, mostly containing an | 125 | copied to the new Jails root, mostly containing an |
| 127 | .I /ezjail.flavour . | 126 | .I /ezjail.flavour . |
| 128 | If the Jail starts up for the first time it runs a setup script found | 127 | If the Jail starts up for the first time this script is run. |
| 129 | at | 128 | |
| 130 | .I /etc/rc.d/ezjail-config.sh. | 129 | In its default form it will create some groups and users, change the |
| 131 | 130 | ownership of some files and installs all packages residing under /pkg. | |
| 132 | This script will create some users specified in the flavour config. | ||
| 133 | It will then chown files specified in the flavour config. (This allows | ||
| 134 | chown-ing files to users only created by the config script.) All | ||
| 135 | packages residing under | ||
| 136 | .I /pkg | ||
| 137 | will be pkg_install-ed. Finally the script | ||
| 138 | .I /ezjail.postinstall | ||
| 139 | is being sourced, if it exists. | ||
| 140 | |||
| 141 | .I ezjail-config.sh | ||
| 142 | then removes all traces, including itself. | ||
| 143 | .SH EZJAIL.FLAVOUR | ||
| 144 | The ezjail.flavour file found in a flavour directory usually provides | ||
| 145 | two variables: | ||
| 146 | |||
| 147 | .B ezjail_flavour_users | ||
| 148 | .br | ||
| 149 | a white space separated list of colon separated entries passed to the | ||
| 150 | pw command after some processing. Refer to the pw(8) man page for more | ||
| 151 | information. Format of an entry in the list is: | ||
| 152 | |||
| 153 | username:uid:group[,group2,..]:gid[,gid2,..]:comment:pw:[-]home:shell | ||
| 154 | |||
| 155 | where each group specified in the group list is being created (with the | ||
| 156 | given gid for each group) if possible and necessary, before the user is | ||
| 157 | added to that group. The character '=' in the comment field is being | ||
| 158 | substituted by ' ' (space) to simplify escaping. The pw is being written | ||
| 159 | verbatim to the passwd db, see pw(8). If the home directory begins with | ||
| 160 | a '-' (dash), it is meant not to be created by the pw command. The dash | ||
| 161 | will of course be removed. It is not possible to specify a shell here | ||
| 162 | that will be installed by a package in /pkg. | ||
| 163 | |||
| 164 | .B ezjail_flavour_files | ||
| 165 | .br | ||
| 166 | a white space separated list of colon separated entries passed to the | ||
| 167 | chown -R command after some processing. Refer to the chown(8) man page | ||
| 168 | for more information. Format of an entry in the list is: | ||
| 169 | 131 | ||
| 170 | user:group:file[:file2...] | 132 | It allows you to add some post install actions. |
| 171 | .SH EXAMPLES | 133 | .SH EXAMPLES |
| 172 | ezjail-admin update -p | 134 | ezjail-admin update -p |
| 173 | .br | 135 | .br |
