diff options
author | erdgeist <erdgeist@erdgeist.org> | 2011-01-24 20:18:21 +0000 |
---|---|---|
committer | erdgeist <erdgeist@erdgeist.org> | 2011-01-24 20:18:21 +0000 |
commit | 2147da646ebc673be4a95a866cbf5383fd8b739f (patch) | |
tree | 163465396a70f5b4710db0298df7bb2d6605196d /man7 | |
parent | d9ba6ce81145a787852ed08a2b84288eadd04282 (diff) |
Explaining the zfs features of ezjail
Diffstat (limited to 'man7')
-rw-r--r-- | man7/ezjail.7 | 40 |
1 files changed, 37 insertions, 3 deletions
diff --git a/man7/ezjail.7 b/man7/ezjail.7 index 0e87bf5..be258c8 100644 --- a/man7/ezjail.7 +++ b/man7/ezjail.7 | |||
@@ -142,6 +142,34 @@ Image jails may also be encrypted using | |||
142 | or | 142 | or |
143 | .Xr geli 8 , | 143 | .Xr geli 8 , |
144 | depending on the options given at creation time. | 144 | depending on the options given at creation time. |
145 | .Ss Using ZFS | ||
146 | To give more precise control over the resources consumed by a jail, | ||
147 | ezjail allows putting each jail in its own | ||
148 | .Xr zfs 8 | ||
149 | filesystem. See | ||
150 | .Sx Jail Creation Examples | ||
151 | for details. | ||
152 | .Pp | ||
153 | Also, ezjail can be configured to install its basejail | ||
154 | and the accompaning template for all new jails into its own filesystem. | ||
155 | Set the the | ||
156 | .Dq Li $ezjail_use_zfs | ||
157 | variable in your | ||
158 | .Pa ezjail.conf | ||
159 | to | ||
160 | .Dq YES | ||
161 | before running | ||
162 | .Nm Cm update | ||
163 | or | ||
164 | .Nm Cm install . | ||
165 | You may also want to configure the destination | ||
166 | .Xr zpool 8 | ||
167 | using the | ||
168 | .Dq Li $ezjail_jailzfs | ||
169 | variable. | ||
170 | .Pp | ||
171 | You can use ZFS jails without installing the basejail into its own ZFS | ||
172 | filesystem and vice versa. | ||
145 | .Ss Per-Jail options | 173 | .Ss Per-Jail options |
146 | As we saw earlier, a jail is described by a file in | 174 | As we saw earlier, a jail is described by a file in |
147 | .Pa EZJAIL_PREFIX/etc/ezjail/ . | 175 | .Pa EZJAIL_PREFIX/etc/ezjail/ . |
@@ -416,7 +444,7 @@ It is possible to set this variable to | |||
416 | if the administrator wants to temporarily ezjail, or if she doesn't | 444 | if the administrator wants to temporarily ezjail, or if she doesn't |
417 | want the jails to be automatically started on boot. | 445 | want the jails to be automatically started on boot. |
418 | .Pp | 446 | .Pp |
419 | The ezjail system may be reset to a printine state by removing all its | 447 | The ezjail system may be reset to a pristine state by removing all its |
420 | files, that is: | 448 | files, that is: |
421 | .Bl -item -compact | 449 | .Bl -item -compact |
422 | .It | 450 | .It |
@@ -570,7 +598,7 @@ in | |||
570 | An empty directory, | 598 | An empty directory, |
571 | .Pa /usr/jails/sandbox2 , | 599 | .Pa /usr/jails/sandbox2 , |
572 | will be created, and used as a mount point when starting the jail. | 600 | will be created, and used as a mount point when starting the jail. |
573 | .It Nm Cm create Fl i Fl c Cm bde Fl s Ar 600M sandbox3 10.0.10.5 | 601 | .It Nm Cm create Fl c Cm bde Fl s Ar 600M sandbox3 10.0.10.5 |
574 | This creates a new file based image jail, with | 602 | This creates a new file based image jail, with |
575 | .Xr gbde 4 | 603 | .Xr gbde 4 |
576 | encryption. During the gbde creation process you are asked to enter a | 604 | encryption. During the gbde creation process you are asked to enter a |
@@ -579,6 +607,11 @@ process. Remember this passphrase, you will be asked for the | |||
579 | passphrase every time sub-command start is used on this jail. As they | 607 | passphrase every time sub-command start is used on this jail. As they |
580 | require administrator interaction, jails backed by an encrypted file | 608 | require administrator interaction, jails backed by an encrypted file |
581 | are not automatically started when the system boots. | 609 | are not automatically started when the system boots. |
610 | .It Nm Cm create Fl c Ar zfs Fl s Ar 1G sandbox4 10.0.10.6 | ||
611 | This creates a new zfs filesystem based jail with a default quota of 1 | ||
612 | gigabyte using lzjb compression. It uses the zpool configured in the | ||
613 | .Dq Li $ezjail_jailzfs | ||
614 | variable to create the filesystem in. | ||
582 | .El | 615 | .El |
583 | .Sh FILES | 616 | .Sh FILES |
584 | .Pa EZJAIL_PREFIX/bin/ezjail-admin | 617 | .Pa EZJAIL_PREFIX/bin/ezjail-admin |
@@ -596,7 +629,8 @@ are not automatically started when the system boots. | |||
596 | .Xr ezjail-admin 8 , | 629 | .Xr ezjail-admin 8 , |
597 | .Xr ezjail.conf 5 , | 630 | .Xr ezjail.conf 5 , |
598 | .Xr jail 8 , | 631 | .Xr jail 8 , |
599 | .Xr nullfs 4 . | 632 | .Xr nullfs 4 , |
633 | .Xr zfs 8 . | ||
600 | .Pp | 634 | .Pp |
601 | Interesting additional tools include: | 635 | Interesting additional tools include: |
602 | .Dq Li ports-mgmt/jailaudit . | 636 | .Dq Li ports-mgmt/jailaudit . |