81 lines
6 KiB
HTML
81 lines
6 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>cdist-type__jail(7)</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.77.1" /></head><body><div xml:lang="en" class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="idp185312"></a>cdist-type__jail(7)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Jake</span> <span class="surname">Guffey</span></h3><code class="email"><<a class="email" href="mailto:jake.guffey--@--eprotex.com">jake.guffey--@--eprotex.com</a>></code></div></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="section"><a href="#_name">1. NAME</a></span></dt><dt><span class="section"><a href="#_description">2. DESCRIPTION</a></span></dt><dt><span class="section"><a href="#_required_parameters">3. REQUIRED PARAMETERS</a></span></dt><dt><span class="section"><a href="#_optional_parameters">4. OPTIONAL PARAMETERS</a></span></dt><dt><span class="section"><a href="#_caveats">5. CAVEATS</a></span></dt><dt><span class="section"><a href="#_examples">6. EXAMPLES</a></span></dt><dt><span class="section"><a href="#_see_also">7. SEE ALSO</a></span></dt><dt><span class="section"><a href="#_copying">8. COPYING</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_name"></a>1. NAME</h2></div></div></div><p>cdist-type__jail - Manage FreeBSD jails</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_description"></a>2. DESCRIPTION</h2></div></div></div><p>This type is used on FreeBSD to manage jails.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_required_parameters"></a>3. REQUIRED PARAMETERS</h2></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">
|
||
state
|
||
</span></dt><dd>
|
||
Either "present" or "absent."
|
||
</dd><dt><span class="term">
|
||
jailbase
|
||
</span></dt><dd>
|
||
The location of the .tgz archive containing the base fs for your jails.
|
||
</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_optional_parameters"></a>4. OPTIONAL PARAMETERS</h2></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">
|
||
name
|
||
</span></dt><dd>
|
||
The name of the jail. Default is to use the object_id as the jail name.
|
||
</dd><dt><span class="term">
|
||
started
|
||
</span></dt><dd>
|
||
Either "true" or "false." Defaults to true.
|
||
</dd><dt><span class="term">
|
||
ip
|
||
</span></dt><dd>
|
||
The ifconfig style IP/netmask combination to use for the jail guest. If
|
||
the state parameter is "present," this parameter is required.
|
||
</dd><dt><span class="term">
|
||
hostname
|
||
</span></dt><dd>
|
||
The FQDN to use for the jail guest. Defaults to the name parameter.
|
||
</dd><dt><span class="term">
|
||
interface
|
||
</span></dt><dd>
|
||
The name of the physical interface on the jail server to bind the jail to.
|
||
Defaults to the first interface found in the output of ifconfig -l.
|
||
</dd><dt><span class="term">
|
||
devfs-enable
|
||
</span></dt><dd>
|
||
Whether to allow devfs mounting within the jail. Must be "true" or "false."
|
||
Defaults to true.
|
||
</dd><dt><span class="term">
|
||
devfs-ruleset
|
||
</span></dt><dd>
|
||
The name of the devfs ruleset to associate with the jail. Defaults to
|
||
"jailrules." This ruleset must be copied to the server via another type.
|
||
To use this option, devfs-enable must be "true."
|
||
</dd><dt><span class="term">
|
||
onboot
|
||
</span></dt><dd>
|
||
Whether to add the jail to rc.conf’s jail_list variable. Must be either
|
||
"true" or "false." Defaults to false.
|
||
</dd><dt><span class="term">
|
||
jaildir
|
||
</span></dt><dd>
|
||
The location on the remote server to use for hosting jail filesystems.
|
||
Defaults to /usr/jail.
|
||
</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_caveats"></a>5. CAVEATS</h2></div></div></div><p>This type does not currently support modification of jail options. If, for
|
||
example a jail needs to have its IP address or netmask changed, the jail must
|
||
be removed then re-added with the correct IP address/netmask or the appropriate
|
||
line (jail_<name>_ip="…") modified within rc.conf through some alternate
|
||
means.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_examples"></a>6. EXAMPLES</h2></div></div></div><pre class="screen"># Create a jail called www
|
||
__jail www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
|
||
|
||
# Remove the jail called www
|
||
__jail www --state absent --jailbase /my/jail/base.tgz
|
||
|
||
# Ensure that the jail called www is started
|
||
__jail www --state present --started true \
|
||
--ip "192.168.1.2 netmask 255.255.255.0" \
|
||
--jailbase /my/jail/base.tgz
|
||
|
||
# Use the name variable explicitly
|
||
__jail thisjail --state present --name www \
|
||
--ip "192.168.1.2" \
|
||
--jailbase /my/jail/base.tgz
|
||
|
||
# Go nuts
|
||
__jail lotsofoptions --state present --name testjail --started true \
|
||
--ip "192.168.1.100 netmask 255.255.255.0" \
|
||
--hostname "testjail.example.com" --interface "em0" \
|
||
--onboot yes --jailbase /my/jail/base.tgz --jaildir /jails</pre></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_see_also"></a>7. SEE ALSO</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
|
||
cdist-type(7)
|
||
</li></ul></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_copying"></a>8. COPYING</h2></div></div></div><p>Copyright (C) 2012 Jake Guffey. Free use of this software is
|
||
granted under the terms of the GNU General Public License version 3 (GPLv3).</p></div></div></body></html>
|