diff options
| -rwxr-xr-x | man1/ezjail-admin.1 | 69 |
1 files changed, 59 insertions, 10 deletions
diff --git a/man1/ezjail-admin.1 b/man1/ezjail-admin.1 index 1f95a9a..a00494c 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 | [-f flavour] [-r jailroot] [-s imagesize] [-cix] | 7 | [-f flavour] [-r jailroot] [-s imagesize] [-cibx] [-C attachargs] |
| 8 | .I hostname jailip | 8 | .I hostname jailip |
| 9 | 9 | ||
| 10 | .T | 10 | .T |
| @@ -16,6 +16,9 @@ ezjail-admin \- Administrate ezjail | |||
| 16 | .B ezjail-admin list | 16 | .B ezjail-admin list |
| 17 | 17 | ||
| 18 | .T | 18 | .T |
| 19 | .B ezjail-admin install [-mps] [-h host] [-r release] | ||
| 20 | |||
| 21 | .T | ||
| 19 | .B ezjail-admin update | 22 | .B ezjail-admin update |
| 20 | [-s sourcetree] [-i] [-pP] | 23 | [-s sourcetree] [-i] [-pP] |
| 21 | .SH DESCRIPTION | 24 | .SH DESCRIPTION |
| @@ -37,12 +40,9 @@ is created inside this root dir pointing to the newly created jails | |||
| 37 | location. | 40 | location. |
| 38 | 41 | ||
| 39 | The -i and the -c option both require a size passed via the -s option | 42 | The -i and the -c option both require a size passed via the -s option |
| 40 | and create a file based jail image, gbde encrypted for the -c case. The | 43 | and create a file based jail image, gbde or geli encrypted for the -c |
| 41 | image file is named as the jail root suffixed with | 44 | case. The image file is named as the jail root suffixed with |
| 42 | .I .img | 45 | .I .img |
| 43 | , a lock file required for gbde devices is named as the jail root | ||
| 44 | suffixed with | ||
| 45 | .I .lock | ||
| 46 | . | 46 | . |
| 47 | 47 | ||
| 48 | The -x (jail exists) option indicates, that an ezjail already exists | 48 | The -x (jail exists) option indicates, that an ezjail already exists |
| @@ -80,8 +80,57 @@ up on next reboot. | |||
| 80 | If the -w (wipe) option is given, the directory pointed to by the jail | 80 | If the -w (wipe) option is given, the directory pointed to by the jail |
| 81 | root entry is removed as well as the soft link in ezjails root dir. | 81 | root entry is removed as well as the soft link in ezjails root dir. |
| 82 | .SH ezjail-admin list | 82 | .SH ezjail-admin list |
| 83 | lists all jails inside ezjails scope, together with some information on | 83 | lists all jails inside ezjails scope. They are sorted by the order they |
| 84 | them. | 84 | start up, as defined by rcorder. The list format is straight forward. |
| 85 | |||
| 86 | A status flag consisting of 2 or 3 letters, the first meaning | ||
| 87 | .B (D)irectory | ||
| 88 | based, | ||
| 89 | .B (I)mage | ||
| 90 | based, | ||
| 91 | .B (B)de | ||
| 92 | crypto image based, | ||
| 93 | .B (E)li | ||
| 94 | crypto image based. The second one meaning | ||
| 95 | .B (R)unning | ||
| 96 | , | ||
| 97 | .B (A)ttached | ||
| 98 | but not running, | ||
| 99 | .B (S)topped | ||
| 100 | . An optional | ||
| 101 | .B (N)orun | ||
| 102 | stands for disabled jails (see | ||
| 103 | .I ezjail-admin config | ||
| 104 | ). | ||
| 105 | |||
| 106 | Rest of the row is follow by jails jid (if available), its IP, hostname | ||
| 107 | and root directory. | ||
| 108 | .SH ezjail-admin install | ||
| 109 | fetches everything needed to setup a base jail from an FTP server and | ||
| 110 | installs it. | ||
| 111 | |||
| 112 | Default location for ezjails base jail is | ||
| 113 | .I /usr/jails | ||
| 114 | , so be sure you have enough space there (a FreeBSD base without man | ||
| 115 | pages, sources and ports is around 120MB). | ||
| 116 | |||
| 117 | The -m and -s option will fetch and install man pages (ca. 10MB) and | ||
| 118 | sources packages (ca. 450MB) respectively. The -p option invokes the | ||
| 119 | portsnap utility to fetch and extract a FreeBSD ports tree (ca. 475MB). | ||
| 120 | |||
| 121 | Default OS version is, whatever uname -r returns. If this does not match | ||
| 122 | "*-RELEASE", you will be prompted for a better guess. (Normally | ||
| 123 | ftp-servers do not provide release candidates or CURRENT builds). You can | ||
| 124 | use the -r option to specify a releas from command line. | ||
| 125 | |||
| 126 | Default host to fetch packages from is ftp.freebsd.org, you may want to | ||
| 127 | change this via the -h option. If the specified location begins with | ||
| 128 | file://, your local copy of the release is used. That way you can do some | ||
| 129 | modifications to install.sh scripts before executing them. | ||
| 130 | |||
| 131 | You can later update your world from CVS by | ||
| 132 | .U ezjail-admin update | ||
| 133 | or rerun this subcommand with another OS version. | ||
| 85 | .SH ezjail-admin update | 134 | .SH ezjail-admin update |
| 86 | creates or update ezjails basejail. Depending on the parameters | 135 | creates or update ezjails basejail. Depending on the parameters |
| 87 | given it will install a FreeBSD system from a source tree whose location | 136 | given it will install a FreeBSD system from a source tree whose location |
| @@ -91,10 +140,10 @@ config file or via the -s option. | |||
| 91 | 140 | ||
| 92 | If the -p or -P options are given, the base jail also is given a copy of | 141 | If the -p or -P options are given, the base jail also is given a copy of |
| 93 | FreeBSDs ports tree, which is in turn linked into all newly created | 142 | FreeBSDs ports tree, which is in turn linked into all newly created |
| 94 | ezjails. | 143 | ezjails. The portsnap utility is invoked to do the actual work. |
| 95 | 144 | ||
| 96 | If the -P option is given, | 145 | If the -P option is given, |
| 97 | .B only the ports tree will be checked out/updated, | 146 | .B only the ports tree will be updated, |
| 98 | this can be done, while jails are running. | 147 | this can be done, while jails are running. |
| 99 | 148 | ||
| 100 | If the -i (install only) option is given, | 149 | If the -i (install only) option is given, |
