diff options
Diffstat (limited to 'man1/ezjail-admin.1')
-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 |