1CDIST-TYPE__JAIL_FREEBSD10(7)        cdist       CDIST-TYPE__JAIL_FREEBSD10(7)
2
3
4

NAME

6       cdist-type__jail_freeebsd10 - Manage FreeBSD jails
7

DESCRIPTION

9       This type is used on FreeBSD >= 10.0 to manage jails.
10

REQUIRED PARAMETERS

12       state  Either "present" or "absent", defaults to "present".
13
14       jailbase
15              The location of the .tgz archive containing the base fs for your
16              jails.
17

OPTIONAL PARAMETERS

19       name   The name of the jail. Default is to use  the  object_id  as  the
20              jail name.
21
22       ip     The  ifconfig  style  IP/netmask combination to use for the jail
23              guest. If the state parameter is "present,"  this  parameter  is
24              required.
25
26       hostname
27              The FQDN to use for the jail guest. Defaults to the name parame‐
28              ter.
29
30       interface
31              The name of the physical interface on the jail  server  to  bind
32              the  jail to.  Defaults to the first interface found in the out‐
33              put of ifconfig -l.
34
35       devfs-ruleset
36              The name of the  devfs  ruleset  to  associate  with  the  jail.
37              Defaults  to  "jailrules."  This  ruleset  must be copied to the
38              server via another type.  To use this option, devfs-enable  must
39              be "true."
40
41       jaildir
42              The  location  on  the  remote  server  to  use for hosting jail
43              filesystems.  Defaults to /usr/jail.
44

BOOLEAN PARAMETERS

46       stopped
47              Do not start the jail
48
49       devfs-disable
50              Whether to disallow devfs mounting within the jail
51
52       onboot Whether to add the jail to rc.conf's jail_list variable.
53

CAVEATS

55       This type does not currently support modification of jail options.  If,
56       for example a jail needs to have its IP address or netmask changed, the
57       jail must be removed then re-added with the correct IP  address/netmask
58       or  the  appropriate modifications to jail.conf need to be made through
59       alternate means.
60

MESSAGES

62       start  The jail was started
63
64       stop   The jail was stopped
65
66       create:
67              The jail was created
68
69       delete The jail was deleted
70
71       onboot The jail was configured to start on boot
72

EXAMPLES

74          # Create a jail called www
75          __jail_freebsd10 www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
76
77          # Remove the jail called www
78          __jail_freebsd10 www --state absent --jailbase /my/jail/base.tgz
79
80          # The jail www should not be started
81          __jail_freebsd10 www --state present --stopped \
82             --ip "192.168.1.2 netmask 255.255.255.0" \
83             --jailbase /my/jail/base.tgz
84
85          # Use the name variable explicitly
86          __jail_freebsd10 thisjail --state present --name www \
87             --ip "192.168.1.2" \
88             --jailbase /my/jail/base.tgz
89
90          # Go nuts
91          __jail_freebsd10 lotsofoptions --state present --name testjail \
92             --ip "192.168.1.100 netmask 255.255.255.0" \
93             --hostname "testjail.example.com" --interface "em0" \
94             --onboot --jailbase /my/jail/base.tgz --jaildir /jails
95

SEE ALSO

97       jail(8)
98

AUTHORS

100       Jake Guffey <jake.guffey--@--jointheirstm.org>
101

COPYING

103       Copyright (C) 2012-2016 Jake Guffey. You  can  redistribute  it  and/or
104       modify  it  under  the  terms of the GNU General Public License as pub‐
105       lished by the  Free  Software  Foundation,  either  version  3  of  the
106       License, or (at your option) any later version.
107
109       ungleich GmbH 2020
110
111
112
113
1146.9.4                            Dec 21, 2020    CDIST-TYPE__JAIL_FREEBSD10(7)
Impressum