diff --git a/src/extra/manual/beta/_sources/cdist-install.rst.txt b/src/extra/manual/beta/_sources/cdist-install.rst.txt index 18863145..390ab9ec 100644 --- a/src/extra/manual/beta/_sources/cdist-install.rst.txt +++ b/src/extra/manual/beta/_sources/cdist-install.rst.txt @@ -12,7 +12,7 @@ This is the machine from which you will configure target hosts. * /bin/sh: A POSIX like shell (for instance bash, dash, zsh) * Python >= 3.5 * SSH client - * sphinx (for building html docs and/or the man pages) + * sphinx with the rtd theme (for building html docs and/or the man pages) Target Hosts ~~~~~~~~~~~~ diff --git a/src/extra/manual/beta/_sources/cdist-reference.rst.txt b/src/extra/manual/beta/_sources/cdist-reference.rst.txt index 51a50a29..c296c282 100644 --- a/src/extra/manual/beta/_sources/cdist-reference.rst.txt +++ b/src/extra/manual/beta/_sources/cdist-reference.rst.txt @@ -143,6 +143,7 @@ The following types are available: - __apt_key_uri (`cdist-type__apt_key_uri(7) `_) - __apt_mark (`cdist-type__apt_mark(7) `_) - __apt_norecommends (`cdist-type__apt_norecommends(7) `_) +- __apt_pin (`cdist-type__apt_pin(7) `_) - __apt_ppa (`cdist-type__apt_ppa(7) `_) - __apt_source (`cdist-type__apt_source(7) `_) - __apt_unattended_upgrades (`cdist-type__apt_unattended_upgrades(7) `_) diff --git a/src/extra/manual/beta/_sources/cdist-scan.rst.txt b/src/extra/manual/beta/_sources/cdist-scan.rst.txt index 064e65ff..86b7fab6 100644 --- a/src/extra/manual/beta/_sources/cdist-scan.rst.txt +++ b/src/extra/manual/beta/_sources/cdist-scan.rst.txt @@ -57,6 +57,7 @@ resolved name to stdout - if any. The script must be executable. Simplest script: .. code-block:: sh + #!/bin/sh case "$1" in @@ -71,6 +72,7 @@ Simplest script: Resolving name from `PTR` DNS record: .. code-block:: sh + #!/bin/sh for cmd in dig sed; do diff --git a/src/extra/manual/beta/_sources/cdist-types.rst.txt b/src/extra/manual/beta/_sources/cdist-types.rst.txt index 9cd8ffdb..009b6ddf 100644 --- a/src/extra/manual/beta/_sources/cdist-types.rst.txt +++ b/src/extra/manual/beta/_sources/cdist-types.rst.txt @@ -11,6 +11,7 @@ cdist types __apt_key_uri __apt_mark __apt_norecommends + __apt_pin __apt_ppa __apt_source __apt_unattended_upgrades diff --git a/src/extra/manual/beta/_sources/man7/cdist-type__apt_pin.rst.txt b/src/extra/manual/beta/_sources/man7/cdist-type__apt_pin.rst.txt new file mode 100644 index 00000000..4229c0cd --- /dev/null +++ b/src/extra/manual/beta/_sources/man7/cdist-type__apt_pin.rst.txt @@ -0,0 +1,79 @@ +cdist-type__apt_pin(7) +====================== + +NAME +---- +cdist-type__apt_pin - Manage apt pinning rules + + +DESCRIPTION +----------- +Adds/removes/edits rules to pin some packages to a specific distribution. Useful if using multiple debian repositories at the same time. (Useful, if one wants to use a few specific packages from backports or perhaps Debain testing... or even sid.) + + +REQUIRED PARAMETERS +------------------- +distribution + Specifies what distribution the package should be pinned to. Accepts both codenames (buster/bullseye/sid) and suite names (stable/testing/...). + + +OPTIONAL PARAMETERS +------------------- +package + Package name, glob or regular expression to match (multiple) packages. If not specified `__object_id` is used. + +priority + The priority value to assign to matching packages. Deafults to 500. (To match the default target distro's priority) + +state + Will be passed to underlying `__file` type; see there for valid values and defaults. + + + +BOOLEAN PARAMETERS +------------------ +None. + + +EXAMPLES +-------- + +.. code-block:: sh + + # Add the bullseye repo to buster, but do not install any packages by default, + # only if explicitely asked for (-1 means "never" for apt) + __apt_pin bullseye-default \ + --package "*" \ + --distribution bullseye \ + --priority -1 + + require="__apt_pin/bullseye-default" __apt_source bullseye \ + --uri http://deb.debian.org/debian/ \ + --distribution bullseye \ + --component main + + __apt_pin foo --package "foo foo-*" --distribution bullseye + + __foo # Assuming, this installs the `foo` package internally + + __package foo-plugin-extras # Assuming we also need some extra stuff + + +SEE ALSO +-------- +:strong:`apt_preferences`\ (5) +:strong:`cdist-type__apt_source`\ (7) +:strong:`cdist-type__apt_backports`\ (7) +:strong:`cdist-type__file`\ (7) + +AUTHORS +------- +Daniel Fancsali + + +COPYING +------- +Copyright \(C) 2021 Daniel Fancsali. You can redistribute it +and/or modify it under the terms of the GNU General Public License as +published by the Free Software Foundation, either version 3 of the +License, or (at your option) any later version. diff --git a/src/extra/manual/beta/_sources/man7/cdist-type__rsync.rst.txt b/src/extra/manual/beta/_sources/man7/cdist-type__rsync.rst.txt index 94b06d63..88019c92 100644 --- a/src/extra/manual/beta/_sources/man7/cdist-type__rsync.rst.txt +++ b/src/extra/manual/beta/_sources/man7/cdist-type__rsync.rst.txt @@ -3,112 +3,73 @@ cdist-type__rsync(7) NAME ---- -cdist-type__rsync - Mirror directories using rsync +cdist-type__rsync - Mirror directories using ``rsync`` DESCRIPTION ----------- -WARNING: This type is of BETA quality: - -- it has not been tested widely -- interfaces *may* change -- if there is a better approach to solve the problem -> the type may even vanish - -If you are fine with these constraints, please read on. - - -This cdist type allows you to mirror local directories to the -target host using rsync. Rsync will be installed in the manifest of the type. -If group or owner are giveng, a recursive chown will be executed on the -target host. - -A slash will be appended to the source directory so that only the contents -of the directory are taken and not the directory name itself. +The purpose of this type is to bring power of ``rsync`` into ``cdist``. REQUIRED PARAMETERS ------------------- source - Where to take files from + Source directory in local machine. + If source is directory, slash (``/``) will be added to source and destination paths. OPTIONAL PARAMETERS ------------------- -group - Group to chgrp to. +destination + Destination directory. Defaults to ``$__object_id``. owner - User to chown to. + Will be passed to ``rsync`` as ``--chown=OWNER``. + Read ``rsync(1)`` for more details. -destination - Use this as the base destination instead of the object id +group + Will be passed to ``rsync`` as ``--chown=:GROUP``. + Read ``rsync(1)`` for more details. + +mode + Will be passed to ``rsync`` as ``--chmod=MODE``. + Read ``rsync(1)`` for more details. + +options + Defaults to ``--recursive --links --perms --times``. + Due to `bug in Python's argparse`_, value must be prefixed with ``\``. remote-user - Use this user instead of the default "root" for rsync operations. + Defaults to ``root``. OPTIONAL MULTIPLE PARAMETERS ---------------------------- -rsync-opts - Use this option to give rsync options with. - See rsync(1) for available options. - Only "--" options are supported. - Write the options without the beginning "--" - Can be specified multiple times. - - -MESSAGES --------- -NONE +option + Pass additional options to ``rsync``. + See ``rsync(1)`` for all possible options. + Due to `bug in Python's argparse`_, value must be prefixed with ``\``. EXAMPLES -------- - .. code-block:: sh - # You can use any source directory - __rsync /tmp/testdir \ - --source /etc - - # Use source from type - __rsync /etc \ - --source "$__type/files/package" - - # Allow multiple __rsync objects to write to the same dir - __rsync mystuff \ - --destination /usr/local/bin \ - --source "$__type/files/package" - - __rsync otherstuff \ - --destination /usr/local/bin \ - --source "$__type/files/package2" - - # Use rsync option --exclude - __rsync /tmp/testdir \ - --source /etc \ - --rsync-opts exclude=sshd_conf - - # Use rsync with multiple options --exclude --dry-run - __rsync /tmp/testing \ - --source /home/tester \ - --rsync-opts exclude=id_rsa \ - --rsync-opts dry-run - - -SEE ALSO --------- -:strong:`rsync`\ (1) + __rsync /var/www/example.com \ + --owner root \ + --group www-data \ + --mode 'D750,F640' \ + --source "$__files/example.com/www" AUTHORS ------- -Nico Schottelius +Ander Punnar COPYING ------- -Copyright \(C) 2015 Nico Schottelius. You can redistribute it -and/or modify it under the terms of the GNU General Public License as -published by the Free Software Foundation, either version 3 of the -License, or (at your option) any later version. +Copyright \(C) 2021 Ander Punnar. You can redistribute it and/or modify it +under the terms of the GNU General Public License as published by the Free +Software Foundation, either version 3 of the License, or (at your option) +any later version. diff --git a/src/extra/manual/beta/_sources/man7/cdist-type__snakeoil_cert.rst.txt b/src/extra/manual/beta/_sources/man7/cdist-type__snakeoil_cert.rst.txt index 0b547804..b0b0a2e9 100644 --- a/src/extra/manual/beta/_sources/man7/cdist-type__snakeoil_cert.rst.txt +++ b/src/extra/manual/beta/_sources/man7/cdist-type__snakeoil_cert.rst.txt @@ -38,6 +38,7 @@ cert-path EXAMPLES -------- .. code-block:: sh + __snakeoil_cert localhost-rsa \ --common-name localhost \ --key-type rsa:4096 diff --git a/src/extra/manual/beta/_static/css/badge_only.css b/src/extra/manual/beta/_static/css/badge_only.css index 3c33cef5..e380325b 100644 --- a/src/extra/manual/beta/_static/css/badge_only.css +++ b/src/extra/manual/beta/_static/css/badge_only.css @@ -1 +1 @@ -.fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url("../fonts/fontawesome-webfont.eot");src:url("../fonts/fontawesome-webfont.eot?#iefix") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff") format("woff"),url("../fonts/fontawesome-webfont.ttf") format("truetype"),url("../fonts/fontawesome-webfont.svg#FontAwesome") format("svg")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:""}.icon-book:before{content:""}.fa-caret-down:before{content:""}.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.icon-caret-up:before{content:""}.fa-caret-left:before{content:""}.icon-caret-left:before{content:""}.fa-caret-right:before{content:""}.icon-caret-right:before{content:""}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}} +.fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}} \ No newline at end of file diff --git a/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Bold.woff b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Bold.woff new file mode 100644 index 00000000..6cb60000 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Bold.woff differ diff --git a/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Bold.woff2 b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Bold.woff2 new file mode 100644 index 00000000..7059e231 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Bold.woff2 differ diff --git a/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Regular.woff b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Regular.woff new file mode 100644 index 00000000..f815f63f Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Regular.woff differ diff --git a/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Regular.woff2 b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Regular.woff2 new file mode 100644 index 00000000..f2c76e5b Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/Roboto-Slab-Regular.woff2 differ diff --git a/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.eot b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.eot new file mode 100644 index 00000000..e9f60ca9 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.eot differ diff --git a/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.svg b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.svg new file mode 100644 index 00000000..855c845e --- /dev/null +++ b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.svg @@ -0,0 +1,2671 @@ + + + + +Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016 + By ,,, +Copyright Dave Gandy 2016. All rights reserved. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.ttf b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.ttf new file mode 100644 index 00000000..35acda2f Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.ttf differ diff --git a/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.woff b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.woff new file mode 100644 index 00000000..400014a4 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.woff differ diff --git a/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.woff2 b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.woff2 new file mode 100644 index 00000000..4d13fc60 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/fontawesome-webfont.woff2 differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-bold-italic.woff b/src/extra/manual/beta/_static/css/fonts/lato-bold-italic.woff new file mode 100644 index 00000000..88ad05b9 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-bold-italic.woff differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-bold-italic.woff2 b/src/extra/manual/beta/_static/css/fonts/lato-bold-italic.woff2 new file mode 100644 index 00000000..c4e3d804 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-bold-italic.woff2 differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-bold.woff b/src/extra/manual/beta/_static/css/fonts/lato-bold.woff new file mode 100644 index 00000000..c6dff51f Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-bold.woff differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-bold.woff2 b/src/extra/manual/beta/_static/css/fonts/lato-bold.woff2 new file mode 100644 index 00000000..bb195043 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-bold.woff2 differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-normal-italic.woff b/src/extra/manual/beta/_static/css/fonts/lato-normal-italic.woff new file mode 100644 index 00000000..76114bc0 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-normal-italic.woff differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-normal-italic.woff2 b/src/extra/manual/beta/_static/css/fonts/lato-normal-italic.woff2 new file mode 100644 index 00000000..3404f37e Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-normal-italic.woff2 differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-normal.woff b/src/extra/manual/beta/_static/css/fonts/lato-normal.woff new file mode 100644 index 00000000..ae1307ff Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-normal.woff differ diff --git a/src/extra/manual/beta/_static/css/fonts/lato-normal.woff2 b/src/extra/manual/beta/_static/css/fonts/lato-normal.woff2 new file mode 100644 index 00000000..3bf98433 Binary files /dev/null and b/src/extra/manual/beta/_static/css/fonts/lato-normal.woff2 differ diff --git a/src/extra/manual/beta/_static/css/theme.css b/src/extra/manual/beta/_static/css/theme.css index aed8cef0..8cd4f101 100644 --- a/src/extra/manual/beta/_static/css/theme.css +++ b/src/extra/manual/beta/_static/css/theme.css @@ -1,6 +1,4 @@ -/* sphinx_rtd_theme version 0.4.3 | MIT license */ -/* Built 20190212 16:02 */ -*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}audio:not([controls]){display:none}[hidden]{display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:hover,a:active{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;color:#000;text-decoration:none}mark{background:#ff0;color:#000;font-style:italic;font-weight:bold}pre,code,.rst-content tt,.rst-content code,kbd,samp{font-family:monospace,serif;_font-family:"courier new",monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:before,q:after{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}ul,ol,dl{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure{margin:0}form{margin:0}fieldset{border:0;margin:0;padding:0}label{cursor:pointer}legend{border:0;*margin-left:-7px;padding:0;white-space:normal}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0;*width:13px;*height:13px}input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none !important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{html,body,section{background:none !important}*{box-shadow:none !important;text-shadow:none !important;filter:none !important;-ms-filter:none !important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:""}pre,blockquote{page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}img{max-width:100% !important}@page{margin:.5cm}p,h2,.rst-content .toctree-wrapper p.caption,h3{orphans:3;widows:3}h2,.rst-content .toctree-wrapper p.caption,h3{page-break-after:avoid}}.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content .code-block-caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition,.btn,input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"],select,textarea,.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a,.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a,.wy-nav-top a{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}/*! +html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}[hidden],audio:not([controls]){display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;text-decoration:none}ins,mark{color:#000}mark{background:#ff0;font-style:italic;font-weight:700}.rst-content code,.rst-content tt,code,kbd,pre,samp{font-family:monospace,serif;_font-family:courier new,monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:after,q:before{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}dl,ol,ul{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure,form{margin:0}label{cursor:pointer}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=button],input[type=reset],input[type=submit]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}textarea{resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none!important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{body,html,section{background:none!important}*{box-shadow:none!important;text-shadow:none!important;filter:none!important;-ms-filter:none!important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="#"]:after,a[href^="javascript:"]:after{content:""}blockquote,pre{page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}@page{margin:.5cm}.rst-content .toctree-wrapper>p.caption,h2,h3,p{orphans:3;widows:3}.rst-content .toctree-wrapper>p.caption,h2,h3{page-break-after:avoid}}.btn,.fa:before,.icon:before,.rst-content .admonition,.rst-content .admonition-title:before,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .code-block-caption .headerlink:before,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-alert,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a,.wy-menu-vertical li.current>a span.toctree-expand:before,.wy-menu-vertical li.on a,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li span.toctree-expand:before,.wy-nav-top a,.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a,input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}/*! * Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License) - */@font-face{font-family:'FontAwesome';src:url("../fonts/fontawesome-webfont.eot?v=4.7.0");src:url("../fonts/fontawesome-webfont.eot?#iefix&v=4.7.0") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff2?v=4.7.0") format("woff2"),url("../fonts/fontawesome-webfont.woff?v=4.7.0") format("woff"),url("../fonts/fontawesome-webfont.ttf?v=4.7.0") format("truetype"),url("../fonts/fontawesome-webfont.svg?v=4.7.0#fontawesomeregular") format("svg");font-weight:normal;font-style:normal}.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content .code-block-caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.3333333333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.2857142857em;text-align:center}.fa-ul{padding-left:0;margin-left:2.1428571429em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.1428571429em;width:2.1428571429em;top:.1428571429em;text-align:center}.fa-li.fa-lg{left:-1.8571428571em}.fa-border{padding:.2em .25em .15em;border:solid 0.08em #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa.fa-pull-left,.wy-menu-vertical li span.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-left.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-left.toctree-expand,.rst-content .fa-pull-left.admonition-title,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content dl dt .fa-pull-left.headerlink,.rst-content p.caption .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.rst-content code.download span.fa-pull-left:first-child,.fa-pull-left.icon{margin-right:.3em}.fa.fa-pull-right,.wy-menu-vertical li span.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-right.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-right.toctree-expand,.rst-content .fa-pull-right.admonition-title,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content dl dt .fa-pull-right.headerlink,.rst-content p.caption .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.rst-content code.download span.fa-pull-right:first-child,.fa-pull-right.icon{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.wy-menu-vertical li span.pull-left.toctree-expand,.wy-menu-vertical li.on a span.pull-left.toctree-expand,.wy-menu-vertical li.current>a span.pull-left.toctree-expand,.rst-content .pull-left.admonition-title,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content dl dt .pull-left.headerlink,.rst-content p.caption .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content .code-block-caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.rst-content code.download span.pull-left:first-child,.pull-left.icon{margin-right:.3em}.fa.pull-right,.wy-menu-vertical li span.pull-right.toctree-expand,.wy-menu-vertical li.on a span.pull-right.toctree-expand,.wy-menu-vertical li.current>a span.pull-right.toctree-expand,.rst-content .pull-right.admonition-title,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content dl dt .pull-right.headerlink,.rst-content p.caption .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content .code-block-caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.rst-content code.download span.pull-right:first-child,.pull-right.icon{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s infinite linear;animation:fa-spin 2s infinite linear}.fa-pulse{-webkit-animation:fa-spin 1s infinite steps(8);animation:fa-spin 1s infinite steps(8)}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scale(-1, 1);-ms-transform:scale(-1, 1);transform:scale(-1, 1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scale(1, -1);-ms-transform:scale(1, -1);transform:scale(1, -1)}:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270,:root .fa-flip-horizontal,:root .fa-flip-vertical{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-remove:before,.fa-close:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-gear:before,.fa-cog:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-rotate-right:before,.fa-repeat:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-photo:before,.fa-image:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.rst-content .admonition-title:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-warning:before,.fa-exclamation-triangle:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-gears:before,.fa-cogs:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-save:before,.fa-floppy-o:before{content:""}.fa-square:before{content:""}.fa-navicon:before,.fa-reorder:before,.fa-bars:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.wy-dropdown .caret:before,.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-unsorted:before,.fa-sort:before{content:""}.fa-sort-down:before,.fa-sort-desc:before{content:""}.fa-sort-up:before,.fa-sort-asc:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-legal:before,.fa-gavel:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-flash:before,.fa-bolt:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-paste:before,.fa-clipboard:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-unlink:before,.fa-chain-broken:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-toggle-down:before,.fa-caret-square-o-down:before{content:""}.fa-toggle-up:before,.fa-caret-square-o-up:before{content:""}.fa-toggle-right:before,.fa-caret-square-o-right:before{content:""}.fa-euro:before,.fa-eur:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-rupee:before,.fa-inr:before{content:""}.fa-cny:before,.fa-rmb:before,.fa-yen:before,.fa-jpy:before{content:""}.fa-ruble:before,.fa-rouble:before,.fa-rub:before{content:""}.fa-won:before,.fa-krw:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-toggle-left:before,.fa-caret-square-o-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-turkish-lira:before,.fa-try:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li span.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-institution:before,.fa-bank:before,.fa-university:before{content:""}.fa-mortar-board:before,.fa-graduation-cap:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-photo-o:before,.fa-file-picture-o:before,.fa-file-image-o:before{content:""}.fa-file-zip-o:before,.fa-file-archive-o:before{content:""}.fa-file-sound-o:before,.fa-file-audio-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-saver:before,.fa-support:before,.fa-life-ring:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-resistance:before,.fa-rebel:before{content:""}.fa-ge:before,.fa-empire:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-y-combinator-square:before,.fa-yc-square:before,.fa-hacker-news:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-send:before,.fa-paper-plane:before{content:""}.fa-send-o:before,.fa-paper-plane-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-soccer-ball-o:before,.fa-futbol-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-shekel:before,.fa-sheqel:before,.fa-ils:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-hotel:before,.fa-bed:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-yc:before,.fa-y-combinator:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery:before,.fa-battery-full:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-stop-o:before,.fa-hand-paper-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-tv:before,.fa-television:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-asl-interpreting:before,.fa-american-sign-language-interpreting:before{content:""}.fa-deafness:before,.fa-hard-of-hearing:before,.fa-deaf:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-signing:before,.fa-sign-language:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-vcard:before,.fa-address-card:before{content:""}.fa-vcard-o:before,.fa-address-card-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer:before,.fa-thermometer-full:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bathtub:before,.fa-s15:before,.fa-bath:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content .code-block-caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context{font-family:inherit}.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content .code-block-caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before{font-family:"FontAwesome";display:inline-block;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa,a .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,a .rst-content .admonition-title,.rst-content a .admonition-title,a .rst-content h1 .headerlink,.rst-content h1 a .headerlink,a .rst-content h2 .headerlink,.rst-content h2 a .headerlink,a .rst-content h3 .headerlink,.rst-content h3 a .headerlink,a .rst-content h4 .headerlink,.rst-content h4 a .headerlink,a .rst-content h5 .headerlink,.rst-content h5 a .headerlink,a .rst-content h6 .headerlink,.rst-content h6 a .headerlink,a .rst-content dl dt .headerlink,.rst-content dl dt a .headerlink,a .rst-content p.caption .headerlink,.rst-content p.caption a .headerlink,a .rst-content table>caption .headerlink,.rst-content table>caption a .headerlink,a .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption a .headerlink,a .rst-content tt.download span:first-child,.rst-content tt.download a span:first-child,a .rst-content code.download span:first-child,.rst-content code.download a span:first-child,a .icon{display:inline-block;text-decoration:inherit}.btn .fa,.btn .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .btn span.toctree-expand,.btn .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .btn span.toctree-expand,.btn .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .btn span.toctree-expand,.btn .rst-content .admonition-title,.rst-content .btn .admonition-title,.btn .rst-content h1 .headerlink,.rst-content h1 .btn .headerlink,.btn .rst-content h2 .headerlink,.rst-content h2 .btn .headerlink,.btn .rst-content h3 .headerlink,.rst-content h3 .btn .headerlink,.btn .rst-content h4 .headerlink,.rst-content h4 .btn .headerlink,.btn .rst-content h5 .headerlink,.rst-content h5 .btn .headerlink,.btn .rst-content h6 .headerlink,.rst-content h6 .btn .headerlink,.btn .rst-content dl dt .headerlink,.rst-content dl dt .btn .headerlink,.btn .rst-content p.caption .headerlink,.rst-content p.caption .btn .headerlink,.btn .rst-content table>caption .headerlink,.rst-content table>caption .btn .headerlink,.btn .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption .btn .headerlink,.btn .rst-content tt.download span:first-child,.rst-content tt.download .btn span:first-child,.btn .rst-content code.download span:first-child,.rst-content code.download .btn span:first-child,.btn .icon,.nav .fa,.nav .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .nav span.toctree-expand,.nav .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .nav span.toctree-expand,.nav .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .nav span.toctree-expand,.nav .rst-content .admonition-title,.rst-content .nav .admonition-title,.nav .rst-content h1 .headerlink,.rst-content h1 .nav .headerlink,.nav .rst-content h2 .headerlink,.rst-content h2 .nav .headerlink,.nav .rst-content h3 .headerlink,.rst-content h3 .nav .headerlink,.nav .rst-content h4 .headerlink,.rst-content h4 .nav .headerlink,.nav .rst-content h5 .headerlink,.rst-content h5 .nav .headerlink,.nav .rst-content h6 .headerlink,.rst-content h6 .nav .headerlink,.nav .rst-content dl dt .headerlink,.rst-content dl dt .nav .headerlink,.nav .rst-content p.caption .headerlink,.rst-content p.caption .nav .headerlink,.nav .rst-content table>caption .headerlink,.rst-content table>caption .nav .headerlink,.nav .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption .nav .headerlink,.nav .rst-content tt.download span:first-child,.rst-content tt.download .nav span:first-child,.nav .rst-content code.download span:first-child,.rst-content code.download .nav span:first-child,.nav .icon{display:inline}.btn .fa.fa-large,.btn .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .btn span.fa-large.toctree-expand,.btn .rst-content .fa-large.admonition-title,.rst-content .btn .fa-large.admonition-title,.btn .rst-content h1 .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.btn .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .btn .fa-large.headerlink,.btn .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .btn .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.btn .rst-content .code-block-caption .fa-large.headerlink,.rst-content .code-block-caption .btn .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .btn span.fa-large:first-child,.btn .rst-content code.download span.fa-large:first-child,.rst-content code.download .btn span.fa-large:first-child,.btn .fa-large.icon,.nav .fa.fa-large,.nav .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .nav span.fa-large.toctree-expand,.nav .rst-content .fa-large.admonition-title,.rst-content .nav .fa-large.admonition-title,.nav .rst-content h1 .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.nav .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.nav .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .nav .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.nav .rst-content .code-block-caption .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.nav .rst-content code.download span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.nav .fa-large.icon{line-height:.9em}.btn .fa.fa-spin,.btn .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .btn span.fa-spin.toctree-expand,.btn .rst-content .fa-spin.admonition-title,.rst-content .btn .fa-spin.admonition-title,.btn .rst-content h1 .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.btn .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .btn .fa-spin.headerlink,.btn .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .btn .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.btn .rst-content .code-block-caption .fa-spin.headerlink,.rst-content .code-block-caption .btn .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .btn span.fa-spin:first-child,.btn .rst-content code.download span.fa-spin:first-child,.rst-content code.download .btn span.fa-spin:first-child,.btn .fa-spin.icon,.nav .fa.fa-spin,.nav .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .nav span.fa-spin.toctree-expand,.nav .rst-content .fa-spin.admonition-title,.rst-content .nav .fa-spin.admonition-title,.nav .rst-content h1 .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.nav .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.nav .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .nav .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.nav .rst-content .code-block-caption .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.nav .rst-content code.download span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.nav .fa-spin.icon{display:inline-block}.btn.fa:before,.wy-menu-vertical li span.btn.toctree-expand:before,.rst-content .btn.admonition-title:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content dl dt .btn.headerlink:before,.rst-content p.caption .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.rst-content code.download span.btn:first-child:before,.btn.icon:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.wy-menu-vertical li span.btn.toctree-expand:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content p.caption .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.rst-content code.download span.btn:first-child:hover:before,.btn.icon:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li .btn-mini span.toctree-expand:before,.btn-mini .rst-content .admonition-title:before,.rst-content .btn-mini .admonition-title:before,.btn-mini .rst-content h1 .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.btn-mini .rst-content dl dt .headerlink:before,.rst-content dl dt .btn-mini .headerlink:before,.btn-mini .rst-content p.caption .headerlink:before,.rst-content p.caption .btn-mini .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.rst-content tt.download .btn-mini span:first-child:before,.btn-mini .rst-content code.download span:first-child:before,.rst-content code.download .btn-mini span:first-child:before,.btn-mini .icon:before{font-size:14px;vertical-align:-15%}.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.wy-alert-title,.rst-content .admonition-title{color:#fff;font-weight:bold;display:block;color:#fff;background:#6ab0de;margin:-12px;padding:6px 12px;margin-bottom:12px}.wy-alert.wy-alert-danger,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.admonition{background:#fdf3f2}.wy-alert.wy-alert-danger .wy-alert-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .danger .wy-alert-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .danger .admonition-title,.rst-content .error .admonition-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition .admonition-title{background:#f29f97}.wy-alert.wy-alert-warning,.rst-content .wy-alert-warning.note,.rst-content .attention,.rst-content .caution,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.tip,.rst-content .warning,.rst-content .wy-alert-warning.seealso,.rst-content .admonition-todo,.rst-content .wy-alert-warning.admonition{background:#ffedcc}.wy-alert.wy-alert-warning .wy-alert-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .attention .wy-alert-title,.rst-content .caution .wy-alert-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .attention .admonition-title,.rst-content .caution .admonition-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .warning .admonition-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .admonition-todo .admonition-title,.rst-content .wy-alert-warning.admonition .admonition-title{background:#f0b37e}.wy-alert.wy-alert-info,.rst-content .note,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.rst-content .seealso,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.admonition{background:#e7f2fa}.wy-alert.wy-alert-info .wy-alert-title,.rst-content .note .wy-alert-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.rst-content .note .admonition-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .seealso .admonition-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition .admonition-title{background:#6ab0de}.wy-alert.wy-alert-success,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.warning,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.admonition{background:#dbfaf4}.wy-alert.wy-alert-success .wy-alert-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .hint .wy-alert-title,.rst-content .important .wy-alert-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .hint .admonition-title,.rst-content .important .admonition-title,.rst-content .tip .admonition-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition .admonition-title{background:#1abc9c}.wy-alert.wy-alert-neutral,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.admonition{background:#f3f6f6}.wy-alert.wy-alert-neutral .wy-alert-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition .admonition-title{color:#404040;background:#e1e4e5}.wy-alert.wy-alert-neutral a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a{color:#2980B9}.wy-alert p:last-child,.rst-content .note p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.rst-content .seealso p:last-child,.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0px;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,0.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27AE60}.wy-tray-container li.wy-tray-item-info{background:#2980B9}.wy-tray-container li.wy-tray-item-warning{background:#E67E22}.wy-tray-container li.wy-tray-item-danger{background:#E74C3C}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width: 768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px 12px;color:#fff;border:1px solid rgba(0,0,0,0.1);background-color:#27AE60;text-decoration:none;font-weight:normal;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:0px 1px 2px -1px rgba(255,255,255,0.5) inset,0px -2px 0px 0px rgba(0,0,0,0.1) inset;outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:0px -1px 0px 0px rgba(0,0,0,0.05) inset,0px 2px 0px 0px rgba(0,0,0,0.1) inset;padding:8px 12px 6px 12px}.btn:visited{color:#fff}.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn-disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn-disabled:hover,.btn-disabled:focus,.btn-disabled:active{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980B9 !important}.btn-info:hover{background-color:#2e8ece !important}.btn-neutral{background-color:#f3f6f6 !important;color:#404040 !important}.btn-neutral:hover{background-color:#e5ebeb !important;color:#404040}.btn-neutral:visited{color:#404040 !important}.btn-success{background-color:#27AE60 !important}.btn-success:hover{background-color:#295 !important}.btn-danger{background-color:#E74C3C !important}.btn-danger:hover{background-color:#ea6153 !important}.btn-warning{background-color:#E67E22 !important}.btn-warning:hover{background-color:#e98b39 !important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f !important}.btn-link{background-color:transparent !important;color:#2980B9;box-shadow:none;border-color:transparent !important}.btn-link:hover{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:active{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:visited{color:#9B59B6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:before,.wy-btn-group:after{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:solid 1px #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,0.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980B9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:solid 1px #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type="search"]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980B9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned input,.wy-form-aligned textarea,.wy-form-aligned select,.wy-form-aligned .wy-help-inline,.wy-form-aligned label{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{border:0;margin:0;padding:0}legend{display:block;width:100%;border:0;padding:0;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label{display:block;margin:0 0 .3125em 0;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;*zoom:1;max-width:68em;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#E74C3C}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full input[type="text"],.wy-control-group .wy-form-full input[type="password"],.wy-control-group .wy-form-full input[type="email"],.wy-control-group .wy-form-full input[type="url"],.wy-control-group .wy-form-full input[type="date"],.wy-control-group .wy-form-full input[type="month"],.wy-control-group .wy-form-full input[type="time"],.wy-control-group .wy-form-full input[type="datetime"],.wy-control-group .wy-form-full input[type="datetime-local"],.wy-control-group .wy-form-full input[type="week"],.wy-control-group .wy-form-full input[type="number"],.wy-control-group .wy-form-full input[type="search"],.wy-control-group .wy-form-full input[type="tel"],.wy-control-group .wy-form-full input[type="color"],.wy-control-group .wy-form-halves input[type="text"],.wy-control-group .wy-form-halves input[type="password"],.wy-control-group .wy-form-halves input[type="email"],.wy-control-group .wy-form-halves input[type="url"],.wy-control-group .wy-form-halves input[type="date"],.wy-control-group .wy-form-halves input[type="month"],.wy-control-group .wy-form-halves input[type="time"],.wy-control-group .wy-form-halves input[type="datetime"],.wy-control-group .wy-form-halves input[type="datetime-local"],.wy-control-group .wy-form-halves input[type="week"],.wy-control-group .wy-form-halves input[type="number"],.wy-control-group .wy-form-halves input[type="search"],.wy-control-group .wy-form-halves input[type="tel"],.wy-control-group .wy-form-halves input[type="color"],.wy-control-group .wy-form-thirds input[type="text"],.wy-control-group .wy-form-thirds input[type="password"],.wy-control-group .wy-form-thirds input[type="email"],.wy-control-group .wy-form-thirds input[type="url"],.wy-control-group .wy-form-thirds input[type="date"],.wy-control-group .wy-form-thirds input[type="month"],.wy-control-group .wy-form-thirds input[type="time"],.wy-control-group .wy-form-thirds input[type="datetime"],.wy-control-group .wy-form-thirds input[type="datetime-local"],.wy-control-group .wy-form-thirds input[type="week"],.wy-control-group .wy-form-thirds input[type="number"],.wy-control-group .wy-form-thirds input[type="search"],.wy-control-group .wy-form-thirds input[type="tel"],.wy-control-group .wy-form-thirds input[type="color"]{width:100%}.wy-control-group .wy-form-full{float:left;display:block;margin-right:2.3576515979%;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.3576515979%;width:48.821174201%}.wy-control-group .wy-form-halves:last-child{margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n+1){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.3576515979%;width:31.7615656014%}.wy-control-group .wy-form-thirds:last-child{margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control{margin:6px 0 0 0;font-size:90%}.wy-control-no-input{display:inline-block;margin:6px 0 0 0;font-size:90%}.wy-control-group.fluid-input input[type="text"],.wy-control-group.fluid-input input[type="password"],.wy-control-group.fluid-input input[type="email"],.wy-control-group.fluid-input input[type="url"],.wy-control-group.fluid-input input[type="date"],.wy-control-group.fluid-input input[type="month"],.wy-control-group.fluid-input input[type="time"],.wy-control-group.fluid-input input[type="datetime"],.wy-control-group.fluid-input input[type="datetime-local"],.wy-control-group.fluid-input input[type="week"],.wy-control-group.fluid-input input[type="number"],.wy-control-group.fluid-input input[type="search"],.wy-control-group.fluid-input input[type="tel"],.wy-control-group.fluid-input input[type="color"]{width:100%}.wy-form-message-inline{display:inline-block;padding-left:.3em;color:#666;vertical-align:middle;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;*overflow:visible}input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type="datetime-local"]{padding:.34375em .625em}input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type="search"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input[type="text"]:focus,input[type="password"]:focus,input[type="email"]:focus,input[type="url"]:focus,input[type="date"]:focus,input[type="month"]:focus,input[type="time"]:focus,input[type="datetime"]:focus,input[type="datetime-local"]:focus,input[type="week"]:focus,input[type="number"]:focus,input[type="search"]:focus,input[type="tel"]:focus,input[type="color"]:focus{outline:0;outline:thin dotted \9;border-color:#333}input.no-focus:focus{border-color:#ccc !important}input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus{outline:thin dotted #333;outline:1px auto #129FEA}input[type="text"][disabled],input[type="password"][disabled],input[type="email"][disabled],input[type="url"][disabled],input[type="date"][disabled],input[type="month"][disabled],input[type="time"][disabled],input[type="datetime"][disabled],input[type="datetime-local"][disabled],input[type="week"][disabled],input[type="number"][disabled],input[type="search"][disabled],input[type="tel"][disabled],input[type="color"][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,textarea:focus:invalid,select:focus:invalid{color:#E74C3C;border:1px solid #E74C3C}input:focus:invalid:focus,textarea:focus:invalid:focus,select:focus:invalid:focus{border-color:#E74C3C}input[type="file"]:focus:invalid:focus,input[type="radio"]:focus:invalid:focus,input[type="checkbox"]:focus:invalid:focus{outline-color:#E74C3C}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type="radio"][disabled],input[type="checkbox"][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:solid 1px #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{position:absolute;content:"";display:block;left:0;top:0;width:36px;height:12px;border-radius:4px;background:#ccc;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{position:absolute;content:"";display:block;width:18px;height:18px;border-radius:4px;background:#999;left:-3px;top:-3px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27AE60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#E74C3C}.wy-control-group.wy-control-group-error input[type="text"],.wy-control-group.wy-control-group-error input[type="password"],.wy-control-group.wy-control-group-error input[type="email"],.wy-control-group.wy-control-group-error input[type="url"],.wy-control-group.wy-control-group-error input[type="date"],.wy-control-group.wy-control-group-error input[type="month"],.wy-control-group.wy-control-group-error input[type="time"],.wy-control-group.wy-control-group-error input[type="datetime"],.wy-control-group.wy-control-group-error input[type="datetime-local"],.wy-control-group.wy-control-group-error input[type="week"],.wy-control-group.wy-control-group-error input[type="number"],.wy-control-group.wy-control-group-error input[type="search"],.wy-control-group.wy-control-group-error input[type="tel"],.wy-control-group.wy-control-group-error input[type="color"]{border:solid 1px #E74C3C}.wy-control-group.wy-control-group-error textarea{border:solid 1px #E74C3C}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27AE60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#E74C3C}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#E67E22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980B9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width: 480px){.wy-form button[type="submit"]{margin:.7em 0 0}.wy-form input[type="text"],.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:.3em;display:block}.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0 0}.wy-form .wy-help-inline,.wy-form-message-inline,.wy-form-message{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width: 768px){.tablet-hide{display:none}}@media screen and (max-width: 480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.wy-table,.rst-content table.docutils,.rst-content table.field-list{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.wy-table caption,.rst-content table.docutils caption,.rst-content table.field-list caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td,.wy-table th,.rst-content table.docutils th,.rst-content table.field-list th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.wy-table td:first-child,.rst-content table.docutils td:first-child,.rst-content table.field-list td:first-child,.wy-table th:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list th:first-child{border-left-width:0}.wy-table thead,.rst-content table.docutils thead,.rst-content table.field-list thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.wy-table thead th,.rst-content table.docutils thead th,.rst-content table.field-list thead th{font-weight:bold;border-bottom:solid 2px #e1e4e5}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td{background-color:transparent;vertical-align:middle}.wy-table td p,.rst-content table.docutils td p,.rst-content table.field-list td p{line-height:18px}.wy-table td p:last-child,.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child{margin-bottom:0}.wy-table .wy-table-cell-min,.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min{width:1%;padding-right:0}.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:gray;font-size:90%}.wy-table-tertiary{color:gray;font-size:80%}.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td,.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td{background-color:#f3f6f6}.wy-table-backed{background-color:#f3f6f6}.wy-table-bordered-all,.rst-content table.docutils{border:1px solid #e1e4e5}.wy-table-bordered-all td,.rst-content table.docutils td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.wy-table-bordered-all tbody>tr:last-child td,.rst-content table.docutils tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px 0;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0 !important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980B9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9B59B6}html{height:100%;overflow-x:hidden}body{font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;font-weight:normal;color:#404040;min-height:100%;overflow-x:hidden;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#E67E22 !important}a.wy-text-warning:hover{color:#eb9950 !important}.wy-text-info{color:#2980B9 !important}a.wy-text-info:hover{color:#409ad5 !important}.wy-text-success{color:#27AE60 !important}a.wy-text-success:hover{color:#36d278 !important}.wy-text-danger{color:#E74C3C !important}a.wy-text-danger:hover{color:#ed7669 !important}.wy-text-neutral{color:#404040 !important}a.wy-text-neutral:hover{color:#595959 !important}h1,h2,.rst-content .toctree-wrapper p.caption,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif}p{line-height:24px;margin:0;font-size:16px;margin-bottom:24px}h1{font-size:175%}h2,.rst-content .toctree-wrapper p.caption{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}code,.rst-content tt,.rst-content code{white-space:nowrap;max-width:100%;background:#fff;border:solid 1px #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;color:#E74C3C;overflow-x:auto}code.code-large,.rst-content tt.code-large{font-size:90%}.wy-plain-list-disc,.rst-content .section ul,.rst-content .toctree-wrapper ul,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.wy-plain-list-disc li,.rst-content .section ul li,.rst-content .toctree-wrapper ul li,article ul li{list-style:disc;margin-left:24px}.wy-plain-list-disc li p:last-child,.rst-content .section ul li p:last-child,.rst-content .toctree-wrapper ul li p:last-child,article ul li p:last-child{margin-bottom:0}.wy-plain-list-disc li ul,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li ul,article ul li ul{margin-bottom:0}.wy-plain-list-disc li li,.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,article ul li li{list-style:circle}.wy-plain-list-disc li li li,.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,article ul li li li{list-style:square}.wy-plain-list-disc li ol li,.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,article ul li ol li{list-style:decimal}.wy-plain-list-decimal,.rst-content .section ol,.rst-content ol.arabic,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.wy-plain-list-decimal li,.rst-content .section ol li,.rst-content ol.arabic li,article ol li{list-style:decimal;margin-left:24px}.wy-plain-list-decimal li p:last-child,.rst-content .section ol li p:last-child,.rst-content ol.arabic li p:last-child,article ol li p:last-child{margin-bottom:0}.wy-plain-list-decimal li ul,.rst-content .section ol li ul,.rst-content ol.arabic li ul,article ol li ul{margin-bottom:0}.wy-plain-list-decimal li ul li,.rst-content .section ol li ul li,.rst-content ol.arabic li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:before,.wy-breadcrumbs:after{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs li{display:inline-block}.wy-breadcrumbs li.wy-breadcrumbs-aside{float:right}.wy-breadcrumbs li a{display:inline-block;padding:5px}.wy-breadcrumbs li a:first-child{padding-left:0}.wy-breadcrumbs li code,.wy-breadcrumbs li .rst-content tt,.rst-content .wy-breadcrumbs li tt{padding:5px;border:none;background:none}.wy-breadcrumbs li code.literal,.wy-breadcrumbs li .rst-content tt.literal,.rst-content .wy-breadcrumbs li tt.literal{color:#404040}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width: 480px){.wy-breadcrumbs-extra{display:none}.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:before,.wy-menu-horiz:after{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz ul,.wy-menu-horiz li{display:inline-block}.wy-menu-horiz li:hover{background:rgba(255,255,255,0.1)}.wy-menu-horiz li.divide-left{border-left:solid 1px #404040}.wy-menu-horiz li.divide-right{border-right:solid 1px #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#3a7ca8;height:32px;display:inline-block;line-height:32px;padding:0 1.618em;margin:12px 0 0 0;display:block;font-weight:bold;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:solid 1px #404040}.wy-menu-vertical li.divide-bottom{border-bottom:solid 1px #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:gray;border-right:solid 1px #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.wy-menu-vertical li code,.wy-menu-vertical li .rst-content tt,.rst-content .wy-menu-vertical li tt{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li span.toctree-expand{display:block;float:left;margin-left:-1.2em;font-size:.8em;line-height:1.6em;color:#4d4d4d}.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a{color:#404040;padding:.4045em 1.618em;font-weight:bold;position:relative;background:#fcfcfc;border:none;padding-left:1.618em -4px}.wy-menu-vertical li.on a:hover,.wy-menu-vertical li.current>a:hover{background:#fcfcfc}.wy-menu-vertical li.on a:hover span.toctree-expand,.wy-menu-vertical li.current>a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand{display:block;font-size:.8em;line-height:1.6em;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:solid 1px #c9c9c9;border-top:solid 1px #c9c9c9}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a{color:#404040}.wy-menu-vertical li.toctree-l1.current li.toctree-l2>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>ul{display:none}.wy-menu-vertical li.toctree-l1.current li.toctree-l2.current>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3.current>ul{display:block}.wy-menu-vertical li.toctree-l2.current>a{background:#c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{display:block;background:#c9c9c9;padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l2 a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.toctree-l2 span.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3{font-size:.9em}.wy-menu-vertical li.toctree-l3.current>a{background:#bdbdbd;padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{display:block;background:#bdbdbd;padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l3 a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.toctree-l3 span.toctree-expand{color:#969696}.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:normal}.wy-menu-vertical a{display:inline-block;line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover span.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980B9;cursor:pointer;color:#fff}.wy-menu-vertical a:active span.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980B9;text-align:center;padding:.809em;display:block;color:#fcfcfc;margin-bottom:.809em}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em auto;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a{color:#fcfcfc;font-size:100%;font-weight:bold;display:inline-block;padding:4px 6px;margin-bottom:.809em}.wy-side-nav-search>a:hover,.wy-side-nav-search .wy-dropdown>a:hover{background:rgba(255,255,255,0.1)}.wy-side-nav-search>a img.logo,.wy-side-nav-search .wy-dropdown>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search>a.icon img.logo,.wy-side-nav-search .wy-dropdown>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:normal;color:rgba(255,255,255,0.3)}.wy-nav .wy-menu-vertical header{color:#2980B9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980B9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980B9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:before,.wy-nav-top:after{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:bold}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,0.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:gray}footer p{margin-bottom:12px}footer span.commit code,footer span.commit .rst-content tt,.rst-content footer span.commit tt{padding:0px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;font-size:1em;background:none;border:none;color:gray}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:before,.rst-footer-buttons:after{width:100%}.rst-footer-buttons:before,.rst-footer-buttons:after{display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:before,.rst-breadcrumbs-buttons:after{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:solid 1px #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:solid 1px #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:gray;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width: 768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-side-scroll{width:auto}.wy-side-nav-search{width:auto}.wy-menu.wy-menu-vertical{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width: 1100px){.wy-nav-content-wrap{background:rgba(0,0,0,0.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,footer,.wy-nav-side{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version span.toctree-expand,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content p.caption .headerlink,.rst-content p.caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .icon{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content img{max-width:100%;height:auto}.rst-content div.figure{margin-bottom:24px}.rst-content div.figure p.caption{font-style:italic}.rst-content div.figure p:last-child.caption{margin-bottom:0px}.rst-content div.figure.align-center{text-align:center}.rst-content .section>img,.rst-content .section>a>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px 12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;display:block;overflow:auto}.rst-content pre.literal-block,.rst-content div[class^='highlight']{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px 0}.rst-content pre.literal-block div[class^='highlight'],.rst-content div[class^='highlight'] div[class^='highlight']{padding:0px;border:none;margin:0}.rst-content div[class^='highlight'] td.code{width:100%}.rst-content .linenodiv pre{border-right:solid 1px #e6e9ea;margin:0;padding:12px 12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^='highlight'] pre{white-space:pre;margin:0;padding:12px 12px;display:block;overflow:auto}.rst-content div[class^='highlight'] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content pre.literal-block,.rst-content div[class^='highlight'] pre,.rst-content .linenodiv pre{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;font-size:12px;line-height:1.4}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^='highlight'],.rst-content div[class^='highlight'] pre{white-space:pre-wrap}}.rst-content .note .last,.rst-content .attention .last,.rst-content .caution .last,.rst-content .danger .last,.rst-content .error .last,.rst-content .hint .last,.rst-content .important .last,.rst-content .tip .last,.rst-content .warning .last,.rst-content .seealso .last,.rst-content .admonition-todo .last,.rst-content .admonition .last{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,0.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent !important;border-color:rgba(0,0,0,0.1) !important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha li{list-style:upper-alpha}.rst-content .section ol p,.rst-content .section ul p{margin-bottom:12px}.rst-content .section ol p:last-child,.rst-content .section ul p:last-child{margin-bottom:24px}.rst-content .line-block{margin-left:0px;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0px}.rst-content .topic-title{font-weight:bold;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0px 0px 24px 24px}.rst-content .align-left{float:left;margin:0px 24px 24px 0px}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content .toctree-wrapper p.caption .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content .code-block-caption .headerlink{visibility:hidden;font-size:14px}.rst-content h1 .headerlink:after,.rst-content h2 .headerlink:after,.rst-content .toctree-wrapper p.caption .headerlink:after,.rst-content h3 .headerlink:after,.rst-content h4 .headerlink:after,.rst-content h5 .headerlink:after,.rst-content h6 .headerlink:after,.rst-content dl dt .headerlink:after,.rst-content p.caption .headerlink:after,.rst-content table>caption .headerlink:after,.rst-content .code-block-caption .headerlink:after{content:"";font-family:FontAwesome}.rst-content h1:hover .headerlink:after,.rst-content h2:hover .headerlink:after,.rst-content .toctree-wrapper p.caption:hover .headerlink:after,.rst-content h3:hover .headerlink:after,.rst-content h4:hover .headerlink:after,.rst-content h5:hover .headerlink:after,.rst-content h6:hover .headerlink:after,.rst-content dl dt:hover .headerlink:after,.rst-content p.caption:hover .headerlink:after,.rst-content table>caption:hover .headerlink:after,.rst-content .code-block-caption:hover .headerlink:after{visibility:visible}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:solid 1px #e1e4e5}.rst-content .sidebar p,.rst-content .sidebar ul,.rst-content .sidebar dl{font-size:90%}.rst-content .sidebar .last{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif;font-weight:bold;background:#e1e4e5;padding:6px 12px;margin:-24px;margin-bottom:24px;font-size:100%}.rst-content .highlighted{background:#F1C40F;display:inline-block;font-weight:bold;padding:0 6px}.rst-content .footnote-reference,.rst-content .citation-reference{vertical-align:baseline;position:relative;top:-0.4em;line-height:0;font-size:90%}.rst-content table.docutils.citation,.rst-content table.docutils.footnote{background:none;border:none;color:gray}.rst-content table.docutils.citation td,.rst-content table.docutils.citation tr,.rst-content table.docutils.footnote td,.rst-content table.docutils.footnote tr{border:none;background-color:transparent !important;white-space:normal}.rst-content table.docutils.citation td.label,.rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}.rst-content table.docutils.citation tt,.rst-content table.docutils.citation code,.rst-content table.docutils.footnote tt,.rst-content table.docutils.footnote code{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}.rst-content table.docutils td .last,.rst-content table.docutils td .last :last-child{margin-bottom:0}.rst-content table.field-list{border:none}.rst-content table.field-list td{border:none}.rst-content table.field-list td p{font-size:inherit;line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content tt,.rst-content tt,.rst-content code{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;padding:2px 5px}.rst-content tt big,.rst-content tt em,.rst-content tt big,.rst-content code big,.rst-content tt em,.rst-content code em{font-size:100% !important;line-height:normal}.rst-content tt.literal,.rst-content tt.literal,.rst-content code.literal{color:#E74C3C}.rst-content tt.xref,a .rst-content tt,.rst-content tt.xref,.rst-content code.xref,a .rst-content tt,a .rst-content code{font-weight:bold;color:#404040}.rst-content pre,.rst-content kbd,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace}.rst-content a tt,.rst-content a tt,.rst-content a code{color:#2980B9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:bold;margin-bottom:12px}.rst-content dl p,.rst-content dl table,.rst-content dl ul,.rst-content dl ol{margin-bottom:12px !important}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl:not(.docutils){margin-bottom:24px}.rst-content dl:not(.docutils) dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980B9;border-top:solid 3px #6ab0de;padding:6px;position:relative}.rst-content dl:not(.docutils) dt:before{color:#6ab0de}.rst-content dl:not(.docutils) dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dl dt{margin-bottom:6px;border:none;border-left:solid 3px #ccc;background:#f0f0f0;color:#555}.rst-content dl:not(.docutils) dl dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dt:first-child{margin-top:0}.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) code{font-weight:bold}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) code.descclassname{background-color:transparent;border:none;padding:0;font-size:100% !important}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname{font-weight:bold}.rst-content dl:not(.docutils) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:bold}.rst-content dl:not(.docutils) .property{display:inline-block;padding-right:8px}.rst-content .viewcode-link,.rst-content .viewcode-back{display:inline-block;color:#27AE60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:bold}.rst-content tt.download,.rst-content code.download{background:inherit;padding:inherit;font-weight:normal;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content tt.download span:first-child,.rst-content code.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{margin-right:4px}.rst-content .guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content .versionmodified{font-style:italic}@media screen and (max-width: 480px){.rst-content .sidebar{width:100%}}span[id*='MathJax-Span']{color:#404040}.math{text-align:center}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-regular.eot");src:url("../fonts/Lato/lato-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-regular.woff2") format("woff2"),url("../fonts/Lato/lato-regular.woff") format("woff"),url("../fonts/Lato/lato-regular.ttf") format("truetype");font-weight:400;font-style:normal}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-bold.eot");src:url("../fonts/Lato/lato-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bold.woff2") format("woff2"),url("../fonts/Lato/lato-bold.woff") format("woff"),url("../fonts/Lato/lato-bold.ttf") format("truetype");font-weight:700;font-style:normal}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-bolditalic.eot");src:url("../fonts/Lato/lato-bolditalic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bolditalic.woff2") format("woff2"),url("../fonts/Lato/lato-bolditalic.woff") format("woff"),url("../fonts/Lato/lato-bolditalic.ttf") format("truetype");font-weight:700;font-style:italic}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-italic.eot");src:url("../fonts/Lato/lato-italic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-italic.woff2") format("woff2"),url("../fonts/Lato/lato-italic.woff") format("woff"),url("../fonts/Lato/lato-italic.ttf") format("truetype");font-weight:400;font-style:italic}@font-face{font-family:"Roboto Slab";font-style:normal;font-weight:400;src:url("../fonts/RobotoSlab/roboto-slab.eot");src:url("../fonts/RobotoSlab/roboto-slab-v7-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.ttf") format("truetype")}@font-face{font-family:"Roboto Slab";font-style:normal;font-weight:700;src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot");src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.ttf") format("truetype")} + */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713);src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix&v=4.7.0) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#fontawesomeregular) format("svg");font-weight:400;font-style:normal}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li span.toctree-expand{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:.08em solid #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa-pull-left.icon,.fa.fa-pull-left,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content .fa-pull-left.admonition-title,.rst-content code.download span.fa-pull-left:first-child,.rst-content dl dt .fa-pull-left.headerlink,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content p.caption .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.wy-menu-vertical li.current>a span.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-left.toctree-expand,.wy-menu-vertical li span.fa-pull-left.toctree-expand{margin-right:.3em}.fa-pull-right.icon,.fa.fa-pull-right,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content .fa-pull-right.admonition-title,.rst-content code.download span.fa-pull-right:first-child,.rst-content dl dt .fa-pull-right.headerlink,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content p.caption .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.wy-menu-vertical li.current>a span.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-right.toctree-expand,.wy-menu-vertical li span.fa-pull-right.toctree-expand{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.pull-left.icon,.rst-content .code-block-caption .pull-left.headerlink,.rst-content .pull-left.admonition-title,.rst-content code.download span.pull-left:first-child,.rst-content dl dt .pull-left.headerlink,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content p.caption .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.wy-menu-vertical li.current>a span.pull-left.toctree-expand,.wy-menu-vertical li.on a span.pull-left.toctree-expand,.wy-menu-vertical li span.pull-left.toctree-expand{margin-right:.3em}.fa.pull-right,.pull-right.icon,.rst-content .code-block-caption .pull-right.headerlink,.rst-content .pull-right.admonition-title,.rst-content code.download span.pull-right:first-child,.rst-content dl dt .pull-right.headerlink,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content p.caption .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.wy-menu-vertical li.current>a span.pull-right.toctree-expand,.wy-menu-vertical li.on a span.pull-right.toctree-expand,.wy-menu-vertical li span.pull-right.toctree-expand{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s linear infinite;animation:fa-spin 2s linear infinite}.fa-pulse{-webkit-animation:fa-spin 1s steps(8) infinite;animation:fa-spin 1s steps(8) infinite}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scaleX(-1);-ms-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scaleY(-1);-ms-transform:scaleY(-1);transform:scaleY(-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-close:before,.fa-remove:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-cog:before,.fa-gear:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-repeat:before,.fa-rotate-right:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.rst-content .admonition-title:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-exclamation-triangle:before,.fa-warning:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-cogs:before,.fa-gears:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-floppy-o:before,.fa-save:before{content:""}.fa-square:before{content:""}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.icon-caret-down:before,.wy-dropdown .caret:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-sort:before,.fa-unsorted:before{content:""}.fa-sort-desc:before,.fa-sort-down:before{content:""}.fa-sort-asc:before,.fa-sort-up:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-gavel:before,.fa-legal:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-bolt:before,.fa-flash:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-clipboard:before,.fa-paste:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-chain-broken:before,.fa-unlink:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:""}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:""}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:""}.fa-eur:before,.fa-euro:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-inr:before,.fa-rupee:before{content:""}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:""}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:""}.fa-krw:before,.fa-won:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-try:before,.fa-turkish-lira:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li span.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-bank:before,.fa-institution:before,.fa-university:before{content:""}.fa-graduation-cap:before,.fa-mortar-board:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:""}.fa-file-archive-o:before,.fa-file-zip-o:before{content:""}.fa-file-audio-o:before,.fa-file-sound-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:""}.fa-empire:before,.fa-ge:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-paper-plane:before,.fa-send:before{content:""}.fa-paper-plane-o:before,.fa-send-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-bed:before,.fa-hotel:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-y-combinator:before,.fa-yc:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery-full:before,.fa-battery:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-television:before,.fa-tv:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:""}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-sign-language:before,.fa-signing:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-address-card:before,.fa-vcard:before{content:""}.fa-address-card-o:before,.fa-vcard-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer-full:before,.fa-thermometer:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bath:before,.fa-bathtub:before,.fa-s15:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li span.toctree-expand{font-family:inherit}.fa:before,.icon:before,.rst-content .admonition-title:before,.rst-content .code-block-caption .headerlink:before,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li span.toctree-expand:before{font-family:FontAwesome;display:inline-block;font-style:normal;font-weight:400;line-height:1;text-decoration:inherit}.rst-content .code-block-caption a .headerlink,.rst-content a .admonition-title,.rst-content code.download a span:first-child,.rst-content dl dt a .headerlink,.rst-content h1 a .headerlink,.rst-content h2 a .headerlink,.rst-content h3 a .headerlink,.rst-content h4 a .headerlink,.rst-content h5 a .headerlink,.rst-content h6 a .headerlink,.rst-content p.caption a .headerlink,.rst-content table>caption a .headerlink,.rst-content tt.download a span:first-child,.wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li a span.toctree-expand,a .fa,a .icon,a .rst-content .admonition-title,a .rst-content .code-block-caption .headerlink,a .rst-content code.download span:first-child,a .rst-content dl dt .headerlink,a .rst-content h1 .headerlink,a .rst-content h2 .headerlink,a .rst-content h3 .headerlink,a .rst-content h4 .headerlink,a .rst-content h5 .headerlink,a .rst-content h6 .headerlink,a .rst-content p.caption .headerlink,a .rst-content table>caption .headerlink,a .rst-content tt.download span:first-child,a .wy-menu-vertical li span.toctree-expand{display:inline-block;text-decoration:inherit}.btn .fa,.btn .icon,.btn .rst-content .admonition-title,.btn .rst-content .code-block-caption .headerlink,.btn .rst-content code.download span:first-child,.btn .rst-content dl dt .headerlink,.btn .rst-content h1 .headerlink,.btn .rst-content h2 .headerlink,.btn .rst-content h3 .headerlink,.btn .rst-content h4 .headerlink,.btn .rst-content h5 .headerlink,.btn .rst-content h6 .headerlink,.btn .rst-content p.caption .headerlink,.btn .rst-content table>caption .headerlink,.btn .rst-content tt.download span:first-child,.btn .wy-menu-vertical li.current>a span.toctree-expand,.btn .wy-menu-vertical li.on a span.toctree-expand,.btn .wy-menu-vertical li span.toctree-expand,.nav .fa,.nav .icon,.nav .rst-content .admonition-title,.nav .rst-content .code-block-caption .headerlink,.nav .rst-content code.download span:first-child,.nav .rst-content dl dt .headerlink,.nav .rst-content h1 .headerlink,.nav .rst-content h2 .headerlink,.nav .rst-content h3 .headerlink,.nav .rst-content h4 .headerlink,.nav .rst-content h5 .headerlink,.nav .rst-content h6 .headerlink,.nav .rst-content p.caption .headerlink,.nav .rst-content table>caption .headerlink,.nav .rst-content tt.download span:first-child,.nav .wy-menu-vertical li.current>a span.toctree-expand,.nav .wy-menu-vertical li.on a span.toctree-expand,.nav .wy-menu-vertical li span.toctree-expand,.rst-content .btn .admonition-title,.rst-content .code-block-caption .btn .headerlink,.rst-content .code-block-caption .nav .headerlink,.rst-content .nav .admonition-title,.rst-content code.download .btn span:first-child,.rst-content code.download .nav span:first-child,.rst-content dl dt .btn .headerlink,.rst-content dl dt .nav .headerlink,.rst-content h1 .btn .headerlink,.rst-content h1 .nav .headerlink,.rst-content h2 .btn .headerlink,.rst-content h2 .nav .headerlink,.rst-content h3 .btn .headerlink,.rst-content h3 .nav .headerlink,.rst-content h4 .btn .headerlink,.rst-content h4 .nav .headerlink,.rst-content h5 .btn .headerlink,.rst-content h5 .nav .headerlink,.rst-content h6 .btn .headerlink,.rst-content h6 .nav .headerlink,.rst-content p.caption .btn .headerlink,.rst-content p.caption .nav .headerlink,.rst-content table>caption .btn .headerlink,.rst-content table>caption .nav .headerlink,.rst-content tt.download .btn span:first-child,.rst-content tt.download .nav span:first-child,.wy-menu-vertical li .btn span.toctree-expand,.wy-menu-vertical li.current>a .btn span.toctree-expand,.wy-menu-vertical li.current>a .nav span.toctree-expand,.wy-menu-vertical li .nav span.toctree-expand,.wy-menu-vertical li.on a .btn span.toctree-expand,.wy-menu-vertical li.on a .nav span.toctree-expand{display:inline}.btn .fa-large.icon,.btn .fa.fa-large,.btn .rst-content .code-block-caption .fa-large.headerlink,.btn .rst-content .fa-large.admonition-title,.btn .rst-content code.download span.fa-large:first-child,.btn .rst-content dl dt .fa-large.headerlink,.btn .rst-content h1 .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.btn .rst-content p.caption .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.btn .wy-menu-vertical li span.fa-large.toctree-expand,.nav .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .code-block-caption .fa-large.headerlink,.nav .rst-content .fa-large.admonition-title,.nav .rst-content code.download span.fa-large:first-child,.nav .rst-content dl dt .fa-large.headerlink,.nav .rst-content h1 .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.nav .rst-content p.caption .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.nav .wy-menu-vertical li span.fa-large.toctree-expand,.rst-content .btn .fa-large.admonition-title,.rst-content .code-block-caption .btn .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.rst-content .nav .fa-large.admonition-title,.rst-content code.download .btn span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.rst-content dl dt .btn .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.rst-content p.caption .btn .fa-large.headerlink,.rst-content p.caption .nav .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.rst-content tt.download .btn span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.wy-menu-vertical li .btn span.fa-large.toctree-expand,.wy-menu-vertical li .nav span.fa-large.toctree-expand{line-height:.9em}.btn .fa-spin.icon,.btn .fa.fa-spin,.btn .rst-content .code-block-caption .fa-spin.headerlink,.btn .rst-content .fa-spin.admonition-title,.btn .rst-content code.download span.fa-spin:first-child,.btn .rst-content dl dt .fa-spin.headerlink,.btn .rst-content h1 .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.btn .rst-content p.caption .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.btn .wy-menu-vertical li span.fa-spin.toctree-expand,.nav .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .code-block-caption .fa-spin.headerlink,.nav .rst-content .fa-spin.admonition-title,.nav .rst-content code.download span.fa-spin:first-child,.nav .rst-content dl dt .fa-spin.headerlink,.nav .rst-content h1 .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.nav .rst-content p.caption .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.nav .wy-menu-vertical li span.fa-spin.toctree-expand,.rst-content .btn .fa-spin.admonition-title,.rst-content .code-block-caption .btn .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.rst-content .nav .fa-spin.admonition-title,.rst-content code.download .btn span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.rst-content dl dt .btn .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.rst-content p.caption .btn .fa-spin.headerlink,.rst-content p.caption .nav .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.rst-content tt.download .btn span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.wy-menu-vertical li .btn span.fa-spin.toctree-expand,.wy-menu-vertical li .nav span.fa-spin.toctree-expand{display:inline-block}.btn.fa:before,.btn.icon:before,.rst-content .btn.admonition-title:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content code.download span.btn:first-child:before,.rst-content dl dt .btn.headerlink:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content p.caption .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.wy-menu-vertical li span.btn.toctree-expand:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.btn.icon:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content code.download span.btn:first-child:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content p.caption .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.wy-menu-vertical li span.btn.toctree-expand:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .icon:before,.btn-mini .rst-content .admonition-title:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.btn-mini .rst-content code.download span:first-child:before,.btn-mini .rst-content dl dt .headerlink:before,.btn-mini .rst-content h1 .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.btn-mini .rst-content p.caption .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.btn-mini .wy-menu-vertical li span.toctree-expand:before,.rst-content .btn-mini .admonition-title:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.rst-content code.download .btn-mini span:first-child:before,.rst-content dl dt .btn-mini .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.rst-content p.caption .btn-mini .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.rst-content tt.download .btn-mini span:first-child:before,.wy-menu-vertical li .btn-mini span.toctree-expand:before{font-size:14px;vertical-align:-15%}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.wy-alert{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.rst-content .admonition-title,.wy-alert-title{font-weight:700;display:block;color:#fff;background:#6ab0de;padding:6px 12px;margin:-12px -12px 12px}.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.admonition,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.wy-alert.wy-alert-danger{background:#fdf3f2}.rst-content .danger .admonition-title,.rst-content .danger .wy-alert-title,.rst-content .error .admonition-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .admonition-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.wy-alert.wy-alert-danger .wy-alert-title{background:#f29f97}.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .warning,.rst-content .wy-alert-warning.admonition,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.note,.rst-content .wy-alert-warning.seealso,.rst-content .wy-alert-warning.tip,.wy-alert.wy-alert-warning{background:#ffedcc}.rst-content .admonition-todo .admonition-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .attention .admonition-title,.rst-content .attention .wy-alert-title,.rst-content .caution .admonition-title,.rst-content .caution .wy-alert-title,.rst-content .warning .admonition-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.admonition .admonition-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.wy-alert.wy-alert-warning .wy-alert-title{background:#f0b37e}.rst-content .note,.rst-content .seealso,.rst-content .wy-alert-info.admonition,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.wy-alert.wy-alert-info{background:#e7f2fa}.rst-content .note .admonition-title,.rst-content .note .wy-alert-title,.rst-content .seealso .admonition-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .admonition-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.wy-alert.wy-alert-info .wy-alert-title{background:#6ab0de}.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.admonition,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.warning,.wy-alert.wy-alert-success{background:#dbfaf4}.rst-content .hint .admonition-title,.rst-content .hint .wy-alert-title,.rst-content .important .admonition-title,.rst-content .important .wy-alert-title,.rst-content .tip .admonition-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .admonition-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.wy-alert.wy-alert-success .wy-alert-title{background:#1abc9c}.rst-content .wy-alert-neutral.admonition,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.wy-alert.wy-alert-neutral{background:#f3f6f6}.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .admonition-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.wy-alert.wy-alert-neutral .wy-alert-title{color:#404040;background:#e1e4e5}.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.wy-alert.wy-alert-neutral a{color:#2980b9}.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .note p:last-child,.rst-content .seealso p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.wy-alert p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27ae60}.wy-tray-container li.wy-tray-item-info{background:#2980b9}.wy-tray-container li.wy-tray-item-warning{background:#e67e22}.wy-tray-container li.wy-tray-item-danger{background:#e74c3c}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width:768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px;color:#fff;border:1px solid rgba(0,0,0,.1);background-color:#27ae60;text-decoration:none;font-weight:400;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 2px -1px hsla(0,0%,100%,.5),inset 0 -2px 0 0 rgba(0,0,0,.1);outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:inset 0 -1px 0 0 rgba(0,0,0,.05),inset 0 2px 0 0 rgba(0,0,0,.1);padding:8px 12px 6px}.btn:visited{color:#fff}.btn-disabled,.btn-disabled:active,.btn-disabled:focus,.btn-disabled:hover,.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980b9!important}.btn-info:hover{background-color:#2e8ece!important}.btn-neutral{background-color:#f3f6f6!important;color:#404040!important}.btn-neutral:hover{background-color:#e5ebeb!important;color:#404040}.btn-neutral:visited{color:#404040!important}.btn-success{background-color:#27ae60!important}.btn-success:hover{background-color:#295!important}.btn-danger{background-color:#e74c3c!important}.btn-danger:hover{background-color:#ea6153!important}.btn-warning{background-color:#e67e22!important}.btn-warning:hover{background-color:#e98b39!important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f!important}.btn-link{background-color:transparent!important;color:#2980b9;box-shadow:none;border-color:transparent!important}.btn-link:active,.btn-link:hover{background-color:transparent!important;color:#409ad5!important;box-shadow:none}.btn-link:visited{color:#9b59b6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:after,.wy-btn-group:before{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:1px solid #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980b9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:1px solid #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=search]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980b9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned .wy-help-inline,.wy-form-aligned input,.wy-form-aligned label,.wy-form-aligned select,.wy-form-aligned textarea{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{margin:0}fieldset,legend{border:0;padding:0}legend{width:100%;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label,legend{display:block}label{margin:0 0 .3125em;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;max-width:1200px;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:after,.wy-control-group:before{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#e74c3c}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full input[type=color],.wy-control-group .wy-form-full input[type=date],.wy-control-group .wy-form-full input[type=datetime-local],.wy-control-group .wy-form-full input[type=datetime],.wy-control-group .wy-form-full input[type=email],.wy-control-group .wy-form-full input[type=month],.wy-control-group .wy-form-full input[type=number],.wy-control-group .wy-form-full input[type=password],.wy-control-group .wy-form-full input[type=search],.wy-control-group .wy-form-full input[type=tel],.wy-control-group .wy-form-full input[type=text],.wy-control-group .wy-form-full input[type=time],.wy-control-group .wy-form-full input[type=url],.wy-control-group .wy-form-full input[type=week],.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves input[type=color],.wy-control-group .wy-form-halves input[type=date],.wy-control-group .wy-form-halves input[type=datetime-local],.wy-control-group .wy-form-halves input[type=datetime],.wy-control-group .wy-form-halves input[type=email],.wy-control-group .wy-form-halves input[type=month],.wy-control-group .wy-form-halves input[type=number],.wy-control-group .wy-form-halves input[type=password],.wy-control-group .wy-form-halves input[type=search],.wy-control-group .wy-form-halves input[type=tel],.wy-control-group .wy-form-halves input[type=text],.wy-control-group .wy-form-halves input[type=time],.wy-control-group .wy-form-halves input[type=url],.wy-control-group .wy-form-halves input[type=week],.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds input[type=color],.wy-control-group .wy-form-thirds input[type=date],.wy-control-group .wy-form-thirds input[type=datetime-local],.wy-control-group .wy-form-thirds input[type=datetime],.wy-control-group .wy-form-thirds input[type=email],.wy-control-group .wy-form-thirds input[type=month],.wy-control-group .wy-form-thirds input[type=number],.wy-control-group .wy-form-thirds input[type=password],.wy-control-group .wy-form-thirds input[type=search],.wy-control-group .wy-form-thirds input[type=tel],.wy-control-group .wy-form-thirds input[type=text],.wy-control-group .wy-form-thirds input[type=time],.wy-control-group .wy-form-thirds input[type=url],.wy-control-group .wy-form-thirds input[type=week],.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full{float:left;display:block;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child,.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(odd){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child,.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control,.wy-control-no-input{margin:6px 0 0;font-size:90%}.wy-control-no-input{display:inline-block}.wy-control-group.fluid-input input[type=color],.wy-control-group.fluid-input input[type=date],.wy-control-group.fluid-input input[type=datetime-local],.wy-control-group.fluid-input input[type=datetime],.wy-control-group.fluid-input input[type=email],.wy-control-group.fluid-input input[type=month],.wy-control-group.fluid-input input[type=number],.wy-control-group.fluid-input input[type=password],.wy-control-group.fluid-input input[type=search],.wy-control-group.fluid-input input[type=tel],.wy-control-group.fluid-input input[type=text],.wy-control-group.fluid-input input[type=time],.wy-control-group.fluid-input input[type=url],.wy-control-group.fluid-input input[type=week]{width:100%}.wy-form-message-inline{padding-left:.3em;color:#666;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;*overflow:visible}input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type=datetime-local]{padding:.34375em .625em}input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type=checkbox],input[type=radio],input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}input[type=color]:focus,input[type=date]:focus,input[type=datetime-local]:focus,input[type=datetime]:focus,input[type=email]:focus,input[type=month]:focus,input[type=number]:focus,input[type=password]:focus,input[type=search]:focus,input[type=tel]:focus,input[type=text]:focus,input[type=time]:focus,input[type=url]:focus,input[type=week]:focus{outline:0;outline:thin dotted\9;border-color:#333}input.no-focus:focus{border-color:#ccc!important}input[type=checkbox]:focus,input[type=file]:focus,input[type=radio]:focus{outline:thin dotted #333;outline:1px auto #129fea}input[type=color][disabled],input[type=date][disabled],input[type=datetime-local][disabled],input[type=datetime][disabled],input[type=email][disabled],input[type=month][disabled],input[type=number][disabled],input[type=password][disabled],input[type=search][disabled],input[type=tel][disabled],input[type=text][disabled],input[type=time][disabled],input[type=url][disabled],input[type=week][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,select:focus:invalid,textarea:focus:invalid{color:#e74c3c;border:1px solid #e74c3c}input:focus:invalid:focus,select:focus:invalid:focus,textarea:focus:invalid:focus{border-color:#e74c3c}input[type=checkbox]:focus:invalid:focus,input[type=file]:focus:invalid:focus,input[type=radio]:focus:invalid:focus{outline-color:#e74c3c}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}input[readonly],select[disabled],select[readonly],textarea[disabled],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type=checkbox][disabled],input[type=radio][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:1px solid #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{left:0;top:0;width:36px;height:12px;background:#ccc}.wy-switch:after,.wy-switch:before{position:absolute;content:"";display:block;border-radius:4px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{width:18px;height:18px;background:#999;left:-3px;top:-3px}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27ae60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#e74c3c}.wy-control-group.wy-control-group-error input[type=color],.wy-control-group.wy-control-group-error input[type=date],.wy-control-group.wy-control-group-error input[type=datetime-local],.wy-control-group.wy-control-group-error input[type=datetime],.wy-control-group.wy-control-group-error input[type=email],.wy-control-group.wy-control-group-error input[type=month],.wy-control-group.wy-control-group-error input[type=number],.wy-control-group.wy-control-group-error input[type=password],.wy-control-group.wy-control-group-error input[type=search],.wy-control-group.wy-control-group-error input[type=tel],.wy-control-group.wy-control-group-error input[type=text],.wy-control-group.wy-control-group-error input[type=time],.wy-control-group.wy-control-group-error input[type=url],.wy-control-group.wy-control-group-error input[type=week],.wy-control-group.wy-control-group-error textarea{border:1px solid #e74c3c}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27ae60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#e74c3c}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#e67e22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980b9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width:480px){.wy-form button[type=submit]{margin:.7em 0 0}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=text],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week],.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0}.wy-form-message,.wy-form-message-inline,.wy-form .wy-help-inline{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width:768px){.tablet-hide{display:none}}@media screen and (max-width:480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.rst-content table.docutils,.rst-content table.field-list,.wy-table{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.rst-content table.docutils caption,.rst-content table.field-list caption,.wy-table caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.rst-content table.docutils td,.rst-content table.docutils th,.rst-content table.field-list td,.rst-content table.field-list th,.wy-table td,.wy-table th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.rst-content table.docutils td:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list td:first-child,.rst-content table.field-list th:first-child,.wy-table td:first-child,.wy-table th:first-child{border-left-width:0}.rst-content table.docutils thead,.rst-content table.field-list thead,.wy-table thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.rst-content table.docutils thead th,.rst-content table.field-list thead th,.wy-table thead th{font-weight:700;border-bottom:2px solid #e1e4e5}.rst-content table.docutils td,.rst-content table.field-list td,.wy-table td{background-color:transparent;vertical-align:middle}.rst-content table.docutils td p,.rst-content table.field-list td p,.wy-table td p{line-height:18px}.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child,.wy-table td p:last-child{margin-bottom:0}.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min,.wy-table .wy-table-cell-min{width:1%;padding-right:0}.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:grey;font-size:90%}.wy-table-tertiary{color:grey;font-size:80%}.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td,.wy-table-backed,.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td{background-color:#f3f6f6}.rst-content table.docutils,.wy-table-bordered-all{border:1px solid #e1e4e5}.rst-content table.docutils td,.wy-table-bordered-all td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.rst-content table.docutils tbody>tr:last-child td,.wy-table-bordered-all tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0!important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980b9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9b59b6}html{height:100%}body,html{overflow-x:hidden}body{font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-weight:400;color:#404040;min-height:100%;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#e67e22!important}a.wy-text-warning:hover{color:#eb9950!important}.wy-text-info{color:#2980b9!important}a.wy-text-info:hover{color:#409ad5!important}.wy-text-success{color:#27ae60!important}a.wy-text-success:hover{color:#36d278!important}.wy-text-danger{color:#e74c3c!important}a.wy-text-danger:hover{color:#ed7669!important}.wy-text-neutral{color:#404040!important}a.wy-text-neutral:hover{color:#595959!important}.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif}p{line-height:24px;font-size:16px;margin:0 0 24px}h1{font-size:175%}.rst-content .toctree-wrapper>p.caption,h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}.rst-content code,.rst-content tt,code{white-space:nowrap;max-width:100%;background:#fff;border:1px solid #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#e74c3c;overflow-x:auto}.rst-content tt.code-large,code.code-large{font-size:90%}.rst-content .section ul,.rst-content .toctree-wrapper ul,.wy-plain-list-disc,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.rst-content .section ul li,.rst-content .toctree-wrapper ul li,.wy-plain-list-disc li,article ul li{list-style:disc;margin-left:24px}.rst-content .section ul li p:last-child,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li p:last-child,.rst-content .toctree-wrapper ul li ul,.wy-plain-list-disc li p:last-child,.wy-plain-list-disc li ul,article ul li p:last-child,article ul li ul{margin-bottom:0}.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,.wy-plain-list-disc li li,article ul li li{list-style:circle}.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,.wy-plain-list-disc li li li,article ul li li li{list-style:square}.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,.wy-plain-list-disc li ol li,article ul li ol li{list-style:decimal}.rst-content .section ol,.rst-content ol.arabic,.wy-plain-list-decimal,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.rst-content .section ol li,.rst-content ol.arabic li,.wy-plain-list-decimal li,article ol li{list-style:decimal;margin-left:24px}.rst-content .section ol li p:last-child,.rst-content .section ol li ul,.rst-content ol.arabic li p:last-child,.rst-content ol.arabic li ul,.wy-plain-list-decimal li p:last-child,.wy-plain-list-decimal li ul,article ol li p:last-child,article ol li ul{margin-bottom:0}.rst-content .section ol li ul li,.rst-content ol.arabic li ul li,.wy-plain-list-decimal li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:after,.wy-breadcrumbs:before{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs li{display:inline-block}.wy-breadcrumbs li.wy-breadcrumbs-aside{float:right}.wy-breadcrumbs li a{display:inline-block;padding:5px}.wy-breadcrumbs li a:first-child{padding-left:0}.rst-content .wy-breadcrumbs li tt,.wy-breadcrumbs li .rst-content tt,.wy-breadcrumbs li code{padding:5px;border:none;background:none}.rst-content .wy-breadcrumbs li tt.literal,.wy-breadcrumbs li .rst-content tt.literal,.wy-breadcrumbs li code.literal{color:#404040}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width:480px){.wy-breadcrumbs-extra,.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:after,.wy-menu-horiz:before{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz li,.wy-menu-horiz ul{display:inline-block}.wy-menu-horiz li:hover{background:hsla(0,0%,100%,.1)}.wy-menu-horiz li.divide-left{border-left:1px solid #404040}.wy-menu-horiz li.divide-right{border-right:1px solid #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#55a5d9;height:32px;line-height:32px;padding:0 1.618em;margin:12px 0 0;display:block;font-weight:700;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:1px solid #404040}.wy-menu-vertical li.divide-bottom{border-bottom:1px solid #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:grey;border-right:1px solid #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.rst-content .wy-menu-vertical li tt,.wy-menu-vertical li .rst-content tt,.wy-menu-vertical li code{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li span.toctree-expand{display:block;float:left;margin-left:-1.2em;font-size:.8em;line-height:1.6em;color:#4d4d4d}.wy-menu-vertical li.current>a,.wy-menu-vertical li.on a{color:#404040;font-weight:700;position:relative;background:#fcfcfc;border:none;padding:.4045em 1.618em}.wy-menu-vertical li.current>a:hover,.wy-menu-vertical li.on a:hover{background:#fcfcfc}.wy-menu-vertical li.current>a:hover span.toctree-expand,.wy-menu-vertical li.on a:hover span.toctree-expand{color:grey}.wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand{display:block;font-size:.8em;line-height:1.6em;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:1px solid #c9c9c9;border-top:1px solid #c9c9c9}.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .toctree-l11>ul{display:none}.wy-menu-vertical .toctree-l1.current .current.toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .current.toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .current.toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .current.toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .current.toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .current.toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .current.toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .current.toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .current.toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .current.toctree-l11>ul{display:block}.wy-menu-vertical li.toctree-l3,.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a,.wy-menu-vertical li.toctree-l5 a,.wy-menu-vertical li.toctree-l6 a,.wy-menu-vertical li.toctree-l7 a,.wy-menu-vertical li.toctree-l8 a,.wy-menu-vertical li.toctree-l9 a,.wy-menu-vertical li.toctree-l10 a{color:#404040}.wy-menu-vertical li.toctree-l2 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l3 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l4 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l5 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l6 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l7 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l8 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l9 a:hover span.toctree-expand,.wy-menu-vertical li.toctree-l10 a:hover span.toctree-expand{color:grey}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{display:block}.wy-menu-vertical li.toctree-l2.current>a{padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current>a{padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current>a{padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current>a{padding:.4045em 7.281em}.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current>a{padding:.4045em 8.899em}.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current>a{padding:.4045em 10.517em}.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current>a{padding:.4045em 12.135em}.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current>a{padding:.4045em 13.753em}.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current>a{padding:.4045em 15.371em}.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{padding:.4045em 16.989em}.wy-menu-vertical li.toctree-l2.current>a,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{background:#c9c9c9}.wy-menu-vertical li.toctree-l2 span.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3.current>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{background:#bdbdbd}.wy-menu-vertical li.toctree-l3 span.toctree-expand{color:#969696}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:400}.wy-menu-vertical a{line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover span.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980b9;cursor:pointer;color:#fff}.wy-menu-vertical a:active span.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980b9;text-align:center;color:#fcfcfc}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a{color:#fcfcfc;font-size:100%;font-weight:700;display:inline-block;padding:4px 6px;margin-bottom:.809em}.wy-side-nav-search .wy-dropdown>a:hover,.wy-side-nav-search>a:hover{background:hsla(0,0%,100%,.1)}.wy-side-nav-search .wy-dropdown>a img.logo,.wy-side-nav-search>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search .wy-dropdown>a.icon img.logo,.wy-side-nav-search>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-nav .wy-menu-vertical header{color:#2980b9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980b9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980b9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:after,.wy-nav-top:before{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:700}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:grey}footer p{margin-bottom:12px}.rst-content footer span.commit tt,footer span.commit .rst-content tt,footer span.commit code{padding:0;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:1em;background:none;border:none;color:grey}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:after,.rst-footer-buttons:before{width:100%;display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:after,.rst-breadcrumbs-buttons:before{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:1px solid #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:1px solid #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:grey;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width:768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-menu.wy-menu-vertical,.wy-side-nav-search,.wy-side-scroll{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width:1100px){.wy-nav-content-wrap{background:rgba(0,0,0,.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,.wy-nav-side,footer{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60;*zoom:1}.rst-versions .rst-current-version:after,.rst-versions .rst-current-version:before{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-content p.caption .rst-versions .rst-current-version .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .icon,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-versions .rst-current-version .rst-content p.caption .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-versions .rst-current-version .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version span.toctree-expand{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content img{max-width:100%;height:auto}.rst-content div.figure{margin-bottom:24px}.rst-content div.figure p.caption{font-style:italic}.rst-content div.figure p:last-child.caption{margin-bottom:0}.rst-content div.figure.align-center{text-align:center}.rst-content .section>a>img,.rst-content .section>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"\f08e";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;display:block;overflow:auto}.rst-content div[class^=highlight],.rst-content pre.literal-block{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px}.rst-content div[class^=highlight] div[class^=highlight],.rst-content pre.literal-block div[class^=highlight]{padding:0;border:none;margin:0}.rst-content div[class^=highlight] td.code{width:100%}.rst-content .linenodiv pre{border-right:1px solid #e6e9ea;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^=highlight] pre{white-space:pre;margin:0;padding:12px;display:block;overflow:auto}.rst-content div[class^=highlight] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content .linenodiv pre,.rst-content div[class^=highlight] pre,.rst-content pre.literal-block{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:12px;line-height:1.4}.rst-content div.highlight .gp{user-select:none;pointer-events:none}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^=highlight],.rst-content div[class^=highlight] pre{white-space:pre-wrap}}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning{clear:both}.rst-content .admonition-todo .last,.rst-content .admonition-todo>:last-child,.rst-content .admonition .last,.rst-content .admonition>:last-child,.rst-content .attention .last,.rst-content .attention>:last-child,.rst-content .caution .last,.rst-content .caution>:last-child,.rst-content .danger .last,.rst-content .danger>:last-child,.rst-content .error .last,.rst-content .error>:last-child,.rst-content .hint .last,.rst-content .hint>:last-child,.rst-content .important .last,.rst-content .important>:last-child,.rst-content .note .last,.rst-content .note>:last-child,.rst-content .seealso .last,.rst-content .seealso>:last-child,.rst-content .tip .last,.rst-content .tip>:last-child,.rst-content .warning .last,.rst-content .warning>:last-child{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent!important;border-color:rgba(0,0,0,.1)!important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha>li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha>li{list-style:upper-alpha}.rst-content .section ol li>*,.rst-content .section ul li>*{margin-top:12px;margin-bottom:12px}.rst-content .section ol li>:first-child,.rst-content .section ul li>:first-child{margin-top:0}.rst-content .section ol li>p,.rst-content .section ol li>p:last-child,.rst-content .section ul li>p,.rst-content .section ul li>p:last-child{margin-bottom:12px}.rst-content .section ol li>p:only-child,.rst-content .section ol li>p:only-child:last-child,.rst-content .section ul li>p:only-child,.rst-content .section ul li>p:only-child:last-child{margin-bottom:0}.rst-content .section ol li>ol,.rst-content .section ol li>ul,.rst-content .section ul li>ol,.rst-content .section ul li>ul{margin-bottom:12px}.rst-content .section ol.simple li>*,.rst-content .section ol.simple li ol,.rst-content .section ol.simple li ul,.rst-content .section ul.simple li>*,.rst-content .section ul.simple li ol,.rst-content .section ul.simple li ul{margin-top:0;margin-bottom:0}.rst-content .line-block{margin-left:0;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0}.rst-content .topic-title{font-weight:700;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0 0 24px 24px}.rst-content .align-left{float:left;margin:0 24px 24px 0}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content .code-block-caption .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink{visibility:hidden;font-size:14px}.rst-content .code-block-caption .headerlink:after,.rst-content .toctree-wrapper>p.caption .headerlink:after,.rst-content dl dt .headerlink:after,.rst-content h1 .headerlink:after,.rst-content h2 .headerlink:after,.rst-content h3 .headerlink:after,.rst-content h4 .headerlink:after,.rst-content h5 .headerlink:after,.rst-content h6 .headerlink:after,.rst-content p.caption .headerlink:after,.rst-content table>caption .headerlink:after{content:"\f0c1";font-family:FontAwesome}.rst-content .code-block-caption:hover .headerlink:after,.rst-content .toctree-wrapper>p.caption:hover .headerlink:after,.rst-content dl dt:hover .headerlink:after,.rst-content h1:hover .headerlink:after,.rst-content h2:hover .headerlink:after,.rst-content h3:hover .headerlink:after,.rst-content h4:hover .headerlink:after,.rst-content h5:hover .headerlink:after,.rst-content h6:hover .headerlink:after,.rst-content p.caption:hover .headerlink:after,.rst-content table>caption:hover .headerlink:after{visibility:visible}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:1px solid #e1e4e5}.rst-content .sidebar dl,.rst-content .sidebar p,.rst-content .sidebar ul{font-size:90%}.rst-content .sidebar .last,.rst-content .sidebar>:last-child{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;font-weight:700;background:#e1e4e5;padding:6px 12px;margin:-24px -24px 24px;font-size:100%}.rst-content .highlighted{background:#f1c40f;box-shadow:0 0 0 2px #f1c40f;display:inline;font-weight:700}.rst-content .citation-reference,.rst-content .footnote-reference{vertical-align:baseline;position:relative;top:-.4em;line-height:0;font-size:90%}.rst-content .hlist{width:100%}html.writer-html4 .rst-content table.docutils.citation,html.writer-html4 .rst-content table.docutils.footnote{background:none;border:none}html.writer-html4 .rst-content table.docutils.citation td,html.writer-html4 .rst-content table.docutils.citation tr,html.writer-html4 .rst-content table.docutils.footnote td,html.writer-html4 .rst-content table.docutils.footnote tr{border:none;background-color:transparent!important;white-space:normal}html.writer-html4 .rst-content table.docutils.citation td.label,html.writer-html4 .rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}html.writer-html5 .rst-content dl dt span.classifier:before{content:" : "}html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{display:grid;grid-template-columns:max-content auto}html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{padding-left:1rem}html.writer-html5 .rst-content dl.field-list>dt:after,html.writer-html5 .rst-content dl.footnote>dt:after{content:":"}html.writer-html5 .rst-content dl.field-list>dd,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dd,html.writer-html5 .rst-content dl.footnote>dt{margin-bottom:0}html.writer-html5 .rst-content dl.footnote{font-size:.9rem}html.writer-html5 .rst-content dl.footnote>dt{margin:0 .5rem .5rem 0;line-height:1.2rem;word-break:break-all;font-weight:400}html.writer-html5 .rst-content dl.footnote>dt>span.brackets{margin-right:.5rem}html.writer-html5 .rst-content dl.footnote>dt>span.brackets:before{content:"["}html.writer-html5 .rst-content dl.footnote>dt>span.brackets:after{content:"]"}html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref{font-style:italic}html.writer-html5 .rst-content dl.footnote>dd{margin:0 0 .5rem;line-height:1.2rem}html.writer-html5 .rst-content dl.footnote>dd p,html.writer-html5 .rst-content dl.option-list kbd{font-size:.9rem}.rst-content table.docutils.footnote,html.writer-html4 .rst-content table.docutils.citation,html.writer-html5 .rst-content dl.footnote{color:grey}.rst-content table.docutils.footnote code,.rst-content table.docutils.footnote tt,html.writer-html4 .rst-content table.docutils.citation code,html.writer-html4 .rst-content table.docutils.citation tt,html.writer-html5 .rst-content dl.footnote code,html.writer-html5 .rst-content dl.footnote tt{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}html.writer-html5 .rst-content table.docutils th{border:1px solid #e1e4e5}html.writer-html5 .rst-content table.docutils td>p,html.writer-html5 .rst-content table.docutils th>p{line-height:1rem;margin-bottom:0;font-size:.9rem}.rst-content table.docutils td .last,.rst-content table.docutils td .last>:last-child{margin-bottom:0}.rst-content table.field-list,.rst-content table.field-list td{border:none}.rst-content table.field-list td p{font-size:inherit;line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content code,.rst-content tt{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;padding:2px 5px}.rst-content code big,.rst-content code em,.rst-content tt big,.rst-content tt em{font-size:100%!important;line-height:normal}.rst-content code.literal,.rst-content tt.literal{color:#e74c3c}.rst-content code.xref,.rst-content tt.xref,a .rst-content code,a .rst-content tt{font-weight:700;color:#404040}.rst-content kbd,.rst-content pre,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace}.rst-content a code,.rst-content a tt{color:#2980b9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:700;margin-bottom:12px}.rst-content dl ol,.rst-content dl p,.rst-content dl table,.rst-content dl ul{margin-bottom:12px}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}html.writer-html4 .rst-content dl:not(.docutils),html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple){margin-bottom:24px}html.writer-html4 .rst-content dl:not(.docutils)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)>dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980b9;border-top:3px solid #6ab0de;padding:6px;position:relative}html.writer-html4 .rst-content dl:not(.docutils)>dt:before,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)>dt:before{color:#6ab0de}html.writer-html4 .rst-content dl:not(.docutils)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.field-list)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dl:not(.field-list)>dt{margin-bottom:6px;border:none;border-left:3px solid #ccc;background:#f0f0f0;color:#555}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.field-list)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dl:not(.field-list)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils)>dt:first-child,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)>dt:first-child{margin-top:0}html.writer-html4 .rst-content dl:not(.docutils) code,html.writer-html4 .rst-content dl:not(.docutils) tt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) code,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) tt{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) code.descclassname,html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descclassname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) code.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) tt.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) tt.descname{background-color:transparent;border:none;padding:0;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) tt.descname{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .optional,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .property,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .property{display:inline-block;padding-right:8px}.rst-content .viewcode-back,.rst-content .viewcode-link{display:inline-block;color:#27ae60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:700}.rst-content code.download,.rst-content tt.download{background:inherit;padding:inherit;font-weight:400;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content code.download span:first-child,.rst-content tt.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{margin-right:4px}.rst-content .guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content .versionmodified{font-style:italic}@media screen and (max-width:480px){.rst-content .sidebar{width:100%}}span[id*=MathJax-Span]{color:#404040}.math{text-align:center}@font-face{font-family:Lato;src:url(fonts/lato-normal.woff2?bd03a2cc277bbbc338d464e679fe9942) format("woff2"),url(fonts/lato-normal.woff?27bd77b9162d388cb8d4c4217c7c5e2a) format("woff");font-weight:400;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold.woff2?cccb897485813c7c256901dbca54ecf2) format("woff2"),url(fonts/lato-bold.woff?d878b6c29b10beca227e9eef4246111b) format("woff");font-weight:700;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold-italic.woff2?0b6bb6725576b072c5d0b02ecdd1900d) format("woff2"),url(fonts/lato-bold-italic.woff?9c7e4e9eb485b4a121c760e61bc3707c) format("woff");font-weight:700;font-style:italic;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-normal-italic.woff2?4eb103b4d12be57cb1d040ed5e162e9d) format("woff2"),url(fonts/lato-normal-italic.woff?f28f2d6482446544ef1ea1ccc6dd5892) format("woff");font-weight:400;font-style:italic;font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:400;src:url(fonts/Roboto-Slab-Regular.woff2?7abf5b8d04d26a2cafea937019bca958) format("woff2"),url(fonts/Roboto-Slab-Regular.woff?c1be9284088d487c5e3ff0a10a92e58c) format("woff");font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:700;src:url(fonts/Roboto-Slab-Bold.woff2?9984f4a9bda09be08e83f2506954adbe) format("woff2"),url(fonts/Roboto-Slab-Bold.woff?bed5564a116b05148e3b3bea6fb1162a) format("woff");font-display:block} \ No newline at end of file diff --git a/src/extra/manual/beta/_static/documentation_options.js b/src/extra/manual/beta/_static/documentation_options.js index b658c023..82532597 100644 --- a/src/extra/manual/beta/_static/documentation_options.js +++ b/src/extra/manual/beta/_static/documentation_options.js @@ -1,6 +1,6 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '6.9.7', + VERSION: '6.9.8', LANGUAGE: 'None', COLLAPSE_INDEX: false, BUILDER: 'html', diff --git a/src/extra/manual/beta/_static/fonts/Inconsolata.ttf b/src/extra/manual/beta/_static/fonts/Inconsolata.ttf new file mode 100644 index 00000000..4b8a36d2 Binary files /dev/null and b/src/extra/manual/beta/_static/fonts/Inconsolata.ttf differ diff --git a/src/extra/manual/beta/_static/js/badge_only.js b/src/extra/manual/beta/_static/js/badge_only.js new file mode 100644 index 00000000..526d7234 --- /dev/null +++ b/src/extra/manual/beta/_static/js/badge_only.js @@ -0,0 +1 @@ +!function(e){var t={};function r(n){if(t[n])return t[n].exports;var o=t[n]={i:n,l:!1,exports:{}};return e[n].call(o.exports,o,o.exports,r),o.l=!0,o.exports}r.m=e,r.c=t,r.d=function(e,t,n){r.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:n})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(r.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)r.d(n,o,function(t){return e[t]}.bind(null,o));return n},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="",r(r.s=4)}({4:function(e,t,r){}}); \ No newline at end of file diff --git a/src/extra/manual/beta/_static/js/html5shiv-printshiv.min.js b/src/extra/manual/beta/_static/js/html5shiv-printshiv.min.js new file mode 100644 index 00000000..2b43bd06 --- /dev/null +++ b/src/extra/manual/beta/_static/js/html5shiv-printshiv.min.js @@ -0,0 +1,4 @@ +/** +* @preserve HTML5 Shiv 3.7.3-pre | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed +*/ +!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=y.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=y.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),y.elements=c+" "+a,j(b)}function f(a){var b=x[a[v]];return b||(b={},w++,a[v]=w,x[w]=b),b}function g(a,c,d){if(c||(c=b),q)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():u.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||t.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),q)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return y.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(y,b.frag)}function j(a){a||(a=b);var d=f(a);return!y.shivCSS||p||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),q||i(a,d),a}function k(a){for(var b,c=a.getElementsByTagName("*"),e=c.length,f=RegExp("^(?:"+d().join("|")+")$","i"),g=[];e--;)b=c[e],f.test(b.nodeName)&&g.push(b.applyElement(l(b)));return g}function l(a){for(var b,c=a.attributes,d=c.length,e=a.ownerDocument.createElement(A+":"+a.nodeName);d--;)b=c[d],b.specified&&e.setAttribute(b.nodeName,b.nodeValue);return e.style.cssText=a.style.cssText,e}function m(a){for(var b,c=a.split("{"),e=c.length,f=RegExp("(^|[\\s,>+~])("+d().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),g="$1"+A+"\\:$2";e--;)b=c[e]=c[e].split("}"),b[b.length-1]=b[b.length-1].replace(f,g),c[e]=b.join("}");return c.join("{")}function n(a){for(var b=a.length;b--;)a[b].removeNode()}function o(a){function b(){clearTimeout(g._removeSheetTimer),d&&d.removeNode(!0),d=null}var d,e,g=f(a),h=a.namespaces,i=a.parentWindow;return!B||a.printShived?a:("undefined"==typeof h[A]&&h.add(A),i.attachEvent("onbeforeprint",function(){b();for(var f,g,h,i=a.styleSheets,j=[],l=i.length,n=Array(l);l--;)n[l]=i[l];for(;h=n.pop();)if(!h.disabled&&z.test(h.media)){try{f=h.imports,g=f.length}catch(o){g=0}for(l=0;g>l;l++)n.push(f[l]);try{j.push(h.cssText)}catch(o){}}j=m(j.reverse().join("")),e=k(a),d=c(a,j)}),i.attachEvent("onafterprint",function(){n(e),clearTimeout(g._removeSheetTimer),g._removeSheetTimer=setTimeout(b,500)}),a.printShived=!0,a)}var p,q,r="3.7.3",s=a.html5||{},t=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,u=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,v="_html5shiv",w=0,x={};!function(){try{var a=b.createElement("a");a.innerHTML="",p="hidden"in a,q=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){p=!0,q=!0}}();var y={elements:s.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:r,shivCSS:s.shivCSS!==!1,supportsUnknownElements:q,shivMethods:s.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=y,j(b);var z=/^$|\b(?:all|print)\b/,A="html5shiv",B=!q&&function(){var c=b.documentElement;return!("undefined"==typeof b.namespaces||"undefined"==typeof b.parentWindow||"undefined"==typeof c.applyElement||"undefined"==typeof c.removeNode||"undefined"==typeof a.attachEvent)}();y.type+=" print",y.shivPrint=o,o(b),"object"==typeof module&&module.exports&&(module.exports=y)}("undefined"!=typeof window?window:this,document); \ No newline at end of file diff --git a/src/extra/manual/beta/_static/js/html5shiv.min.js b/src/extra/manual/beta/_static/js/html5shiv.min.js new file mode 100644 index 00000000..cd1c674f --- /dev/null +++ b/src/extra/manual/beta/_static/js/html5shiv.min.js @@ -0,0 +1,4 @@ +/** +* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed +*/ +!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3-pre",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document); \ No newline at end of file diff --git a/src/extra/manual/beta/_static/js/theme.js b/src/extra/manual/beta/_static/js/theme.js index 8555d79b..839d07e2 100644 --- a/src/extra/manual/beta/_static/js/theme.js +++ b/src/extra/manual/beta/_static/js/theme.js @@ -1,3 +1 @@ -/* sphinx_rtd_theme version 0.4.3 | MIT license */ -/* Built 20190212 16:02 */ -require=function r(s,a,l){function c(e,n){if(!a[e]){if(!s[e]){var i="function"==typeof require&&require;if(!n&&i)return i(e,!0);if(u)return u(e,!0);var t=new Error("Cannot find module '"+e+"'");throw t.code="MODULE_NOT_FOUND",t}var o=a[e]={exports:{}};s[e][0].call(o.exports,function(n){return c(s[e][1][n]||n)},o,o.exports,r,s,a,l)}return a[e].exports}for(var u="function"==typeof require&&require,n=0;n"),i("table.docutils.footnote").wrap("
"),i("table.docutils.citation").wrap("
"),i(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var e=i(this);expand=i(''),expand.on("click",function(n){return t.toggleCurrent(e),n.stopPropagation(),!1}),e.prepend(expand)})},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),i=e.find('[href="'+n+'"]');if(0===i.length){var t=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(i=e.find('[href="#'+t.attr("id")+'"]')).length&&(i=e.find('[href="#"]'))}0this.docHeight||(this.navBar.scrollTop(i),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1})},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:e.exports.ThemeNav,StickyNav:e.exports.ThemeNav}),function(){for(var r=0,n=["ms","moz","webkit","o"],e=0;e"),n("table.docutils.footnote").wrap("
"),n("table.docutils.citation").wrap("
"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each((function(){var t=n(this);expand=n(''),expand.on("click",(function(n){return e.toggleCurrent(t),n.stopPropagation(),!1})),t.prepend(expand)}))},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),t=e.find('[href="'+n+'"]');if(0===t.length){var i=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(t=e.find('[href="#'+i.attr("id")+'"]')).length&&(t=e.find('[href="#"]'))}t.length>0&&($(".wy-menu-vertical .current").removeClass("current"),t.addClass("current"),t.closest("li.toctree-l1").addClass("current"),t.closest("li.toctree-l1").parent().addClass("current"),t.closest("li.toctree-l1").addClass("current"),t.closest("li.toctree-l2").addClass("current"),t.closest("li.toctree-l3").addClass("current"),t.closest("li.toctree-l4").addClass("current"),t.closest("li.toctree-l5").addClass("current"),t[0].scrollIntoView())}catch(n){console.log("Error expanding nav for anchor",n)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",(function(){this.linkScroll=!1}))},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:n.exports.ThemeNav,StickyNav:n.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t - - + - - - - + + + + + 26. Best practice — cdist 6.9.8 documentation + + + + + + - 26. Best practice — cdist 6.9.7 documentation - + - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -175,18 +180,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 26. Best practice
  • - + View page source @@ -200,17 +207,17 @@
    -
    +

    26. Best practice

    Practices used in real environments

    -
    +

    26.1. Passwordless connections

    It is recommended to run cdist with public key authentication. This requires a private/public key pair and the entry "PermitRootLogin without-password" in the sshd server. See sshd_config(5) and ssh-keygen(1).

    -
    -
    +
    +

    26.2. Speeding up ssh connections

    When connecting to a new host, the initial delay with ssh connections is pretty big. As cdist makes many connections to each host successive @@ -223,16 +230,16 @@ ControlPersist=2h).

    Note that the sshd_config on the server can configure the maximum number of parallel multiplexed connections this with MaxSessions N (N defaults to 10 for OpenSSH v7.4).

    -
    -
    +
    +

    26.3. Speeding up shell execution

    On the source host, ensure that /bin/sh is not bash: bash is quite slow for script execution. Instead, you could use dash after installing it:

    ln -sf /bin/dash /bin/sh
    - -
    +
    +

    26.4. Multi master or environment setups

    If you plan to distribute cdist among servers or use different environments, you can do so easily with the included version @@ -257,8 +264,8 @@ you can clone it multiple times:

    machine-b % git clone git://your-git-server/cdist
    - -
    +
+

26.5. Separating work by groups

If you are working with different groups on one cdist-configuration, you can delegate to other manifests and have the groups edit only @@ -270,8 +277,8 @@ their manifests. You can use the following snippet in sh -e "$__manifest/cbrg"

- -
+ +

26.6. Maintaining multiple configurations

When you need to manage multiple sites with cdist, like company_a, company_b and private for instance, you can easily use git for this purpose. @@ -329,8 +336,8 @@ Including a possible common base that is reused across the different sites:

Have a look at git-remote(1) to adjust the remote configuration, which allows

-
-
+ +

26.7. Multiple developers with different trust

If you are working in an environment that requires different people to work on the same configuration, but having different privileges, you can @@ -349,8 +356,8 @@ implement this scenario with a gateway host and sudo:

For more details consult sudoers(5)

-
-
+ +

26.8. Templating

  • create directory files/ in your type (convention)

    • @@ -387,8 +394,8 @@ cat << EOF --source "$__object/files/basic.conf"
-
-
+ +

26.9. Testing a new type

If you want to test a new type on a node, you can tell cdist to only use an object of this type: Use the '--initial-manifest' parameter @@ -406,8 +413,8 @@ of cdist:

cdist config --initial-manifest - cdist-dev-01.ungleich.ch
-
-
+ +

26.10. Other content in cdist repository

Usually the cdist repository contains all configuration items. Sometimes you may have additional resources that @@ -419,8 +426,8 @@ in the repository for such content: It allows you to easily distinguish what is used by cdist and what is not and also to store all important files in one repository.

-
-
+ +

26.11. Notes on CDIST_ORDER_DEPENDENCY

With CDIST_ORDER_DEPENDENCY all types are executed in the order in which they are created in the manifest. The current created object automatically depends @@ -428,7 +435,7 @@ on the previously created object.

It essentially helps you to build up blocks of code that build upon each other (like first creating the directory xyz than the file below the directory).

This can be helpful, but one must be aware of its side effects.

-
+

26.11.1. CDIST_ORDER_DEPENDENCY kills parallelization

Suppose you have defined CDIST_ORDER_DEPENDENCY and then, among other things, you specify creation of three, by nature independent, files.

@@ -461,38 +468,38 @@ __file /tmp/file3 unset CDIST_ORDER_DEPENDENCY
-
- - + + + - @@ -501,7 +508,6 @@ __file /tmp/file3 - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -165,18 +170,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 12. Bootstrap
  • - + View page source @@ -190,12 +197,12 @@
    -
    +

    12. Bootstrap

    This document describes the usual steps recommended for a new cdist setup. It is recommended that you have read and understood cdist quickstart before digging into this.

    -
    +

    12.1. Location

    First of all, you should think about where to store your configuration database and who will be accessing or changing it. Secondly you have to @@ -208,8 +215,8 @@ relies on is recommended, for use as backup as well as to allow easy collaborati with others.

    For more sophisticated setups developing cdist configurations with multiple people, have a look at cdist best practice.

    -
    -
    +
    +

    12.2. Setup working directory and branch

    I assume you have a fresh copy of the cdist tree in ~/cdist, cloned from one of the official URLs (see cdist quickstart if you don't). @@ -256,8 +263,8 @@ ethz-systems, localch, customerX, ... But this is pretty much up to you.

    From now on, you can use git as usual to commit your changes in your own branch.

    - -
    +
    +

    12.3. Publishing the configuration

    Usually a development machine like a notebook should be considered temporary only. For this reason and to enable shareability, the configuration @@ -284,8 +291,8 @@ reachable via ssh and has git installed:

    Now you have setup the git repository to synchronise the mycompany branch with the master branch on the host loch. Thus you can commit as usual in your branch and push out changes by entering git push.

    - -
    +
    +

    12.4. Updating from origin

    Whenever you want to update your cdist installation, you can use git to do so:

    # Update git repository with latest changes from origin
@@ -298,37 +305,37 @@ as usual in your branch and push out changes by entering git pushcdist% git merge origin/2.0
    - - +
    +
- @@ -337,7 +344,6 @@ as usual in your branch and push out changes by entering git push - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -166,18 +171,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 28. Local cache overview
  • - + View page source @@ -191,9 +198,9 @@
    -
    +

    28. Local cache overview

    -
    +

    28.1. Description

    While executing, cdist stores data to local cache. Currently this feature is one way only. That means that cdist does not use stored data for future runs. @@ -206,8 +213,8 @@ configuration option or by using CDIST_CACHE_PATH_PATTERN environment variable.

    For more info on cache path pattern see CACHE PATH PATTERN FORMAT section in cdist man page.

    -
    -
    +
    +

    28.2. Cache overview

    As noted above each configured host has got its subdirectory in local cache. Entries in host's cache directory are as follows.

    @@ -236,7 +243,7 @@ cdist

    typeorder

    file containing types in order of execution.

    -
    +

    28.2.1. Object cache overview

    Each object under object directory has its own structure.

    @@ -280,38 +287,38 @@ outputs

    outputs.

    -
    -
    - +
    +
    +
- @@ -320,7 +327,6 @@ outputs.

- + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -163,18 +168,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 13. Configuration
  • - + View page source @@ -188,9 +195,9 @@
    -
    +

    13. Configuration

    -
    +

    13.1. Description

    cdist obtains configuration data from the following sources in the following order:

    @@ -216,8 +223,8 @@ then ~/.cdist.cfg is used.

    For a per-project configuration, particular environment variables or better, CDIST_CONFIG_FILE environment variable or -g CONFIG_FILE command line option, can be used.

    -
    -
    +
    +

    13.2. Config file format

    cdist configuration file is in the INI file format. Currently it supports only [GLOBAL] section.

    @@ -308,37 +315,37 @@ only [GLOBAL] section.

    # verbosity = INFO
    - - +
    +
- @@ -347,7 +354,6 @@ only [GLOBAL] section.

- + @@ -29,14 +36,10 @@ - - - - - + @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -163,18 +168,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 17. Explorer
  • - + View page source @@ -188,9 +195,9 @@
    -
    +

    17. Explorer

    -
    +

    17.1. Description

    Explorers are small shell scripts, which will be executed on the target host. The aim of each explorer is to give hints to types on how to act on the @@ -213,8 +220,8 @@ the type specific below the object.

    error message on stderr, which will cause cdist to abort.

    You can also use stderr for debugging purposes while developing a new explorer.

    -
    -
    +
    +

    17.2. Examples

    A very simple explorer may look like this:

    hostname
@@ -232,37 +239,37 @@ explorer.
    
 dpkg -s "$name" 2>/dev/null || exit 0
    -
    - +
    +
- @@ -271,7 +278,6 @@ dpkg -s "$name jQuery(function () { SphinxRtdTheme.Navigation.enable(true); diff --git a/src/extra/manual/beta/cdist-features.html b/src/extra/manual/beta/cdist-features.html index 270e087e..e09c1712 100644 --- a/src/extra/manual/beta/cdist-features.html +++ b/src/extra/manual/beta/cdist-features.html @@ -1,24 +1,31 @@ - - + - - - - + + + + + 2. Features — cdist 6.9.8 documentation + + + + + + - 2. Features — cdist 6.9.7 documentation - + - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -159,18 +164,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 2. Features
  • - + View page source @@ -184,7 +191,7 @@
    -
    +

    2. Features

    But cdist ticks differently, here is the feature set that makes it unique:

    @@ -222,36 +229,36 @@ Batteries included: A lot of requirements can be solved using standard types

    UNIX, simplicity, familiar environment

    cdist is configured in POSIX shell

    -
    +
- @@ -260,7 +267,6 @@ Batteries included: A lot of requirements can be solved using standard types

- + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -167,18 +172,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 31. Hacking
  • - + View page source @@ -192,9 +199,9 @@
    -
    +

    31. Hacking

    -
    +

    31.1. Welcome

    Welcome dear hacker! I invite you to a tour of pointers to get into the usable configuration management system, cdist.

    @@ -202,20 +209,20 @@ get into the usable configuration management system, cdist.

    you by people who care about how code looks like and who think twice before merging or implementing a feature: Less features with good usability are far better than the opposite.

    -
    -
    +
    +

    31.2. Reporting bugs

    If you believe you've found a bug and verified that it is in the latest version, drop a mail to the cdist mailing list, subject prefixed with "[BUG] " or create an issue on code.ungleich.ch.

    -
    -
    +
    +

    31.3. Coding conventions (everywhere)

    If something should be improved or needs to be fixed, add the word FIXME nearby, so grepping for FIXME gives all positions that need to be fixed.

    Indentation is 4 spaces (welcome to the python world).

    - -
    +
    +

    31.4. How to submit stuff for inclusion into upstream cdist

    If you did some cool changes to cdist, which you think might be of benefit to other cdist users, you're welcome to propose inclusion into upstream.

    @@ -242,8 +249,8 @@ the other needs to be improved.

    • As soon as your work meets these requirements, write a mail for inclusion to the mailinglist cdist-configuration-management at googlegroups.com or open a merge request at https://code.ungleich.ch/ungleich-public/cdist.

    - -
    +
+

31.5. How to submit a new type

For detailed information about types, see cdist type.

Submitting a type works as described above, with the additional requirement @@ -254,8 +261,8 @@ AND the manpage builds (make man).

gencode will not be accepted, because they are of no use. Every type can output code and thus such a type introduces redundant functionality that is given by core cdist already.

- -
+
+

31.6. Example git workflow

The following workflow works fine for most developers

# get latest upstream master branch
@@ -327,37 +334,37 @@ git merge origin/master

(you can repeat the code above for as many features as you want to develop in parallel)

- - +
+
- @@ -366,7 +373,6 @@ in parallel)

- + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -176,18 +181,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 4. How to install cdist
  • - + View page source @@ -201,11 +208,11 @@
    -
    +

    4. How to install cdist

    -
    +

    4.1. Requirements

    -
    +

    4.1.1. Source Host

    This is the machine from which you will configure target hosts.

    @@ -213,11 +220,11 @@

  • /bin/sh: A POSIX like shell (for instance bash, dash, zsh)

  • Python >= 3.5

  • SSH client

    • -

  • sphinx (for building html docs and/or the man pages)

    • +

  • sphinx with the rtd theme (for building html docs and/or the man pages)

- -
+ +

4.1.2. Target Hosts

    @@ -225,11 +232,11 @@

  • SSH server

-
- -
+ + +

4.2. Install cdist

-
+

4.2.1. From git

Cloning cdist from git gives you the advantage of having a version control in place for development of your own stuff @@ -263,7 +270,7 @@ Or directly with distutils:

Note that bin/cdist-build-helper script is intended for cdist maintainers.

-
+

4.2.1.1. Available versions in git

    @@ -281,8 +288,8 @@ git checkout -b <localbranchname> origin/<branchname> 
    git checkout -b 4.1 origin/4.1
    -
-
+ +

4.2.1.2. Building and using documentation (man and html)

If you want to build and use the documentation, run:

make docs
@@ -319,17 +326,17 @@ some other custom .cdist directory, e.g. /opt/cdist then use:

Note that dotman-target has to be built before a make docs-run, otherwise the custom man-pages are not picked up.

-
-
-
+ + +

4.2.2. Python package

Cdist is available as a python package at PyPi. You can install it using

pip install cdist
-
-
+ +

4.2.3. Installing from source with signature verification

If you want to install cdist from signed source and verify it, first you need to download cdist archive and its detached signature.

@@ -346,38 +353,38 @@ gpg: Good signature from "ungleich GmbH (ungleich FOSS) &l

Further steps are the same as for installing from git.

-
- - + + + - @@ -386,7 +393,6 @@ gpg: Good signature from "ungleich GmbH (ungleich FOSS) &l - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -163,18 +168,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 24. cdist integration / using cdist as library
  • - + View page source @@ -188,9 +195,9 @@
    -
    +

    24. cdist integration / using cdist as library

    -
    +

    24.1. Description

    cdist can be integrate with other applications by importing cdist and other cdist modules and setting all by hand. There are also helper functions which @@ -209,8 +216,8 @@ path to cdist executable, if it is None then functions will try to find it first from local lib directory and then in PATH.

    In case of cdist error cdist.Error exception is raised.

    WARNING: cdist integration helper functions are not yet stable!

    -
    -
    +
    +

    24.2. Examples

    # configure host from python interactive shell
 >>> import cdist.integration
@@ -230,37 +237,37 @@ find it first from local lib directory and then in PATH.
    
 ...                                          '~/.cdist/manifest/init')
    -
    - +
    +
- @@ -269,7 +276,6 @@ find it first from local lib directory and then in PATH.

- + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -168,18 +173,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 20. Inventory
  • - + View page source @@ -193,16 +200,16 @@
    -
    +

    20. Inventory

    -
    +

    20.1. Introduction

    cdist comes with simple built-in tag based inventory. It is a simple inventory with list of hosts and a host has a list of tags. Inventory functionality is still in beta so it can be used only if beta command line flag is specified (-b, --beta) or setting CDIST_BETA env var.

    -
    -
    +
    +

    20.2. Description

    The idea is to have simple tagging inventory. There is a list of hosts and for each host there are tags. Inventory database is a set of files under inventory @@ -214,21 +221,21 @@ context mean that host has two tags and it is selected by specifying that both tags are present.

    This inventory is KISS cdist built-in inventory database. You can maintain it using cdist inventory interface or using standard UNIX tools.

    -
    -
    +
    +

    20.3. cdist inventory interface

    With cdist inventory interface you can list host(s) and tag(s), add host(s), add tag(s), delete host(s) and delete tag(s).

    - -
    +
    +

    20.4. Configuring hosts using inventory

    config command now has new options, -t, -a and -A.

    -A means that all hosts in tag db is selected.

    -a means that selected hosts must contain ALL specified tags.

    -t means that host specifies tag - all hosts that have specified tags are selected.

    - -
    +
    +

    20.5. Examples

    # List inventory content
 $ cdist inventory list -b
@@ -267,8 +274,8 @@ $ cdist config -b -t -a web dynamic
 $ cdist config -b -A
    - -
    +
    +

    20.6. Example of manipulating database

    $ python3 scripts/cdist inventory list -b
 $ python3 scripts/cdist inventory add-host -b localhost
@@ -376,8 +383,8 @@ cloud

    For more info about inventory commands and options see cdist(1).

    - -
    +
    +

    20.7. Using external inventory

    cdist can be used with any external inventory where external inventory is some storage or database from which you can get a list of hosts to configure. @@ -388,37 +395,37 @@ can use it with cdist like:

    $ sqlite3 hosts.db "select hostname from hosts where purpose = 'django';" | cdist config
    - - +
    +
- @@ -427,7 +434,6 @@ can use it with cdist like:

- + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
- 6.9.7 + 6.9.8
@@ -80,6 +83,7 @@ + + @@ -169,18 +174,20 @@ + +
    -
  • Docs »
    • +
  • »
  • 14. Manifest
  • - + View page source @@ -194,9 +201,9 @@
    -
    +

    14. Manifest

    -
    +

    14.1. Description

    Manifests are used to define which objects to create. Objects are instances of types, like in object oriented programming languages. @@ -224,15 +231,15 @@ The resulting objects are stored in an internal database.

    the parameters are exactly the same.

    In general, manifests are used to define which types are used depending on given conditions.

    -
    -
    +
    +

    14.2. Initial and type manifests

    Cdist knows about two types of manifests: The initial manifest and type manifests. The initial manifest is used to define, which configurations to apply to which hosts. The type manifests are used to create objects from types. More about manifests in types can be found in cdist type.

    -
    -
    +
    +

    14.3. Define state in the initial manifest

    The initial manifest is the entry point for cdist to find out, which objects to configure on the selected host. @@ -258,8 +265,8 @@ is only created on the host localhost.

    As you can see, there is no magic involved, the manifest is simple shell code that utilises cdist types. Every available type can be executed like a normal command.

    - -
    +
    +

    14.4. Splitting up the initial manifest

    If you want to split up your initial manifest, you can create other shell scripts in cdist/conf/manifest/ and include them in cdist/conf/manifest/init. @@ -273,8 +280,8 @@ for manifest in $__manifest/*.sh; do done

    - -
    +
+

14.5. Dependencies

If you want to describe that something requires something else, just setup the variable "require" to contain the requirements. Multiple @@ -325,8 +332,8 @@ from the type that is calling them. This is called "autorequirement" i cdist jargon.

You can find a more in depth description of the flow execution of manifests in cdist execution stages and of how types work in cdist type.

- -
+
+

14.6. Create dependencies from execution order

You can tell cdist to execute all types in the order in which they are created in the manifest by setting up the variable CDIST_ORDER_DEPENDENCY. @@ -436,8 +443,8 @@ __file /tmp/fileI

  • H depends on G

    • and there are no other dependencies from this manifest.

    - -
    +
    +

    14.7. Overrides

    In some special cases, you would like to create an already defined object with different parameters. In normal situations this leads to an error in cdist. @@ -450,8 +457,8 @@ in an undefined situation.

    If CDIST_OVERRIDE and CDIST_ORDER_DEPENDENCY are set for an object, CDIST_ORDER_DEPENDENCY will be ignored, because adding a dependency in case of overrides would result in circular dependencies, which is an error.

    - -
    +
    +

    14.8. Examples

    The initial manifest may for instance contain the following code:

    # Always create this file, so other sysadmins know cdist is used.
@@ -515,37 +522,37 @@ __sample_type 1
 __not_in_order_type 42
    - - +
    + - @@ -554,7 +561,6 @@ __not_in_order_type 42 - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -164,18 +169,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 18. Messaging
    • - + View page source @@ -189,9 +196,9 @@
      -
      +

      18. Messaging

      -
      +

      18.1. Description

      cdist has a simple but powerful way of allowing communication between the initial manifest and types as well as types and types.

      @@ -208,8 +215,8 @@ interfere with other types.

      The order of execution is not defined unless you create dependencies between the different objects (see cdist manifest) and thus you can only react reliably on messages by objects that you depend on.

      -
      -
      +
      +

      18.2. Availability

      Messaging is possible between all local scripts:

        @@ -218,8 +225,8 @@ can only react reliably on messages by objects that you depend on.

      • type/gencode-local

      • type/gencode-remote

      -
      -
      +
      +

      18.3. Examples

      When you want to emit a message use:

      echo "something" >> "$__messages_out"
@@ -269,37 +276,37 @@ can only react reliably on messages by objects that you depend on.
      
 fi
      - - +
      +
    - @@ -308,7 +315,6 @@ can only react reliably on messages by objects that you depend on.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -159,18 +164,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 3. Supported operating systems
    • - + View page source @@ -184,7 +191,7 @@
      -
      +

      3. Supported operating systems

      cdist was tested or is know to run on at least

      -
      +
    - @@ -241,7 +248,6 @@ - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -164,18 +169,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 19. Parallelization
    • - + View page source @@ -189,9 +196,9 @@
      -
      +

      19. Parallelization

      -
      +

      19.1. Description

      cdist has two modes of parallel operation.

      One of them is to operate on each host in separate process. This is enabled @@ -205,8 +212,8 @@ object preparation and object run are supported.

      will be processed by its own process. Within each process cdist will operate using specified number of parallel jobs.

      For more info on those options see cdist(1).

      -
      -
      +
      +

      19.2. Examples

      # Configure hosts read from file hosts.file in parallel
 $ cdist config -p -f hosts.file
@@ -220,8 +227,8 @@ $ cdist config -j -f hosts.file
 $ cdist config -j 16 -p -f hosts.file
      -
      -
      +
      +

      19.3. Caveats

      When operating in parallel, either by operating in parallel for each host (-p/--parallel) or by parallel jobs within a host (-j/--jobs), and depending @@ -252,37 +259,37 @@ INFO: 78.47.116.244: Finished successful run in time for 1 host(s): 19.159148693084717

      - - +
    + - @@ -291,7 +298,6 @@ INFO: cdist: Total processing time for - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -172,18 +177,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 22. PreOS
    • - + View page source @@ -197,16 +204,16 @@
      -
      +

      22. PreOS

      -
      +

      22.1. Description

      With cdist you can install and configure new machines. You can use cdist to create PreOS, minimal OS whose purpose is to boot a new machine. After PreOS is booted, the machine is ready for installing the desired OS and afterwards it is ready for configuration.

      -
      -
      +
      +

      22.2. PreOS creation

      With cdist you can create PreOS. Currently supported PreOS-es include:

      @@ -240,8 +247,8 @@ in the previous chapter.

      Machine will connect to cdist trigger server. If the request is, for example, for installation then cdist trigger server will start install command for the client host using parameters specified at trigger server startup.

      -
      -
      +
      +

      22.3. Implementing new PreOS sub-command

      preos command is implemented as a plugin system. This plugin system scans for preos subcommands in the cdist/preos/ distribution directory and also in @@ -264,9 +271,9 @@ attribute if defined in the module/class, defaulting to the module/class name in When a registered preos subcommand is specified, commandline will be called with the first argument set to module/class and the second argument set to sys.argv[2:].

      -
      +

      22.3.1. Example of writing new dummy preos sub-command

      -
      +

      22.3.1.1. Module-based preos:

      1. Create directory ~/.cdist/preos/ if it does not exist

        2. @@ -290,8 +297,8 @@ $ cdist preos netbsd NetBSD PreOS: []
      -
      -
      +
      +

      22.3.1.2. Class based preos:

      1. Create directory ~/.cdist/preos/ if it does not exist

        2. @@ -318,10 +325,10 @@ FreeBSD dummy preos: []

      In the commandline function/method you have all the freedom to actually create a PreOS.

      - - - -
      +
      +
    + +

    22.4. Simple tipical use case for using PreOS and trigger

    Tipical use case for using PreOS and trigger command include the following steps.

      @@ -348,37 +355,37 @@ default init manifest for installation).

    1. Cdist trigger server starts installing host that has triggered it.

    2. After cdist install is finished new host is installed.

    - - +
    + - @@ -387,7 +394,6 @@ default init manifest for installation).

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -159,18 +164,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 7. Quickstart
    • - + View page source @@ -184,7 +191,7 @@
      -
      +

      7. Quickstart

      This tutorial is aimed at people learning cdist and shows typical approaches as well as gives an easy start into @@ -255,36 +262,36 @@ then ~/.cdist/manifest sub-directory and create init manifest

      That's it, you've successfully used cdist to configure your first host! Continue reading the next sections, to understand what you did and how to create a more sophisticated configuration.

      -
      +
    - @@ -293,7 +300,6 @@ to create a more sophisticated configuration.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -186,18 +191,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 8. Dive into real world cdist
    • - + View page source @@ -211,9 +218,9 @@
      -
      +

      8. Dive into real world cdist

      -
      +

      8.1. Introduction

      This walkthrough shows real world cdist configuration example.

      Sample target host is named test.ungleich.ch. @@ -238,8 +245,8 @@ for that. This type will:

      to configure hosting for specified user and project. It is up to the user to create his/her applications.

      So let's start.

      -
      -
      +
      +

      8.2. Creating type layout

      We will create a new custom type. Let's call it __sample_bottle_hosting.

      Go to ~/.cdist/type directory (create it if it does not exist) and create @@ -252,8 +259,8 @@ new type layout:

      touch parameter/required
      - -
      +
      +

      8.3. Creating __sample_bottle_hosting type parameters

      Our type will be configurable through the means of parameters. Let's define the following parameters:

      @@ -273,8 +280,8 @@ the following parameters:

    For details on type parameters see Defining parameters.

    - -
    + +

    8.4. Creating __sample_bottle_hosting type manifest

    Next step is to define manifest (~/.cdist/type/__sample_bottle_hosting/manifest). We also want our type to currently support only Devuan. So we will start by @@ -300,7 +307,7 @@ OS distributions like GNU/Linux distributions. There can also be a different configuration locations (e.g. nginx config directory could be in /usr/local tree). If we detected unsupported OS we should error out. cdist will stop configuration process and output error message.

    -
    +

    8.4.1. Creating user and user directories

    Then we create user and his/her home directory and application home directory. We will use existing cdist types __user and __directory:

    @@ -323,8 +330,8 @@ require="__user/$user __directory/$home" __directory "$apphome&qu User home directory should be created after user is created. And application home directory is created after both user and user home directory are created. For details on require see Dependencies.

    -
    -
    +
    +

    8.4.2. Installing packages

    Install required packages using existing __package type. Before installing package we want to update apt package index using @@ -351,8 +358,8 @@ for package in bottle bottle-pgsql; do done

    -
    -
    + +

    8.4.3. Creating PostgreSQL database

    Create PostgreSQL database using __postgres_database and __postgres_role for creating database user:

    @@ -366,8 +373,8 @@ require="__postgres_role/$user __package/postgresql" __postgres_databa --owner $user
    -
    -
    + +

    8.4.4. Configuring uWSGI

    Configure uWSGI using __file type:

    # configure uWSGI
@@ -398,8 +405,8 @@ We also use stdin as file content source. For details see 
+
    +

    8.4.5. Configuring nginx for Let's Encrypt and HTTPS redirection

    Next configure nginx for Let's Encrypt and for HTTP -> HTTPS redirection. For this purpose we will create new type __sample_nginx_http_letsencrypt_and_ssl_redirect @@ -409,8 +416,8 @@ webroot="/var/www/html" __sample_nginx_http_letsencrypt_and_ssl_redirect "$domain" --webroot "$webroot"

    -
    -
    + +

    8.4.6. Configuring certificate creation

    After HTTP nginx configuration we will create Let's Encrypt certificate using __letsencrypt_cert type. @@ -427,8 +434,8 @@ for Let's Encrypt to work:

    "$domain"
    -
    -
    + +

    8.4.7. Configuring nginx HTTPS server with uWSGI upstream

    Then we can configure nginx HTTPS server that will use created Let's Encrypt certificate:

    # configure nginx
@@ -466,8 +473,8 @@ EOF

    Now our manifest is finished.

    -
    -
    + +

    8.4.8. Complete __sample_bottle_hosting type manifest listing

    Here is complete __sample_bottle_hosting type manifest listing, located in ~/.cdist/type/__sample_bottle_hosting/manifest:

    @@ -589,9 +596,9 @@ server { EOF
    -
    - -
    + + +

    8.5. Creating __sample_bottle_hosting type gencode-remote

    Now define gencode-remote script: ~/.cdist/type/__sample_bottle_hosting/gencode-remote. After manifest is applied it should restart uWSGI and nginx services so that our @@ -601,8 +608,8 @@ configuration is active. Our gencode-remote looks like the following:

    Our __sample_bottle_hosting type is now finished.

    -
    -
    + +

    8.6. Creating __sample_nginx_http_letsencrypt_and_ssl_redirect type

    Let's now create __sample_nginx_http_letsencrypt_and_ssl_redirect type:

    cd ~/.cdist/type
@@ -646,8 +653,8 @@ EOF
 
    echo "service nginx reload"
 
    
 
    
-
    -
    + +

    8.7. Creating init manifest

    Next create init manifest:

    cd ~/.cdist/manifest
@@ -660,16 +667,16 @@ Here the last positional argument sample is type's object id. For detai
 __target_host and __object_id see
 Environment variables (for reading)
 reference.
    
-
    -
    + +

    8.8. Configuring host

    Finally configure test.ungleich.ch:

    cdist config -v -i ~/.cdist/manifest/sample test.ungleich.ch

    After cdist configuration is successfully finished our host is ready.

    -
    -
    + +

    8.9. Creating python bottle application

    We now need to create Bottle application. As you remember from the beginning of this walkthrough our type does not create the actual python application, @@ -679,7 +686,7 @@ It is up to the user to create his/her applications.

    su -l app
    -
    +

    8.9.1. Preparing database

    We need to prepare database for our application. Create table and insert some items:

    @@ -690,8 +697,8 @@ insert some items:

    psql -c "insert into items(item) values('sausage');"
    -
    -
    + +

    8.9.2. Creating application

    Next create sample app:

    cd /home/app/app
@@ -735,8 +742,8 @@ insert some items:
    
 
    We have configured uWSGI with touch-reload = $projectname/wsgi.py so after
 we have changed our wsgi.py file uWSGI reloads the application.
    
 
    Our application selects and lists items from items table.
    
-
    -
    + +

    8.9.3. Opening application

    Finally try the application:

    http://test.ungleich.ch/
@@ -751,42 +758,42 @@ we have changed our wsgi.py file uWSGI reloads the application.
     
  • eggs
    • 
     
  • sausage
    •
    -
    - -
    + + +

    8.10. What's next?

    Continue reading next sections ;)

    -
    - + + - @@ -795,7 +802,6 @@ we have changed our wsgi.py file uWSGI reloads the application. - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -167,18 +172,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 25. Reference
    • - + View page source @@ -192,10 +199,10 @@
      -
      +

      25. Reference

      Variable, path and type reference for cdist

      -
      +

      25.1. Explorers

      The following global explorers are available:

        @@ -219,8 +226,8 @@

      • os_version

      • runlevel

      -
      -
      +
      +

      25.2. Paths

      $HOME/.cdist

      The standard cdist configuration directory relative to your home directory. @@ -302,8 +309,8 @@ This directory is referenced by the variable __object (see below).

      out/object/<object>/explorers

      Output of type specific explorers, per object.

      -
      -
      +
      +

      25.3. Types

      The following types are available:

      - -
      +
      +

      25.4. Objects

      For object to object communication and tests, the following paths are usable within a object directory:

      @@ -496,8 +504,8 @@ code to be executed (either remote or local).

      when the type was called.

      - -
      +
      +

      25.5. Environment variables (for reading)

      The following environment variables are exported by cdist:

      @@ -606,8 +614,8 @@ This variable is derived from __target_host

      Available for: type explorer.

      - -
      +
      +

      25.6. Environment variables (for writing)

      The following environment variables influence the behaviour of cdist:

      @@ -679,37 +687,37 @@ Recognized values are 'always', 'never', and 'auto' (the default).

      CDIST_CACHE_PATH_PATTERN

      Custom cache path pattern.

      - - +
      +
    - @@ -718,7 +726,6 @@ Recognized values are 'always', 'never', and 'auto' (the default).

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -171,18 +176,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 30. Remote exec and copy commands
    • - + View page source @@ -196,7 +203,7 @@
      -
      +

      30. Remote exec and copy commands

      Cdist interacts with the target host in two ways:

        @@ -221,12 +228,12 @@ specified by enclosed in square brackets (see ssh(1) and

        With this simple interface the user can take total control of how cdist interacts with the target when required, while the default implementation remains as simple as possible.

        -
        +

        30.1. Examples

        Here are examples of using alternative __remote_copy and __remote_exec scripts.

        All scripts from below are present in cdist sources in other/examples/remote directory.

        -
        +

        30.1.1. ssh

        Same as cdist default.

        copy

        @@ -241,8 +248,8 @@ scp -o User=root -q User=root $@
        -
        -
        +
      +

      30.1.2. local

      This effectively turns remote calling into local calling. Probably most useful for the unit testing.

      @@ -256,8 +263,8 @@ cp -L $code echo "$@" | /bin/sh
      - -
      +
      +

      30.1.3. chroot

      copy

      Usage: cdist config --remote-copy "/path/to/this/script /path/to/your/chroot" target-id

      @@ -315,8 +322,8 @@ chroot "$chroot"-----"
    - -
    + +

    30.1.4. rsync

    copy

    Usage: cdist config --remote-copy /path/to/this/script target_host

    @@ -341,8 +348,8 @@ log "-----" rsync --backup --suffix=~cdist -e 'ssh -o User=root' $@
    -
    -
    + +

    30.1.5. schroot

    __remote_copy and __remote_exec scripts to run cdist against a chroot on the target host over ssh.

    @@ -397,8 +404,8 @@ log "code: $code"-----"
    -
    -
    + +

    30.1.6. schroot-uri

    __remote_exec/__remote_copy script to run cdist against a schroot target URI.

    Usage:

    @@ -524,8 +531,8 @@ log "code: $code"-----"
    -
    -
    + +

    30.1.7. sudo

    copy

    Use rsync over ssh to copy files. Uses the "--rsync-path" option @@ -561,38 +568,38 @@ rsync --copy-links --rsync-path="su ssh -q "$host" sudo sh -c \""$@"\"

    -
    - - + + + - @@ -601,7 +608,6 @@ ssh -q "$host jQuery(function () { SphinxRtdTheme.Navigation.enable(true); diff --git a/src/extra/manual/beta/cdist-saving-output-streams.html b/src/extra/manual/beta/cdist-saving-output-streams.html index 2d8c0a63..eb1a6b32 100644 --- a/src/extra/manual/beta/cdist-saving-output-streams.html +++ b/src/extra/manual/beta/cdist-saving-output-streams.html @@ -1,24 +1,31 @@ - - + - - - - + + + + + 29. Saving output streams — cdist 6.9.8 documentation + + + + + + - 29. Saving output streams — cdist 6.9.7 documentation - + - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -162,18 +167,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 29. Saving output streams
    • - + View page source @@ -187,9 +194,9 @@
      -
      +

      29. Saving output streams

      -
      +

      29.1. Description

      Since version 4.8.0 cdist, by default, saves output streams to local cache. Saving output streams is implemented because important information was lost @@ -267,37 +274,37 @@ type: /tmp/tmpzomy0wis/75ee6a79e32da093da23fe4a13dd104b/data/conf/type/__myline ERROR: cdist: Failed to configure the following hosts: 185.203.112.42

      -
      - +
      +
    - @@ -306,7 +313,6 @@ ERROR: cdist: Failed to configure the following hosts: 185 - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -165,18 +170,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 23. Scan
    • - + View page source @@ -190,9 +197,9 @@
      -
      +

      23. Scan

      -
      +

      23.1. Description

      Runs cdist as a daemon that discover/watch on hosts and reconfigure them periodically. It is especially useful in netboot-based environment where hosts @@ -200,8 +207,8 @@ boot unconfigured, and to ensure your infrastructure stays in sync with your configuration.

      This feature is still consider to be in beta stage, and only operate on IPv6 (including link-local).

      -
      -
      +
      +

      23.2. Usage (Examples)

      Discover hosts on local network and configure those whose name is resolved by the name mapper script.

      @@ -215,8 +222,8 @@ the name mapper script.

      Please refer to cdist(1) for a detailed list of parameters.

      - -
      +
      +

      23.3. Modes

      The scanner has 3 modes that can be independently toggled. If the --mode parameter is not specified, only tigger and scan are enabled (= hosts are @@ -230,44 +237,67 @@ trigger detection by the scan module.

      config

      Enable configuration of hosts detected by scan.

      - -
      +
      +

      23.4. Name Mapper Script

      The name mapper script takes an IPv6 address as first argument and writes the resolved name to stdout - if any. The script must be executable.

      Simplest script:

      +
      #!/bin/sh
+
+case "$1" in
+      "fe80::20d:b9ff:fe57:3524")
+              printf "my-host-01"
+              ;;
+      "fe80::7603:bdff:fe05:89bb")
+              printf "my-host-02"
+              ;;
+esac
+
      +

      Resolving name from PTR DNS record:

      - - +
      #!/bin/sh
+
+for cmd in dig sed; do
+      if ! command -v $cmd > /dev/null; then
+              exit 1
+      fi
+done
+
+dig +short -x "$1" | sed -e 's/.$//'
+
      +
      +
      +
    - @@ -276,7 +306,6 @@ resolved name to stdout - if any. The script must be executable.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -170,18 +175,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 27. Execution stages
    • - + View page source @@ -195,35 +202,35 @@
      -
      +

      27. Execution stages

      -
      +

      27.1. Description

      When cdist is started, it passes through different stages.

      -
      -
      +
      +

      27.2. Stage 1: target information retrieval

      In this stage information is collected about the target host using so called explorers. Every existing explorer is run on the target and the output of all explorers are copied back into the local cache. The results can be used by manifests and types.

      -
      -
      +
      +

      27.3. Stage 2: run the initial manifest

      The initial manifest, which should be used for mappings of hosts to types, is executed. This stage creates objects in a cconfig database that contains the objects as defined in the manifest for the specific host. In this stage, no conflicts may occur, i.e. no object of the same type with the same id may be created, if it has different parameters.

      - -
      +
      +

      27.4. Stage 3: object information retrieval

      Every object is checked whether its type has explorers and if so, these are executed on the target host. The results are transferred back and can be used in the following stages to decide what changes need to be made on the target to implement the desired state.

      - -
      +
      +

      27.5. Stage 4: run the object manifest

      Every object is checked whether its type has a executable manifest. The manifest script may generate and change the created objects. In other words, @@ -233,58 +240,58 @@ contain a manifest script, which creates new objects of type __file.

      The newly created objects are merged back into the existing tree. No conflicts may occur during the merge. A conflict would mean that two different objects try to create the same object, which indicates a broken configuration.

      - -
      +
      +

      27.6. Stage 5: code generation

      In this stage for every created object its type is checked for executable gencode scripts. The gencode scripts generate the code to be executed on the target on stdout. If the gencode executables fail, they must print diagnostic messages on stderr and exit non-zero.

      - -
      +
      +

      27.7. Stage 6: code execution

      For every object the resulting code from the previous stage is transferred to the target host and executed there to apply the configuration changes.

      - -
      +
      +

      27.8. Stage 7: cache

      The cache stores the information from the current run for later use.

      - -
      +
      +

      27.9. Summary

      If, and only if, all the stages complete without errors, the configuration will be applied to the target.

      - - +
      +
    - @@ -293,7 +300,6 @@ will be applied to the target.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -165,18 +170,20 @@ + +
    - @@ -251,7 +258,6 @@ you can join the - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -162,18 +167,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 21. Trigger
    • - + View page source @@ -187,9 +194,9 @@
      -
      +

      21. Trigger

      -
      +

      21.1. Description

      cdist supports triggering for host installation/configuration using trigger command. This command starts trigger server at management node, for example:

      @@ -217,37 +224,37 @@ host name is resolved then IP address is used.

    • 599 for cdist run errors

    • 500 for cdist/server errors.

    - - +
    + - @@ -256,7 +263,6 @@ host name is resolved then IP address is used.

    - + @@ -29,10 +36,6 @@ - - - - @@ -62,7 +65,7 @@
    - 6.9.7 + 6.9.8
    @@ -79,6 +82,7 @@ + + @@ -162,18 +167,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 32. Troubleshooting
    • - + View page source @@ -187,9 +194,9 @@
      -
      +

      32. Troubleshooting

      -
      +

      32.1. Error in manifest is not considered an error by cdist

      Situation: You are executing other scripts from a manifest. This script fails, but cdist does not recognise the error. @@ -225,8 +232,8 @@ you write to use the -e flag:

      ...
      -
      -
      +
      +

      32.2. Using debug dump helper script

      Since cdist stores data to local cache that can be used for debugging there is a helper script that dumps data from local cache, @@ -239,35 +246,36 @@ is a helper script that dumps data from local cache, 

      ./scripts/cdist-dump -h
      - - +
      +
    - @@ -276,7 +284,6 @@ is a helper script that dumps data from local cache, - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -190,18 +195,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 15. cdist type
    • - + View page source @@ -215,22 +222,22 @@
      -
      +

      15. cdist type

      -
      +

      15.1. Description

      Types are the main component of cdist and define functionality. If you use cdist, you'll write a type for every functionality you would like to use.

      -
      -
      +
      +

      15.2. Synopsis

      __TYPE ID --parameter value [--parameter value ...]
 __TYPE --parameter value [--parameter value ...] (for singletons)
      -
      -
      +
      +

      15.3. How to use a type

      You can use types from the initial manifest or the type manifest like a normal shell command:

      @@ -242,8 +249,8 @@ __package tree --state installed

      A list of supported types can be found in the cdist reference manpage.

      - -
      +
    +

    15.4. Singleton types

    If a type is flagged as a singleton, it may be used only once per host. This is useful for types which can be used only once on a @@ -256,25 +263,25 @@ __issue __myfancysingleton --colour green

    - -
    + +

    15.5. Config types

    By default types are used with config command. These are types that are not flagged by any known command flag. If a type is marked then it will be skipped with config command.

    -
    -
    + +

    15.6. Install types

    If a type is flagged with 'install' flag then it is used only with install command. With other commands, i.e. config, these types are skipped if used.

    -
    -
    + +

    15.7. Nonparallel types

    If a type is flagged with 'nonparallel' flag then its objects cannot be run in parallel when using -j option. Example of such a type is __package_dpkg type where dpkg itself prevents to be run in more than one instance.

    -
    -
    + +

    15.8. Deprecated types

    If a type is flagged with 'deprecated' marker then it is considered deprecated. When it is used cdist writes warning line. If 'deprecated' marker has content @@ -294,8 +301,8 @@ $ echo '__bar foo' 185.203.112.26: Type __bar is deprecated.

    -
    -
    + +

    15.9. How to write a new type

    A type consists of

      @@ -315,8 +322,8 @@ they are written in shell so they are executed using '/bin/sh -e' or 'CDIST_LOCA

      For executable shell code it is suggested that shebang is '#!/bin/sh -e'.

      For creating type skeleton you can use helper script cdist-new-type.

      -
    -
    + +

    15.10. Defining parameters

    Every type consists of required, optional and boolean parameters, which must each be declared in a newline separated file in parameter/required, @@ -339,8 +346,8 @@ mkdir cdist/conf/type/__nginx_vhost/parameter/default echo use_ssl >> cdist/conf/type/__nginx_vhost/parameter/boolean

    -
    -
    + +

    15.11. Using parameters

    The parameters given to a type can be accessed and used in all type scripts (e.g manifest, gencode, explorer). Note that boolean parameters are @@ -372,8 +379,8 @@ file does not exist -> False

    fi
    -
    -
    + +

    15.12. Deprecated parameters

    To deprecate type parameters one can declare a file for each deprecated parameter under parameter/deprecated directory.

    @@ -393,8 +400,8 @@ WARNING: 185.203.112.26: spam parameter of 185.203.112.26: eggs parameter of type __foo is deprecated: eggs parameter is deprecated, please use multiple egg parameter.
    -
    -
    + +

    15.13. Input from stdin

    Every type can access what has been written on stdin when it has been called. The result is saved into the stdin file in the object directory.

    @@ -417,7 +424,7 @@ about "here documents".

    ....
    -
    +

    15.13.1. Stdin inside a loop

    Since cdist saves type's stdin content in the object as $__object/stdin, so it can be accessed in manifest and gencode-* scripts, this can lead to @@ -470,9 +477,9 @@ stdin from /dev/null:

    fi
    -
    -
    -
    + + +

    15.14. Writing the manifest

    In the manifest of a type you can use other types, so your type extends their functionality. A good example is the __package type, which in @@ -495,8 +502,8 @@ __package_$type "cdist reference.

    Always ensure the manifest is executable, otherwise cdist will not be able to execute it. For more information about manifests see cdist manifest.

    -
    -
    + +

    15.15. Singleton - one instance only

    If you want to ensure that a type can only be used once per target, you can mark it as a singleton: Just create the (empty) file "singleton" in your type @@ -510,8 +517,8 @@ directory:

    As you can see, the object ID is omitted, because it does not make any sense, if your type can be used only once.

    -
    -
    + +

    15.16. Install - type with install command

    If you want a type to be used with install command, you must mark it as install: create the (empty) file "install" in your type directory:

    @@ -519,8 +526,8 @@ install: create the (empty) file "install" in your type directory:

    With other commands, i.e. config, it will be skipped if used.

    -
    -
    + +

    15.17. Nonparallel - only one instance can be run at a time

    If objects of a type must not or cannot be run in parallel when using -j option, you must mark it as nonparallel: create the (empty) file "nonparallel" @@ -529,8 +536,8 @@ in your type directory:

    For example, package types are nonparallel types.

    -
    -
    + +

    15.18. The type explorers

    If a type needs to explore specific details, it can provide type specific explorers, which will be executed on the target for every created object.

    @@ -548,8 +555,8 @@ client, like this (shortened version from the type __file):

    fi
    -
    -
    + +

    15.19. Writing the gencode script

    There are two gencode scripts: gencode-local and gencode-remote. The output of gencode-local is executed locally, whereas @@ -571,8 +578,8 @@ then for IPv6 address with __remote_copy execution you should enclose IPv6 address in square brackets. The same applies to __remote_exec if it behaves the same as ssh for some options where colon is a delimiter, as for -L ssh option (see ssh(1) and scp(1)).

    -
    -
    + +

    15.20. Variable access from the generated scripts

    In the generated scripts, you have access to the following cdist variables

      @@ -589,8 +596,8 @@ files after the script execution.

      fi
    -
    -
    + +

    15.21. Environment variable usage idiom

    In type scripts you can support environment variables with default values if environment variable is unset or null by using ${parameter:-[word]} @@ -599,8 +606,8 @@ parameter expansion.

    tempfile=$(mktemp "${TMPDIR:-/tmp}/cdist.XXXXXXXXXX")
    -
    -
    + +

    15.22. Log level in types

    cdist log level can be accessed from __cdist_log_level variable.One of:

    @@ -641,14 +648,14 @@ parameter expansion.

    It is available for initial manifest, explorer, type manifest, type explorer, type gencode.

    -
    -
    + +

    15.23. Detecting dry run

    If $__cdist_dry_run environment variable is set, then it's dry run.

    It is available for initial manifest, explorer, type manifest, type explorer, type gencode.

    -
    -
    + +

    15.24. Hints for typewriters

    It must be assumed that the target is pretty dumb and thus does not have high level tools like ruby installed. If a type requires specific tools to be present @@ -661,14 +668,14 @@ cdist will not touch this directory.

    If your type contains static files, it's also recommended to place them in a folder named "files" within the type (again, because cdist guarantees to never ever touch this folder).

    -
    -
    + +

    15.25. How to include a type into upstream cdist

    If you think your type may be useful for others, ensure it works with the current master branch of cdist and have a look at cdist hacking on how to submit it.

    -
    -
    + +

    15.26. Python types

    From version/branch beta cdist support python types, types that are written in python language with cdist's core support. cdist detects such type if type is @@ -745,37 +752,37 @@ your config.

    Also, this documenation is only an introduction, and not a complete guide to python types. Currently, it is just a short introduction so one can start to write and use python types.

    -
    - + + - @@ -784,7 +791,6 @@ python types.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -332,18 +338,20 @@ + +
    - @@ -572,7 +581,6 @@ - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -181,18 +186,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 5. How to upgrade cdist
    • - + View page source @@ -206,9 +213,9 @@
      -
      +

      5. How to upgrade cdist

      -
      +

      5.1. Update the git installation

      To upgrade cdist in the current branch use

      git pull
@@ -221,7 +228,7 @@ make man
 
      If you stay on a version branch (i.e. 1.0, 1.1., ...), nothing should break.
 The master branch on the other hand is the development branch and may not be
 working, break your setup or eat the tree in your garden.
      
-
      
+
      
 
      5.1.1. Safely upgrading to new versions
      
 
      To upgrade to any further cdist version, you can take the
 following procedure to do a safe upgrade:
      
@@ -253,32 +260,32 @@ git checkout master
 
      # git checkout upgrade_cdist
 
      
 
      
-
      
-
      -
      +
      +
      +

      5.2. Update the python package

      To upgrade to the latest version do

      pip install --upgrade cdist
      - -
      +
      +

      5.3. General update instructions

      -
      +

      5.3.1. Updating from 3.0 to 3.1

      The type __ssh_authorized_keys now also manages existing keys, not only the ones added by cdist.

      -
      -
      +
      +

      5.3.2. Updating from 2.3 to 3.0

      The changed attribute of objects has been removed. Use messaging instead.

      - -
      +
      +

      5.3.3. Updating from 2.2 to 2.3

      No incompatibilities.

      - -
      +
      +

      5.3.4. Updating from 2.1 to 2.2

      Starting with 2.2, the syntax for requiring a singleton type changed: Old format:

      @@ -295,8 +302,8 @@ snippet (currently untested, please report back if it works for you):

      find ~/.cdist/* -type f -exec sed -i 's,/singleton,,' {} \;
      - -
      +
      +

      5.3.5. Updating from 2.0 to 2.1

      Have a look at the update guide for [[2.0 to 2.1|2.0-to-2.1]].

      @@ -326,8 +333,8 @@ Support for the variable __object_name is already present in 2.
    - -
    + +

    5.3.6. Updating from 1.7 to 2.0

    • Ensure python (>= 3.2) is installed on the source host

      • @@ -336,15 +343,15 @@ Support for the variable __object_name is already present in 2.

    • Use "cdist banner" for fun

    • Use __object_name instead of __self in manifests

    -
    -
    + +

    5.3.7. Updating from 1.6 to 1.7

    • If you used the global explorer hardware_type, you need to change your code to use machine instead.

    -
    -
    + +

    5.3.8. Updating from 1.5 to 1.6

    • If you used __package_apt --preseed, you need to use the new @@ -353,20 +360,20 @@ type __debconf_set_selections instead.

      • --state uninstalled. Starting with 1.6, it was made consistently to --state removed.

    -
    -
    + +

    5.3.9. Updating from 1.3 to 1.5

    No incompatibilities.

    -
    -
    + +

    5.3.10. Updating from 1.2 to 1.3

    Rename gencode of every type to gencode-remote.

    -
    -
    + +

    5.3.11. Updating from 1.1 to 1.2

    No incompatibilities.

    -
    -
    + +

    5.3.12. Updating from 1.0 to 1.1

    In 1.1 the type __file was split into __directory, __file and __link. The parameter --type was removed from __file. Thus you @@ -378,38 +385,38 @@ need to replace __file calls in your manifests:

  • If type was directory, use __directory

    • -
    - - + + + - @@ -418,7 +425,6 @@ need to replace __file calls in your manifests:

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -167,18 +172,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 1. Why should I use cdist?
    • - + View page source @@ -192,11 +199,11 @@
      -
      +

      1. Why should I use cdist?

      There are several motivations to use cdist, these are probably the most popular ones.

      -
      +

      1.1. Known language

      Cdist is being configured in shell script. @@ -204,8 +211,8 @@ Shell script is used by UNIX system engineers for decades. So when cdist is introduced, your staff does not need to learn a new DSL or programming language.

      -
      -
      +
      +

      1.2. Powerful language

      Not only is shell scripting widely known by system engineers, but it is also a very powerful language. Here are some features @@ -219,8 +226,8 @@ which make daily work easy:

    • Support for dependencies between cdist types

    - -
    + +

    1.3. More than shell scripting

    If you compare regular shell scripting with cdist, there is one major difference: When using cdist types, @@ -228,8 +235,8 @@ the results are idempotent. In practise that means it does not matter in which order you call cdist types, the result is always the same.

    -
    -
    + +

    1.4. Zero dependency configuration management

    Cdist requires very little on a target system. Even better, in almost all cases all dependencies are usually fulfilled. @@ -238,8 +245,8 @@ languages on the target host: it will run on any host that has a ssh server running and a POSIX compatible shell (/bin/sh). Compared to other configuration management systems, it does not require to open up an additional port.

    -
    -
    + +

    1.5. Push based distribution

    Cdist uses the push based model for configuration. In this scenario, one (or more) computers connect to the target hosts @@ -251,44 +258,44 @@ limited amount of resources.

    needs access to the target hosts. No target hosts will ever need to connect back to the source host, which contains the full configuration.

    -
    -
    + +

    1.6. Highly scalable

    If at some point you manage more hosts than can be handled from a single source host, you can simply add more resources: Either add more cores to one host or add hosts. Cdist will utilise the given resources in parallel.

    -
    - + + - @@ -297,7 +304,6 @@ Cdist will utilise the given resources in parallel.

    - + @@ -28,10 +36,6 @@ - - - - @@ -60,7 +64,7 @@
    - 6.9.7 + 6.9.8
    @@ -77,6 +81,7 @@ + + @@ -156,18 +162,20 @@ + +
      -
    • Docs »
      • +
    • »
    • Index
    • - +
      • @@ -191,20 +199,25 @@
    - @@ -213,7 +226,6 @@ - + @@ -29,10 +36,6 @@ - - - - @@ -62,7 +65,7 @@
    - 6.9.7 + 6.9.8
    @@ -79,6 +82,7 @@ + + @@ -158,18 +163,20 @@ + +
      -
    • Docs »
      • +
    • »
    • cdist - usable configuration management
    • - + View page source @@ -183,7 +190,7 @@
      -
      +

      cdist - usable configuration management

      cdist is a usable configuration management system. It adheres to the KISS principle and @@ -191,34 +198,35 @@ is being used in small up to enterprise grade environments. It natively supports IPv6 since the first release.

      -
      +
    - @@ -227,7 +235,6 @@ It natively supports IPv6 since the first release.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -169,18 +174,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 10. cdist-dump(1)
    • - + View page source @@ -194,27 +201,27 @@
      -
      +

      10. cdist-dump(1)

      -
      +

      10.1. NAME

      cdist-dump - Dump data from local cdist cache

      -
      -
      +
      +

      10.2. SYNOPSIS

      cdist-dump [options] [host...]
      -
      -
      +
      +

      10.3. DESCRIPTION

      cdist-dump is a helper script that dumps data from local cdist cache for specified hosts. If host is not specified then all data from cache directory is dumped. Default cache directory is '~/.cdist/cache'.

      cdist-dump can be used for debugging existing types, host configuration and new types.

      - -
      +
      +

      10.4. OPTIONS

      -a

      dump all

      @@ -254,8 +261,8 @@ new types.

      -v

      increase verbosity

      - -
      +
      +

      10.5. EXAMPLES

      # Dump all
 % cdist-dump -a
@@ -264,50 +271,50 @@ new types.
      
 % cdist-dump -c
      - -
      +
      +

      10.6. SEE ALSO

      cdist(1)

      - -
      +
      +

      10.7. AUTHORS

      Darko Poljak <darko.poljak--@--ungleich.ch>

      - -
      +
      +

      10.8. COPYING

      Copyright (C) 2019 Darko Poljak. Free use of this software is granted under the terms of the GNU General Public License v3 or later (GPLv3+).

      - - +
      +
    - @@ -316,7 +323,6 @@ granted under the terms of the GNU General Public License v3 or later (GPLv3+).< - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -169,18 +174,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 11. cdist-new-type(1)
    • - + View page source @@ -194,19 +201,19 @@
      -
      +

      11. cdist-new-type(1)

      -
      +

      11.1. NAME

      cdist-new-type - Create new type skeleton

      -
      -
      +
      +

      11.2. SYNOPSIS

      cdist-new-type TYPE-NAME AUTHOR-NAME AUTHOR-EMAIL [TYPE-BASE-PATH]
      -
      -
      +
      +

      11.3. DESCRIPTION

      cdist-new-type is a helper script that creates new type skeleton. It is then up to the type author to finish the type.

      @@ -217,8 +224,8 @@ It is then up to the type author to finish the type.

    • gencode-remote.

    Upon creation it prints the path to the newly created type directory.

    - -
    +
    +

    11.4. ARGUMENTS

    TYPE-NAME

    Name of the new type.

    @@ -231,8 +238,8 @@ It is then up to the type author to finish the type.

    to '$PWD/type'.

    - -
    +
    +

    11.5. EXAMPLES

    # Create new type __foo in ~/.cdist directory.
 $ cd ~/.cdist
@@ -240,53 +247,53 @@ $ cdist-new-type '__foo' 'F
 /home/foo/.cdist/type/__foo
    - -
    +
    +

    11.6. SEE ALSO

    cdist(1)

    - -
    +
    +

    11.7. AUTHORS

    Steven Armstrong <steven-cdist--@--armstrong.cc>
    Darko Poljak <darko.poljak--@--ungleich.ch>
    - -
    +
    +

    11.8. COPYING

    Copyright (C) 2019 Steven Armstrong, Darko Poljak. Free use of this software is granted under the terms of the GNU General Public License v3 or later (GPLv3+).

    - - +
    + - @@ -295,7 +302,6 @@ granted under the terms of the GNU General Public License v3 or later (GPLv3+).< - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -196,18 +201,20 @@ + +
      -
    • Docs »
      • +
    • »
    • 9. cdist(1)
    • - + View page source @@ -221,13 +228,13 @@
      -
      +

      9. cdist(1)

      -
      +

      9.1. NAME

      cdist - Usable Configuration Management

      -
      -
      +
      +

      9.2. SYNOPSIS

      cdist [-h] [-V] {banner,config,install,inventory,preos,shell,info,trigger} ...
 
@@ -319,15 +326,15 @@
            [-d CONFIG_DELAY] [-t TRIGGER_DELAY]
      -
      -
      +
      +

      9.3. DESCRIPTION

      cdist is the frontend executable to the cdist configuration management. It supports different subcommands as explained below.

      It is written in Python so it requires python(1) to be installed. It requires a minimal Python version 3.5.

      - -
      +
      +

      9.4. GENERAL

      All commands accept the following options:

      @@ -359,13 +366,13 @@ last set value.

      -V, --version

      Show version and exit.

      - -
      + +

      9.6. CONFIG/INSTALL

      Configure/install one or more hosts. Install command is currently in beta.

      @@ -447,7 +454,7 @@ all hosts that contain any of specified tags. Currently in beta.

      -
      +

      9.6.1. HOSTFILE FORMAT

      The HOSTFILE contains one host per line. A comment is started with '#' and continues to the end of the line. @@ -457,8 +464,8 @@ Empty lines are ignored/skipped.

      removed. Then all leading and trailing whitespace characters are stripped. If such a line results in empty line it is ignored/skipped. Otherwise, host string is used.

      -
      -
      +
      +

      9.6.2. CACHE PATH PATTERN FORMAT

      Cache path pattern specifies path for a cache directory subdirectory. In the path, '%N' will be substituted by the target host, '%h' will @@ -472,14 +479,14 @@ is used.

      Calculated host directory is a hash of a host cdist operates on.

      Resulting path is used to specify cache path subdirectory under which current host cache data are saved.

      - - -
      +
      +
      +

      9.7. INVENTORY

      Manage inventory database. Currently in beta with all sub-commands.

      - -
      +
      +

      9.8. INVENTORY ADD-HOST

      Add host(s) to inventory database.

      @@ -501,8 +508,8 @@ directory is used, if HOME env var is set then inventory directory is used.

      - -
      +
      +

      9.9. INVENTORY ADD-TAG

      Add tag(s) to inventory database.

      @@ -531,8 +538,8 @@ Tagfile format is the same as config hostfile format.

      separated values.

      - -
      +
      +

      9.10. INVENTORY DEL-HOST

      Delete host(s) from inventory database.

      @@ -556,8 +563,8 @@ directory is used, if HOME env var is set then inventory directory is used.

      - -
      +
      +

      9.11. INVENTORY DEL-TAG

      Delete tag(s) from inventory database.

      @@ -589,8 +596,8 @@ Tagfile format is the same as config hostfile format.

      separated values.

      - -
      +
      +

      9.12. INVENTORY LIST

      List inventory database.

      @@ -621,8 +628,8 @@ inventory directory is used.

      all hosts that contain any of specified tags.

      - -
      +
      +

      9.13. PREOS

      Create PreOS.

      @@ -639,8 +646,8 @@ all hosts that contain any of specified tags.

    • ubuntu

    • devuan

    - -
    +
    +

    9.14. PREOS DEBIAN/DEVUAN

    target_dir

    target directory where PreOS will be bootstrapped

    @@ -686,8 +693,8 @@ internal init manifest is used

    internal script is used

    - -
    +
    +

    9.15. PREOS UBUNTU

    target_dir

    target directory where PreOS will be bootstrapped

    @@ -733,8 +740,8 @@ internal init manifest is used

    internal script is used

    - -
    +
    +

    9.16. SHELL

    This command allows you to spawn a shell that enables access to the types as commands. It can be thought as an @@ -745,8 +752,8 @@ usage. Its primary use is for debugging type parameters.

    be POSIX compatible shell.

    - -
    +
    +

    9.17. INFO

    Display information for cdist (global explorers, types).

    @@ -770,8 +777,8 @@ used as specified, otherwise it is translated to *pattern*.

    -t, --types

    Display info for types.

    - -
    +
    +

    9.18. TRIGGER

    Start trigger (simple http server) that waits for connections. When host connects then it triggers config or install command and then cdist @@ -843,8 +850,8 @@ like ssh).

    -S, --disable-saving-output-streams

    Disable saving output streams.

    - -
    +
    +

    9.19. SCAN

    Runs cdist as a daemon that discover/watch on hosts and reconfigure them periodically.

    @@ -864,8 +871,8 @@ to tiggger and scan.

    -t TRIGGER_DELAY, --tigger-delay TRIGGER_DELAY

    How long (seconds) to wait between ICMPv6 echo requests (trigger mode only).

    - -
    +
    +

    9.20. CONFIGURATION

    cdist obtains configuration data from the following sources in the following order (from higher to lower precedence):

    @@ -879,7 +886,7 @@ order (from higher to lower precedence):

  • system-wide configuration file (/etc/cdist.cfg).

    • -
    +

    9.20.1. CONFIGURATION FILE FORMAT

    cdist configuration file is in the INI file format. Currently it supports only [GLOBAL] section. @@ -938,9 +945,9 @@ in the format: YYYYMMDDHHMMSS.us.

    'ERROR', 'WARNING', 'INFO', 'VERBOSE', 'DEBUG', 'TRACE' and 'OFF'.

    -
    - -
    + + +

    9.21. FILES

    ~/.cdist

    Your personal cdist config directory. If exists it will be @@ -966,14 +973,14 @@ This path is relative to cdist installation directory.

    ~/.cdist.cfg or $XDG_CONFIG_HOME/cdist/cdist.cfg

    Local cdist configuration file, if exists.

    -
    -
    + +

    9.22. NOTES

    cdist detects if host is specified by IPv6 address. If so then remote_copy command is executed with host address enclosed in square brackets (see scp(1)).

    -
    -
    + +

    9.23. EXAMPLES

    # Configure ikq05.ethz.ch with debug enabled
 % cdist config -vvv ikq05.ethz.ch
@@ -1070,8 +1077,8 @@ $ cdist preos ubuntu /mnt -B -C \
 % cdist trigger -v -i ~/.cdist/manifest/init-for-triggered
    -
    -
    + +

    9.24. ENVIRONMENT

    TMPDIR, TEMP, TMP

    Setup the base directory for the temporary directory. @@ -1106,19 +1113,19 @@ finally fixed and well defined.

    CDIST_CONFIG_FILE

    Custom configuration file.

    -
    -
    + +

    9.25. EXIT STATUS

    The following exit values shall be returned:

    0 Successful completion.

    1 One or more host configurations failed.

    -
    -
    + +

    9.26. AUTHORS

    Originally written by Nico Schottelius <nico-cdist--@--schottelius.org> and Steven Armstrong <steven-cdist--@--armstrong.cc>.

    -
    -
    + +

    9.27. CAVEATS

    When operating in parallel, either by operating in parallel for each host (-p/--parallel) or by parallel jobs within a host (-j/--jobs), and depending @@ -1156,42 +1163,42 @@ Warning message: Dependency resolver could not handle dependencies as expected.

    -
    -
    + +

    9.28. COPYING

    Copyright (C) 2011-2020 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License v3 or later (GPLv3+).

    -
    - + + - @@ -1200,7 +1207,6 @@ granted under the terms of the GNU General Public License v3 or later (GPLv3+).< - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,11 +348,13 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • @@ -355,7 +363,7 @@
    • - + View page source @@ -369,27 +377,27 @@
      -
      +

      16.1. cdist-type__acl(7)

      -
      +

      16.1.1. NAME

      cdist-type__acl - Set ACL entries

      -
      -
      +
      +

      16.1.2. DESCRIPTION

      Fully supported and tested on Linux (ext4 filesystem), partial support for FreeBSD.

      See setfacl and acl manpages for more details.

      One of --entry or --source must be used.

      -
      -
      +
      +

      16.1.3. OPTIONAL MULTIPLE PARAMETERS

      entry

      Set ACL entry following getfacl output syntax. Must be used if --source is not used.

      - -
      +
      +

      16.1.4. OPTIONAL PARAMETERS

      source

      Read ACL entries from stdin or file. @@ -402,8 +410,8 @@ Must be used if --e

      directory

      Create/change directory with __directory using user:group:mode pattern.

      - -
      +
      +

      16.1.5. BOOLEAN PARAMETERS

      default

      Set all ACL entries as default too. @@ -416,8 +424,8 @@ Setting default ACL in FreeBSD is currently not supported.

      mask and other entries can't be removed, but only changed.

      - -
      +
      +

      16.1.6. EXAMPLES

      __acl /srv/project \
     --default \
@@ -457,48 +465,48 @@ __acl /path/to/directory \
     --entry user:nobody:rwx
      - -
      +
      +

      16.1.7. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      +
      +

      16.1.8. COPYING

      Copyright (C) 2018 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -507,7 +515,6 @@ License, or (at your option) any later version.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -346,11 +352,13 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • @@ -359,7 +367,7 @@
    • - + View page source @@ -373,13 +381,13 @@
      -
      +

      16.2. cdist-type__debian_backports(7)

      -
      +

      16.2.1. NAME

      cdist-type__apt_backports - Install backports

      -
      -
      +
      +

      16.2.2. DESCRIPTION

      This singleton type installs backports for the current OS release. It aborts if backports are not supported for the specified OS or @@ -391,12 +399,12 @@ no version codename could be fetched (like Debian unstable).

    • Devuan

    • Ubuntu

    - -
    +
    +

    16.2.3. REQUIRED PARAMETERS

    None.

    - -
    +
    +

    16.2.4. OPTIONAL PARAMETERS

    state

    Represents the state of the backports repository. present or @@ -408,16 +416,16 @@ mirror of the current OS.

    Will be directly passed to cdist-type__apt_source(7).

    - -
    +
    +

    16.2.5. BOOLEAN PARAMETERS

    None.

    - -
    +
    +

    16.2.6. MESSAGES

    None.

    - -
    +
    +

    16.2.7. EXAMPLES

    # setup the backports
 __apt_backports
@@ -430,67 +438,67 @@ __apt_backports --state present --mirror "http://ftp.de.de
      --target-release buster-backports
    - -
    +
    +

    16.2.8. ABORTS

    Aborts if the detected os is not Debian.

    Aborts if no distribuition codename could be detected. This is common for the unstable distribution, but there is no backports repository for it already.

    - -
    +
    +

    16.2.9. CAVEATS

    For Ubuntu, it setup all componenents for the backports repository: main, restricted, universe and multiverse. The user may not want to install proprietary packages, which will only be installed if the user explicitly uses the backports target-release. The user may change this behavior to install backports packages without the need of explicitly select it.

    - -
    +
    +

    16.2.10. SEE ALSO

    Official Debian Backports site

    cdist-type__apt_source(7)

    - -
    +
    +

    16.2.11. AUTHORS

    Matthias Stecher <matthiasstecher at gmx.de>

    - -
    +
    +

    16.2.12. COPYING

    Copyright (C) 2020 Matthias Stecher. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

    - - +
    + - @@ -499,7 +507,6 @@ License, or (at your option) any later version.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,11 +347,13 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • @@ -354,7 +362,7 @@
    • - + View page source @@ -368,18 +376,18 @@
      -
      +

      16.3. cdist-type__apt_default_release(7)

      -
      +

      16.3.1. NAME

      cdist-type__apt_default_release - Configure the default release for apt

      -
      -
      +
      +

      16.3.2. DESCRIPTION

      Configure the default release for apt, using the APT::Default-Release configuration value.

      -
      -
      +
      +

      16.3.3. REQUIRED PARAMETERS

      release

      The value to set APT::Default-Release to.

      @@ -387,58 +395,58 @@ configuration value.

      'stable', 'testing', 'unstable', 'stretch', 'buster', '4.0', '5.0*'.

      - -
      +
      +

      16.3.4. OPTIONAL PARAMETERS

      None.

      - -
      +
      +

      16.3.5. EXAMPLES

      __apt_default_release --release stretch
      - -
      +
      +

      16.3.6. AUTHORS

      Matthijs Kooijman <matthijs--@--stdin.nl>

      - -
      +
      +

      16.3.7. COPYING

      Copyright (C) 2017 Matthijs Kooijman. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -447,7 +455,6 @@ License, or (at your option) any later version.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,11 +349,13 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • @@ -356,7 +364,7 @@
    • - + View page source @@ -370,13 +378,13 @@
      -
      +

      16.4. cdist-type__apt_key(7)

      -
      +

      16.4.1. NAME

      cdist-type__apt_key - Manage the list of keys used by apt

      -
      -
      +
      +

      16.4.2. DESCRIPTION

      Manages the list of keys used by apt to authenticate packages.

      This is done by placing the requested key in a file named @@ -384,12 +392,12 @@

      This is supported by modern releases of Debian-based distributions.

      In order of preference, exactly one of: source, uri or keyid must be specified.

      -
      -
      +
      +

      16.4.3. REQUIRED PARAMETERS

      None.

      - -
      +
      +

      16.4.4. OPTIONAL PARAMETERS

      keydir

      keyring directory, defaults to /etc/apt/trusted.pgp.d, which is @@ -409,8 +417,8 @@ that the key doesn't change, you are better off downloading it and using --source.

      - -
      +
      +

      16.4.5. DEPRECATED OPTIONAL PARAMETERS

      keyid

      the id of the key to download from the keyserver. @@ -422,8 +430,8 @@ Defaults to $__obje Defaults to pool.sks-keyservers.net.

      - -
      +
      +

      16.4.6. DEPRECATED BOOLEAN PARAMETERS

      use-deprecated-apt-key

      apt-key(8) will last be available in Debian 11 and Ubuntu 22.04. @@ -434,8 +442,8 @@ Adding keys should be done without this parameter. This parameter will be removed when Debian 11 stops being supported.

      - -
      +
      +

      16.4.7. EXAMPLES

      # add a key that has been verified by a type maintainer
 __apt_key jitsi_meet_2021 \
@@ -460,50 +468,50 @@ __apt_key rabbitmq_2007 \
    --uri https://www.rabbitmq.com/rabbitmq-signing-key-public.asc
      - -
      +
      +

      16.4.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc> Ander Punnar <ander-at-kvlt-dot-ee> Evilham <contact~~@~~evilham.com>

      - -
      +
      +

      16.4.9. COPYING

      Copyright (C) 2011-2021 Steven Armstrong, Ander Punnar and Evilham. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -512,7 +520,6 @@ License, or (at your option) any later version.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,11 +347,13 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • @@ -354,7 +362,7 @@
    • - + View page source @@ -368,24 +376,24 @@
      -
      +

      16.5. cdist-type__apt_key_uri(7)

      -
      +

      16.5.1. NAME

      cdist-type__apt_key_uri - Add apt key from uri

      -
      -
      +
      +

      16.5.2. DESCRIPTION

      Download a key from an uri and add it to the apt keyring.

      -
      -
      +
      +

      16.5.3. REQUIRED PARAMETERS

      uri

      the uri from which to download the key

      - -
      +
      +

      16.5.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      @@ -394,8 +402,8 @@ Defaults to __object_id

      - -
      +
      +

      16.5.5. EXAMPLES

      __apt_key_uri rabbitmq \
    --name 'RabbitMQ Release Signing Key <info@rabbitmq.com>' \
@@ -403,48 +411,48 @@ Defaults to __object_id
      
    --state present
      - -
      +
      +

      16.5.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      +
      +

      16.5.7. COPYING

      Copyright (C) 2011-2014 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -453,7 +461,6 @@ License, or (at your option) any later version.

    - + @@ -29,10 +36,6 @@ - - - - @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,11 +347,13 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • @@ -354,7 +362,7 @@
    • - + View page source @@ -368,31 +376,31 @@
      -
      +

      16.6. cdist-type__apt_mark(7)

      -
      +

      16.6.1. NAME

      cdist-type__apt_mark - set package state as 'hold' or 'unhold'

      -
      -
      +
      +

      16.6.2. DESCRIPTION

      See apt-mark(8) for details.

      -
      -
      +
      +

      16.6.3. REQUIRED PARAMETERS

      state

      Either "hold" or "unhold".

      - -
      +
      +

      16.6.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      - -
      +
      +

      16.6.5. EXAMPLES

      # hold package
 __apt_mark quagga --state hold
@@ -400,48 +408,48 @@ __apt_mark quagga --state hold
 __apt_mark quagga --state unhold
      - -
      +
      +

      16.6.6. AUTHORS

      Ander Punnar <cdist--@--kvlt.ee>

      - -
      +
      +

      16.6.7. COPYING

      Copyright (C) 2016 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -450,7 +458,6 @@ License, or (at your option) any later version.

    - + @@ -29,13 +36,9 @@ - - - - - + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,11 +347,13 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • @@ -354,7 +362,7 @@
    • - + View page source @@ -368,72 +376,72 @@
      -
      +

      16.7. cdist-type__apt_norecommends(7)

      -
      +

      16.7.1. NAME

      cdist-type__apt_norecommends - Configure apt to not install recommended packages

      -
      -
      +
      +

      16.7.2. DESCRIPTION

      Configure apt to not install any recommended or suggested packages.

      -
      -
      +
      +

      16.7.3. REQUIRED PARAMETERS

      None.

      - -
      +
      +

      16.7.4. OPTIONAL PARAMETERS

      None.

      - -
      +
      +

      16.7.5. EXAMPLES

      __apt_norecommends
      - -
      +
      +

      16.7.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc> Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>

      - -
      +
      +

      16.7.7. COPYING

      Copyright (C) 2014 Steven Armstrong, 2020 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -442,7 +450,6 @@ the License, or (at your option) any later version.

    - + + + + + + + + + + + + + + + + +
    + + + +
    + + + + + +
    + +
    + + + + + + + + + + + + + + + + + + + +
    + + + + +
    +
    +
    +
    + +
    +

    16.8. cdist-type__apt_pin(7)

    +
    +

    16.8.1. NAME

    +

    cdist-type__apt_pin - Manage apt pinning rules

    +
    +
    +

    16.8.2. DESCRIPTION

    +

    Adds/removes/edits rules to pin some packages to a specific distribution. Useful if using multiple debian repositories at the same time. (Useful, if one wants to use a few specific packages from backports or perhaps Debain testing... or even sid.)

    +
    +
    +

    16.8.3. REQUIRED PARAMETERS

    +
    +
    distribution

    Specifies what distribution the package should be pinned to. Accepts both codenames (buster/bullseye/sid) and suite names (stable/testing/...).

    +
    +
    +
    +
    +

    16.8.4. OPTIONAL PARAMETERS

    +
    +
    package

    Package name, glob or regular expression to match (multiple) packages. If not specified __object_id is used.

    +
    +
    priority

    The priority value to assign to matching packages. Deafults to 500. (To match the default target distro's priority)

    +
    +
    state

    Will be passed to underlying __file type; see there for valid values and defaults.

    +
    +
    +
    +
    +

    16.8.5. BOOLEAN PARAMETERS

    +

    None.

    +
    +
    +

    16.8.6. EXAMPLES

    +
    # Add the bullseye repo to buster, but do not install any packages by default,
+# only if explicitely asked for (-1 means "never" for apt)
+ __apt_pin bullseye-default \
+    --package "*" \
+    --distribution bullseye \
+    --priority -1
+
+ require="__apt_pin/bullseye-default" __apt_source bullseye \
+    --uri http://deb.debian.org/debian/ \
+    --distribution bullseye \
+    --component main
+
+ __apt_pin foo --package "foo foo-*" --distribution bullseye
+
+ __foo # Assuming, this installs the `foo` package internally
+
+ __package foo-plugin-extras # Assuming we also need some extra stuff
+
    +
    +
    +
    +

    16.8.7. SEE ALSO

    +

    apt_preferences(5) +cdist-type__apt_source(7) +cdist-type__apt_backports(7) +cdist-type__file(7)

    +
    +
    +

    16.8.8. AUTHORS

    +

    Daniel Fancsali <fancsali@gmail.com>

    +
    +
    +

    16.8.9. COPYING

    +

    Copyright (C) 2021 Daniel Fancsali. You can redistribute it +and/or modify it under the terms of the GNU General Public License as +published by the Free Software Foundation, either version 3 of the +License, or (at your option) any later version.

    +
    +
    + + +
    + +
    + +
    +
    + +
    + +
    + + + + + + + + + + + \ No newline at end of file diff --git a/src/extra/manual/beta/man7/cdist-type__apt_ppa.html b/src/extra/manual/beta/man7/cdist-type__apt_ppa.html index 3227f63c..740da3a7 100644 --- a/src/extra/manual/beta/man7/cdist-type__apt_ppa.html +++ b/src/extra/manual/beta/man7/cdist-type__apt_ppa.html @@ -1,24 +1,31 @@ - - + - - - - + + + + + 16.9. cdist-type__apt_ppa(7) — cdist 6.9.8 documentation + + + + + + - 16.8. cdist-type__apt_ppa(7) — cdist 6.9.7 documentation - + - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.8. cdist-type__apt_ppa(7)
      • +
    • 16.9. cdist-type__apt_ppa(7)
    • - + View page source @@ -368,30 +376,30 @@
      -
      -

      16.8. cdist-type__apt_ppa(7)

      -
      -

      16.8.1. NAME

      +
      +

      16.9. cdist-type__apt_ppa(7)

      +
      +

      16.9.1. NAME

      cdist-type__apt_ppa - Manage ppa repositories

      -
      -
      -

      16.8.2. DESCRIPTION

      +
      +
      +

      16.9.2. DESCRIPTION

      This cdist type allows manage ubuntu ppa repositories.

      - -
      -

      16.8.3. REQUIRED PARAMETERS

      +
      +
      +

      16.9.3. REQUIRED PARAMETERS

      state

      The state the ppa should be in, either 'present' or 'absent'. Defaults to 'present'

      - -
      -

      16.8.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.9.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.8.5. EXAMPLES

      +
      +
      +

      16.9.5. EXAMPLES

      # Enable a ppa repository
 __apt_ppa ppa:sans-intern/missing-bits
 # same as
@@ -401,48 +409,48 @@ __apt_ppa ppa:sans-intern/missing-bits --state present
 __apt_ppa ppa:sans-intern/missing-bits --state absent
      - -
      -

      16.8.6. AUTHORS

      +
      +
      +

      16.9.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.8.7. COPYING

      +
      +
      +

      16.9.7. COPYING

      Copyright (C) 2011-2014 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -451,7 +459,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.9. cdist-type__apt_source(7)
      • +
    • 16.10. cdist-type__apt_source(7)
    • - + View page source @@ -369,26 +377,26 @@
      -
      -

      16.9. cdist-type__apt_source(7)

      -
      -

      16.9.1. NAME

      +
      +

      16.10. cdist-type__apt_source(7)

      +
      +

      16.10.1. NAME

      cdist-type__apt_source - Manage apt sources

      -
      -
      -

      16.9.2. DESCRIPTION

      +
      +
      +

      16.10.2. DESCRIPTION

      This cdist type allows you to manage apt sources. It invokes index update internally when needed so call of index updating type is not needed.

      - -
      -

      16.9.3. REQUIRED PARAMETERS

      +
      +
      +

      16.10.3. REQUIRED PARAMETERS

      uri

      the uri to the apt repository

      - -
      -

      16.9.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.10.4. OPTIONAL PARAMETERS

      arch

      set this if you need to force and specific arch (ubuntu specific)

      @@ -400,16 +408,16 @@ the targets /etc/lsb-release

      component

      space delimited list of components to enable. Defaults to an empty string.

      - -
      -

      16.9.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.10.5. BOOLEAN PARAMETERS

      include-src

      include deb-src entries

      - -
      -

      16.9.6. EXAMPLES

      +
      +
      +

      16.10.6. EXAMPLES

      __apt_source rabbitmq \
    --uri http://www.rabbitmq.com/debian/ \
    --distribution testing \
@@ -422,48 +430,48 @@ __apt_source canonical_partner \
    --component partner --state present
      - -
      -

      16.9.7. AUTHORS

      +
      +
      +

      16.10.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.9.8. COPYING

      +
      +
      +

      16.10.8. COPYING

      Copyright (C) 2011-2018 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -472,7 +480,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.10. cdist-type__apt_unattended_upgrades(7)
      • +
    • 16.11. cdist-type__apt_unattended_upgrades(7)
    • - + View page source @@ -367,19 +375,19 @@
      -
      -

      16.10. cdist-type__apt_unattended_upgrades(7)

      -
      -

      16.10.1. NAME

      +
      +

      16.11. cdist-type__apt_unattended_upgrades(7)

      +
      +

      16.11.1. NAME

      cdist-type__apt_unattended_upgrades - automatic installation of updates

      -
      -
      -

      16.10.2. DESCRIPTION

      +
      +
      +

      16.11.2. DESCRIPTION

      Install and configure unattended-upgrades package.

      For more information see https://wiki.debian.org/UnattendedUpgrades.

      - -
      -

      16.10.3. OPTIONAL MULTIPLE PARAMETERS

      +
      +
      +

      16.11.3. OPTIONAL MULTIPLE PARAMETERS

      option

      Set options for unattended-upgrades. See examples.

      Supported options with default values (as of 2020-01-17) are:

      @@ -406,9 +414,9 @@
      blacklist

      Python regular expressions, matching packages to exclude from upgrading.

      - -
      -

      16.10.4. EXAMPLES

      +
      +
      +

      16.11.4. EXAMPLES

      __apt_unattended_upgrades \
     --option Mail=root \
     --option MailOnlyOnError=true \
@@ -416,48 +424,48 @@
     --blacklist open-iscsi
      - -
      -

      16.10.5. AUTHORS

      +
      +
      +

      16.11.5. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.10.6. COPYING

      +
      +
      +

      16.11.6. COPYING

      Copyright (C) 2020 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -466,7 +474,6 @@ later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.11. cdist-type__apt_update_index(7)
      • +
    • 16.12. cdist-type__apt_update_index(7)
    • - + View page source @@ -368,71 +376,71 @@
      -
      -

      16.11. cdist-type__apt_update_index(7)

      -
      -

      16.11.1. NAME

      +
      +

      16.12. cdist-type__apt_update_index(7)

      +
      +

      16.12.1. NAME

      cdist-type__apt_update_index - Update apt's package index

      -
      -
      -

      16.11.2. DESCRIPTION

      +
      +
      +

      16.12.2. DESCRIPTION

      This cdist type runs apt-get update whenever any apt sources have changed.

      - -
      -

      16.11.3. REQUIRED PARAMETERS

      +
      +
      +

      16.12.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.11.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.12.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.11.5. EXAMPLES

      +
      +
      +

      16.12.5. EXAMPLES

      __apt_update_index
      - -
      -

      16.11.6. AUTHORS

      +
      +
      +

      16.12.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.11.7. COPYING

      +
      +
      +

      16.12.7. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -441,7 +449,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.12. cdist-type__block(7)
      • +
    • 16.13. cdist-type__block(7)
    • - + View page source @@ -369,29 +377,29 @@
      -
      -

      16.12. cdist-type__block(7)

      -
      -

      16.12.1. NAME

      +
      +

      16.13. cdist-type__block(7)

      +
      +

      16.13.1. NAME

      cdist-type__block - Manage blocks of text in files

      -
      -
      -

      16.12.2. DESCRIPTION

      +
      +
      +

      16.13.2. DESCRIPTION

      Manage a block of text in an existing file. The block is identified using the prefix and suffix parameters. Everything between prefix and suffix is considered to be a managed block of text.

      - -
      -

      16.12.3. REQUIRED PARAMETERS

      +
      +
      +

      16.13.3. REQUIRED PARAMETERS

      text

      the text to manage. If text is '-' (dash), take what was written to stdin as the text.

      - -
      -

      16.12.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.13.4. OPTIONAL PARAMETERS

      file

      the file in which to manage the text block. Defaults to object_id.

      @@ -405,9 +413,9 @@ Defaults to #/cdist:__block/$__object_id

      state

      'present' or 'absent', defaults to 'present'

      - -
      -

      16.12.5. MESSAGES

      +
      +
      +

      16.13.5. MESSAGES

      add

      block was added

      @@ -416,9 +424,9 @@ Defaults to #/cdist:__block/$__object_id

      remove

      block was removed

      - -
      -

      16.12.6. EXAMPLES

      +
      +
      +

      16.13.6. EXAMPLES

      # text from argument
 __block /path/to/file \
    --prefix '#start' \
@@ -434,48 +442,48 @@ __block some-id \
 DONE
      - -
      -

      16.12.7. AUTHORS

      +
      +
      +

      16.13.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.12.8. COPYING

      +
      +
      +

      16.13.8. COPYING

      Copyright (C) 2013 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -484,7 +492,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.13. cdist-type__ccollect_source(7)
      • +
    • 16.14. cdist-type__ccollect_source(7)
    • - + View page source @@ -371,52 +379,52 @@
      -
      -

      16.13. cdist-type__ccollect_source(7)

      -
      -

      16.13.1. NAME

      +
      +

      16.14. cdist-type__ccollect_source(7)

      +
      +

      16.14.1. NAME

      cdist-type__ccollect_source - Manage ccollect sources

      -
      -
      -

      16.13.2. DESCRIPTION

      +
      +
      +

      16.14.2. DESCRIPTION

      This cdist type allows you to create or delete ccollect sources.

      - -
      -

      16.13.3. REQUIRED PARAMETERS

      +
      +
      +

      16.14.3. REQUIRED PARAMETERS

      source

      The source from which to backup

      destination

      The destination directory

      - -
      -

      16.13.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.14.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      ccollectconf

      The CCOLLECT_CONF directory. Defaults to /etc/ccollect.

      - -
      -

      16.13.5. OPTIONAL MULTIPLE PARAMETERS

      +
      +
      +

      16.14.5. OPTIONAL MULTIPLE PARAMETERS

      exclude

      Paths to exclude of backup

      - -
      -

      16.13.6. BOOLEAN PARAMETERS

      +
      +
      +

      16.14.6. BOOLEAN PARAMETERS

      verbose

      Whether to report backup verbosely

      create-destination

      Create the directory specified in the destination parameter on the remote host

      - -
      -

      16.13.7. EXAMPLES

      +
      +
      +

      16.14.7. EXAMPLES

      __ccollect_source doc.ungleich.ch \
     --source doc.ungleich.ch:/ \
     --destination /backup/doc.ungleich.ch \
@@ -431,52 +439,52 @@ __ccollect_source doc.ungleich.ch \
     --create-destination
      - -
      -

      16.13.8. SEE ALSO

      +
      +
      +

      16.14.8. SEE ALSO

      ccollect(1)

      - -
      -

      16.13.9. AUTHORS

      +
      +
      +

      16.14.9. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.13.10. COPYING

      +
      +
      +

      16.14.10. COPYING

      Copyright (C) 2014 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -485,7 +493,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.14. cdist-type__cdist(7)
      • +
    • 16.15. cdist-type__cdist(7)
    • - + View page source @@ -368,14 +376,14 @@
      -
      -

      16.14. cdist-type__cdist(7)

      -
      -

      16.14.1. NAME

      +
      +

      16.15. cdist-type__cdist(7)

      +
      +

      16.15.1. NAME

      cdist-type__cdist - Manage cdist installations

      -
      -
      -

      16.14.2. DESCRIPTION

      +
      +
      +

      16.15.2. DESCRIPTION

      This cdist type allows you to easily setup cdist on another box, to allow the other box to configure systems.

      @@ -383,12 +391,12 @@ systems.

      It is only helpful to build FROM which you configure other hosts.

      This type will use git to clone

      - -
      -

      16.14.3. REQUIRED PARAMETERS

      -
      -
      -

      16.14.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.15.3. REQUIRED PARAMETERS

      +
      +
      +

      16.15.4. OPTIONAL PARAMETERS

      username

      Select the user to create for the cdist installation. Defaults to "cdist".

      @@ -400,9 +408,9 @@ Defaults to " -

      16.14.5. EXAMPLES

      +
      +
      +

      16.15.5. EXAMPLES

      # Install cdist for user cdist in her home as subfolder cdist
 __cdist /home/cdist/cdist
 
@@ -410,48 +418,48 @@ __cdist /home/cdist/cdist
 __cdist --source "git@code.ungleich.ch:ungleich-public/cdist.git" /home/cdist/cdist
      - -
      -

      16.14.6. AUTHORS

      +
      +
      +

      16.15.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.14.7. COPYING

      +
      +
      +

      16.15.7. COPYING

      Copyright (C) 2013 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -460,7 +468,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.15. cdist-type__cdist_preos_trigger(7)
      • +
    • 16.16. cdist-type__cdist_preos_trigger(7)
    • - + View page source @@ -368,76 +376,76 @@
      -
      -

      16.15. cdist-type__cdist_preos_trigger(7)

      -
      -

      16.15.1. NAME

      +
      +

      16.16. cdist-type__cdist_preos_trigger(7)

      +
      +

      16.16.1. NAME

      cdist-type__cdist_preos_trigger - configure cdist preos trigger

      -
      -
      -

      16.15.2. DESCRIPTION

      +
      +
      +

      16.16.2. DESCRIPTION

      Create cdist PreOS trigger by creating systemd unit file that will be started at boot and will execute trigger command - connect to specified host and port.

      - -
      -

      16.15.3. REQUIRED PARAMETERS

      +
      +
      +

      16.16.3. REQUIRED PARAMETERS

      trigger-command

      Command that will be executed as a PreOS cdist trigger.

      - -
      -

      16.15.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.16.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.15.5. EXAMPLES

      +
      +
      +

      16.16.5. EXAMPLES

      # Configure default curl trigger for host cdist.ungleich.ch at port 80.
 __cdist_preos_trigger http --trigger-command '/usr/bin/curl cdist.ungleich.ch:80'
      - -
      -

      16.15.6. AUTHORS

      +
      +
      +

      16.16.6. AUTHORS

      Darko Poljak <darko.poljak--@--ungleich.ch>

      - -
      -

      16.15.7. COPYING

      +
      +
      +

      16.16.7. COPYING

      Copyright (C) 2016 Darko Poljak. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -446,7 +454,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.16. cdist-type__cdistmarker(7)
      • +
    • 16.17. cdist-type__cdistmarker(7)
    • - + View page source @@ -368,25 +376,25 @@
      -
      -

      16.16. cdist-type__cdistmarker(7)

      -
      -

      16.16.1. NAME

      +
      +

      16.17. cdist-type__cdistmarker(7)

      +
      +

      16.17.1. NAME

      cdist-type__cdistmarker - Add a timestamped cdist marker.

      -
      -
      -

      16.16.2. DESCRIPTION

      +
      +
      +

      16.17.2. DESCRIPTION

      This type is used to add a common marker file which indicates that a given machine is being managed by cdist. The contents of this file consist of a timestamp, which can be used to determine the most recent time at which cdist was run against the machine in question.

      - -
      -

      16.16.3. REQUIRED PARAMETERS

      +
      +
      +

      16.17.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.16.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.17.4. OPTIONAL PARAMETERS

      destination

      The path and filename of the marker. Default: /etc/cdist-configured

      @@ -395,9 +403,9 @@ Default: /etc/cdist-configured

      Default: -u

      - -
      -

      16.16.5. EXAMPLES

      +
      +
      +

      16.17.5. EXAMPLES

      # Creates the marker as normal.
 __cdistmarker
 
@@ -405,48 +413,48 @@ __cdistmarker
 __cdistmarker --destination /tmp/cdist_marker --format '+%s'
      - -
      -

      16.16.6. AUTHORS

      +
      +
      +

      16.17.6. AUTHORS

      Daniel Maher <phrawzty+cdist--@--gmail.com>

      - -
      -

      16.16.7. COPYING

      +
      +
      +

      16.17.7. COPYING

      Copyright (C) 2011 Daniel Maher. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.17. cdist-type__check_messages(7)
      • +
    • 16.18. cdist-type__check_messages(7)
    • - + View page source @@ -367,14 +375,14 @@
      -
      -

      16.17. cdist-type__check_messages(7)

      -
      -

      16.17.1. NAME

      +
      +

      16.18. cdist-type__check_messages(7)

      +
      +

      16.18.1. NAME

      cdist-type__check_messages - Check messages for pattern and execute command on match.

      -
      -
      -

      16.17.2. DESCRIPTION

      +
      +
      +

      16.18.2. DESCRIPTION

      Check messages for pattern and execute command on match.

      This type is useful if you chain together multiple related types using dependencies and want to restart service if at least one type changes @@ -382,65 +390,65 @@ something.

      For more information about messages see cdist messaging.

      For more information about dependencies and execution order see cdist manifest documentation.

      - -
      -

      16.17.3. REQUIRED PARAMETERS

      +
      +
      +

      16.18.3. REQUIRED PARAMETERS

      pattern

      Extended regular expression pattern for search (passed to grep -E).

      execute

      Command to execute on pattern match.

      - -
      -

      16.17.4. EXAMPLES

      +
      +
      +

      16.18.4. EXAMPLES

      __check_messages munin \
     --pattern '^__(file|link|line)/etc/munin/' \
     --execute 'service munin-node restart'
      - -
      -

      16.17.5. AUTHORS

      +
      +
      +

      16.18.5. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.17.6. COPYING

      +
      +
      +

      16.18.6. COPYING

      Copyright (C) 2019 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -449,7 +457,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.18. cdist-type__chroot_mount(7)
      • +
    • 16.19. cdist-type__chroot_mount(7)
    • - + View page source @@ -369,22 +377,22 @@
      -
      -

      16.18. cdist-type__chroot_mount(7)

      -
      -

      16.18.1. NAME

      +
      +

      16.19. cdist-type__chroot_mount(7)

      +
      +

      16.19.1. NAME

      cdist-type__chroot_mount - mount a chroot

      -
      -
      -

      16.18.2. DESCRIPTION

      +
      +
      +

      16.19.2. DESCRIPTION

      Mount and prepare a chroot for running commands within it.

      - -
      -

      16.18.3. REQUIRED PARAMETERS

      +
      +
      +

      16.19.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.18.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.19.4. OPTIONAL PARAMETERS

      manage-resolv-conf

      manage /etc/resolv.conf inside the chroot. Use the value of this parameter as the suffix to save a copy @@ -393,61 +401,61 @@ This is used by the __chroot_umount type to restore the initial file content when unmounting the chroot.

      - -
      -

      16.18.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.19.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.18.6. EXAMPLES

      +
      +
      +

      16.19.6. EXAMPLES

      __chroot_mount /path/to/chroot
 
 __chroot_mount /path/to/chroot \
   --manage-resolv-conf "some-known-string"
      - -
      -

      16.18.7. AUTHORS

      +
      +
      +

      16.19.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.18.8. COPYING

      +
      +
      +

      16.19.8. COPYING

      Copyright (C) 2012-2017 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -456,7 +464,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.19. cdist-type__chroot_umount(7)
      • +
    • 16.20. cdist-type__chroot_umount(7)
    • - + View page source @@ -370,22 +378,22 @@
      -
      -

      16.19. cdist-type__chroot_umount(7)

      -
      -

      16.19.1. NAME

      +
      +

      16.20. cdist-type__chroot_umount(7)

      +
      +

      16.20.1. NAME

      cdist-type__chroot_umount - unmount a chroot mounted by __chroot_mount

      -
      -
      -

      16.19.2. DESCRIPTION

      +
      +
      +

      16.20.2. DESCRIPTION

      Undo what __chroot_mount did.

      - -
      -

      16.19.3. REQUIRED PARAMETERS

      +
      +
      +

      16.20.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.19.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.20.4. OPTIONAL PARAMETERS

      manage-resolv-conf

      manage /etc/resolv.conf inside the chroot. Use the value of this parameter as the suffix to find the backup file @@ -394,65 +402,65 @@ This is used by the to restore the initial file content when unmounting the chroot.

      - -
      -

      16.19.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.20.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.19.6. EXAMPLES

      +
      +
      +

      16.20.6. EXAMPLES

      __chroot_umount /path/to/chroot
 
 __chroot_umount /path/to/chroot \
   --manage-resolv-conf "some-known-string"
      - -
      -

      16.19.7. SEE ALSO

      +
      +
      +

      16.20.7. SEE ALSO

      cdist-type__chroot_mount(7)

      - -
      -

      16.19.8. AUTHORS

      +
      +
      +

      16.20.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.19.9. COPYING

      +
      +
      +

      16.20.9. COPYING

      Copyright (C) 2012-2017 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -461,7 +469,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.20. cdist-type__clean_path(7)
      • +
    • 16.21. cdist-type__clean_path(7)
    • - + View page source @@ -368,30 +376,30 @@
      -
      -

      16.20. cdist-type__clean_path(7)

      -
      -

      16.20.1. NAME

      +
      +

      16.21. cdist-type__clean_path(7)

      +
      +

      16.21.1. NAME

      cdist-type__clean_path - Remove files and directories which match the pattern.

      -
      -
      -

      16.20.2. DESCRIPTION

      +
      +
      +

      16.21.2. DESCRIPTION

      Remove files and directories which match the pattern.

      Provided path must be a directory.

      Patterns are passed to find's -regex - see find(1) for more details.

      Look up of files and directories is non-recursive (-maxdepth 1).

      Parent directory is excluded (-mindepth 1).

      This type is not POSIX compatible (sorry, Solaris users).

      - -
      -

      16.20.3. REQUIRED PARAMETERS

      +
      +
      +

      16.21.3. REQUIRED PARAMETERS

      pattern

      Pattern of files which are removed from path.

      - -
      -

      16.20.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.21.4. OPTIONAL PARAMETERS

      path

      Path which will be cleaned. Defaults to $__object_id.

      @@ -400,9 +408,9 @@
      onchange

      The code to run if files or directories were removed.

      - -
      -

      16.20.5. EXAMPLES

      +
      +
      +

      16.21.5. EXAMPLES

      __clean_path /etc/apache2/conf-enabled \
     --pattern '.+' \
     --exclude '.+\(charset\.conf\|security\.conf\)' \
@@ -415,48 +423,48 @@ __clean_path apache2-conf-enabled \
     --onchange 'service apache2 restart'
      - -
      -

      16.20.6. AUTHORS

      +
      +
      +

      16.21.6. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.20.7. COPYING

      +
      +
      +

      16.21.7. COPYING

      Copyright (C) 2019 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -465,7 +473,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.21. cdist-type__config_file(7)
      • +
    • 16.22. cdist-type__config_file(7)
    • - + View page source @@ -369,23 +377,23 @@
      -
      -

      16.21. cdist-type__config_file(7)

      -
      -

      16.21.1. NAME

      +
      +

      16.22. cdist-type__config_file(7)

      +
      +

      16.22.1. NAME

      cdist-type__config_file - _Manages config files

      -
      -
      -

      16.21.2. DESCRIPTION

      +
      +
      +

      16.22.2. DESCRIPTION

      Deploy config files using the file type. Run the given code if the files changes.

      - -
      -

      16.21.3. REQUIRED PARAMETERS

      +
      +
      +

      16.22.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.21.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.22.4. OPTIONAL PARAMETERS

      group

      see cdist-type__file

      @@ -401,9 +409,9 @@ If source is '-' (dash), take what was written to stdin as the config file conte
      state

      see cdist-type__file

      - -
      -

      16.21.5. EXAMPLES

      +
      +
      +

      16.22.5. EXAMPLES

      __config_file /etc/consul/conf.d/watch_foo.json \
    --owner root --group consul --mode 640 \
    --source "$__type/files/watch_foo.json" \
@@ -411,52 +419,52 @@ If source is '-' (dash), take what was written to stdin as the config file conte
    --onchange 'service consul status >/dev/null && service consul reload || true'
      - -
      -

      16.21.6. SEE ALSO

      +
      +
      +

      16.22.6. SEE ALSO

      cdist-type__file(7)

      - -
      -

      16.21.7. AUTHORS

      +
      +
      +

      16.22.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.21.8. COPYING

      +
      +
      +

      16.22.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -465,7 +473,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.22. cdist-type__consul(7)
      • +
    • 16.23. cdist-type__consul(7)
    • - + View page source @@ -370,25 +378,25 @@
      -
      -

      16.22. cdist-type__consul(7)

      -
      -

      16.22.1. NAME

      +
      +

      16.23. cdist-type__consul(7)

      +
      +

      16.23.1. NAME

      cdist-type__consul - Install consul

      -
      -
      -

      16.22.2. DESCRIPTION

      +
      +
      +

      16.23.2. DESCRIPTION

      Downloads and installs the consul binary from https://dl.bintray.com/mitchellh/consul. Note that the consul binary is downloaded on the server (the machine running cdist) and then deployed to the target host using the __file type unless --direct parameter is used.

      - -
      -

      16.22.3. REQUIRED PARAMETERS

      +
      +
      +

      16.23.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.22.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.23.4. OPTIONAL PARAMETERS

      state

      either 'present' or 'absent'. Defaults to 'present'

      @@ -396,25 +404,25 @@ parameter is used.

      supported versions. Defaults to the latest known version.

      - -
      -

      16.22.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.23.5. BOOLEAN PARAMETERS

      direct

      Download and deploy consul binary directly on the target machine.

      - -
      -

      16.22.6. MESSAGES

      +
      +
      +

      16.23.6. MESSAGES

      If consul binary is created using __staged_file then underlaying __file type messages are emitted.

      If consul binary is created by direct method then the following messages are emitted:

      /usr/local/bin/consul created

      consul binary was created

      - -
      -

      16.22.7. EXAMPLES

      +
      +
      +

      16.23.7. EXAMPLES

      # just install using defaults
 __consul
 
@@ -426,51 +434,51 @@ __consul \
    --version 0.4.1
      - -
      -

      16.22.8. AUTHORS

      +
      +
      +

      16.23.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>
      Darko Poljak <darko.poljak--@--gmail.com>
      - -
      -

      16.22.9. COPYING

      +
      +
      +

      16.23.9. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -479,7 +487,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.23. cdist-type__consul_agent(7)
      • +
    • 16.24. cdist-type__consul_agent(7)
    • - + View page source @@ -370,22 +378,22 @@
      -
      -

      16.23. cdist-type__consul_agent(7)

      -
      -

      16.23.1. NAME

      +
      +

      16.24. cdist-type__consul_agent(7)

      +
      +

      16.24.1. NAME

      cdist-type__consul_agent - Manage the consul agent

      -
      -
      -

      16.23.2. DESCRIPTION

      +
      +
      +

      16.24.2. DESCRIPTION

      Configure and manage the consul agent.

      - -
      -

      16.23.3. REQUIRED PARAMETERS

      +
      +
      +

      16.24.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.23.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.24.4. OPTIONAL PARAMETERS

      acl-datacenter

      only used by servers. This designates the datacenter which is authoritative for ACL information.

      @@ -439,9 +447,9 @@ Can be specified multiple times.

      Currently state=absent is not working due to some dependency issues.

      - -
      -

      16.23.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.24.5. BOOLEAN PARAMETERS

      disable-remote-exec

      disables support for remote execution. When set to true, the agent will ignore any incoming remote exec requests.

      @@ -462,9 +470,9 @@ Currently state=absent is not working due to some dependency issues.

      use-distribution-package

      uses distribution package instead of upstream binary

      - -
      -

      16.23.6. EXAMPLES

      +
      +
      +

      16.24.6. EXAMPLES

      # configure as server, bootstrap and rejoin
 hostname="$(cat "$__global/explorer/hostname")"
 __consul_agent \
@@ -506,52 +514,52 @@ __consul_agent \
    --retry-join consul-03
      - -
      -

      16.23.7. SEE ALSO

      +
      +
      +

      16.24.7. SEE ALSO

      consul documentation at: <http://www.consul.io/docs/agent/options.html>.

      - -
      -

      16.23.8. AUTHORS

      +
      +
      +

      16.24.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.23.9. COPYING

      +
      +
      +

      16.24.9. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -560,7 +568,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.24. cdist-type__consul_check(7)
      • +
    • 16.25. cdist-type__consul_check(7)
    • - + View page source @@ -369,24 +377,24 @@
      -
      -

      16.24. cdist-type__consul_check(7)

      -
      -

      16.24.1. NAME

      +
      +

      16.25. cdist-type__consul_check(7)

      +
      +

      16.25.1. NAME

      cdist-type__consul_check - Manages consul checks

      -
      -
      -

      16.24.2. DESCRIPTION

      +
      +
      +

      16.25.2. DESCRIPTION

      Generate and deploy check definitions for a consul agent. See http://www.consul.io/docs/agent/checks.html for parameter documentation.

      Use either script together with interval, or use ttl.

      - -
      -

      16.24.3. REQUIRED PARAMETERS

      +
      +
      +

      16.25.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.24.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.25.4. OPTIONAL PARAMETERS

      docker-container-id

      the id of the docker container to run

      @@ -420,9 +428,9 @@ See -

      16.24.5. EXAMPLES

      +
      +
      +

      16.25.5. EXAMPLES

      __consul_check redis \
    --script /usr/local/bin/check_redis.py \
    --interval 10s
@@ -434,52 +442,52 @@ __consul_check some-object-id \
    --ttl 30s
      - -
      -

      16.24.6. SEE ALSO

      +
      +
      +

      16.25.6. SEE ALSO

      cdist-type__consul_agent(7)

      - -
      -

      16.24.7. AUTHORS

      +
      +
      +

      16.25.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.24.8. COPYING

      +
      +
      +

      16.25.8. COPYING

      Copyright (C) 2015-2016 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -488,7 +496,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.25. cdist-type__consul_reload(7)
      • +
    • 16.26. cdist-type__consul_reload(7)
    • - + View page source @@ -368,71 +376,71 @@
      -
      -

      16.25. cdist-type__consul_reload(7)

      -
      -

      16.25.1. NAME

      +
      +

      16.26. cdist-type__consul_reload(7)

      +
      +

      16.26.1. NAME

      cdist-type__consul_reload - Reload consul

      -
      -
      -

      16.25.2. DESCRIPTION

      +
      +
      +

      16.26.2. DESCRIPTION

      Reload consul after configuration changes.

      - -
      -

      16.25.3. REQUIRED PARAMETERS

      +
      +
      +

      16.26.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.25.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.26.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.25.5. EXAMPLES

      +
      +
      +

      16.26.5. EXAMPLES

      __consul_reload
      - -
      -

      16.25.6. AUTHORS

      +
      +
      +

      16.26.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.25.7. COPYING

      +
      +
      +

      16.26.7. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -441,7 +449,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.26. cdist-type__consul_service(7)
      • +
    • 16.27. cdist-type__consul_service(7)
    • - + View page source @@ -369,24 +377,24 @@
      -
      -

      16.26. cdist-type__consul_service(7)

      -
      -

      16.26.1. NAME

      +
      +

      16.27. cdist-type__consul_service(7)

      +
      +

      16.27.1. NAME

      cdist-type__consul_service - Manages consul services

      -
      -
      -

      16.26.2. DESCRIPTION

      +
      +
      +

      16.27.2. DESCRIPTION

      Generate and deploy service definitions for a consul agent. See http://www.consul.io/docs/agent/services.html for parameter documentation.

      Use either script together with interval, or use ttl.

      - -
      -

      16.26.3. REQUIRED PARAMETERS

      +
      +
      +

      16.27.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.26.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.27.4. OPTIONAL PARAMETERS

      check-interval

      the interval in which the script given with --check-script should be run

      @@ -408,9 +416,9 @@ HTTP interfave

      tag

      a tag to add to this service. Can be specified multiple times.

      - -
      -

      16.26.5. EXAMPLES

      +
      +
      +

      16.27.5. EXAMPLES

      __consul_service redis \
    --tag master \
    --tag production \
@@ -423,52 +431,52 @@ __consul_service webapp \
    --check-ttl 10s
      - -
      -

      16.26.6. SEE ALSO

      +
      +
      +

      16.27.6. SEE ALSO

      cdist-type__consul_agent(7)

      - -
      -

      16.26.7. AUTHORS

      +
      +
      +

      16.27.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.26.8. COPYING

      +
      +
      +

      16.27.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -477,7 +485,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.27. cdist-type__consul_template(7)
      • +
    • 16.28. cdist-type__consul_template(7)
    • - + View page source @@ -370,26 +378,26 @@
      -
      -

      16.27. cdist-type__consul_template(7)

      -
      -

      16.27.1. NAME

      +
      +

      16.28. cdist-type__consul_template(7)

      +
      +

      16.28.1. NAME

      cdist-type__consul_template - Manage the consul-template service

      -
      -
      -

      16.27.2. DESCRIPTION

      +
      +
      +

      16.28.2. DESCRIPTION

      Downloads and installs the consul-template binary from https://github.com/hashicorp/consul-template/releases/download/. Generates a global config file and creates directory for per template config files. Note that the consul-template binary is downloaded on the server (the machine running cdist) and then deployed to the target host using the __file type.

      - -
      -

      16.27.3. REQUIRED PARAMETERS

      +
      +
      +

      16.28.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.27.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.28.4. OPTIONAL PARAMETERS

      auth-username

      specify a username for basic authentication.

      @@ -441,9 +449,9 @@ triggering a command, separated by a colon (:). If the optional maximum value is omitted, it is assumed to be 4x the required minimum value.

      - -
      -

      16.27.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.28.5. BOOLEAN PARAMETERS

      ssl

      use HTTPS while talking to Consul. Requires the Consul server to be configured to serve secure connections.

      @@ -456,9 +464,9 @@ value is omitted, it is assumed to be 4x the required minimum value.

      vault-ssl-no-verify

      ignore certificate warnings. Only used if vault is enabled.

      - -
      -

      16.27.6. EXAMPLES

      +
      +
      +

      16.28.6. EXAMPLES

      __consul_template \
    --consul consul.service.consul:8500 \
    --retry 30s
@@ -469,52 +477,52 @@ __consul_template \
    --retry 30s
      - -
      -

      16.27.7. SEE ALSO

      +
      +
      +

      16.28.7. SEE ALSO

      consul documentation at: <https://github.com/hashicorp/consul-template>.

      - -
      -

      16.27.8. AUTHORS

      +
      +
      +

      16.28.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.27.9. COPYING

      +
      +
      +

      16.28.9. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -523,7 +531,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.28. cdist-type__consul_template_template(7)
      • +
    • 16.29. cdist-type__consul_template_template(7)
    • - + View page source @@ -369,28 +377,28 @@
      -
      -

      16.28. cdist-type__consul_template_template(7)

      -
      -

      16.28.1. NAME

      +
      +

      16.29. cdist-type__consul_template_template(7)

      +
      +

      16.29.1. NAME

      cdist-type__consul_template_template - Manage consul-template templates

      -
      -
      -

      16.28.2. DESCRIPTION

      +
      +
      +

      16.29.2. DESCRIPTION

      Generate and deploy template definitions for a consul-template. See https://github.com/hashicorp/consul-template#examples for documentation. Templates are written in the Go template format. Either the --source or the --source-file parameter must be given.

      - -
      -

      16.28.3. REQUIRED PARAMETERS

      +
      +
      +

      16.29.3. REQUIRED PARAMETERS

      destination

      the destination where the generated file should go.

      - -
      -

      16.28.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.29.4. OPTIONAL PARAMETERS

      command

      an optional command to run after rendering the template to its destination.

      @@ -411,9 +419,9 @@ The wait value for a template takes precedence over any globally-configured wait.

      - -
      -

      16.28.5. EXAMPLES

      +
      +
      +

      16.29.5. EXAMPLES

      # configure template on the target
 __consul_template_template nginx \
    --source /etc/my-consul-templates/nginx.ctmpl \
@@ -429,52 +437,52 @@ __consul_template_template nginx \
    --command 'service nginx restart'
      - -
      -

      16.28.6. SEE ALSO

      +
      +
      +

      16.29.6. SEE ALSO

      cdist-type__consul_template(7), cdist-type__consul_template_config(7)

      - -
      -

      16.28.7. AUTHORS

      +
      +
      +

      16.29.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.28.8. COPYING

      +
      +
      +

      16.29.8. COPYING

      Copyright (C) 2015-2016 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -483,7 +491,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.29. cdist-type__consul_watch_checks(7)
      • +
    • 16.30. cdist-type__consul_watch_checks(7)
    • - + View page source @@ -369,26 +377,26 @@
      -
      -

      16.29. cdist-type__consul_watch_checks(7)

      -
      -

      16.29.1. NAME

      +
      +

      16.30. cdist-type__consul_watch_checks(7)

      +
      +

      16.30.1. NAME

      cdist-type__consul_watch_checks - Manages consul checks watches

      -
      -
      -

      16.29.2. DESCRIPTION

      +
      +
      +

      16.30.2. DESCRIPTION

      Generate and deploy watch definitions of type 'checks' for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

      - -
      -

      16.29.3. REQUIRED PARAMETERS

      +
      +
      +

      16.30.3. REQUIRED PARAMETERS

      handler

      the handler to invoke when the data view updates

      - -
      -

      16.29.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.30.4. OPTIONAL PARAMETERS

      datacenter

      can be provided to override the agent's default datacenter

      @@ -401,9 +409,9 @@ See -

      16.29.5. EXAMPLES

      +
      +
      +

      16.30.5. EXAMPLES

      __consul_watch_checks some-id \
    --handler /usr/bin/my-handler.sh
 
@@ -416,53 +424,53 @@ __consul_watch_checks some-id \
    --handler /usr/bin/my-handler.sh
      - -
      -

      16.29.6. SEE ALSO

      +
      +
      +

      16.30.6. SEE ALSO

      cdist-type__consul_agent(7)

      consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

      - -
      -

      16.29.7. AUTHORS

      +
      +
      +

      16.30.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.29.8. COPYING

      +
      +
      +

      16.30.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -471,7 +479,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.30. cdist-type__consul_watch_event(7)
      • +
    • 16.31. cdist-type__consul_watch_event(7)
    • - + View page source @@ -369,26 +377,26 @@
      -
      -

      16.30. cdist-type__consul_watch_event(7)

      -
      -

      16.30.1. NAME

      +
      +

      16.31. cdist-type__consul_watch_event(7)

      +
      +

      16.31.1. NAME

      cdist-type__consul_watch_event - Manages consul event watches

      -
      -
      -

      16.30.2. DESCRIPTION

      +
      +
      +

      16.31.2. DESCRIPTION

      Generate and deploy watch definitions of type 'event' for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

      - -
      -

      16.30.3. REQUIRED PARAMETERS

      +
      +
      +

      16.31.3. REQUIRED PARAMETERS

      handler

      the handler to invoke when the data view updates

      - -
      -

      16.30.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.31.4. OPTIONAL PARAMETERS

      datacenter

      can be provided to override the agent's default datacenter

      @@ -399,9 +407,9 @@ See -

      16.30.5. EXAMPLES

      +
      +
      +

      16.31.5. EXAMPLES

      __consul_watch_event some-id \
    --handler /usr/bin/my-handler.sh
 
@@ -410,53 +418,53 @@ __consul_watch_event some-id \
    --handler /usr/bin/my-handler.sh
      - -
      -

      16.30.6. SEE ALSO

      +
      +
      +

      16.31.6. SEE ALSO

      cdist-type__consul_agent(7)

      consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

      - -
      -

      16.30.7. AUTHORS

      +
      +
      +

      16.31.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.30.8. COPYING

      +
      +
      +

      16.31.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -465,7 +473,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.31. cdist-type__consul_watch_key(7)
      • +
    • 16.32. cdist-type__consul_watch_key(7)
    • - + View page source @@ -369,28 +377,28 @@
      -
      -

      16.31. cdist-type__consul_watch_key(7)

      -
      -

      16.31.1. NAME

      +
      +

      16.32. cdist-type__consul_watch_key(7)

      +
      +

      16.32.1. NAME

      cdist-type__consul_watch_key - Manages consul key watches

      -
      -
      -

      16.31.2. DESCRIPTION

      +
      +
      +

      16.32.2. DESCRIPTION

      Generate and deploy watch definitions of type 'key' for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

      - -
      -

      16.31.3. REQUIRED PARAMETERS

      +
      +
      +

      16.32.3. REQUIRED PARAMETERS

      handler

      the handler to invoke when the data view updates

      key

      the key to watch for changes

      - -
      -

      16.31.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.32.4. OPTIONAL PARAMETERS

      datacenter

      can be provided to override the agent's default datacenter

      @@ -399,61 +407,61 @@ See -

      16.31.5. EXAMPLES

      +
      +
      +

      16.32.5. EXAMPLES

      __consul_watch_key some-id \
    --key foo/bar/baz \
    --handler /usr/bin/my-key-handler.sh
      - -
      -

      16.31.6. SEE ALSO

      +
      +
      +

      16.32.6. SEE ALSO

      cdist-type__consul_agent(7)

      consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

      - -
      -

      16.31.7. AUTHORS

      +
      +
      +

      16.32.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.31.8. COPYING

      +
      +
      +

      16.32.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -462,7 +470,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.32. cdist-type__consul_watch_keyprefix(7)
      • +
    • 16.33. cdist-type__consul_watch_keyprefix(7)
    • - + View page source @@ -369,28 +377,28 @@
      -
      -

      16.32. cdist-type__consul_watch_keyprefix(7)

      -
      -

      16.32.1. NAME

      +
      +

      16.33. cdist-type__consul_watch_keyprefix(7)

      +
      +

      16.33.1. NAME

      cdist-type__consul_watch_keyprefix - Manages consul keyprefix watches

      -
      -
      -

      16.32.2. DESCRIPTION

      +
      +
      +

      16.33.2. DESCRIPTION

      Generate and deploy watch definitions of type 'keyprefix' for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

      - -
      -

      16.32.3. REQUIRED PARAMETERS

      +
      +
      +

      16.33.3. REQUIRED PARAMETERS

      handler

      the handler to invoke when the data view updates

      prefix

      the prefix of keys to watch for changes

      - -
      -

      16.32.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.33.4. OPTIONAL PARAMETERS

      datacenter

      can be provided to override the agent's default datacenter

      @@ -399,61 +407,61 @@ See -

      16.32.5. EXAMPLES

      +
      +
      +

      16.33.5. EXAMPLES

      __consul_watch_keyprefix some-id \
    --prefix foo/ \
    --handler /usr/bin/my-prefix-handler.sh
      - -
      -

      16.32.6. SEE ALSO

      +
      +
      +

      16.33.6. SEE ALSO

      cdist-type__consul_agent(7)

      consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

      - -
      -

      16.32.7. AUTHORS

      +
      +
      +

      16.33.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.32.8. COPYING

      +
      +
      +

      16.33.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -462,7 +470,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.33. cdist-type__consul_watch_nodes(7)
      • +
    • 16.34. cdist-type__consul_watch_nodes(7)
    • - + View page source @@ -369,26 +377,26 @@
      -
      -

      16.33. cdist-type__consul_watch_nodes(7)

      -
      -

      16.33.1. NAME

      +
      +

      16.34. cdist-type__consul_watch_nodes(7)

      +
      +

      16.34.1. NAME

      cdist-type__consul_watch_nodes - Manages consul nodes watches

      -
      -
      -

      16.33.2. DESCRIPTION

      +
      +
      +

      16.34.2. DESCRIPTION

      Generate and deploy watch definitions of type 'nodes' for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

      - -
      -

      16.33.3. REQUIRED PARAMETERS

      +
      +
      +

      16.34.3. REQUIRED PARAMETERS

      handler

      the handler to invoke when the data view updates

      - -
      -

      16.33.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.34.4. OPTIONAL PARAMETERS

      datacenter

      can be provided to override the agent's default datacenter

      @@ -397,60 +405,60 @@ See -

      16.33.5. EXAMPLES

      +
      +
      +

      16.34.5. EXAMPLES

      __consul_watch_nodes some-id \
    --handler /usr/bin/my-key-handler.sh
      - -
      -

      16.33.6. SEE ALSO

      +
      +
      +

      16.34.6. SEE ALSO

      cdist-type__consul_agent(7)

      consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

      - -
      -

      16.33.7. AUTHORS

      +
      +
      +

      16.34.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.33.8. COPYING

      +
      +
      +

      16.34.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -459,7 +467,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.34. cdist-type__consul_watch_service(7)
      • +
    • 16.35. cdist-type__consul_watch_service(7)
    • - + View page source @@ -370,28 +378,28 @@
      -
      -

      16.34. cdist-type__consul_watch_service(7)

      -
      -

      16.34.1. NAME

      +
      +

      16.35. cdist-type__consul_watch_service(7)

      +
      +

      16.35.1. NAME

      cdist-type__consul_watch_service - Manages consul service watches

      -
      -
      -

      16.34.2. DESCRIPTION

      +
      +
      +

      16.35.2. DESCRIPTION

      Generate and deploy watch definitions of type 'service' for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

      - -
      -

      16.34.3. REQUIRED PARAMETERS

      +
      +
      +

      16.35.3. REQUIRED PARAMETERS

      handler

      the handler to invoke when the data view updates

      service

      the service to watch for changes

      - -
      -

      16.34.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.35.4. OPTIONAL PARAMETERS

      datacenter

      can be provided to override the agent's default datacenter

      @@ -402,16 +410,16 @@ See -

      16.34.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.35.5. BOOLEAN PARAMETERS

      passingonly

      specifies if only hosts passing all checks are displayed

      - -
      -

      16.34.6. EXAMPLES

      +
      +
      +

      16.35.6. EXAMPLES

      __consul_watch_service some-id \
    --service consul \
    --handler /usr/bin/my-handler.sh
@@ -428,53 +436,53 @@ __consul_watch_service some-id \
    --handler /usr/bin/my-handler.sh
      - -
      -

      16.34.7. SEE ALSO

      +
      +
      +

      16.35.7. SEE ALSO

      cdist-type__consul_agent(7)

      consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

      - -
      -

      16.34.8. AUTHORS

      +
      +
      +

      16.35.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.34.9. COPYING

      +
      +
      +

      16.35.9. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -483,7 +491,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.35. cdist-type__consul_watch_services(7)
      • +
    • 16.36. cdist-type__consul_watch_services(7)
    • - + View page source @@ -369,26 +377,26 @@
      -
      -

      16.35. cdist-type__consul_watch_services(7)

      -
      -

      16.35.1. NAME

      +
      +

      16.36. cdist-type__consul_watch_services(7)

      +
      +

      16.36.1. NAME

      cdist-type__consul_watch_services - Manages consul services watches

      -
      -
      -

      16.35.2. DESCRIPTION

      +
      +
      +

      16.36.2. DESCRIPTION

      Generate and deploy watch definitions of type 'services' for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

      - -
      -

      16.35.3. REQUIRED PARAMETERS

      +
      +
      +

      16.36.3. REQUIRED PARAMETERS

      handler

      the handler to invoke when the data view updates

      - -
      -

      16.35.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.36.4. OPTIONAL PARAMETERS

      datacenter

      can be provided to override the agent's default datacenter

      @@ -397,60 +405,60 @@ See -

      16.35.5. EXAMPLES

      +
      +
      +

      16.36.5. EXAMPLES

      __consul_watch_services some-id \
    --handler /usr/bin/my-key-handler.sh
      - -
      -

      16.35.6. SEE ALSO

      +
      +
      +

      16.36.6. SEE ALSO

      cdist-type__consul_agent(7)

      consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

      - -
      -

      16.35.7. AUTHORS

      +
      +
      +

      16.36.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.35.8. COPYING

      +
      +
      +

      16.36.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -459,7 +467,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.36. cdist-type__cron(7)
      • +
    • 16.37. cdist-type__cron(7)
    • - + View page source @@ -369,27 +377,27 @@
      -
      -

      16.36. cdist-type__cron(7)

      -
      -

      16.36.1. NAME

      +
      +

      16.37. cdist-type__cron(7)

      +
      +

      16.37.1. NAME

      cdist-type__cron - Installs and manages cron jobs

      -
      -
      -

      16.36.2. DESCRIPTION

      +
      +
      +

      16.37.2. DESCRIPTION

      This cdist type allows you to manage entries in a users crontab.

      - -
      -

      16.36.3. REQUIRED PARAMETERS

      +
      +
      +

      16.37.3. REQUIRED PARAMETERS

      user

      The user who's crontab is edited

      command

      The command to run.

      - -
      -

      16.36.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.37.4. OPTIONAL PARAMETERS

      NOTE: All time-related parameters (--minute, --hour, --day_of_month --month and --day_of_week) defaults to *, which means to execute it always. If you set --hour 0 to execute the cronjob only at midnight, it @@ -418,9 +426,9 @@ If given, the command will be added to crontab. Can for example be used to define variables like SHELL or MAILTO.

      - -
      -

      16.36.5. EXAMPLES

      +
      +
      +

      16.37.5. EXAMPLES

      # run Monday to Saturday at 23:15
 __cron some-id --user root --command "/path/to/script" \
    --hour 23 --minute 15 --day_of_week 1-6
@@ -437,52 +445,52 @@ __cron some-id --user root --raw_command --command "SHELL=
    --state present
      - -
      -

      16.36.6. SEE ALSO

      +
      +
      +

      16.37.6. SEE ALSO

      crontab(5)

      - -
      -

      16.36.7. AUTHORS

      +
      +
      +

      16.37.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.36.8. COPYING

      +
      +
      +

      16.37.8. COPYING

      Copyright (C) 2011-2013 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -491,7 +499,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.37. cdist-type__daemontools(7)
      • +
    • 16.38. cdist-type__daemontools(7)
    • - + View page source @@ -370,87 +378,87 @@
      -
      -

      16.37. cdist-type__daemontools(7)

      -
      -

      16.37.1. NAME

      +
      +

      16.38. cdist-type__daemontools(7)

      +
      +

      16.38.1. NAME

      cdist-type__daemontools - Install daemontools

      -
      -
      -

      16.37.2. DESCRIPTION

      +
      +
      +

      16.38.2. DESCRIPTION

      Install djb daemontools and (optionally) an init script.

      - -
      -

      16.37.3. REQUIRED PARAMETERS

      +
      +
      +

      16.38.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.37.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.38.4. OPTIONAL PARAMETERS

      from-package

      Package to install. Must be compatible with the original daemontools. Example: daemontools-encore. Default: daemontools.

      servicedir

      Directory to scan for services. Default: /service

      - -
      -

      16.37.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.38.5. BOOLEAN PARAMETERS

      install-init-script

      Add an init script and set it to start on boot.

      - -
      -

      16.37.6. EXAMPLES

      +
      +
      +

      16.38.6. EXAMPLES

      __daemontools --from-package daemontools-encore  # if you prefer
      - -
      -

      16.37.7. SEE ALSO

      +
      +
      +

      16.38.7. SEE ALSO

      cdist-type__daemontools_service(7)

      - -
      -

      16.37.8. AUTHORS

      +
      +
      +

      16.38.8. AUTHORS

      Kamila Součková <kamila--@--ksp.sk>

      - -
      -

      16.37.9. COPYING

      +
      +
      +

      16.38.9. COPYING

      Copyright (C) 2017 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -459,7 +467,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.38. cdist-type__daemontools_service(7)
      • +
    • 16.39. cdist-type__daemontools_service(7)
    • - + View page source @@ -370,24 +378,24 @@
      -
      -

      16.38. cdist-type__daemontools_service(7)

      -
      -

      16.38.1. NAME

      +
      +

      16.39. cdist-type__daemontools_service(7)

      +
      +

      16.39.1. NAME

      cdist-type__daemontools_service - Create a daemontools-compatible service dir.

      -
      -
      -

      16.38.2. DESCRIPTION

      +
      +
      +

      16.39.2. DESCRIPTION

      Create a directory structure compatible with daemontools-like service management.

      Note that svc must be present on the target system.

      The object ID will be used as the service name.

      - -
      -

      16.38.3. REQUIRED PARAMETERS

      +
      +
      +

      16.39.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.38.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.39.4. OPTIONAL PARAMETERS

      run

      Command to run. exec-ing and stderr redirection will be added. One of run, run-file must be specified.

      Example: my-program

      @@ -407,62 +415,62 @@
      servicedir

      Directory to install into. Default: /service

      - -
      -

      16.38.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.39.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.38.6. EXAMPLES

      +
      +
      +

      16.39.6. EXAMPLES

      require="__daemontools" __daemontools_service prometheus --run "setuidgid prometheus $GOBIN/prometheus $FLAGS"
      - -
      -

      16.38.7. SEE ALSO

      +
      +
      +

      16.39.7. SEE ALSO

      cdist-type__daemontools(7)

      - -
      -

      16.38.8. AUTHORS

      +
      +
      +

      16.39.8. AUTHORS

      Kamila Součková <kamila--@--ksp.sk>

      - -
      -

      16.38.9. COPYING

      +
      +
      +

      16.39.9. COPYING

      Copyright (C) 2017 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -471,7 +479,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.39. cdist-type__debconf_set_selections(7)
      • +
    • 16.40. cdist-type__debconf_set_selections(7)
    • - + View page source @@ -370,23 +378,23 @@
      -
      -

      16.39. cdist-type__debconf_set_selections(7)

      -
      -

      16.39.1. NAME

      +
      +

      16.40. cdist-type__debconf_set_selections(7)

      +
      +

      16.40.1. NAME

      cdist-type__debconf_set_selections - Setup debconf selections

      -
      -
      -

      16.39.2. DESCRIPTION

      +
      +
      +

      16.40.2. DESCRIPTION

      On Debian and alike systems debconf-set-selections(1) can be used to setup configuration parameters.

      - -
      -

      16.39.3. REQUIRED PARAMETERS

      +
      +
      +

      16.40.3. REQUIRED PARAMETERS

      cf. --line.

      - -
      -

      16.39.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.40.4. OPTIONAL PARAMETERS

      file

      Use the given filename as input for debconf-set-selections(1) If filename is -, read from stdin.

      @@ -398,13 +406,13 @@ This parameter can be used multiple times to set multiple options.

      deprecated --file is still accepted.)

      - -
      -

      16.39.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.40.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.39.6. EXAMPLES

      +
      +
      +

      16.40.6. EXAMPLES

      # Setup gitolite's gituser
 __debconf_set_selections nslcd --line 'gitolite gitolite/gituser string git'
 
@@ -413,58 +421,58 @@ __debconf_set_selections nslcd --line 'gitolite gitolite/gi
 __debconf_set_selections nslcd --line "$(cat "${__files:?}/preseed/nslcd.debconf")"
      - -
      -

      16.39.7. SEE ALSO

      +
      +
      +

      16.40.7. SEE ALSO

      • cdist-type__update_alternatives(7)

      • debconf-set-selections(1)

      - -
      -

      16.39.8. AUTHORS

      +
      +
      +

      16.40.8. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>
      Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>
      - -
      -

      16.39.9. COPYING

      +
      +
      +

      16.40.9. COPYING

      Copyright (C) 2011-2014 Nico Schottelius, 2021 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -473,7 +481,6 @@ the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.40. cdist-type__directory(7)
      • +
    • 16.41. cdist-type__directory(7)
    • - + View page source @@ -370,22 +378,22 @@
      -
      -

      16.40. cdist-type__directory(7)

      -
      -

      16.40.1. NAME

      +
      +

      16.41. cdist-type__directory(7)

      +
      +

      16.41.1. NAME

      cdist-type__directory - Manage a directory

      -
      -
      -

      16.40.2. DESCRIPTION

      +
      +
      +

      16.41.2. DESCRIPTION

      This cdist type allows you to create or remove directories on the target.

      - -
      -

      16.40.3. REQUIRED PARAMETERS

      +
      +
      +

      16.41.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.40.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.41.4. OPTIONAL PARAMETERS

      state

      'present', 'absent', 'exists' or 'pre-exists', defaults to 'present' where:

      @@ -408,9 +416,9 @@ create or modify it.

      owner

      User to chown to.

      - -
      -

      16.40.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.41.5. BOOLEAN PARAMETERS

      parents

      Whether to create parents as well (mkdir -p behaviour). Warning: all intermediate directory permissions default @@ -421,9 +429,9 @@ to whatever mkdir -p does.

      This does not influence the behaviour of chmod.

      - -
      -

      16.40.6. MESSAGES

      +
      +
      +

      16.41.6. MESSAGES

      chgrp <group>

      Changed group membership

      @@ -438,9 +446,9 @@ This does not influence the behaviour of chmod.

      remove non directory

      Something other than a directory with the same name exists and was removed prior to create.

      - -
      -

      16.40.7. EXAMPLES

      +
      +
      +

      16.41.7. EXAMPLES

      # A silly example
 __directory /tmp/foobar
 
@@ -464,48 +472,48 @@ __directory /home/services/kvm --recursive --parents \
     --owner root --group root --mode 0755 --state present
      - -
      -

      16.40.8. AUTHORS

      +
      +
      +

      16.41.8. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.40.9. COPYING

      +
      +
      +

      16.41.9. COPYING

      Copyright (C) 2011 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -514,7 +522,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.41. cdist-type__docker(7)
      • +
    • 16.42. cdist-type__docker(7)
    • - + View page source @@ -369,22 +377,22 @@
      -
      -

      16.41. cdist-type__docker(7)

      -
      -

      16.41.1. NAME

      +
      +

      16.42. cdist-type__docker(7)

      +
      +

      16.42.1. NAME

      cdist-type__docker - install Docker CE

      -
      -
      -

      16.41.2. DESCRIPTION

      +
      +
      +

      16.42.2. DESCRIPTION

      Installs latest Docker Community Edition package.

      - -
      -

      16.41.3. REQUIRED PARAMETERS

      +
      +
      +

      16.42.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.41.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.42.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      @@ -392,13 +400,13 @@ meaning the version the package manager will install by default.

      - -
      -

      16.41.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.42.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.41.6. EXAMPLES

      +
      +
      +

      16.42.6. EXAMPLES

      # Install docker
 __docker
 
@@ -409,46 +417,46 @@ __docker --state absent
 __docker --state present --version 18.03.0.ce
      - -
      -

      16.41.7. AUTHORS

      +
      +
      +

      16.42.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.41.8. COPYING

      +
      +
      +

      16.42.8. COPYING

      Copyright (C) 2016 Steven Armstrong. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

      - - +
      +
    - @@ -457,7 +465,6 @@ granted under the terms of the GNU General Public License version 3 (GPLv3).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.42. cdist-type__docker_compose(7)
      • +
    • 16.43. cdist-type__docker_compose(7)
    • - + View page source @@ -369,37 +377,37 @@
      -
      -

      16.42. cdist-type__docker_compose(7)

      -
      -

      16.42.1. NAME

      +
      +

      16.43. cdist-type__docker_compose(7)

      +
      +

      16.43.1. NAME

      cdist-type__docker_compose - install docker-compose

      -
      -
      -

      16.42.2. DESCRIPTION

      +
      +
      +

      16.43.2. DESCRIPTION

      Installs docker-compose package. State 'absent' will not remove docker binary itself, only docker-compose binary will be removed

      - -
      -

      16.42.3. REQUIRED PARAMETERS

      +
      +
      +

      16.43.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.42.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.43.4. OPTIONAL PARAMETERS

      version

      Define docker_compose version, defaults to "1.9.0"

      state

      'present' or 'absent', defaults to 'present'

      - -
      -

      16.42.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.43.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.42.6. EXAMPLES

      +
      +
      +

      16.43.6. EXAMPLES

      # Install docker-compose
 __docker_compose
 
@@ -410,46 +418,46 @@ __docker_compose --version 1.9.0-rc4
 __docker_compose --state absent
      - -
      -

      16.42.7. AUTHORS

      +
      +
      +

      16.43.7. AUTHORS

      Dominique Roux <dominique.roux--@--ungleich.ch>

      - -
      -

      16.42.8. COPYING

      +
      +
      +

      16.43.8. COPYING

      Copyright (C) 2016 Dominique Roux. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

      - - +
      +
    - @@ -458,7 +466,6 @@ granted under the terms of the GNU General Public License version 3 or later (GP - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.43. cdist-type__docker_config(7)
      • +
    • 16.44. cdist-type__docker_config(7)
    • - + View page source @@ -368,18 +376,18 @@
      -
      -

      16.43. cdist-type__docker_config(7)

      -
      -

      16.43.1. NAME

      +
      +

      16.44. cdist-type__docker_config(7)

      +
      +

      16.44.1. NAME

      cdist-type__docker_config - Manage Docker configs

      -
      -
      -

      16.43.2. DESCRIPTION

      +
      +
      +

      16.44.2. DESCRIPTION

      This type manages Docker configs.

      - -
      -

      16.43.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.44.3. OPTIONAL PARAMETERS

      source

      Path to the source file. If it is '-' (dash), read standard input.

      @@ -392,61 +400,61 @@
      - -
      -

      16.43.4. CAVEATS

      +
      +
      +

      16.44.4. CAVEATS

      Since Docker configs cannot be updated once created, this type tries removing and recreating the config if it changes. If the config is used by a service at the time of removing, then this type will fail.

      - -
      -

      16.43.5. EXAMPLES

      +
      +
      +

      16.44.5. EXAMPLES

      # Creates "foo" config from "bar" source file
 __docker_config foo --source bar
      - -
      -

      16.43.6. AUTHORS

      +
      +
      +

      16.44.6. AUTHORS

      Ľubomír Kučera <lubomir.kucera.jr at gmail.com>

      - -
      -

      16.43.7. COPYING

      +
      +
      +

      16.44.7. COPYING

      Copyright (C) 2018 Ľubomír Kučera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.44. cdist-type__docker_secret(7)
      • +
    • 16.45. cdist-type__docker_secret(7)
    • - + View page source @@ -368,18 +376,18 @@
      -
      -

      16.44. cdist-type__docker_secret(7)

      -
      -

      16.44.1. NAME

      +
      +

      16.45. cdist-type__docker_secret(7)

      +
      +

      16.45.1. NAME

      cdist-type__docker_secret - Manage Docker secrets

      -
      -
      -

      16.44.2. DESCRIPTION

      +
      +
      +

      16.45.2. DESCRIPTION

      This type manages Docker secrets.

      - -
      -

      16.44.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.45.3. OPTIONAL PARAMETERS

      source

      Path to the source file. If it is '-' (dash), read standard input.

      @@ -392,60 +400,60 @@
      - -
      -

      16.44.4. CAVEATS

      +
      +
      +

      16.45.4. CAVEATS

      Since Docker secrets cannot be updated once created, this type takes no action if the specified secret already exists.

      - -
      -

      16.44.5. EXAMPLES

      +
      +
      +

      16.45.5. EXAMPLES

      # Creates "foo" secret from "bar" source file
 __docker_secret foo --source bar
      - -
      -

      16.44.6. AUTHORS

      +
      +
      +

      16.45.6. AUTHORS

      Ľubomír Kučera <lubomir.kucera.jr at gmail.com>

      - -
      -

      16.44.7. COPYING

      +
      +
      +

      16.45.7. COPYING

      Copyright (C) 2018 Ľubomír Kučera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -454,7 +462,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.45. cdist-type__docker_stack(7)
      • +
    • 16.46. cdist-type__docker_stack(7)
    • - + View page source @@ -367,14 +375,14 @@
      -
      -

      16.45. cdist-type__docker_stack(7)

      -
      -

      16.45.1. NAME

      +
      +

      16.46. cdist-type__docker_stack(7)

      +
      +

      16.46.1. NAME

      cdist-type__docker_stack - Manage Docker stacks

      -
      -
      -

      16.45.2. DESCRIPTION

      +
      +
      +

      16.46.2. DESCRIPTION

      This type manages service stacks.

      Note

      @@ -383,9 +391,9 @@ However, it does not mean this type is not idempotent. If Docker does not detect changes, the existing stack will not be updated.

      - -
      -

      16.45.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.46.3. OPTIONAL PARAMETERS

      compose-file

      Path to the compose file. If it is '-' (dash), read standard input.

      @@ -398,55 +406,55 @@ detect changes, the existing stack will not be updated.

      - -
      -

      16.45.4. EXAMPLES

      +
      +
      +

      16.46.4. EXAMPLES

      # Deploys 'foo' stack defined in 'docker-compose.yml' compose file
 __docker_stack foo --compose-file docker-compose.yml
      - -
      -

      16.45.5. AUTHORS

      +
      +
      +

      16.46.5. AUTHORS

      Ľubomír Kučera <lubomir.kucera.jr at gmail.com>

      - -
      -

      16.45.6. COPYING

      +
      +
      +

      16.46.6. COPYING

      Copyright (C) 2018 Ľubomír Kučera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.46. cdist-type__docker_swarm(7)
      • +
    • 16.47. cdist-type__docker_swarm(7)
    • - + View page source @@ -367,19 +375,19 @@
      -
      -

      16.46. cdist-type__docker_swarm(7)

      -
      -

      16.46.1. NAME

      +
      +

      16.47. cdist-type__docker_swarm(7)

      +
      +

      16.47.1. NAME

      cdist-type__docker_swarm - Manage Swarm

      -
      -
      -

      16.46.2. DESCRIPTION

      +
      +
      +

      16.47.2. DESCRIPTION

      This type can initialize Docker swarm mode. For more information about swarm mode, see Swarm mode overview.

      - -
      -

      16.46.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.47.3. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present' where:

      @@ -390,9 +398,9 @@ mode, see -

      16.46.4. EXAMPLES

      +
      +
      +

      16.47.4. EXAMPLES

      # Initializes a swarm
 __docker_swarm
 
@@ -400,48 +408,48 @@ __docker_swarm
 __docker_swarm --state absent
      - -
      -

      16.46.5. AUTHORS

      +
      +
      +

      16.47.5. AUTHORS

      Ľubomír Kučera <lubomir.kucera.jr at gmail.com>

      - -
      -

      16.46.6. COPYING

      +
      +
      +

      16.47.6. COPYING

      Copyright (C) 2018 Ľubomír Kučera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -450,7 +458,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.47. cdist-type__dog_vdi(7)
      • +
    • 16.48. cdist-type__dog_vdi(7)
    • - + View page source @@ -368,19 +376,19 @@
      -
      -

      16.47. cdist-type__dog_vdi(7)

      -
      -

      16.47.1. NAME

      +
      +

      16.48. cdist-type__dog_vdi(7)

      +
      +

      16.48.1. NAME

      cdist-type__dog_vdi - Manage Sheepdog VM images

      -
      -
      -

      16.47.2. DESCRIPTION

      +
      +
      +

      16.48.2. DESCRIPTION

      The dog program is used to create images for sheepdog to be used in qemu.

      - -
      -

      16.47.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.48.3. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      @@ -388,9 +396,9 @@ to be used in qemu.

      Required if state is "present".

      - -
      -

      16.47.4. EXAMPLES

      +
      +
      +

      16.48.4. EXAMPLES

      # Create a 50G size image
 __dog_vdi nico-privat.sky.ungleich.ch --size 50G
 
@@ -404,52 +412,52 @@ __dog_vdi nico-privat.sky.ungleich.ch --state absent
 __dog_vdi nico-privat.sky.ungleich.ch --size 50G --state absent
      - -
      -

      16.47.5. SEE ALSO

      +
      +
      +

      16.48.5. SEE ALSO

      qemu(1), dog(8)

      - -
      -

      16.47.6. AUTHORS

      +
      +
      +

      16.48.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.47.7. COPYING

      +
      +
      +

      16.48.7. COPYING

      Copyright (C) 2014 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -458,7 +466,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.48. cdist-type__dot_file(7)
      • +
    • 16.49. cdist-type__dot_file(7)
    • - + View page source @@ -369,29 +377,29 @@
      -
      -

      16.48. cdist-type__dot_file(7)

      -
      -

      16.48.1. NAME

      +
      +

      16.49. cdist-type__dot_file(7)

      +
      +

      16.49.1. NAME

      cdist-type__dot_file - install file under user's home directory

      -
      -
      -

      16.48.2. DESCRIPTION

      +
      +
      +

      16.49.2. DESCRIPTION

      This type installs a file (=__object_id) under user's home directory, providing a way to install per-user configuration files. File owner and group is deduced from user, for who file is installed.

      Unlike regular __file type, you do not need make any assumptions, where user's home directory is.

      - -
      -

      16.48.3. REQUIRED PARAMETERS

      +
      +
      +

      16.49.3. REQUIRED PARAMETERS

      user

      User, for who file is installed

      - -
      -

      16.48.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.49.4. OPTIONAL PARAMETERS

      dirmode

      forwarded to __directory type as mode

      @@ -402,14 +410,14 @@ where user's home directory is.

      source

      forwarded to __file type

      - -
      -

      16.48.5. MESSAGES

      +
      +
      +

      16.49.5. MESSAGES

      This type inherits all messages from file type, and do not add any new.

      - -
      -

      16.48.6. EXAMPLES

      +
      +
      +

      16.49.6. EXAMPLES

      # Install .forward file for user 'alice'. Since state is 'present',
 # user is not meant to edit this file, all changes will be overridden.
 # It is good idea to put warning about it in file itself.
@@ -424,47 +432,47 @@ __dot_file .muttrc --user bob --source ""$__files/xmonad.hs"
      - -
      -

      16.48.7. SEE ALSO

      +
      +
      +

      16.49.7. SEE ALSO

      cdist-type__file(7)

      - -
      -

      16.48.8. COPYING

      +
      +
      +

      16.49.8. COPYING

      Copyright (C) 2015 Dmitry Bogatov. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

      - - +
      +
    - @@ -473,7 +481,6 @@ under the terms of the GNU General Public License version 3 or later - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.49. cdist-type__download(7)
      • +
    • 16.50. cdist-type__download(7)
    • - + View page source @@ -368,14 +376,14 @@
      -
      -

      16.49. cdist-type__download(7)

      -
      -

      16.49.1. NAME

      +
      +

      16.50. cdist-type__download(7)

      +
      +

      16.50.1. NAME

      cdist-type__download - Download a file

      -
      -
      -

      16.49.2. DESCRIPTION

      +
      +
      +

      16.50.2. DESCRIPTION

      By default type will try to use curl, fetch or wget. If download happens in target (see --download) then type will fallback to (and install) wget.

      @@ -383,16 +391,16 @@ fallback to (and install) {http,https,ftp}_proxy etc can be used on cdist execution (http_proxy=foo cdist config ...).

      To change downloaded file's owner, group or permissions, use require='__download/path/to/file' __file ....

      - -
      -

      16.49.3. REQUIRED PARAMETERS

      +
      +
      +

      16.50.3. REQUIRED PARAMETERS

      url

      File's URL.

      - -
      -

      16.49.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.50.4. OPTIONAL PARAMETERS

      destination

      Downloaded file's destination in target. If unset, $__object_id is used.

      @@ -426,9 +434,9 @@ For example: md5sum
      onchange

      Execute this command after download.

      - -
      -

      16.49.5. EXAMPLES

      +
      +
      +

      16.50.5. EXAMPLES

      __directory /opt/cpma
 
 require='__directory/opt/cpma' \
@@ -443,48 +451,48 @@ For example: md5sum
         --destination /opt/cpma/server
      - -
      -

      16.49.6. AUTHORS

      +
      +
      +

      16.50.6. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.49.7. COPYING

      +
      +
      +

      16.50.7. COPYING

      Copyright (C) 2021 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -493,7 +501,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.50. cdist-type__dpkg_architecture(7)
      • +
    • 16.51. cdist-type__dpkg_architecture(7)
    • - + View page source @@ -371,15 +379,15 @@
      -
      -

      16.50. cdist-type__dpkg_architecture(7)

      -
      -

      16.50.1. NAME

      +
      +

      16.51. cdist-type__dpkg_architecture(7)

      +
      +

      16.51.1. NAME

      cdist-type__dpkg_architecture - Handles foreign architectures on debian-like systems managed by dpkg

      -
      -
      -

      16.50.2. DESCRIPTION

      +
      +
      +

      16.51.2. DESCRIPTION

      This type handles foreign architectures on systems managed by dpkg(1). The object id is the name of the architecture accepted by dpkg, which should be added or removed.

      @@ -390,29 +398,29 @@ make packages from the new architecture available.

      architecture on where the system was installed on. Before it, it will purge every package based on the "to be removed" architecture via apt to be able to remove the selected architecture.

      - -
      -

      16.50.3. REQUIRED PARAMETERS

      +
      +
      +

      16.51.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.50.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.51.4. OPTIONAL PARAMETERS

      state

      present or absent. Defaults to present.

      - -
      -

      16.50.5. MESSAGES

      +
      +
      +

      16.51.5. MESSAGES

      added

      Added the specified architecture

      removed

      Removed the specified architecture

      - -
      -

      16.50.6. ABORTS

      +
      +
      +

      16.51.6. ABORTS

      Aborts in the following cases:

      If dpkg(1) is not available. It will abort with a proper error message.

      @@ -420,9 +428,9 @@ message.

      upon it (returned by dpkg --print-architecture) and it should be removed.

      It will fail if it can not execute apt(8). It is assumed that it is already installed.

      - -
      -

      16.50.7. EXAMPLES

      +
      +
      +

      16.51.7. EXAMPLES

      # add i386 (32 bit) architecture
 __dpkg_architecture i386
 
@@ -430,9 +438,9 @@ __dpkg_architecture i386
 __dpkg_architecture i386 --state absent
      - -
      -

      16.50.8. SEE ALSO

      +
      +
      +

      16.51.8. SEE ALSO

      Multiarch on Debian systems

      How to setup multiarch on Debian

      dpkg(1) @@ -446,48 +454,48 @@ dpkg --print-architecture dpkg --print-foreign-architectures

      - -
      -

      16.50.9. AUTHORS

      +
    +
    +

    16.51.9. AUTHORS

    Matthias Stecher <matthiasstecher at gmx.de>

    - -
    -

    16.50.10. COPYING

    +
    +
    +

    16.51.10. COPYING

    Copyright (C) 2020 Matthias Stecher. You can redistribute it and/or modify it under the terms of the GNU General Public License as ublished by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

    - - +
    + - @@ -496,7 +504,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.51. cdist-type__file(7)
      • +
    • 16.52. cdist-type__file(7)
    • - + View page source @@ -369,14 +377,14 @@
      -
      -

      16.51. cdist-type__file(7)

      -
      -

      16.51.1. NAME

      +
      +

      16.52. cdist-type__file(7)

      +
      +

      16.52.1. NAME

      cdist-type__file - Manage files.

      -
      -
      -

      16.51.2. DESCRIPTION

      +
      +
      +

      16.52.2. DESCRIPTION

      This cdist type allows you to create files, remove files and set file attributes on the target.

      If the file already exists on the target, then if it is a:

      @@ -397,13 +405,13 @@ attributes on the target.

      the file would have been created otherwise (e.g. it is not present or not a regular file).

      In any case, make sure that the file attributes are as specified.

      - -
      -

      16.51.3. REQUIRED PARAMETERS

      +
      +
      +

      16.52.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.51.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.52.4. OPTIONAL PARAMETERS

      state

      'present', 'absent', 'exists' or 'pre-exists', defaults to 'present' where:

      @@ -431,9 +439,9 @@ If source is '-' (dash), take what was written to stdin as the file content.

      onchange

      The code to run if file is modified.

      - -
      -

      16.51.5. MESSAGES

      +
      +
      +

      16.52.5. MESSAGES

      chgrp <group>

      Changed group membership

      @@ -448,9 +456,9 @@ If source is '-' (dash), take what was written to stdin as the file content.

      upload

      File was uploaded

      - -
      -

      16.51.6. EXAMPLES

      +
      +
      +

      16.52.6. EXAMPLES

      # Create  /etc/cdist-configured as an empty file
 __file /etc/cdist-configured
 # The same thing
@@ -475,48 +483,48 @@ __file /tmp/whatever --owner root --group root --mode 644
 DONE
      - -
      -

      16.51.7. AUTHORS

      +
      +
      +

      16.52.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.51.8. COPYING

      +
      +
      +

      16.52.8. COPYING

      Copyright (C) 2011-2013 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -525,7 +533,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.52. cdist-type__filesystem(7)
      • +
    • 16.53. cdist-type__filesystem(7)
    • - + View page source @@ -370,29 +378,29 @@
      -
      -

      16.52. cdist-type__filesystem(7)

      -
      -

      16.52.1. NAME

      +
      +

      16.53. cdist-type__filesystem(7)

      +
      +

      16.53.1. NAME

      cdist-type__filesystem - Create Filesystems.

      -
      -
      -

      16.52.2. DESCRIPTION

      +
      +
      +

      16.53.2. DESCRIPTION

      This cdist type allows you to create filesystems on devices.

      If the device is mounted on target, it refuses to do anything.

      If the device has a filesystem other then the specified and/or the label is not correct, it only makes a new filesystem if you have specified --force option.

      - -
      -

      16.52.3. REQUIRED PARAMETERS

      +
      +
      +

      16.53.3. REQUIRED PARAMETERS

      fstype

      Filesystem type, for example 'ext3', 'btrfs' or 'xfs'.

      - -
      -

      16.52.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.53.4. OPTIONAL PARAMETERS

      device

      Blockdevice for filesystem, Defaults to object_id. On linux, it can be any lsblk accepted device notation.

      @@ -411,9 +419,9 @@ On linux, it can be any lsblk accepted device notation.

      mkfsoptions

      Additional options which are inserted to the mkfs.xxx call.

      - -
      -

      16.52.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.53.5. BOOLEAN PARAMETERS

      force

      Normally, this type does nothing if a filesystem is found on the target device. If you specify force, it's formatted @@ -421,16 +429,16 @@ if the filesystem type or label differs from parameters. Warning: This option can easily lead into data loss!

      - -
      -

      16.52.6. MESSAGES

      +
      +
      +

      16.53.6. MESSAGES

      filesystem <fstype> on <device> : <discoverd device> created

      Filesystem was created on <discoverd device>

      - -
      -

      16.52.7. EXAMPLES

      +
      +
      +

      16.53.7. EXAMPLES

      # Ensures that device /dev/sdb is formatted with xfs
 __filesystem /dev/sdb --fstype xfs --label Testdisk1
 # The same thing with btrfs and disk spezified by pci path to disk 1:0 on vmware
@@ -439,46 +447,46 @@ __filesystem dev_sdb --fstype btrfs --device /dev/disk/by-path/pci-0000:0b:00.0-
 __filesystem dev_sdb --fstype xfs --device /dev/mapper/360060e80432f560050202f22000023ff --label Testdisk3
      - -
      -

      16.52.8. AUTHORS

      +
      +
      +

      16.53.8. AUTHORS

      Daniel Heule <hda--@--sfs.biz>

      - -
      -

      16.52.9. COPYING

      +
      +
      +

      16.53.9. COPYING

      Copyright (C) 2016 Daniel Heule. Free use of this software is granted under the terms of the GNU General Public License version 3 or any later version (GPLv3+).

      - - +
      +
    - @@ -487,7 +495,6 @@ granted under the terms of the GNU General Public License version 3 or any later - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.53. cdist-type__firewalld_rule(7)
      • +
    • 16.54. cdist-type__firewalld_rule(7)
    • - + View page source @@ -369,19 +377,19 @@
      -
      -

      16.53. cdist-type__firewalld_rule(7)

      -
      -

      16.53.1. NAME

      +
      +

      16.54. cdist-type__firewalld_rule(7)

      +
      +

      16.54.1. NAME

      cdist-type__firewalld_rule - Configure firewalld rules

      -
      -
      -

      16.53.2. DESCRIPTION

      +
      +
      +

      16.54.2. DESCRIPTION

      This cdist type allows you to manage rules in firewalld using the direct way (i.e. no zone support).

      - -
      -

      16.53.3. REQUIRED PARAMETERS

      +
      +
      +

      16.54.3. REQUIRED PARAMETERS

      rule

      The rule to apply. Essentially an firewalld command line without firewalld in front of it.

      @@ -395,16 +403,16 @@ line without firewalld in front of it.

      priority

      The priority to use (0 is topmost). See firewall-cmd(1).

      - -
      -

      16.53.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.54.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      - -
      -

      16.53.5. EXAMPLES

      +
      +
      +

      16.54.5. EXAMPLES

      # Allow access from entrance.place4.ungleich.ch
 __firewalld_rule entrance \
     --protocol ipv4 \
@@ -430,52 +438,52 @@ __firewalld_rule vm-forward
     --state absent
      - -
      -

      16.53.6. SEE ALSO

      +
      +
      +

      16.54.6. SEE ALSO

      cdist-type__iptables_rule(7), firewalld(8)

      - -
      -

      16.53.7. AUTHORS

      +
      +
      +

      16.54.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.53.8. COPYING

      +
      +
      +

      16.54.8. COPYING

      Copyright (C) 2015 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -484,7 +492,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.54. cdist-type__firewalld_start(7)
      • +
    • 16.55. cdist-type__firewalld_start(7)
    • - + View page source @@ -369,31 +377,31 @@
      -
      -

      16.54. cdist-type__firewalld_start(7)

      -
      -

      16.54.1. NAME

      +
      +

      16.55. cdist-type__firewalld_start(7)

      +
      +

      16.55.1. NAME

      cdist-type__firewalld_start - start and enable firewalld

      -
      -
      -

      16.54.2. DESCRIPTION

      +
      +
      +

      16.55.2. DESCRIPTION

      This cdist type allows you to start and enable firewalld.

      - -
      -

      16.54.3. REQUIRED PARAMETERS

      +
      +
      +

      16.55.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.54.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.55.4. OPTIONAL PARAMETERS

      startstate

      'present' or 'absent', start/stop firewalld. Default is 'present'.

      bootstate

      'present' or 'absent', enable/disable firewalld on boot. Default is 'present'.

      - -
      -

      16.54.5. EXAMPLES

      +
      +
      +

      16.55.5. EXAMPLES

      # start and enable firewalld
 __firewalld_start
 
@@ -401,52 +409,52 @@ __firewalld_start
 __firewalld_start --startstate present --bootstate absent
      - -
      -

      16.54.6. SEE ALSO

      +
      +
      +

      16.55.6. SEE ALSO

      firewalld(8)

      - -
      -

      16.54.7. AUTHORS

      +
      +
      +

      16.55.7. AUTHORS

      Darko Poljak <darko.poljak--@--ungleich.ch>

      - -
      -

      16.54.8. COPYING

      +
      +
      +

      16.55.8. COPYING

      Copyright (C) 2016 Darko Poljak. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.55. cdist-type__git(7)
      • +
    • 16.56. cdist-type__git(7)
    • - + View page source @@ -368,25 +376,25 @@
      -
      -

      16.55. cdist-type__git(7)

      -
      -

      16.55.1. NAME

      +
      +

      16.56. cdist-type__git(7)

      +
      +

      16.56.1. NAME

      cdist-type__git - Get and or keep git repositories up-to-date

      -
      -
      -

      16.55.2. DESCRIPTION

      +
      +
      +

      16.56.2. DESCRIPTION

      This cdist type allows you to clone git repositories

      - -
      -

      16.55.3. REQUIRED PARAMETERS

      +
      +
      +

      16.56.3. REQUIRED PARAMETERS

      source

      Specifies the git remote to clone from

      - -
      -

      16.55.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.56.4. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      @@ -404,57 +412,57 @@ Default branch is "master"

      shallow

      Sets --depth=1 and --shallow-submodules for cloning repositories with big history.

      - -
      -

      16.55.5. EXAMPLES

      +
      +
      +

      16.56.5. EXAMPLES

      __git /home/services/dokuwiki --source git://github.com/splitbrain/dokuwiki.git
 
 # Checkout cdist, stay on branch 2.1
 __git /home/nico/cdist --source git@code.ungleich.ch:ungleich-public/cdist.git --branch 2.1
      - -
      -

      16.55.6. AUTHORS

      +
      +
      +

      16.56.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.55.7. COPYING

      +
      +
      +

      16.56.7. COPYING

      Copyright (C) 2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -463,7 +471,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.56. cdist-type__go_get(7)
      • +
    • 16.57. cdist-type__go_get(7)
    • - + View page source @@ -368,76 +376,76 @@
      -
      -

      16.56. cdist-type__go_get(7)

      -
      -

      16.56.1. NAME

      +
      +

      16.57. cdist-type__go_get(7)

      +
      +

      16.57.1. NAME

      cdist-type__go_get - Install go packages with go get

      -
      -
      -

      16.56.2. DESCRIPTION

      +
      +
      +

      16.57.2. DESCRIPTION

      This cdist type allows you to install golang packages with go get. A sufficiently recent version of go must be present on the system.

      The object ID is the go package to be installed.

      - -
      -

      16.56.3. REQUIRED PARAMETERS

      +
      +
      +

      16.57.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.56.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.57.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.56.5. EXAMPLES

      +
      +
      +

      16.57.5. EXAMPLES

      __go_get github.com/prometheus/prometheus/cmd/...
 
 # usually you'd need to require golang from somewhere:
 require="__golang_from_vendor" __go_get github.com/prometheus/prometheus/cmd/...
      - -
      -

      16.56.6. AUTHORS

      +
      +
      +

      16.57.6. AUTHORS

      Kamila Součková <kamila@ksp.sk>

      - -
      -

      16.56.7. COPYING

      +
      +
      +

      16.57.7. COPYING

      Copyright (C) 2017 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -446,7 +454,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.57. cdist-type__golang_from_vendor(7)
      • +
    • 16.58. cdist-type__golang_from_vendor(7)
    • - + View page source @@ -368,76 +376,76 @@
      -
      -

      16.57. cdist-type__golang_from_vendor(7)

      -
      -

      16.57.1. NAME

      +
      +

      16.58. cdist-type__golang_from_vendor(7)

      +
      +

      16.58.1. NAME

      cdist-type__golang_from_vendor - Install any version of golang from golang.org

      -
      -
      -

      16.57.2. DESCRIPTION

      +
      +
      +

      16.58.2. DESCRIPTION

      This cdist type allows you to install golang from archives provided by https://golang.org/dl/.

      See https://golang.org/dl/ for the list of supported versions, operating systems and architectures.

      This is a singleton type.

      - -
      -

      16.57.3. REQUIRED PARAMETERS

      +
      +
      +

      16.58.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.57.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.58.4. OPTIONAL PARAMETERS

      version

      The golang version to install, defaults to 1.8.1

      - -
      -

      16.57.5. EXAMPLES

      +
      +
      +

      16.58.5. EXAMPLES

      __golang_from_vendor --version 1.8.1
      - -
      -

      16.57.6. AUTHORS

      +
      +
      +

      16.58.6. AUTHORS

      Kamila Součková <kamila@ksp.sk>

      - -
      -

      16.57.7. COPYING

      +
      +
      +

      16.58.7. COPYING

      Copyright (C) 2017 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -446,7 +454,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.58. cdist-type__grafana_dashboard(7)
      • +
    • 16.59. cdist-type__grafana_dashboard(7)
    • - + View page source @@ -368,72 +376,72 @@
      -
      -

      16.58. cdist-type__grafana_dashboard(7)

      -
      -

      16.58.1. NAME

      +
      +

      16.59. cdist-type__grafana_dashboard(7)

      +
      +

      16.59.1. NAME

      cdist-type__grafana_dashboard - Install Grafana (https://grafana.com)

      -
      -
      -

      16.58.2. DESCRIPTION

      +
      +
      +

      16.59.2. DESCRIPTION

      This cdist type adds the Grafana repository, installs the grafana package, and sets the server to start on boot.

      This is a singleton type.

      - -
      -

      16.58.3. REQUIRED PARAMETERS

      +
      +
      +

      16.59.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.58.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.59.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.58.5. EXAMPLES

      +
      +
      +

      16.59.5. EXAMPLES

      __grafana_dashboard
      - -
      -

      16.58.6. AUTHORS

      +
      +
      +

      16.59.6. AUTHORS

      Kamila Součková <kamila@ksp.sk>

      - -
      -

      16.58.7. COPYING

      +
      +
      +

      16.59.7. COPYING

      Copyright (C) 2017 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -442,7 +450,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.59. cdist-type__group(7)
      • +
    • 16.60. cdist-type__group(7)
    • - + View page source @@ -370,22 +378,22 @@
      -
      -

      16.59. cdist-type__group(7)

      -
      -

      16.59.1. NAME

      +
      +

      16.60. cdist-type__group(7)

      +
      +

      16.60.1. NAME

      cdist-type__group - Manage groups

      -
      -
      -

      16.59.2. DESCRIPTION

      +
      +
      +

      16.60.2. DESCRIPTION

      This cdist type allows you to create or modify groups on the target.

      - -
      -

      16.59.3. REQUIRED PARAMETERS

      +
      +
      +

      16.60.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.59.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.60.4. OPTIONAL PARAMETERS

      state

      absent or present, defaults to present

      @@ -394,16 +402,16 @@
      password

      see above

      - -
      -

      16.59.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.60.5. BOOLEAN PARAMETERS

      system

      see groupadd(8), apply only on group creation

      - -
      -

      16.59.6. MESSAGES

      +
      +
      +

      16.60.6. MESSAGES

      mod

      group is modified

      @@ -416,9 +424,9 @@
      set <property> <new_value>

      set property to new value, property was not set before

      - -
      -

      16.59.7. EXAMPLES

      +
      +
      +

      16.60.7. EXAMPLES

      # Create a group 'foobar' with operating system default settings
 __group foobar
 
@@ -435,48 +443,48 @@ __group foobar --gid 1234
 __group foobar --gid 1234 --password 'crypted-password-string'
      - -
      -

      16.59.8. AUTHORS

      +
      +
      +

      16.60.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.59.9. COPYING

      +
      +
      +

      16.60.9. COPYING

      Copyright (C) 2011-2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -485,7 +493,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.60. cdist-type__hostname(7)
      • +
    • 16.61. cdist-type__hostname(7)
    • - + View page source @@ -369,39 +377,39 @@
      -
      -

      16.60. cdist-type__hostname(7)

      -
      -

      16.60.1. NAME

      +
      +

      16.61. cdist-type__hostname(7)

      +
      +

      16.61.1. NAME

      cdist-type__hostname - Set the hostname

      -
      -
      -

      16.60.2. DESCRIPTION

      +
      +
      +

      16.61.2. DESCRIPTION

      Sets the hostname on various operating systems.

      Tip: For advice on choosing a hostname, see RFC 1178.

      - -
      -

      16.60.3. REQUIRED PARAMETERS

      +
      +
      +

      16.61.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.60.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.61.4. OPTIONAL PARAMETERS

      name

      The hostname to set. Defaults to the first segment of __target_host (${__target_host%%.*})

      - -
      -

      16.60.5. MESSAGES

      +
      +
      +

      16.61.5. MESSAGES

      changed

      Changed the hostname

      - -
      -

      16.60.6. EXAMPLES

      +
      +
      +

      16.61.6. EXAMPLES

      # take hostname from __target_host
 __hostname
 
@@ -409,48 +417,48 @@ __hostname
 __hostname --name some-static-hostname
      - -
      -

      16.60.7. AUTHORS

      +
      +
      +

      16.61.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.60.8. COPYING

      +
      +
      +

      16.61.8. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -459,7 +467,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.61. cdist-type__hosts(7)
      • +
    • 16.62. cdist-type__hosts(7)
    • - + View page source @@ -368,18 +376,18 @@
      -
      -

      16.61. cdist-type__hosts(7)

      -
      -

      16.61.1. NAME

      +
      +

      16.62. cdist-type__hosts(7)

      +
      +

      16.62.1. NAME

      cdist-type__hosts - manage entries in /etc/hosts

      -
      -
      -

      16.61.2. DESCRIPTION

      +
      +
      +

      16.62.2. DESCRIPTION

      Add or remove entries from /etc/hosts file.

      - -
      -

      16.61.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.62.3. OPTIONAL PARAMETERS

      state

      If state is present, make object_id resolve to ip. If state is absent, object_id will no longer resolve via @@ -394,9 +402,9 @@ state is present

      - -
      -

      16.61.4. EXAMPLES

      +
      +
      +

      16.62.4. EXAMPLES

      # Now `funny' resolves to 192.168.1.76,
 __hosts funny --ip 192.168.1.76
 # and `happy' no longer resolve via /etc/hosts if it was
@@ -406,55 +414,55 @@ __hosts happy --state absent
 __hosts srv1.example.com --ip 192.168.0.42 --alias srv1
      - -
      -

      16.61.5. SEE ALSO

      +
      +
      +

      16.62.5. SEE ALSO

      hosts(5)

      - -
      -

      16.61.6. AUTHORS

      +
      +
      +

      16.62.6. AUTHORS

      Dmitry Bogatov <KAction@gnu.org>
      Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>
      - -
      -

      16.61.7. COPYING

      +
      +
      +

      16.62.7. COPYING

      Copyright (C) 2015-2016 Dmitry Bogatov, 2019 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -463,7 +471,6 @@ the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.62. cdist-type__hwclock(7)
      • +
    • 16.63. cdist-type__hwclock(7)
    • - + View page source @@ -370,19 +378,19 @@
      -
      -

      16.62. cdist-type__hwclock(7)

      -
      -

      16.62.1. NAME

      +
      +

      16.63. cdist-type__hwclock(7)

      +
      +

      16.63.1. NAME

      cdist-type__hwclock - Manage the hardware real time clock.

      -
      -
      -

      16.62.2. DESCRIPTION

      +
      +
      +

      16.63.2. DESCRIPTION

      This type can be used to control how the hardware clock is used by the operating system.

      - -
      -

      16.62.3. REQUIRED PARAMETERS

      +
      +
      +

      16.63.3. REQUIRED PARAMETERS

      mode

      What mode the hardware clock is in.

      Acceptable values:

      @@ -395,67 +403,67 @@ Windows.)

      - -
      -

      16.62.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.63.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.62.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.63.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.62.6. EXAMPLES

      +
      +
      +

      16.63.6. EXAMPLES

      # Make the operating system treat the time read from the hwclock as UTC.
 __hwclock --mode UTC
      - -
      -

      16.62.7. SEE ALSO

      +
      +
      +

      16.63.7. SEE ALSO

      hwclock(8)

      - -
      -

      16.62.8. AUTHORS

      +
      +
      +

      16.63.8. AUTHORS

      Dennis Camera <dennis.camera@ssrq-sds-fds.ch>

      - -
      -

      16.62.9. COPYING

      +
      +
      +

      16.63.9. COPYING

      Copyright (C) 2020 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -464,7 +472,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.63. cdist-type__install_bootloader_grub(7)
      • +
    • 16.64. cdist-type__install_bootloader_grub(7)
    • - + View page source @@ -368,78 +376,78 @@
      -
      -

      16.63. cdist-type__install_bootloader_grub(7)

      -
      -

      16.63.1. NAME

      +
      +

      16.64. cdist-type__install_bootloader_grub(7)

      +
      +

      16.64.1. NAME

      cdist-type__install_bootloader_grub - install grub2 bootloader on given disk

      -
      -
      -

      16.63.2. DESCRIPTION

      +
      +
      +

      16.64.2. DESCRIPTION

      This cdist type allows you to install grub2 bootloader on given disk.

      - -
      -

      16.63.3. REQUIRED PARAMETERS

      +
      +
      +

      16.64.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.63.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.64.4. OPTIONAL PARAMETERS

      device

      The device to install grub to. Defaults to object_id

      chroot

      where to chroot before running grub-install. Defaults to /target.

      - -
      -

      16.63.5. EXAMPLES

      +
      +
      +

      16.64.5. EXAMPLES

      __install_bootloader_grub /dev/sda
 
 __install_bootloader_grub /dev/sda --chroot /mnt/foobar
      - -
      -

      16.63.6. AUTHORS

      +
      +
      +

      16.64.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.63.7. COPYING

      +
      +
      +

      16.64.7. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -448,7 +456,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.64. cdist-type__install_chroot_mount(7)
      • +
    • 16.65. cdist-type__install_chroot_mount(7)
    • - + View page source @@ -368,71 +376,71 @@
      -
      -

      16.64. cdist-type__install_chroot_mount(7)

      -
      -

      16.64.1. NAME

      +
      +

      16.65. cdist-type__install_chroot_mount(7)

      +
      +

      16.65.1. NAME

      cdist-type__install_chroot_mount - mount a chroot with install command

      -
      -
      -

      16.64.2. DESCRIPTION

      +
      +
      +

      16.65.2. DESCRIPTION

      Mount and prepare a chroot for running commands within it.

      - -
      -

      16.64.3. REQUIRED PARAMETERS

      +
      +
      +

      16.65.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.64.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.65.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.64.5. EXAMPLES

      +
      +
      +

      16.65.5. EXAMPLES

      __install_chroot_mount /path/to/chroot
      - -
      -

      16.64.6. AUTHORS

      +
      +
      +

      16.65.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.64.7. COPYING

      +
      +
      +

      16.65.7. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -441,7 +449,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.65. cdist-type__install_chroot_umount(7)
      • +
    • 16.66. cdist-type__install_chroot_umount(7)
    • - + View page source @@ -369,75 +377,75 @@
      -
      -

      16.65. cdist-type__install_chroot_umount(7)

      -
      -

      16.65.1. NAME

      +
      +

      16.66. cdist-type__install_chroot_umount(7)

      +
      +

      16.66.1. NAME

      cdist-type__install_chroot_umount - unmount a chroot mounted by __install_chroot_mount

      -
      -
      -

      16.65.2. DESCRIPTION

      +
      +
      +

      16.66.2. DESCRIPTION

      Undo what __install_chroot_mount did.

      - -
      -

      16.65.3. REQUIRED PARAMETERS

      +
      +
      +

      16.66.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.65.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.66.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.65.5. EXAMPLES

      +
      +
      +

      16.66.5. EXAMPLES

      __install_chroot_umount /path/to/chroot
      - -
      -

      16.65.6. SEE ALSO

      +
      +
      +

      16.66.6. SEE ALSO

      cdist-type__install_chroot_mount(7)

      - -
      -

      16.65.7. AUTHORS

      +
      +
      +

      16.66.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.65.8. COPYING

      +
      +
      +

      16.66.8. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -446,7 +454,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.66. cdist-type__install_config(7)
      • +
    • 16.67. cdist-type__install_config(7)
    • - + View page source @@ -368,78 +376,78 @@
      -
      -

      16.66. cdist-type__install_config(7)

      -
      -

      16.66.1. NAME

      +
      +

      16.67. cdist-type__install_config(7)

      +
      +

      16.67.1. NAME

      cdist-type__install_config - run cdist config as part of the installation

      -
      -
      -

      16.66.2. DESCRIPTION

      +
      +
      +

      16.67.2. DESCRIPTION

      This cdist type allows you to run cdist config as part of the installation. It does this by using a custom __remote_{copy,exec} prefix which runs cdist config against the /target chroot on the remote host.

      - -
      -

      16.66.3. REQUIRED PARAMETERS

      +
      +
      +

      16.67.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.66.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.67.4. OPTIONAL PARAMETERS

      chroot

      where to chroot before running grub-install. Defaults to /target.

      - -
      -

      16.66.5. EXAMPLES

      +
      +
      +

      16.67.5. EXAMPLES

      __install_config
 
 __install_config --chroot /mnt/somewhere
      - -
      -

      16.66.6. AUTHORS

      +
      +
      +

      16.67.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.66.7. COPYING

      +
      +
      +

      16.67.7. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -448,7 +456,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.67. cdist-type__install_coreos(7)
      • +
    • 16.68. cdist-type__install_coreos(7)
    • - + View page source @@ -368,80 +376,80 @@
      -
      -

      16.67. cdist-type__install_coreos(7)

      -
      -

      16.67.1. NAME

      +
      +

      16.68. cdist-type__install_coreos(7)

      +
      +

      16.68.1. NAME

      cdist-type__install_coreos - Install CoreOS

      -
      -
      -

      16.67.2. DESCRIPTION

      +
      +
      +

      16.68.2. DESCRIPTION

      This type installs CoreOS to a given device using coreos-install, which is present in CoreOS ISO by default.

      - -
      -

      16.67.3. REQUIRED PARAMETERS

      +
      +
      +

      16.68.3. REQUIRED PARAMETERS

      device

      A device CoreOS will be installed to.

      - -
      -

      16.67.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.68.4. OPTIONAL PARAMETERS

      ignition

      Path to ignition config.

      - -
      -

      16.67.5. EXAMPLES

      +
      +
      +

      16.68.5. EXAMPLES

      __install_coreos \
     --device /dev/sda \
     --ignition ignition.json
      - -
      -

      16.67.6. AUTHORS

      +
      +
      +

      16.68.6. AUTHORS

      Ľubomír Kučera <lubomir.kucera.jr at gmail.com>

      - -
      -

      16.67.7. COPYING

      +
      +
      +

      16.68.7. COPYING

      Copyright (C) 2018 Ľubomír Kučera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -450,7 +458,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.68. cdist-type__install_directory(7)
      • +
    • 16.69. cdist-type__install_directory(7)
    • - + View page source @@ -370,22 +378,22 @@
      -
      -

      16.68. cdist-type__install_directory(7)

      -
      -

      16.68.1. NAME

      +
      +

      16.69. cdist-type__install_directory(7)

      +
      +

      16.69.1. NAME

      cdist-type__install_directory - Manage a directory with install command

      -
      -
      -

      16.68.2. DESCRIPTION

      +
      +
      +

      16.69.2. DESCRIPTION

      This cdist type allows you to create or remove directories on the target.

      - -
      -

      16.68.3. REQUIRED PARAMETERS

      +
      +
      +

      16.69.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.68.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.69.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      @@ -396,9 +404,9 @@
      owner

      User to chown to.

      - -
      -

      16.68.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.69.5. BOOLEAN PARAMETERS

      parents

      Whether to create parents as well (mkdir -p behaviour). Warning: all intermediate directory permissions default @@ -409,9 +417,9 @@ to whatever mkdir -p does.

      This does not influence the behaviour of chmod.

      - -
      -

      16.68.6. MESSAGES

      +
      +
      +

      16.69.6. MESSAGES

      chgrp <group>

      Changed group membership

      @@ -426,9 +434,9 @@ This does not influence the behaviour of chmod.

      remove non directory

      Something other than a directory with the same name exists and was removed prior to create.

      - -
      -

      16.68.7. EXAMPLES

      +
      +
      +

      16.69.7. EXAMPLES

      # A silly example
 __install_directory /tmp/foobar
 
@@ -452,48 +460,48 @@ __install_directory /home/services/kvm --recursive --parents \<
     --owner root --group root --mode 0755 --state present
      - -
      -

      16.68.8. AUTHORS

      +
      +
      +

      16.69.8. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.68.9. COPYING

      +
      +
      +

      16.69.9. COPYING

      Copyright (C) 2011 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -502,7 +510,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.69. cdist-type__install_file(7)
      • +
    • 16.70. cdist-type__install_file(7)
    • - + View page source @@ -369,14 +377,14 @@
      -
      -

      16.69. cdist-type__install_file(7)

      -
      -

      16.69.1. NAME

      +
      +

      16.70. cdist-type__install_file(7)

      +
      +

      16.70.1. NAME

      cdist-type__install_file - Manage files with install command.

      -
      -
      -

      16.69.2. DESCRIPTION

      +
      +
      +

      16.70.2. DESCRIPTION

      This cdist type allows you to create files, remove files and set file attributes on the target.

      If the file already exists on the target, then if it is a:

      @@ -397,13 +405,13 @@ attributes on the target.

      the file would have been created otherwise (e.g. it is not present or not a regular file).

      In any case, make sure that the file attributes are as specified.

      - -
      -

      16.69.3. REQUIRED PARAMETERS

      +
      +
      +

      16.70.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.69.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.70.4. OPTIONAL PARAMETERS

      state

      'present', 'absent', 'exists' or 'pre-exists', defaults to 'present' where:

      @@ -431,9 +439,9 @@ If source is '-' (dash), take what was written to stdin as the file content.

      onchange

      The code to run if file is modified.

      - -
      -

      16.69.5. MESSAGES

      +
      +
      +

      16.70.5. MESSAGES

      chgrp <group>

      Changed group membership

      @@ -448,9 +456,9 @@ If source is '-' (dash), take what was written to stdin as the file content.

      upload

      File was uploaded

      - -
      -

      16.69.6. EXAMPLES

      +
      +
      +

      16.70.6. EXAMPLES

      # Create  /etc/cdist-configured as an empty file
 __install_file /etc/cdist-configured
 # The same thing
@@ -475,48 +483,48 @@ __install_file /tmp/whatever --owner root --group root --mode 64
 DONE
      - -
      -

      16.69.7. AUTHORS

      +
      +
      +

      16.70.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.69.8. COPYING

      +
      +
      +

      16.70.8. COPYING

      Copyright (C) 2011-2013 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -525,7 +533,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.70. cdist-type__install_fstab(7)
      • +
    • 16.71. cdist-type__install_fstab(7)
    • - + View page source @@ -369,83 +377,83 @@
      -
      -

      16.70. cdist-type__install_fstab(7)

      -
      -

      16.70.1. NAME

      +
      +

      16.71. cdist-type__install_fstab(7)

      +
      +

      16.71.1. NAME

      cdist-type__install_fstab - generate /etc/fstab during installation

      -
      -
      -

      16.70.2. DESCRIPTION

      +
      +
      +

      16.71.2. DESCRIPTION

      Uses __install_generate_fstab to generate a /etc/fstab file and uploads it to the target machine at ${prefix}/etc/fstab.

      - -
      -

      16.70.3. REQUIRED PARAMETERS

      +
      +
      +

      16.71.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.70.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.71.4. OPTIONAL PARAMETERS

      prefix

      The prefix under which to generate the /etc/fstab file. Defaults to /target.

      - -
      -

      16.70.5. EXAMPLES

      +
      +
      +

      16.71.5. EXAMPLES

      __install_fstab
 
 __install_fstab --prefix /mnt/target
      - -
      -

      16.70.6. SEE ALSO

      +
      +
      +

      16.71.6. SEE ALSO

      cdist-type__install_generate_fstab(7), cdist-type__install_mount(7)

      - -
      -

      16.70.7. AUTHORS

      +
      +
      +

      16.71.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.70.8. COPYING

      +
      +
      +

      16.71.8. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -454,7 +462,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.71. cdist-type__install_generate_fstab(7)
      • +
    • 16.72. cdist-type__install_generate_fstab(7)
    • - + View page source @@ -369,85 +377,85 @@
      -
      -

      16.71. cdist-type__install_generate_fstab(7)

      -
      -

      16.71.1. NAME

      +
      +

      16.72. cdist-type__install_generate_fstab(7)

      +
      +

      16.72.1. NAME

      cdist-type__install_generate_fstab - generate /etc/fstab during installation

      -
      -
      -

      16.71.2. DESCRIPTION

      +
      +
      +

      16.72.2. DESCRIPTION

      Generates a /etc/fstab file from information retrieved from __install_mount definitions.

      - -
      -

      16.71.3. REQUIRED PARAMETERS

      +
      +
      +

      16.72.3. REQUIRED PARAMETERS

      destination

      The path where to store the generated fstab file. Note that this is a path on the server, where cdist is running, not the target host.

      - -
      -

      16.71.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.72.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.71.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.72.5. BOOLEAN PARAMETERS

      uuid

      use UUID instead of device in fstab

      - -
      -

      16.71.6. EXAMPLES

      +
      +
      +

      16.72.6. EXAMPLES

      __install_generate_fstab --destination /path/where/you/want/fstab
 
 __install_generate_fstab --uuid --destination /path/where/you/want/fstab
      - -
      -

      16.71.7. AUTHORS

      +
      +
      +

      16.72.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.71.8. COPYING

      +
      +
      +

      16.72.8. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -456,7 +464,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.72. cdist-type__install_mkfs(7)
      • +
    • 16.73. cdist-type__install_mkfs(7)
    • - + View page source @@ -369,25 +377,25 @@
      -
      -

      16.72. cdist-type__install_mkfs(7)

      -
      -

      16.72.1. NAME

      +
      +

      16.73. cdist-type__install_mkfs(7)

      +
      +

      16.73.1. NAME

      cdist-type__install_mkfs - build a linux file system

      -
      -
      -

      16.72.2. DESCRIPTION

      +
      +
      +

      16.73.2. DESCRIPTION

      This cdist type is a wrapper for the mkfs command.

      - -
      -

      16.72.3. REQUIRED PARAMETERS

      +
      +
      +

      16.73.3. REQUIRED PARAMETERS

      type

      The filesystem type to use. Same as used with mkfs -t.

      - -
      -

      16.72.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.73.4. OPTIONAL PARAMETERS

      device

      defaults to object_id

      @@ -396,9 +404,9 @@
      blocks

      the number of blocks to be used for the file system

      - -
      -

      16.72.5. EXAMPLES

      +
      +
      +

      16.73.5. EXAMPLES

      # reiserfs /dev/sda5
 __install_mkfs /dev/sda5 --type reiserfs
 
@@ -409,52 +417,52 @@ __install_mkfs whatever --device /dev/sda5 --type reiserfs
 __install_mkfs /dev/sda1 --type jfs --options "-j /dev/sda2"
      - -
      -

      16.72.6. SEE ALSO

      +
      +
      +

      16.73.6. SEE ALSO

      mkfs(8)

      - -
      -

      16.72.7. AUTHORS

      +
      +
      +

      16.73.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.72.8. COPYING

      +
      +
      +

      16.73.8. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -463,7 +471,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.73. cdist-type__install_mount(7)
      • +
    • 16.74. cdist-type__install_mount(7)
    • - + View page source @@ -369,25 +377,25 @@
      -
      -

      16.73. cdist-type__install_mount(7)

      -
      -

      16.73.1. NAME

      +
      +

      16.74. cdist-type__install_mount(7)

      +
      +

      16.74.1. NAME

      cdist-type__install_mount - mount filesystems in the installer

      -
      -
      -

      16.73.2. DESCRIPTION

      +
      +
      +

      16.74.2. DESCRIPTION

      Mounts filesystems in the installer. Collects data to generate /etc/fstab.

      - -
      -

      16.73.3. REQUIRED PARAMETERS

      +
      +
      +

      16.74.3. REQUIRED PARAMETERS

      device

      the device to mount

      - -
      -

      16.73.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.74.4. OPTIONAL PARAMETERS

      dir

      where to mount device. Defaults to object_id.

      @@ -401,62 +409,62 @@ Defaults to the filesystem used in __install_mkfs for the same 'device'.

      Defaults to /target.

      - -
      -

      16.73.5. EXAMPLES

      +
      +
      +

      16.74.5. EXAMPLES

      __install_mount slash --dir / --device /dev/sda5 --options noatime
 require="__install_mount/slash" __install_mount /boot --device /dev/sda1
 __install_mount swap --device /dev/sda2 --type swap
 require="__install_mount/slash" __install_mount /tmp --device tmpfs --type tmpfs
      - -
      -

      16.73.6. SEE ALSO

      +
      +
      +

      16.74.6. SEE ALSO

      cdist-type__install_mkfs(7), cdist-type__install_mount_apply (7)

      - -
      -

      16.73.7. AUTHORS

      +
      +
      +

      16.74.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.73.8. COPYING

      +
      +
      +

      16.74.8. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -465,7 +473,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.74. cdist-type__install_partition_msdos(7)
      • +
    • 16.75. cdist-type__install_partition_msdos(7)
    • - + View page source @@ -368,25 +376,25 @@
      -
      -

      16.74. cdist-type__install_partition_msdos(7)

      -
      -

      16.74.1. NAME

      +
      +

      16.75. cdist-type__install_partition_msdos(7)

      +
      +

      16.75.1. NAME

      cdist-type__install_partition_msdos - creates msdos partitions

      -
      -
      -

      16.74.2. DESCRIPTION

      +
      +
      +

      16.75.2. DESCRIPTION

      This cdist type allows you to create msdos paritions.

      - -
      -

      16.74.3. REQUIRED PARAMETERS

      +
      +
      +

      16.75.3. REQUIRED PARAMETERS

      type

      the partition type used in fdisk (such as 82 or 83) or "extended"

      - -
      -

      16.74.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.75.4. OPTIONAL PARAMETERS

      device

      the device we're working on. Defaults to the string prefix of --partition

      @@ -402,9 +410,9 @@ only), '+' for remaining space, or 'n%' for percentage of remaining specified). Defaults to +.

      - -
      -

      16.74.5. EXAMPLES

      +
      +
      +

      16.75.5. EXAMPLES

      # 128MB, linux, bootable
 __install_partition_msdos /dev/sda1 --type 83 --size 128M --bootable true
 # 512MB, swap
@@ -421,48 +429,48 @@ __install_partition_msdos /dev/sda7 --type 83 --size +
 __install_partition_msdos /dev/nvme0n1p2 --device /dev/nvme0n1 --minor 2 --type 83 --size 128M --bootable true
      - -
      -

      16.74.6. AUTHORS

      +
      +
      +

      16.75.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.74.7. COPYING

      +
      +
      +

      16.75.7. COPYING

      Copyright (C) 2011-2017 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -471,7 +479,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.75. cdist-type__install_partition_msdos_apply(7)
      • +
    • 16.76. cdist-type__install_partition_msdos_apply(7)
    • - + View page source @@ -369,75 +377,75 @@
      -
      -

      16.75. cdist-type__install_partition_msdos_apply(7)

      -
      -

      16.75.1. NAME

      +
      +

      16.76. cdist-type__install_partition_msdos_apply(7)

      +
      +

      16.76.1. NAME

      cdist-type__install_partition_msdos_apply - Apply dos partition settings

      -
      -
      -

      16.75.2. DESCRIPTION

      +
      +
      +

      16.76.2. DESCRIPTION

      Create the partitions defined with __install_partition_msdos

      - -
      -

      16.75.3. REQUIRED PARAMETERS

      +
      +
      +

      16.76.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.75.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.76.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.75.5. EXAMPLES

      +
      +
      +

      16.76.5. EXAMPLES

      __install_partition_msdos_apply
      - -
      -

      16.75.6. SEE ALSO

      +
      +
      +

      16.76.6. SEE ALSO

      cdist-type__install_partition_msdos_apply(7)

      - -
      -

      16.75.7. AUTHORS

      +
      +
      +

      16.76.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.75.8. COPYING

      +
      +
      +

      16.76.8. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -446,7 +454,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.76. cdist-type__install_reboot(7)
      • +
    • 16.77. cdist-type__install_reboot(7)
    • - + View page source @@ -368,71 +376,71 @@
      -
      -

      16.76. cdist-type__install_reboot(7)

      -
      -

      16.76.1. NAME

      +
      +

      16.77. cdist-type__install_reboot(7)

      +
      +

      16.77.1. NAME

      cdist-type__install_reboot - run reboot

      -
      -
      -

      16.76.2. DESCRIPTION

      +
      +
      +

      16.77.2. DESCRIPTION

      This cdist type allows you to reboot a machine.

      - -
      -

      16.76.3. REQUIRED PARAMETERS

      +
      +
      +

      16.77.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.76.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.77.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.76.5. EXAMPLES

      +
      +
      +

      16.77.5. EXAMPLES

      __install_reboot
      - -
      -

      16.76.6. AUTHORS

      +
      +
      +

      16.77.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.76.7. COPYING

      +
      +
      +

      16.77.7. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -441,7 +449,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.77. cdist-type__install_reset_disk(7)
      • +
    • 16.78. cdist-type__install_reset_disk(7)
    • - + View page source @@ -368,73 +376,73 @@
      -
      -

      16.77. cdist-type__install_reset_disk(7)

      -
      -

      16.77.1. NAME

      +
      +

      16.78. cdist-type__install_reset_disk(7)

      +
      +

      16.78.1. NAME

      cdist-type__install_reset_disk - reset a disk

      -
      -
      -

      16.77.2. DESCRIPTION

      +
      +
      +

      16.78.2. DESCRIPTION

      Remove partition table. Remove all lvm labels. Remove mdadm superblock.

      - -
      -

      16.77.3. REQUIRED PARAMETERS

      +
      +
      +

      16.78.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.77.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.78.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.77.5. EXAMPLES

      +
      +
      +

      16.78.5. EXAMPLES

      __install_reset_disk /dev/sdb
      - -
      -

      16.77.6. AUTHORS

      +
      +
      +

      16.78.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.77.7. COPYING

      +
      +
      +

      16.78.7. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -443,7 +451,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.78. cdist-type__install_stage(7)
      • +
    • 16.79. cdist-type__install_stage(7)
    • - + View page source @@ -369,19 +377,19 @@
      -
      -

      16.78. cdist-type__install_stage(7)

      -
      -

      16.78.1. NAME

      +
      +

      16.79. cdist-type__install_stage(7)

      +
      +

      16.79.1. NAME

      cdist-type__install_stage - download and unpack a stage file

      -
      -
      -

      16.78.2. DESCRIPTION

      +
      +
      +

      16.79.2. DESCRIPTION

      Downloads a operating system stage using curl and unpacks it to /target using tar. The stage tarball is expected to be gzip compressed.

      - -
      -

      16.78.3. REQUIRED PARAMETERS

      +
      +
      +

      16.79.3. REQUIRED PARAMETERS

      uri

      The uri from which to fetch the tarball. Can be anything understood by curl, e.g: @@ -390,71 +398,71 @@ Can be anything understood by curl, e.g: | file:///local/path/stage.tgz

      - -
      -

      16.78.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.79.4. OPTIONAL PARAMETERS

      target

      where to unpack the tarball to. Defaults to /target.

      - -
      -

      16.78.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.79.5. BOOLEAN PARAMETERS

      insecure

      run curl in insecure mode so it does not check the servers ssl certificate

      - -
      -

      16.78.6. EXAMPLES

      +
      +
      +

      16.79.6. EXAMPLES

      __install_stage --uri tftp:///path/to/stage.tgz
 __install_stage --uri http://path/to/stage.tgz --target /mnt/foobar
 __install_stage --uri file:///path/to/stage.tgz --target /target
 __install_stage --uri https://path/to/stage.tgz --target /mnt/foobar --insecure
      - -
      -

      16.78.7. AUTHORS

      +
      +
      +

      16.79.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.78.8. COPYING

      +
      +
      +

      16.79.8. COPYING

      Copyright (C) 2011 - 2013 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -463,7 +471,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.79. cdist-type__install_umount(7)
      • +
    • 16.80. cdist-type__install_umount(7)
    • - + View page source @@ -368,74 +376,74 @@
      -
      -

      16.79. cdist-type__install_umount(7)

      -
      -

      16.79.1. NAME

      +
      +

      16.80. cdist-type__install_umount(7)

      +
      +

      16.80.1. NAME

      cdist-type__install_umount - umount target directory

      -
      -
      -

      16.79.2. DESCRIPTION

      +
      +
      +

      16.80.2. DESCRIPTION

      This cdist type allows you to recursively umount the given target directory.

      - -
      -

      16.79.3. REQUIRED PARAMETERS

      +
      +
      +

      16.80.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.79.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.80.4. OPTIONAL PARAMETERS

      target

      the mount point to umount. Defaults to object_id

      - -
      -

      16.79.5. EXAMPLES

      +
      +
      +

      16.80.5. EXAMPLES

      __install_umount /target
      - -
      -

      16.79.6. AUTHORS

      +
      +
      +

      16.80.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.79.7. COPYING

      +
      +
      +

      16.80.7. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -444,7 +452,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.80. cdist-type__iptables_apply(7)
      • +
    • 16.81. cdist-type__iptables_apply(7)
    • - + View page source @@ -369,14 +377,14 @@
      -
      -

      16.80. cdist-type__iptables_apply(7)

      -
      -

      16.80.1. NAME

      +
      +

      16.81. cdist-type__iptables_apply(7)

      +
      +

      16.81.1. NAME

      cdist-type__iptables_apply - Apply the rules

      -
      -
      -

      16.80.2. DESCRIPTION

      +
      +
      +

      16.81.2. DESCRIPTION

      This cdist type deploys an init script that triggers the configured rules and also re-applies them on configuration. Rules are written from __iptables_rule @@ -394,66 +402,66 @@ files contain the arguments for a single .

      - -
      -

      16.80.3. REQUIRED PARAMETERS

      +
      +
      +

      16.81.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.80.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.81.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.80.5. EXAMPLES

      +
      +
      +

      16.81.5. EXAMPLES

      None (__iptables_apply is used by __iptables_rule automatically)

      - -
      -

      16.80.6. SEE ALSO

      +
      +
      +

      16.81.6. SEE ALSO

      cdist-type__iptables_rule(7), iptables(8)

      - -
      -

      16.80.7. AUTHORS

      +
      +
      +

      16.81.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org> Matthias Stecher <matthiasstecher--@--gmx.de>

      - -
      -

      16.80.8. COPYING

      +
      +
      +

      16.81.8. COPYING

      Copyright (C) 2013 Nico Schottelius. Copyright (C) 2020 Matthias Stecher. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -462,7 +470,6 @@ either version 3 of the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.81. cdist-type__iptables_rule(7)
      • +
    • 16.82. cdist-type__iptables_rule(7)
    • - + View page source @@ -370,37 +378,37 @@
      -
      -

      16.81. cdist-type__iptables_rule(7)

      -
      -

      16.81.1. NAME

      +
      +

      16.82. cdist-type__iptables_rule(7)

      +
      +

      16.82.1. NAME

      cdist-type__iptables_rule - Deploy iptable rulesets

      -
      -
      -

      16.81.2. DESCRIPTION

      +
      +
      +

      16.82.2. DESCRIPTION

      This cdist type allows you to manage iptable rules in a distribution independent manner.

      See cdist-type__iptables_apply(7) for the execution order of these rules. It will be executed automaticly to apply all rules non-volaite.

      - -
      -

      16.81.3. REQUIRED PARAMETERS

      +
      +
      +

      16.82.3. REQUIRED PARAMETERS

      rule

      The rule to apply. Essentially an iptables command line without iptables in front of it.

      - -
      -

      16.81.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.82.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      - -
      -

      16.81.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.82.5. BOOLEAN PARAMETERS

      All rules without any of these parameters will be treated like --v4 because of backward compatibility.

      @@ -414,9 +422,9 @@ threaten like --all other rules.

      - -
      -

      16.81.6. EXAMPLES

      +
      +
      +

      16.82.6. EXAMPLES

      # Deploy some policies
 __iptables_rule policy-in  --rule "-P INPUT DROP"
 __iptables_rule policy-out  --rule "-P OUTPUT ACCEPT"
@@ -445,54 +453,54 @@ __iptables_rule fwd-eth0-eth1 --v4 --v6 --rule "-A INPUT -
 __iptables_rule fwd-eth1-eth0 --all --rule "-A -o eth1 -i eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT"
      - -
      -

      16.81.7. SEE ALSO

      +
      +
      +

      16.82.7. SEE ALSO

      cdist-type__iptables_apply(7), iptables(8)

      - -
      -

      16.81.8. AUTHORS

      +
      +
      +

      16.82.8. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org> Matthias Stecher <matthiasstecher--@--gmx.de>

      - -
      -

      16.81.9. COPYING

      +
      +
      +

      16.82.9. COPYING

      Copyright (C) 2013 Nico Schottelius. Copyright (C) 2020 Matthias Stecher. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -501,7 +509,6 @@ either version 3 of the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.82. cdist-type__issue(7)
      • +
    • 16.83. cdist-type__issue(7)
    • - + View page source @@ -368,77 +376,77 @@
      -
      -

      16.82. cdist-type__issue(7)

      -
      -

      16.82.1. NAME

      +
      +

      16.83. cdist-type__issue(7)

      +
      +

      16.83.1. NAME

      cdist-type__issue - Manage issue

      -
      -
      -

      16.82.2. DESCRIPTION

      +
      +
      +

      16.83.2. DESCRIPTION

      This cdist type allows you to easily setup /etc/issue.

      - -
      -

      16.82.3. REQUIRED PARAMETERS

      +
      +
      +

      16.83.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.82.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.83.4. OPTIONAL PARAMETERS

      source

      If supplied, use this file as /etc/issue instead of default.

      - -
      -

      16.82.5. EXAMPLES

      +
      +
      +

      16.83.5. EXAMPLES

      __issue
 
 # When called from another type
 __issue --source "$__type/files/myfancyissue"
      - -
      -

      16.82.6. AUTHORS

      +
      +
      +

      16.83.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.82.7. COPYING

      +
      +
      +

      16.83.7. COPYING

      Copyright (C) 2011 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -447,7 +455,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -345,20 +351,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.83. cdist-type__jail(7)
      • +
    • 16.84. cdist-type__jail(7)
    • - + View page source @@ -372,27 +380,27 @@
      -
      -

      16.83. cdist-type__jail(7)

      -
      -

      16.83.1. NAME

      +
      +

      16.84. cdist-type__jail(7)

      +
      +

      16.84.1. NAME

      cdist-type__jail - Manage FreeBSD jails

      -
      -
      -

      16.83.2. DESCRIPTION

      +
      +
      +

      16.84.2. DESCRIPTION

      This type is used on FreeBSD to manage jails by calling the appropriate per-version subtype.

      - -
      -

      16.83.3. REQUIRED PARAMETERS

      +
      +
      +

      16.84.3. REQUIRED PARAMETERS

      state

      Either "present" or "absent", defaults to "present".

      jailbase

      The location of the .tgz archive containing the base fs for your jails.

      - -
      -

      16.83.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.84.4. OPTIONAL PARAMETERS

      name

      The name of the jail. Default is to use the object_id as the jail name.

      @@ -412,9 +420,9 @@ To use this option, devfs-enable must be "true."

      Defaults to /usr/jail.

      - -
      -

      16.83.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.84.5. BOOLEAN PARAMETERS

      stopped

      Do not start the jail

      @@ -423,17 +431,17 @@ Defaults to /usr/jail.

      onboot

      Whether to add the jail to rc.conf's jail_list variable.

      - -
      -

      16.83.6. CAVEATS

      +
      +
      +

      16.84.6. CAVEATS

      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.

      - -
      -

      16.83.7. MESSAGES

      +
      +
      +

      16.84.7. MESSAGES

      start

      The jail was started

      @@ -446,9 +454,9 @@ means.

      onboot

      The jail was configured to start on boot

      - -
      -

      16.83.8. EXAMPLES

      +
      +
      +

      16.84.8. EXAMPLES

      # Create a jail called www
 __jail www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
 
@@ -472,52 +480,52 @@ __jail lotsofoptions --state present --name testjail \
    --onboot --jailbase /my/jail/base.tgz --jaildir /jails
      - -
      -

      16.83.9. SEE ALSO

      +
      +
      +

      16.84.9. SEE ALSO

      jail(8)

      - -
      -

      16.83.10. AUTHORS

      +
      +
      +

      16.84.10. AUTHORS

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

      - -
      -

      16.83.11. COPYING

      +
      +
      +

      16.84.11. COPYING

      Copyright (C) 2012,2016 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -526,7 +534,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -345,20 +351,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.84. cdist-type__jail_freebsd10(7)
      • +
    • 16.85. cdist-type__jail_freebsd10(7)
    • - + View page source @@ -372,27 +380,27 @@
      -
      -

      16.84. cdist-type__jail_freebsd10(7)

      -
      -

      16.84.1. NAME

      +
      +

      16.85. cdist-type__jail_freebsd10(7)

      +
      +

      16.85.1. NAME

      cdist-type__jail_freeebsd10 - Manage FreeBSD jails

      -
      -
      -

      16.84.2. DESCRIPTION

      +
      +
      +

      16.85.2. DESCRIPTION

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

      - -
      -

      16.84.3. REQUIRED PARAMETERS

      +
      +
      +

      16.85.3. REQUIRED PARAMETERS

      state

      Either "present" or "absent", defaults to "present".

      jailbase

      The location of the .tgz archive containing the base fs for your jails.

      - -
      -

      16.84.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.85.4. OPTIONAL PARAMETERS

      name

      The name of the jail. Default is to use the object_id as the jail name.

      @@ -412,9 +420,9 @@ To use this option, devfs-enable must be "true."

      Defaults to /usr/jail.

      - -
      -

      16.84.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.85.5. BOOLEAN PARAMETERS

      stopped

      Do not start the jail

      @@ -423,16 +431,16 @@ Defaults to /usr/jail.

      onboot

      Whether to add the jail to rc.conf's jail_list variable.

      - -
      -

      16.84.6. CAVEATS

      +
      +
      +

      16.85.6. CAVEATS

      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 modifications to jail.conf need to be made through alternate means.

      - -
      -

      16.84.7. MESSAGES

      +
      +
      +

      16.85.7. MESSAGES

      start

      The jail was started

      @@ -445,9 +453,9 @@ modifications to jail.conf need to be made through alternate means.

      onboot

      The jail was configured to start on boot

      - -
      -

      16.84.8. EXAMPLES

      +
      +
      +

      16.85.8. EXAMPLES

      # Create a jail called www
 __jail_freebsd10 www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
 
@@ -471,52 +479,52 @@ __jail_freebsd10 lotsofoptions --state present --name testjail 
    --onboot --jailbase /my/jail/base.tgz --jaildir /jails
      - -
      -

      16.84.9. SEE ALSO

      +
      +
      +

      16.85.9. SEE ALSO

      jail(8)

      - -
      -

      16.84.10. AUTHORS

      +
      +
      +

      16.85.10. AUTHORS

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

      - -
      -

      16.84.11. COPYING

      +
      +
      +

      16.85.11. COPYING

      Copyright (C) 2012-2016 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -525,7 +533,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -345,20 +351,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.85. cdist-type__jail_freebsd9(7)
      • +
    • 16.86. cdist-type__jail_freebsd9(7)
    • - + View page source @@ -372,27 +380,27 @@
      -
      -

      16.85. cdist-type__jail_freebsd9(7)

      -
      -

      16.85.1. NAME

      +
      +

      16.86. cdist-type__jail_freebsd9(7)

      +
      +

      16.86.1. NAME

      cdist-type__jail_freebsd9 - Manage FreeBSD jails

      -
      -
      -

      16.85.2. DESCRIPTION

      +
      +
      +

      16.86.2. DESCRIPTION

      This type is used on FreeBSD <= 9.x to manage jails.

      - -
      -

      16.85.3. REQUIRED PARAMETERS

      +
      +
      +

      16.86.3. REQUIRED PARAMETERS

      state

      Either "present" or "absent", defaults to "present".

      jailbase

      The location of the .tgz archive containing the base fs for your jails.

      - -
      -

      16.85.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.86.4. OPTIONAL PARAMETERS

      name

      The name of the jail. Default is to use the object_id as the jail name.

      @@ -412,9 +420,9 @@ To use this option, devfs-enable must be "true."

      Defaults to /usr/jail.

      - -
      -

      16.85.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.86.5. BOOLEAN PARAMETERS

      stopped

      Do not start the jail

      @@ -423,17 +431,17 @@ Defaults to /usr/jail.

      onboot

      Whether to add the jail to rc.conf's jail_list variable.

      - -
      -

      16.85.6. CAVEATS

      +
      +
      +

      16.86.6. CAVEATS

      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.

      - -
      -

      16.85.7. MESSAGES

      +
      +
      +

      16.86.7. MESSAGES

      start

      The jail was started

      @@ -446,9 +454,9 @@ means.

      onboot

      The jail was configured to start on boot

      - -
      -

      16.85.8. EXAMPLES

      +
      +
      +

      16.86.8. EXAMPLES

      # Create a jail called www
 __jail_freebsd9 www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
 
@@ -472,52 +480,52 @@ __jail_freebsd9 lotsofoptions --state present --name testjail \
    --onboot --jailbase /my/jail/base.tgz --jaildir /jails
      - -
      -

      16.85.9. SEE ALSO

      +
      +
      +

      16.86.9. SEE ALSO

      jail(8)

      - -
      -

      16.85.10. AUTHORS

      +
      +
      +

      16.86.10. AUTHORS

      Jake Guffey <jake.guffey--@--eprotex.com>

      - -
      -

      16.85.11. COPYING

      +
      +
      +

      16.86.11. COPYING

      Copyright (C) 2012-2016 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -526,7 +534,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.86. cdist-type__key_value(7)
      • +
    • 16.87. cdist-type__key_value(7)
    • - + View page source @@ -371,28 +379,28 @@
      -
      -

      16.86. cdist-type__key_value(7)

      -
      -

      16.86.1. NAME

      +
      +

      16.87. cdist-type__key_value(7)

      +
      +

      16.87.1. NAME

      cdist-type__key_value - Change property values in files

      -
      -
      -

      16.86.2. DESCRIPTION

      +
      +
      +

      16.87.2. DESCRIPTION

      This cdist type allows you to change values in a key value based config file.

      - -
      -

      16.86.3. REQUIRED PARAMETERS

      +
      +
      +

      16.87.3. REQUIRED PARAMETERS

      file

      The file to operate on.

      delimiter

      The delimiter which separates the key from the value.

      - -
      -

      16.86.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.87.4. OPTIONAL PARAMETERS

      state

      present or absent, defaults to present. If present, sets the key to value, if absent, removes the key from the file.

      @@ -409,17 +417,17 @@ comment sign. (for example # or ; or wathever ..)

      onchange

      The code to run if the key or value changes (i.e. is inserted, removed or replaced).

      - -
      -

      16.86.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.87.5. BOOLEAN PARAMETERS

      exact_delimiter

      If supplied, treat additional whitespaces between key, delimiter and value as wrong value.

      - -
      -

      16.86.6. MESSAGES

      +
      +
      +

      16.87.6. MESSAGES

      remove

      Removed existing key and value

      @@ -430,9 +438,9 @@ as wrong value.

      create

      A new line was inserted in a new file

      - -
      -

      16.86.7. EXAMPLES

      +
      +
      +

      16.87.7. EXAMPLES

      # Set the maximum system user id
 __key_value SYS_UID_MAX --file /etc/login.defs --value 666 --delimiter ' '
 
@@ -448,53 +456,53 @@ __key_value net.ipv4.ip_forward --file /etc/sysctl.conf --value 
 __key_value LEGACY_KEY --file /etc/somefile --state absent --delimiter '='
      - -
      -

      16.86.8. MORE INFORMATION

      +
      +
      +

      16.87.8. MORE INFORMATION

      This type try to handle as many values as possible, so it doesn't use regexes. So you need to exactly specify the key and delimiter. Delimiter can be of any length.

      - -
      -

      16.86.9. AUTHORS

      +
      +
      +

      16.87.9. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.86.10. COPYING

      +
      +
      +

      16.87.10. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -503,7 +511,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.87. cdist-type__keyboard(7)
      • +
    • 16.88. cdist-type__keyboard(7)
    • - + View page source @@ -367,69 +375,69 @@
      -
      -

      16.87. cdist-type__keyboard(7)

      -
      -

      16.87.1. NAME

      +
      +

      16.88. cdist-type__keyboard(7)

      +
      +

      16.88.1. NAME

      cdit-type__keyboard - Set keyboard layout

      -
      -
      -

      16.87.2. DESCRIPTION

      +
      +
      +

      16.88.2. DESCRIPTION

      This cdist type allows you to modify keyboard layout.

      - -
      -

      16.87.3. REQUIRED PARAMETERS

      +
      +
      +

      16.88.3. REQUIRED PARAMETERS

      type

      Any valid type, for example "us"

      - -
      -

      16.87.4. EXAMPLES

      +
      +
      +

      16.88.4. EXAMPLES

      # Set keyboard type to "us"
 __keyboard --type "us"
      - -
      -

      16.87.5. AUTHORS

      +
      +
      +

      16.88.5. AUTHORS

      Carlos Ortigoza <carlos.ortigoza--@--ungleich.ch>

      - -
      -

      16.87.6. COPYING

      +
      +
      +

      16.88.6. COPYING

      Copyright (C) 2016 Carlos Ortigoza. Free use of this software is granted under the terms of the GNU General Public License v3 or later (GPLv3+).

      - - +
      +
    - @@ -438,7 +446,6 @@ granted under the terms of the GNU General Public License v3 or later (GPLv3+).< - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.88. cdist-type__letsencrypt_cert(7)
      • +
    • 16.89. cdist-type__letsencrypt_cert(7)
    • - + View page source @@ -371,14 +379,14 @@
      -
      -

      16.88. cdist-type__letsencrypt_cert(7)

      -
      -

      16.88.1. NAME

      +
      +

      16.89. cdist-type__letsencrypt_cert(7)

      +
      +

      16.89.1. NAME

      cdist-type__letsencrypt_cert - Get an SSL certificate from Let's Encrypt

      -
      -
      -

      16.88.2. DESCRIPTION

      +
      +
      +

      16.89.2. DESCRIPTION

      Automatically obtain a Let's Encrypt SSL certificate using Certbot.

      This type attempts to setup automatic renewals always. In many Linux distributions, that is the case out of the box, see: @@ -390,9 +398,9 @@ the port mantainer, so there will be a weekly attempt at renewal.

      If your OS is not mentioned here or on Certbot's docs as having support for automated renewals, please make sure you check your OS and possibly patch this type so the system-wide cronjob is installed.

      - -
      -

      16.88.3. REQUIRED PARAMETERS

      +
      +
      +

      16.89.3. REQUIRED PARAMETERS

      object id

      A cert name. If domain parameter is not specified then it is used as a domain to be included in the certificate.

      @@ -400,9 +408,9 @@ as a domain to be included in the certificate.

      admin-email

      Where to send Let's Encrypt emails like "certificate needs renewal".

      - -
      -

      16.88.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.89.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present' where:

      @@ -416,9 +424,9 @@ as a domain to be included in the certificate.

      parameter is not present, Certbot will be run in standalone mode.

      - -
      -

      16.88.5. OPTIONAL MULTIPLE PARAMETERS

      +
      +
      +

      16.89.5. OPTIONAL MULTIPLE PARAMETERS

      domain

      Domains to be included in the certificate. When specified then object id is not used as a domain.

      @@ -462,16 +470,16 @@ were stopped by --pre-hook. This is only run if an attempt was made to obtain/renew a certificate.

      - -
      -

      16.88.6. BOOLEAN PARAMETERS

      +
      +
      +

      16.89.6. BOOLEAN PARAMETERS

      staging

      Obtain a test certificate from a staging server.

      - -
      -

      16.88.7. MESSAGES

      +
      +
      +

      16.89.7. MESSAGES

      change

      Certificate was changed.

      @@ -480,9 +488,9 @@ attempt was made to obtain/renew a certificate.

      remove

      Certificate was removed.

      - -
      -

      16.88.8. EXAMPLES

      +
      +
      +

      16.89.8. EXAMPLES

      # use object id as domain
 __letsencrypt_cert example.com \
     --admin-email root@example.com \
@@ -501,9 +509,9 @@ __letsencrypt_cert example.com \
     --webroot /data/letsencrypt/root
      - -
      -

      16.88.9. AUTHORS

      +
      +
      +

      16.89.9. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>
      Kamila Součková <kamila--@--ksp.sk>
      @@ -511,44 +519,44 @@ __letsencrypt_cert example.com \
      Ľubomír Kučera <lubomir.kucera.jr at gmail.com>
      Evilham <contact@evilham.com>
      - -
      -

      16.88.10. COPYING

      +
      +
      +

      16.89.10. COPYING

      Copyright (C) 2017-2021 Nico Schottelius, Kamila Součková, Darko Poljak and Ľubomír Kučera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -557,7 +565,6 @@ either version 3 of the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.89. cdist-type__line(7)
      • +
    • 16.90. cdist-type__line(7)
    • - + View page source @@ -371,22 +379,22 @@
      -
      -

      16.89. cdist-type__line(7)

      -
      -

      16.89.1. NAME

      +
      +

      16.90. cdist-type__line(7)

      +
      +

      16.90.1. NAME

      cdist-type__line - Manage lines in files

      -
      -
      -

      16.89.2. DESCRIPTION

      +
      +
      +

      16.90.2. DESCRIPTION

      This cdist type allows you to add lines and remove lines from files.

      - -
      -

      16.89.3. REQUIRED PARAMETERS

      +
      +
      +

      16.90.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.89.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.90.4. OPTIONAL PARAMETERS

      after

      Insert the given line after this pattern.

      @@ -412,13 +420,13 @@ are exactly 'line'.

      onchange

      The code to run if line is added, removed or updated.

      - -
      -

      16.89.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.90.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.89.6. MESSAGES

      +
      +
      +

      16.90.6. MESSAGES

      added

      The line was added.

      @@ -427,9 +435,9 @@ are exactly 'line'.

      removed

      The line was removed.

      - -
      -

      16.89.7. EXAMPLES

      +
      +
      +

      16.90.7. EXAMPLES

      # Manage a hosts entry for www.example.com.
 __line /etc/hosts \
     --line '127.0.0.2 www.example.com'
@@ -464,50 +472,50 @@ __line /etc/example.conf \
     --state replace
      - -
      -

      16.89.8. SEE ALSO

      +
      +
      +

      16.90.8. SEE ALSO

      cdist-type(7)

      - -
      -

      16.89.9. AUTHORS

      +
      +
      +

      16.90.9. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.89.10. COPYING

      +
      +
      +

      16.90.10. COPYING

      Copyright (C) 2018 Steven Armstrong. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

      - - +
      +
    - @@ -516,7 +524,6 @@ granted under the terms of the GNU General Public License version 3 (GPLv3).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.90. cdist-type__link(7)
      • +
    • 16.91. cdist-type__link(7)
    • - + View page source @@ -369,35 +377,35 @@
      -
      +
      +

      16.91.2. DESCRIPTION

      This cdist type allows you to manage hard and symbolic links. The given object id is the destination for the link.

      - -
      -

      16.90.3. REQUIRED PARAMETERS

      +
      +
      +

      16.91.3. REQUIRED PARAMETERS

      source

      Specifies the link source.

      type

      Specifies the link type: Either hard or symbolic.

      - -
      -

      16.90.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.91.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      - -
      -

      16.90.5. MESSAGES

      +
      +
      +

      16.91.5. MESSAGES

      created <destination>

      Link to destination was created.

      @@ -408,9 +416,9 @@ The given object id is the destination for the link.

      removed <destination> (wrongsource)

      Destination was removed because state is present and destination link source was wrong.

      - -
      -

      16.90.6. EXAMPLES

      +
      +
      +

      16.91.6. EXAMPLES

      # Create hard link of /etc/shadow
 __link /root/shadow --source /etc/shadow --type hard
 
@@ -426,48 +434,48 @@ __link /opt/plone --source /home/services/plone --type symbolic
 __link /opt/plone --state absent
      - -
      -

      16.90.7. AUTHORS

      +
      +
      +

      16.91.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.90.8. COPYING

      +
      +
      +

      16.91.8. COPYING

      Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -476,7 +484,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.91. cdist-type__locale(7)
      • +
    • 16.92. cdist-type__locale(7)
    • - + View page source @@ -368,26 +376,26 @@
      -
      -

      16.91. cdist-type__locale(7)

      -
      -

      16.91.1. NAME

      +
      +

      16.92. cdist-type__locale(7)

      +
      +

      16.92.1. NAME

      cdist-type__locale - Configure locales

      -
      -
      -

      16.91.2. DESCRIPTION

      +
      +
      +

      16.92.2. DESCRIPTION

      This cdist type allows you to setup locales. On systems that don't support locale setting like alpine/musl libc, it is a no-op.

      - -
      -

      16.91.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.92.3. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to present

      - -
      -

      16.91.4. EXAMPLES

      +
      +
      +

      16.92.4. EXAMPLES

      # Add locale de_CH.UTF-8
 __locale de_CH.UTF-8
 
@@ -398,51 +406,51 @@ __locale de_CH.UTF-8 --state present
 __locale en_GB.UTF-8 --state absent
      - -
      -

      16.91.5. SEE ALSO

      +
      +
      +

      16.92.5. SEE ALSO

      locale(1), localedef(1), cdist-type__locale_system(7)

      - -
      -

      16.91.6. AUTHORS

      +
      +
      +

      16.92.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.91.7. COPYING

      +
      +
      +

      16.92.7. COPYING

      Copyright (C) 2013-2019 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

      - - +
      +
    - @@ -451,7 +459,6 @@ later (GPLv3+).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.92. cdist-type__locale_system(7)
      • +
    • 16.93. cdist-type__locale_system(7)
    • - + View page source @@ -368,20 +376,20 @@
      -
      -

      16.92. cdist-type__locale_system(7)

      -
      -

      16.92.1. NAME

      +
      +

      16.93. cdist-type__locale_system(7)

      +
      +

      16.93.1. NAME

      cdist-type__locale_system - Set system-wide locale

      -
      -
      -

      16.92.2. DESCRIPTION

      +
      +
      +

      16.93.2. DESCRIPTION

      This cdist type allows you to modify system-wide locale. The name of the locale category is given as the object id (usually you are probably interested in using LANG).

      - -
      -

      16.92.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.93.3. OPTIONAL PARAMETERS

      state

      present or absent, defaults to present. If present, sets the locale category to the given value. @@ -391,9 +399,9 @@ If absent, removes the locale category from the system file.

      Defaults to en_US.UTF-8.

      - -
      -

      16.92.4. EXAMPLES

      +
      +
      +

      16.93.4. EXAMPLES

      # Set LANG to en_US.UTF-8
 __locale_system LANG
 
@@ -407,55 +415,55 @@ __locale_system LC_MESSAGES --value de_CH.UTF-8
 __locale_system LC_ALL --state absent
      - -
      -

      16.92.5. SEE ALSO

      +
      +
      +

      16.93.5. SEE ALSO

      locale(1), localedef(1), cdist-type__locale(7)

      - -
      -

      16.92.6. AUTHORS

      +
      +
      +

      16.93.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>
      Carlos Ortigoza <carlos.ortigoza--@--ungleich.ch>
      Nico Schottelius <nico.schottelius--@--ungleich.ch>
      - -
      -

      16.92.7. COPYING

      +
      +
      +

      16.93.7. COPYING

      Copyright (C) 2016 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

      - - +
      +
    - @@ -464,7 +472,6 @@ later (GPLv3+).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.93. cdist-type__localedef(7)
      • +
    • 16.94. cdist-type__localedef(7)
    • - + View page source @@ -368,14 +376,14 @@
      -
      -

      16.93. cdist-type__localedef(7)

      -
      -

      16.93.1. NAME

      +
      +

      16.94. cdist-type__localedef(7)

      +
      +

      16.94.1. NAME

      cdist-type__localedef - Define and remove system locales

      -
      -
      -

      16.93.2. DESCRIPTION

      +
      +
      +

      16.94.2. DESCRIPTION

      This cdist type allows you to define locales on the system using localedef(1) or remove them. On systems that don't support definition of new locales, the type will raise an @@ -384,16 +392,16 @@ error.

      i.e. it defines alias locales or deletes aliases of a locale when it is removed. It is not possible, however, to use alias names to define locales or only remove certain aliases of a locale.

      - -
      -

      16.93.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.94.3. OPTIONAL PARAMETERS

      state

      present or absent. Defaults to present.

      - -
      -

      16.93.4. EXAMPLES

      +
      +
      +

      16.94.4. EXAMPLES

      # Add locale de_CH.UTF-8
 __localedef de_CH.UTF-8
 
@@ -404,56 +412,56 @@ __localedef de_CH.UTF-8 --state present
 __localedef en_GB.UTF-8 --state absent
      - -
      -

      16.93.5. SEE ALSO

      +
      +
      +

      16.94.5. SEE ALSO

      locale(1), localedef(1), cdist-type__locale_system(7)

      - -
      -

      16.93.6. AUTHORS

      +
      +
      +

      16.94.6. AUTHORS

      Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>
      Nico Schottelius <nico-cdist--@--schottelius.org>
      - -
      -

      16.93.7. COPYING

      +
      +
      +

      16.94.7. COPYING

      Copyright (C) 2013-2019 Nico Schottelius, 2020 Dennis Camera. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

      - - +
      +
    - @@ -462,7 +470,6 @@ or later (GPLv3+).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.94. cdist-type__motd(7)
      • +
    • 16.95. cdist-type__motd(7)
    • - + View page source @@ -368,14 +376,14 @@
      -
      -

      16.94. cdist-type__motd(7)

      -
      -

      16.94.1. NAME

      +
      +

      16.95. cdist-type__motd(7)

      +
      +

      16.95.1. NAME

      cdist-type__motd - Manage message of the day

      -
      -
      -

      16.94.2. DESCRIPTION

      +
      +
      +

      16.95.2. DESCRIPTION

      This cdist type allows you to easily setup /etc/motd.

      Note

      @@ -385,22 +393,22 @@ If your OS of choice does something besides /etc/motd, check the source and contribute support for it. Otherwise it will likely just work.

      - -
      -

      16.94.3. REQUIRED PARAMETERS

      +
      +
      +

      16.95.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.94.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.95.4. OPTIONAL PARAMETERS

      source

      If supplied, copy this file from the host running cdist to the target. If source is '-' (dash), take what was written to stdin as the file content. If not supplied, a default message will be placed onto the target.

      - -
      -

      16.94.5. EXAMPLES

      +
      +
      +

      16.95.5. EXAMPLES

      # Use cdist defaults
 __motd
 
@@ -417,48 +425,48 @@ __motd --source "-" <<EO
 EOF
      - -
      -

      16.94.6. AUTHORS

      +
      +
      +

      16.95.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.94.7. COPYING

      +
      +
      +

      16.95.7. COPYING

      Copyright (C) 2020 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -467,7 +475,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.95. cdist-type__mount(7)
      • +
    • 16.96. cdist-type__mount(7)
    • - + View page source @@ -369,22 +377,22 @@
      -
      -

      16.95. cdist-type__mount(7)

      -
      -

      16.95.1. NAME

      +
      +

      16.96. cdist-type__mount(7)

      +
      +

      16.96.1. NAME

      cdit-type__mount - Manage filesystem mounts

      -
      -
      -

      16.95.2. DESCRIPTION

      +
      +
      +

      16.96.2. DESCRIPTION

      Manage filesystem mounts either via /etc/fstab or manually.

      - -
      -

      16.95.3. REQUIRED PARAMETERS

      +
      +
      +

      16.96.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.95.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.96.4. OPTIONAL PARAMETERS

      device

      device to mount at path, defaults to 'none'. see mount(8)

      @@ -406,16 +414,16 @@ Defaults to __object_id

      type

      vfstype, see mount(8)

      - -
      -

      16.95.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.96.5. BOOLEAN PARAMETERS

      nofstab

      do not manage an entry in /etc/fstab

      - -
      -

      16.95.6. EXAMPLES

      +
      +
      +

      16.96.6. EXAMPLES

      __mount /some/dir \
    --device /dev/sdc3 \
    --type xfs \
@@ -429,48 +437,48 @@ __mount /var/lib/one \
    --options "mfsmaster=mfsmaster.domain.tld,mfssubfolder=/one,nonempty,_netdev"
      - -
      -

      16.95.7. AUTHORS

      +
      +
      +

      16.96.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.95.8. COPYING

      +
      +
      +

      16.96.8. COPYING

      Copyright (C) 2014 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -479,7 +487,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.96. cdist-type__mysql_database(7)
      • +
    • 16.97. cdist-type__mysql_database(7)
    • - + View page source @@ -367,18 +375,18 @@
      -
      -

      16.96. cdist-type__mysql_database(7)

      -
      -

      16.96.1. NAME

      +
      +

      16.97. cdist-type__mysql_database(7)

      +
      +

      16.97.1. NAME

      cdist-type__mysql_database - Manage a MySQL database

      -
      -
      -

      16.96.2. DESCRIPTION

      +
      +
      +

      16.97.2. DESCRIPTION

      Create MySQL database and optionally user with all privileges.

      - -
      -

      16.96.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.97.3. OPTIONAL PARAMETERS

      name

      Name of database. Defaults to object id.

      @@ -390,9 +398,9 @@ If absent and user is also set, both will be removed (with privileges).

      - -
      -

      16.96.4. EXAMPLES

      +
      +
      +

      16.97.4. EXAMPLES

      # just create database
 __mysql_database foo
 
@@ -402,48 +410,48 @@ __mysql_database bar \
     --password secret
      - -
      -

      16.96.5. AUTHORS

      +
      +
      +

      16.97.5. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.96.6. COPYING

      +
      +
      +

      16.97.6. COPYING

      Copyright (C) 2020 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -452,7 +460,6 @@ later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.97. cdist-type__mysql_privileges(7)
      • +
    • 16.98. cdist-type__mysql_privileges(7)
    • - + View page source @@ -368,27 +376,27 @@
      -
      -

      16.97. cdist-type__mysql_privileges(7)

      -
      -

      16.97.1. NAME

      +
      +

      16.98. cdist-type__mysql_privileges(7)

      +
      +

      16.98.1. NAME

      cdist-type__mysql_privileges - Manage MySQL privileges

      -
      -
      -

      16.97.2. DESCRIPTION

      +
      +
      +

      16.98.2. DESCRIPTION

      Grant and revoke privileges of MySQL user.

      - -
      -

      16.97.3. REQUIRED PARAMETERS

      +
      +
      +

      16.98.3. REQUIRED PARAMETERS

      database

      Name of database.

      user

      Name of user.

      - -
      -

      16.97.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.98.4. OPTIONAL PARAMETERS

      privileges

      Defaults to "all".

      @@ -399,54 +407,54 @@
      state

      "present" grants and "absent" revokes. Defaults to present.

      - -
      -

      16.97.5. EXAMPLES

      +
      +
      +

      16.98.5. EXAMPLES

      __mysql_privileges user-to-db --database db --user user
      - -
      -

      16.97.6. AUTHORS

      +
      +
      +

      16.98.6. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.97.7. COPYING

      +
      +
      +

      16.98.7. COPYING

      Copyright (C) 2020 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.98. cdist-type__mysql_user(7)
      • +
    • 16.99. cdist-type__mysql_user(7)
    • - + View page source @@ -367,18 +375,18 @@
      -
      -

      16.98. cdist-type__mysql_user(7)

      -
      -

      16.98.1. NAME

      +
      +

      16.99. cdist-type__mysql_user(7)

      +
      +

      16.99.1. NAME

      cdist-type__mysql_user - Manage a MySQL user

      -
      -
      -

      16.98.2. DESCRIPTION

      +
      +
      +

      16.99.2. DESCRIPTION

      Create MySQL user or change password for the user.

      - -
      -

      16.98.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.99.3. OPTIONAL PARAMETERS

      name

      Name of user. Defaults to object id.

      @@ -389,54 +397,54 @@
      state

      Defaults to present.

      - -
      -

      16.98.4. EXAMPLES

      +
      +
      +

      16.99.4. EXAMPLES

      __mysql_user user --password secret
      - -
      -

      16.98.5. AUTHORS

      +
      +
      +

      16.99.5. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.98.6. COPYING

      +
      +
      +

      16.99.6. COPYING

      Copyright (C) 2020 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -445,7 +453,6 @@ later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -345,20 +351,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.99. cdist-type__openldap_server(7)
      • +
    • 16.100. cdist-type__openldap_server(7)
    • - + View page source @@ -372,20 +380,20 @@
      -
      -

      16.99. cdist-type__openldap_server(7)

      -
      -

      16.99.1. NAME

      +
      +

      16.100. cdist-type__openldap_server(7)

      +
      +

      16.100.1. NAME

      cdist-type__openldap_server - Setup an openldap(4) server instance

      -
      -
      -

      16.99.2. DESCRIPTION

      +
      +
      +

      16.100.2. DESCRIPTION

      This type can be used to bootstrap an LDAP environment using openldap as slapd.

      It bootstraps the LDAP server with sane defaults and creates and manages the base DN defined by suffix.

      - -
      -

      16.99.3. REQUIRED PARAMETERS

      +
      +
      +

      16.100.3. REQUIRED PARAMETERS

      manager-dn

      The rootdn to set up in the directory. E.g. cn=manager,dc=ungleich,dc=ch. See slapd.conf(5).

      @@ -409,9 +417,9 @@ E.g. dc=ungleich,dc=ch. See slapd.conf(5).

      E.g. dc=ungleich,dc=ch. See slapd.conf(5).

      - -
      -

      16.99.4. REQUIRED MULTIPLE PARAMETERS

      +
      +
      +

      16.100.4. REQUIRED MULTIPLE PARAMETERS

      slapd-url

      A URL for slapd to listen on. Pass once for each URL you want to support, @@ -421,9 +429,9 @@ connect to this LDAP server See the -h flag in slapd(8C).

      - -
      -

      16.99.5. OPTIONAL PARAMETERS

      +
      +
      +

      16.100.5. OPTIONAL PARAMETERS

      syncrepl-credentials

      Only has an effect if replicate is set; required in that case. This secret is shared amongst the hosts that will replicate the directory. @@ -457,9 +465,9 @@ Path in the remote hosts to the PEM-encoded CA certificate file.

      extra-config

      Custom settings to be added in slapd.conf(5).

      - -
      -

      16.99.6. OPTIONAL MULTIPLE PARAMETERS

      +
      +
      +

      16.100.6. OPTIONAL MULTIPLE PARAMETERS

      syncrepl-host

      Only has an effect if replicate is set; required in that case. Set once per host that will replicate the directory.

      @@ -478,9 +486,9 @@ This defaults to a sensible subset, for details see the type definition.

      Defaults to Managed by cdist, do not edit manually.

      - -
      -

      16.99.7. BOOLEAN PARAMETERS

      +
      +
      +

      16.100.7. BOOLEAN PARAMETERS

      staging

      Passed to cdist-type__letsencrypt_cert; has otherwise no use. Obtain a test certificate from a staging server.

      @@ -489,9 +497,9 @@ Obtain a test certificate from a staging server.

      If present syncrepl-credentials and syncrepl-host are also required.

      - -
      -

      16.99.8. EXAMPLES

      +
      +
      +

      16.100.8. EXAMPLES

      # Example of a simple server with manual certificate management.
 pki_prefix="/usr/local/etc/pki/realms/ldap.camilion.cloud"
 __openldap_server \
@@ -553,53 +561,53 @@ __openldap_server \
 # Do not change it manually, the type will overwrite your changes.
      - -
      -

      16.99.9. SEE ALSO

      +
      +
      +

      16.100.9. SEE ALSO

      cdist-type__letsencrypt_cert(7)

      - -
      -

      16.99.10. AUTHORS

      +
      +
      +

      16.100.10. AUTHORS

      ungleich <foss--@--ungleich.ch> Evilham <contact--@--evilham.com>

      - -
      -

      16.99.11. COPYING

      +
      +
      +

      16.100.11. COPYING

      Copyright (C) 2020 ungleich glarus ag. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -608,7 +616,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.100. cdist-type__package(7)
      • +
    • 16.101. cdist-type__package(7)
    • - + View page source @@ -368,23 +376,23 @@
      -
      -

      16.100. cdist-type__package(7)

      -
      -

      16.100.1. NAME

      +
      +

      16.101. cdist-type__package(7)

      +
      +

      16.101.1. NAME

      cdist-type__package - Manage packages

      -
      -
      -

      16.100.2. DESCRIPTION

      +
      +
      +

      16.101.2. DESCRIPTION

      This cdist type allows you to install or uninstall packages on the target. It dispatches the actual work to the package system dependent types.

      - -
      -

      16.100.3. REQUIRED PARAMETERS

      +
      +
      +

      16.101.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.100.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.101.4. OPTIONAL PARAMETERS

      name

      The name of the package to install. Default is to use the object_id as the package name.

      @@ -401,9 +409,9 @@ e.g.
      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.100.5. EXAMPLES

      +
      +
      +

      16.101.5. EXAMPLES

      # Install the package vim on the target
 __package vim --state present
 
@@ -414,48 +422,48 @@ __package vim --state present --version 7.3.50
 __package vim --state present --type __package_apt
      - -
      -

      16.100.6. AUTHORS

      +
      +
      +

      16.101.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.100.7. COPYING

      +
      +
      +

      16.101.7. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -464,7 +472,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.101. cdist-type__package_akp(7)
      • +
    • 16.102. cdist-type__package_akp(7)
    • - + View page source @@ -369,31 +377,31 @@
      -
      -

      16.101. cdist-type__package_akp(7)

      -
      -

      16.101.1. NAME

      +
      +

      16.102. cdist-type__package_akp(7)

      +
      +

      16.102.1. NAME

      cdist-type__package_akp - Manage packages with akp

      -
      -
      -

      16.101.2. DESCRIPTION

      +
      +
      +

      16.102.2. DESCRIPTION

      apk is usually used on Alpine to manage packages.

      - -
      -

      16.101.3. REQUIRED PARAMETERS

      +
      +
      +

      16.102.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.101.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.102.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.101.5. EXAMPLES

      +
      +
      +

      16.102.5. EXAMPLES

      # Ensure zsh in installed
 __package_apk zsh --state present
 
@@ -401,52 +409,52 @@ __package_apk zsh --state present
 __package_apk apache2 --state absent
      - -
      -

      16.101.6. SEE ALSO

      +
      +
      +

      16.102.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.101.7. AUTHORS

      +
      +
      +

      16.102.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.101.8. COPYING

      +
      +
      +

      16.102.8. COPYING

      Copyright (C) 2019 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.102. cdist-type__package_apt(7)
      • +
    • 16.103. cdist-type__package_apt(7)
    • - + View page source @@ -370,27 +378,27 @@
      -
      -

      16.102. cdist-type__package_apt(7)

      -
      -

      16.102.1. NAME

      +
      +

      16.103. cdist-type__package_apt(7)

      +
      +

      16.103.1. NAME

      cdist-type__package_apt - Manage packages with apt-get

      -
      -
      -

      16.102.2. DESCRIPTION

      +
      +
      +

      16.103.2. DESCRIPTION

      apt-get is usually used on Debian and variants (like Ubuntu) to manage packages. The package will be installed without recommended or suggested packages. If such packages are required, install them separatly or use the parameter --install-recommends.

      This type will also update package index, if it is older than one day, to avoid missing package error messages.

      - -
      -

      16.102.3. REQUIRED PARAMETERS

      +
      +
      +

      16.103.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.102.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.103.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -403,9 +411,9 @@ Essentially allows you to retrieve packages from a different release

      chosen by the local package manager.

      - -
      -

      16.102.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.103.5. BOOLEAN PARAMETERS

      install-recommends

      If the package will be installed, it also installs recommended packages with it. It will not install recommended packages if the original package @@ -418,9 +426,9 @@ installed packages.

      purged from the system (using --purge).

      - -
      -

      16.102.6. EXAMPLES

      +
      +
      +

      16.103.6. EXAMPLES

      # Ensure zsh in installed
 __package_apt zsh --state present
 
@@ -431,52 +439,52 @@ __package_apt webserver --state present --name nginx
 __package_apt puppet --state absent
      - -
      -

      16.102.7. SEE ALSO

      +
      +
      +

      16.103.7. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.102.8. AUTHORS

      +
      +
      +

      16.103.8. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.102.9. COPYING

      +
      +
      +

      16.103.9. COPYING

      Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -485,7 +493,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -345,20 +351,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.103. cdist-type__package_dpkg(7)
      • +
    • 16.104. cdist-type__package_dpkg(7)
    • - + View page source @@ -372,52 +380,52 @@
      -
      -

      16.103. cdist-type__package_dpkg(7)

      -
      -

      16.103.1. NAME

      +
      +

      16.104. cdist-type__package_dpkg(7)

      +
      +

      16.104.1. NAME

      cdist-type__package_dpkg - Manage packages with dpkg

      -
      -
      -

      16.103.2. DESCRIPTION

      +
      +
      +

      16.104.2. DESCRIPTION

      This type is used on Debian and variants (like Ubuntu) to install packages that are provided locally as *.deb files.

      The object given to this type must be the name of the deb package. The filename of the deb package has to follow Debian naming conventions, i.e. ${binary:Package}_${Version}_${Architecture}.deb (see dpkg-query(1) for details).

      - -
      -

      16.103.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.104.3. OPTIONAL PARAMETERS

      state

      present or absent, defaults to present.

      - -
      -

      16.103.4. REQUIRED PARAMETERS

      +
      +
      +

      16.104.4. REQUIRED PARAMETERS

      source

      path to the *.deb package

      - -
      -

      16.103.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.104.5. BOOLEAN PARAMETERS

      purge-if-absent

      If this parameter is given when state is absent, the package is purged from the system (using --purge).

      - -
      -

      16.103.6. EXPLORER

      +
      +
      +

      16.104.6. EXPLORER

      pkg_state

      Returns the full package name if package is installed, empty otherwise.

      - -
      -

      16.103.7. MESSAGES

      +
      +
      +

      16.104.7. MESSAGES

      installed

      The deb-file was installed.

      @@ -426,9 +434,9 @@ purged from the system (using --purge).

      removed (--purge)

      The package was removed including config (purged).

      - -
      -

      16.103.8. EXAMPLES

      +
      +
      +

      16.104.8. EXAMPLES

      # Install foo and bar packages
 __package_dpkg foo_0.1_all.deb --source /tmp/foo_0.1_all.deb
 __package_dpkg bar_1.4.deb --source $__type/files/bar_1.4.deb
@@ -444,56 +452,56 @@ __package_dpkg baz_1.4_amd64.deb \
     --state "absent"
      - -
      -

      16.103.9. SEE ALSO

      +
      +
      +

      16.104.9. SEE ALSO

      cdist-type__package(7), dpkg-query(1)

      - -
      -

      16.103.10. AUTHORS

      +
      +
      +

      16.104.10. AUTHORS

      Tomas Pospisek <tpo_deb--@--sourcepole.ch>
      Thomas Eckert <tom--@--it-eckert.de>
      - -
      -

      16.103.11. COPYING

      +
      +
      +

      16.104.11. COPYING

      Copyright (C) 2013 Tomas Pospisek. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This type is based on __package_apt.

      - - +
      +
    - @@ -502,7 +510,6 @@ This type is based on __package_apt.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.104. cdist-type__package_emerge(7)
      • +
    • 16.105. cdist-type__package_emerge(7)
    • - + View page source @@ -369,25 +377,25 @@
      -
      -

      16.104. cdist-type__package_emerge(7)

      -
      -

      16.104.1. NAME

      +
      +

      16.105. cdist-type__package_emerge(7)

      +
      +

      16.105.1. NAME

      cdist-type__package_emerge - Manage packages with portage

      -
      -
      -

      16.104.2. DESCRIPTION

      +
      +
      +

      16.105.2. DESCRIPTION

      Portage is usually used on the gentoo distribution to manage packages. This type requires app-portage/gentoolkit installed on the target host. cdist-type__package_emerge_dependencies is supposed to install the needed packages on the target host.

      - -
      -

      16.104.3. REQUIRED PARAMETERS

      +
      +
      +

      16.105.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.104.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.105.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -396,9 +404,9 @@ packages on the target host.

      version

      If supplied, use to install or uninstall a specific version of the package named.

      - -
      -

      16.104.5. EXAMPLES

      +
      +
      +

      16.105.5. EXAMPLES

      # Ensure sys-devel/gcc is installed
 __package_emerge sys-devel/gcc --state present
 
@@ -409,52 +417,52 @@ __package_emerge app-portage/gentoolkit --state present --version 
-
      16.104.6. SEE ALSO
      
+
      +
      +

      16.105.6. SEE ALSO

      cdist-type__package(7), cdist-type__package_emerge_dependencies(7)

      - -
      -

      16.104.7. AUTHORS

      +
      +
      +

      16.105.7. AUTHORS

      Thomas Oettli <otho--@--sfs.biz>

      - -
      -

      16.104.8. COPYING

      +
      +
      +

      16.105.8. COPYING

      Copyright (C) 2013 Thomas Oettli. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
      -
    @@ -463,7 +471,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.105. cdist-type__package_emerge_dependencies(7)
      • +
    • 16.106. cdist-type__package_emerge_dependencies(7)
    • - + View page source @@ -369,81 +377,81 @@
      -
      -

      16.105. cdist-type__package_emerge_dependencies(7)

      -
      -

      16.105.1. NAME

      +
      +

      16.106. cdist-type__package_emerge_dependencies(7)

      +
      +

      16.106.1. NAME

      cdist-type__package_emerge_dependencies - Install dependencies for __package_emerge

      -
      -
      -

      16.105.2. DESCRIPTION

      +
      +
      +

      16.106.2. DESCRIPTION

      Portage is usually used on the gentoo distribution to manage packages. This type installs the following tools which are required by __package_emerge to work:

      • app-portage/flaggie

      • app-portage/gentoolkit

      - -
      -

      16.105.3. REQUIRED PARAMETERS

      +
      +
      +

      16.106.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.105.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.106.4. OPTIONAL PARAMETERS

      None

      - -
      -

      16.105.5. EXAMPLES

      +
      +
      +

      16.106.5. EXAMPLES

      # Ensure app-portage/flaggie and app-portage/gentoolkit are installed
 __package_emerge_dependencies
      - -
      -

      16.105.6. SEE ALSO

      +
      +
      +

      16.106.6. SEE ALSO

      cdist-type__package(7), cdist-type__package_emerge(7)

      - -
      -

      16.105.7. AUTHORS

      +
      +
      +

      16.106.7. AUTHORS

      Thomas Oettli <otho--@--sfs.biz>

      - -
      -

      16.105.8. COPYING

      +
      +
      +

      16.106.8. COPYING

      Copyright (C) 2013 Thomas Oettli. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -452,7 +460,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.106. cdist-type__package_luarocks(7)
      • +
    • 16.107. cdist-type__package_luarocks(7)
    • - + View page source @@ -369,31 +377,31 @@
      -
      -

      16.106. cdist-type__package_luarocks(7)

      -
      -

      16.106.1. NAME

      +
      +

      16.107. cdist-type__package_luarocks(7)

      +
      +

      16.107.1. NAME

      cdist-type__package_luarocks - Manage luarocks packages

      -
      -
      -

      16.106.2. DESCRIPTION

      +
      +
      +

      16.107.2. DESCRIPTION

      LuaRocks is a deployment and management system for Lua modules.

      - -
      -

      16.106.3. REQUIRED PARAMETERS

      +
      +
      +

      16.107.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.106.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.107.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.106.5. EXAMPLES

      +
      +
      +

      16.107.5. EXAMPLES

      # Ensure luasocket is installed
 __package_luarocks luasocket --state present
 
@@ -401,52 +409,52 @@ __package_luarocks luasocket --state present
 __package_luarocks luasocket --state absent
      - -
      -

      16.106.6. SEE ALSO

      +
      +
      +

      16.107.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.106.7. AUTHORS

      +
      +
      +

      16.107.7. AUTHORS

      Christian G. Warden <cwarden@xerus.org>

      - -
      -

      16.106.8. COPYING

      +
      +
      +

      16.107.8. COPYING

      Copyright (C) 2012 SwellPath, Inc. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.107. cdist-type__package_opkg(7)
      • +
    • 16.108. cdist-type__package_opkg(7)
    • - + View page source @@ -369,31 +377,31 @@
      -
      -

      16.107. cdist-type__package_opkg(7)

      -
      -

      16.107.1. NAME

      +
      +

      16.108. cdist-type__package_opkg(7)

      +
      +

      16.108.1. NAME

      cdist-type__package_opkg - Manage packages with opkg

      -
      -
      -

      16.107.2. DESCRIPTION

      +
      +
      +

      16.108.2. DESCRIPTION

      opkg is usually used on OpenWRT to manage packages.

      - -
      -

      16.107.3. REQUIRED PARAMETERS

      +
      +
      +

      16.108.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.107.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.108.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.107.5. EXAMPLES

      +
      +
      +

      16.108.5. EXAMPLES

      # Ensure lsof is installed
 __package_opkg lsof --state present
 
@@ -401,52 +409,52 @@ __package_opkg lsof --state present
 __package_opkg dnsmasq --state absent
      - -
      -

      16.107.6. SEE ALSO

      +
      +
      +

      16.108.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.107.7. AUTHORS

      +
      +
      +

      16.108.7. AUTHORS

      Giel van Schijndel <giel+cdist--@--mortis.eu>

      - -
      -

      16.107.8. COPYING

      +
      +
      +

      16.108.8. COPYING

      Copyright (C) 2012 Giel van Schijndel. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.108. cdist-type__package_pacman(7)
      • +
    • 16.109. cdist-type__package_pacman(7)
    • - + View page source @@ -369,31 +377,31 @@
      -
      -

      16.108. cdist-type__package_pacman(7)

      -
      -

      16.108.1. NAME

      +
      +

      16.109. cdist-type__package_pacman(7)

      +
      +

      16.109.1. NAME

      cdist-type__package_pacman - Manage packages with pacman

      -
      -
      -

      16.108.2. DESCRIPTION

      +
      +
      +

      16.109.2. DESCRIPTION

      Pacman is usually used on the Archlinux distribution to manage packages.

      - -
      -

      16.108.3. REQUIRED PARAMETERS

      +
      +
      +

      16.109.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.108.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.109.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.108.5. EXAMPLES

      +
      +
      +

      16.109.5. EXAMPLES

      # Ensure zsh in installed
 __package_pacman zsh --state present
 
@@ -404,52 +412,52 @@ __package_pacman python --state present --name python2
 __package_pacman puppet --state absent
      - -
      -

      16.108.6. SEE ALSO

      +
      +
      +

      16.109.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.108.7. AUTHORS

      +
      +
      +

      16.109.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.108.8. COPYING

      +
      +
      +

      16.109.8. COPYING

      Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -458,7 +466,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.109. cdist-type__package_pip(7)
      • +
    • 16.110. cdist-type__package_pip(7)
    • - + View page source @@ -369,23 +377,23 @@
      -
      -

      16.109. cdist-type__package_pip(7)

      -
      -

      16.109.1. NAME

      +
      +

      16.110. cdist-type__package_pip(7)

      +
      +

      16.110.1. NAME

      cdist-type__package_pip - Manage packages with pip

      -
      -
      -

      16.109.2. DESCRIPTION

      +
      +
      +

      16.110.2. DESCRIPTION

      Pip is used in Python environments to install packages. It is also included in the python virtualenv environment.

      - -
      -

      16.109.3. REQUIRED PARAMETERS

      +
      +
      +

      16.110.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.109.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.110.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -404,9 +412,9 @@ management for orphaned packages and they may be used by other packages.

      runas

      Run pip as specified user. By default it runs as root.

      - -
      -

      16.109.5. EXAMPLES

      +
      +
      +

      16.110.5. EXAMPLES

      # Install a package
 __package_pip pyro --state present
 
@@ -425,55 +433,55 @@ __package_pip mautrix-telegram --extra speedups,webp_convert,hq_thumbnails --ext
 __package_pip mautrix-telegram --extra all
      - -
      -

      16.109.6. SEE ALSO

      +
      +
      +

      16.110.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.109.7. AUTHORS

      +
      +
      +

      16.110.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>
      Matthias Stecher <matthiasstecher--@--gmx.de>
      - -
      -

      16.109.8. COPYING

      +
      +
      +

      16.110.8. COPYING

      Copyright (C) 2012 Nico Schottelius, 2021 Matthias Stecher. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -482,7 +490,6 @@ version 3 of the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.110. cdist-type__package_pkg_freebsd(7)
      • +
    • 16.111. cdist-type__package_pkg_freebsd(7)
    • - + View page source @@ -369,22 +377,22 @@
      -
      -

      16.110. cdist-type__package_pkg_freebsd(7)

      -
      -

      16.110.1. NAME

      +
      +

      16.111. cdist-type__package_pkg_freebsd(7)

      +
      +

      16.111.1. NAME

      cdist-type__package_pkg_freebsd - Manage FreeBSD packages

      -
      -
      -

      16.110.2. DESCRIPTION

      +
      +
      +

      16.111.2. DESCRIPTION

      This type is usually used on FreeBSD to manage packages.

      - -
      -

      16.110.3. REQUIRED PARAMETERS

      +
      +
      +

      16.111.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.110.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.111.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -397,9 +405,9 @@
      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.110.5. EXAMPLES

      +
      +
      +

      16.111.5. EXAMPLES

      # Ensure zsh is installed
 __package_pkg_freebsd zsh --state present
 
@@ -413,52 +421,52 @@ __package_pkg_freebsd python --state present --name python2
 __package_pkg_freebsd puppet --state absent
      - -
      -

      16.110.6. SEE ALSO

      +
      +
      +

      16.111.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.110.7. AUTHORS

      +
      +
      +

      16.111.7. AUTHORS

      Jake Guffey <jake.guffey--@--eprotex.com>

      - -
      -

      16.110.8. COPYING

      +
      +
      +

      16.111.8. COPYING

      Copyright (C) 2012 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -467,7 +475,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.111. cdist-type__package_pkg(7)
      • +
    • 16.112. cdist-type__package_pkg(7)
    • - + View page source @@ -369,22 +377,22 @@
      -
      -

      16.111. cdist-type__package_pkg(7)

      -
      -

      16.111.1. NAME

      +
      +

      16.112. cdist-type__package_pkg(7)

      +
      +

      16.112.1. NAME

      cdist-type__package_pkg - Manage OpenBSD packages

      -
      -
      -

      16.111.2. DESCRIPTION

      +
      +
      +

      16.112.2. DESCRIPTION

      This type is usually used on OpenBSD to manage packages.

      - -
      -

      16.111.3. REQUIRED PARAMETERS

      +
      +
      +

      16.112.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.111.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.112.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -397,9 +405,9 @@
      pkg_path

      Manually specify a PKG_PATH to add packages from.

      - -
      -

      16.111.5. EXAMPLES

      +
      +
      +

      16.112.5. EXAMPLES

      # Ensure zsh is installed
 __package_pkg_openbsd zsh --state present
 
@@ -417,50 +425,50 @@ __package_pkg_openbsd bash \
   --pkg_path http://openbsd.mirrorcatalogs.com/snapshots/packages/amd64
      - -
      -

      16.111.6. SEE ALSO

      +
      +
      +

      16.112.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.111.7. AUTHORS

      +
      +
      +

      16.112.7. AUTHORS

      Andi Brönnimann <andi-cdist--@--v-net.ch>

      - -
      -

      16.111.8. COPYING

      +
      +
      +

      16.112.8. COPYING

      Copyright (C) 2011 Andi Brönnimann. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

      - - +
      +
    - @@ -469,7 +477,6 @@ granted under the terms of the GNU General Public License version 3 (GPLv3).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -345,20 +351,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.112. cdist-type__package_pkgng_freebsd(7)
      • +
    • 16.113. cdist-type__package_pkgng_freebsd(7)
    • - + View page source @@ -372,22 +380,22 @@
      -
      -

      16.112. cdist-type__package_pkgng_freebsd(7)

      -
      -

      16.112.1. NAME

      +
      +

      16.113. cdist-type__package_pkgng_freebsd(7)

      +
      +

      16.113.1. NAME

      cdist-type__package_pkgng_freebsd - Manage FreeBSD packages with pkg-ng

      -
      -
      -

      16.112.2. DESCRIPTION

      +
      +
      +

      16.113.2. DESCRIPTION

      This type is usually used on FreeBSD to manage packages.

      - -
      -

      16.112.3. REQUIRED PARAMETERS

      +
      +
      +

      16.113.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.112.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.113.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -400,24 +408,24 @@
      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.112.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.113.5. BOOLEAN PARAMETERS

      upgrade

      If supplied, allow upgrading to the latest version of a package.

      - -
      -

      16.112.6. CAVEATS

      +
      +
      +

      16.113.6. CAVEATS

      This type requires that repository definitions already exist in /etc/pkg/*.conf. Ensure that they exist prior to use of this type with __file.

      pkg-ng can't upgrade a package to a specific version. If this type needs to upgrade a package, it can only ugprade to the latest available version. If the "upgrade" parameter is not given and an upgrade needs to occur, an error will result.

      - -
      -

      16.112.7. MESSAGES

      +
      +
      +

      16.113.7. MESSAGES

      install

      The package was installed

      @@ -428,9 +436,9 @@ upgrade a package, it can only ugprade to the latest available version. If the
      exist

      The package was already present and thus not installed

      - -
      -

      16.112.8. EXAMPLES

      +
      +
      +

      16.113.8. EXAMPLES

      # Ensure zsh is installed
 __package_pkgng_freebsd zsh --state present
 
@@ -447,52 +455,52 @@ __package_pkgng_freebsd bash --state present --repo myrepo
 __package_pkgng_freebsd puppet --state absent
      - -
      -

      16.112.9. SEE ALSO

      +
      +
      +

      16.113.9. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.112.10. AUTHORS

      +
      +
      +

      16.113.10. AUTHORS

      Jake Guffey <jake.guffey--@--eprotex.com>

      - -
      -

      16.112.11. COPYING

      +
      +
      +

      16.113.11. COPYING

      Copyright (C) 2014 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -501,7 +509,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.113. cdist-type__package_rubygem(7)
      • +
    • 16.114. cdist-type__package_rubygem(7)
    • - + View page source @@ -369,31 +377,31 @@
      -
      -

      16.113. cdist-type__package_rubygem(7)

      -
      -

      16.113.1. NAME

      +
      +

      16.114. cdist-type__package_rubygem(7)

      +
      +

      16.114.1. NAME

      cdist-type__package_rubygem - Manage rubygem packages

      -
      -
      -

      16.113.2. DESCRIPTION

      +
      +
      +

      16.114.2. DESCRIPTION

      Rubygems is the default package management system for the Ruby programming language.

      - -
      -

      16.113.3. REQUIRED PARAMETERS

      +
      +
      +

      16.114.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.113.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.114.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      state

      Either "present" or "absent", defaults to "present"

      - -
      -

      16.113.5. EXAMPLES

      +
      +
      +

      16.114.5. EXAMPLES

      # Ensure sinatra is installed
 __package_rubygem sinatra --state present
 
@@ -401,52 +409,52 @@ __package_rubygem sinatra --state present
 __package_rubygem rails --state absent
      - -
      -

      16.113.6. SEE ALSO

      +
      +
      +

      16.114.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.113.7. AUTHORS

      +
      +
      +

      16.114.7. AUTHORS

      Chase Allen James <nx-cdist@nu-ex.com>

      - -
      -

      16.113.8. COPYING

      +
      +
      +

      16.114.8. COPYING

      Copyright (C) 2011 Chase Allen James. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -455,7 +463,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.114. cdist-type__package_update_index(7)
      • +
    • 16.115. cdist-type__package_update_index(7)
    • - + View page source @@ -369,23 +377,23 @@
      -
      -

      16.114. cdist-type__package_update_index(7)

      -
      -

      16.114.1. NAME

      +
      +

      16.115. cdist-type__package_update_index(7)

      +
      +

      16.115.1. NAME

      cdist-type__update_index - Update the package index

      -
      -
      -

      16.114.2. DESCRIPTION

      +
      +
      +

      16.115.2. DESCRIPTION

      This cdist type allows you to update the package index on the target. It will automatically use the appropriate package manager.

      - -
      -

      16.114.3. REQUIRED PARAMETERS

      +
      +
      +

      16.115.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.114.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.115.4. OPTIONAL PARAMETERS

      type

      The package manager to use. Default is determined based on the $os explorer variable. @@ -398,17 +406,17 @@ e.g. last update. Repo update is skipped if maxage is not reached yet.

      - -
      -

      16.114.5. MESSAGES

      +
      +
      +

      16.115.5. MESSAGES

      apt-cache updated (age was: currage)

      apt-cache was updated (run of apt-get update). currage is the time in seconds since the previous run.

      - -
      -

      16.114.6. EXAMPLES

      +
      +
      +

      16.115.6. EXAMPLES

      # Update the package index on the target
 __package_update_index
 
@@ -422,52 +430,52 @@ __package_update_index --maxage 3600 --type apt
 __package_update_index --maxage 3600
      - -
      -

      16.114.7. AUTHORS

      +
      +
      +

      16.115.7. AUTHORS

      Ricardo Catalinas Jiménez <jimenezrick--@--gmail.com>
      Thomas Eckert <tom--@--it-eckert.de>
      Stu Zhao <z12y12l12--@--gmail.com>
      - -
      -

      16.114.8. COPYING

      +
      +
      +

      16.115.8. COPYING

      Copyright (C) 2014 Ricardo Catalinas Jiménez. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -476,7 +484,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.115. cdist-type__package_upgrade_all(7)
      • +
    • 16.116. cdist-type__package_upgrade_all(7)
    • - + View page source @@ -369,23 +377,23 @@
      -
      -

      16.115. cdist-type__package_upgrade_all(7)

      -
      -

      16.115.1. NAME

      +
      +

      16.116. cdist-type__package_upgrade_all(7)

      +
      +

      16.116.1. NAME

      cdist-type__package_upgrade_all - Upgrade all the installed packages

      -
      -
      -

      16.115.2. DESCRIPTION

      +
      +
      +

      16.116.2. DESCRIPTION

      This cdist type allows you to upgrade all the installed packages on the target. It will automatically use the appropriate package manager.

      - -
      -

      16.115.3. REQUIRED PARAMETERS

      +
      +
      +

      16.116.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.115.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.116.4. OPTIONAL PARAMETERS

      type

      The package manager to use. Default is determined based on the $os explorer variable. @@ -395,18 +403,18 @@ e.g. * pacman for Arch Linux

      - -
      -

      16.115.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.116.5. BOOLEAN PARAMETERS

      apt-dist-upgrade

      Do dist-upgrade instead of upgrade.

      apt-clean

      Clean out the local repository of retrieved package files.

      - -
      -

      16.115.6. EXAMPLES

      +
      +
      +

      16.116.6. EXAMPLES

      # Upgrade all the installed packages on the target
 __package_upgrade_all
 
@@ -414,48 +422,48 @@ __package_upgrade_all
 __package_upgrade_all --type apt
      - -
      -

      16.115.7. AUTHORS

      +
      +
      +

      16.116.7. AUTHORS

      Ricardo Catalinas Jiménez <jimenezrick--@--gmail.com>

      - -
      -

      16.115.8. COPYING

      +
      +
      +

      16.116.8. COPYING

      Copyright (C) 2014 Ricardo Catalinas Jiménez. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -464,7 +472,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.116. cdist-type__package_yum(7)
      • +
    • 16.117. cdist-type__package_yum(7)
    • - + View page source @@ -369,24 +377,24 @@
      -
      -

      16.116. cdist-type__package_yum(7)

      -
      -

      16.116.1. NAME

      +
      +

      16.117. cdist-type__package_yum(7)

      +
      +

      16.117.1. NAME

      cdist-type__package_yum - Manage packages with yum

      -
      -
      -

      16.116.2. DESCRIPTION

      +
      +
      +

      16.117.2. DESCRIPTION

      Yum is usually used on the Fedora distribution to manage packages. If you specify an unknown package, yum will display the slightly confusing error message "Error: Nothing to do".

      - -
      -

      16.116.3. REQUIRED PARAMETERS

      +
      +
      +

      16.117.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.116.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.117.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -395,9 +403,9 @@ slightly confusing error message "Error: Nothing to do".

      url

      URL to use for the package

      - -
      -

      16.116.5. EXAMPLES

      +
      +
      +

      16.117.5. EXAMPLES

      # Ensure zsh in installed
 __package_yum zsh --state present
 
@@ -411,52 +419,52 @@ __package epel-release-6-8 \
     --url http://mirror.switch.ch/ftp/mirror/epel/6/i386/epel-release-6-8.noarch.rpm
      - -
      -

      16.116.6. SEE ALSO

      +
      +
      +

      16.117.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.116.7. AUTHORS

      +
      +
      +

      16.117.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.116.8. COPYING

      +
      +
      +

      16.117.8. COPYING

      Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -465,7 +473,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.117. cdist-type__package_zypper(7)
      • +
    • 16.118. cdist-type__package_zypper(7)
    • - + View page source @@ -369,22 +377,22 @@
      -
      -

      16.117. cdist-type__package_zypper(7)

      -
      -

      16.117.1. NAME

      +
      +

      16.118. cdist-type__package_zypper(7)

      +
      +

      16.118.1. NAME

      cdist-type__package_zypper - Manage packages with zypper

      -
      -
      -

      16.117.2. DESCRIPTION

      +
      +
      +

      16.118.2. DESCRIPTION

      Zypper is usually used on the SuSE distribution to manage packages.

      - -
      -

      16.117.3. REQUIRED PARAMETERS

      +
      +
      +

      16.118.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.117.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.118.4. OPTIONAL PARAMETERS

      name

      If supplied, use the name and not the object id as the package name.

      @@ -397,9 +405,9 @@ have a look at the output of "zypper se -s packagename"

      ptype

      Either "package", "patch", "pattern", "product" or "srcpackage", defaults to "package". For a description see man zypper.

      - -
      -

      16.117.5. EXAMPLES

      +
      +
      +

      16.118.5. EXAMPLES

      # Ensure zsh is installed
 __package_zypper zsh --state present
 
@@ -416,53 +424,53 @@ __package_zypper cfengine --state absent
 __package_zypper x11 --ptype pattern --state present
      - -
      -

      16.117.6. SEE ALSO

      +
      +
      +

      16.118.6. SEE ALSO

      cdist-type__package(7)

      - -
      -

      16.117.7. AUTHORS

      +
      +
      +

      16.118.7. AUTHORS

      Daniel Heule <hda--@--sfs.biz>

      - -
      -

      16.117.8. COPYING

      +
      +
      +

      16.118.8. COPYING

      Copyright (C) 2012 Nico Schottelius. Copyright (C) 2013 Daniel Heule. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -471,7 +479,6 @@ either version 3 of the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.118. cdist-type__pacman_conf(7)
      • +
    • 16.119. cdist-type__pacman_conf(7)
    • - + View page source @@ -369,18 +377,18 @@
      -
      -

      16.118. cdist-type__pacman_conf(7)

      -
      -

      16.118.1. NAME

      +
      +

      16.119. cdist-type__pacman_conf(7)

      +
      +

      16.119.1. NAME

      cdist-type__pacman_conf - Manage pacman configuration

      -
      -
      -

      16.118.2. DESCRIPTION

      +
      +
      +

      16.119.2. DESCRIPTION

      The type allows you to configure options section, add or delete repositories and manage mirrorlists

      - -
      -

      16.118.3. REQUIRED PARAMETERS

      +
      +
      +

      16.119.3. REQUIRED PARAMETERS

      section

      'options' for configure options section

      Otherwise it specifies a repository or a plain file

      @@ -392,9 +400,9 @@ be checked against available keys from pacman.conf

      value

      Specifies the value which will be set against the key

      - -
      -

      16.118.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.119.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      @@ -403,9 +411,9 @@ be checked against available keys from pacman.conf

      If supplied the key will not be checked.

      - -
      -

      16.118.5. EXAMPLES

      +
      +
      +

      16.119.5. EXAMPLES

      # Manage options section in pacman.conf
 __pacman_conf options_Architecture --section options --key Architecture --value auto
 
@@ -417,52 +425,52 @@ __pacman_conf customlist_Server --file customlist --section customlist --key Ser
     --value "file:///var/cache/pacman/pkg"
      - -
      -

      16.118.6. SEE ALSO

      +
      +
      +

      16.119.6. SEE ALSO

      grep(1)

      - -
      -

      16.118.7. AUTHORS

      +
      +
      +

      16.119.7. AUTHORS

      Dominique Roux <dominique.roux4@gmail.com>

      - -
      -

      16.118.8. COPYING

      +
      +
      +

      16.119.8. COPYING

      Copyright (C) 2015 Dominique Roux. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -471,7 +479,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.119. cdist-type__pacman_conf_integrate(7)
      • +
    • 16.120. cdist-type__pacman_conf_integrate(7)
    • - + View page source @@ -369,29 +377,29 @@
      -
      -

      16.119. cdist-type__pacman_conf_integrate(7)

      -
      -

      16.119.1. NAME

      +
      +

      16.120. cdist-type__pacman_conf_integrate(7)

      +
      +

      16.120.1. NAME

      cdist-type__pacman_conf_integrate - Integrate default pacman.conf to cdist conform and vice versa

      -
      -
      -

      16.119.2. DESCRIPTION

      +
      +
      +

      16.120.2. DESCRIPTION

      The type allows you to convert the default pacman.conf to a cdist conform one and vice versa

      - -
      -

      16.119.3. REQUIRED PARAMETERS

      +
      +
      +

      16.120.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.119.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.120.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent', defaults to 'present'

      - -
      -

      16.119.5. EXAMPLES

      +
      +
      +

      16.120.5. EXAMPLES

      # Convert normal to cdist conform
 __pacman_conf_integrate convert
 
@@ -399,52 +407,52 @@ __pacman_conf_integrate convert
 __pacman_conf_integrate convert --state absent
      - -
      -

      16.119.6. SEE ALSO

      +
      +
      +

      16.120.6. SEE ALSO

      grep(1)

      - -
      -

      16.119.7. AUTHORS

      +
      +
      +

      16.120.7. AUTHORS

      Dominique Roux <dominique.roux4@gmail.com>

      - -
      -

      16.119.8. COPYING

      +
      +
      +

      16.120.8. COPYING

      Copyright (C) 2015 Dominique Roux. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -453,7 +461,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.120. cdist-type__pf_apply_anchor(7)
      • +
    • 16.121. cdist-type__pf_apply_anchor(7)
    • - + View page source @@ -368,29 +376,29 @@
      -
      -

      16.120. cdist-type__pf_apply_anchor(7)

      -
      -

      16.120.1. NAME

      +
      +

      16.121. cdist-type__pf_apply_anchor(7)

      +
      +

      16.121.1. NAME

      cdist-type__pf_apply_anchor - Apply a pf(4) anchor on $__target_host

      -
      -
      -

      16.120.2. DESCRIPTION

      +
      +
      +

      16.121.2. DESCRIPTION

      This type is used on *BSD systems to manage anchors for the pf firewall.

      Notice this type does not take care of copying the ruleset, that must be done by the user with, e.g. __file.

      - -
      -

      16.120.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.121.3. OPTIONAL PARAMETERS

      anchor_name

      The name of the anchor to apply. If not set, ${__object_id} is used. This type requires /etc/pf.d/${anchor_name} to exist on $__target_host.

      - -
      -

      16.120.4. EXAMPLES

      +
      +
      +

      16.121.4. EXAMPLES

      # Copy anchor file to ${__target_host}
 __file "/etc/pf.d/80_dns" --source - <<EOF
 # Managed remotely, changes will be lost
@@ -404,56 +412,56 @@ __file "/etc/pf.d/80_dns" --source - #   pfctl -a "${anchor_name}" -f "/etc/pf.d/${anchor_name}"
      - -
      -

      16.120.5. SEE ALSO

      +
      +
      +

      16.121.5. SEE ALSO

      pf(4)

      - -
      -

      16.120.6. AUTHORS

      +
      +
      +

      16.121.6. AUTHORS

      Evilham <contact--@--evilham.com> Kamila Součková <coding--@--kamila.is> Jake Guffey <jake.guffey--@--eprotex.com>

      - -
      -

      16.120.7. COPYING

      +
      +
      +

      16.121.7. COPYING

      Copyright (C) 2020 Evilham. Copyright (C) 2016 Kamila Součková. Copyright (C) 2012 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -462,7 +470,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.121. cdist-type__pf_ruleset(7)
      • +
    • 16.122. cdist-type__pf_ruleset(7)
    • - + View page source @@ -369,35 +377,35 @@
      -
      -

      16.121. cdist-type__pf_ruleset(7)

      -
      -

      16.121.1. NAME

      +
      +

      16.122. cdist-type__pf_ruleset(7)

      +
      +

      16.122.1. NAME

      cdist-type__pf_ruleset - Copy a pf(4) ruleset to $__target_host

      -
      -
      -

      16.121.2. DESCRIPTION

      +
      +
      +

      16.122.2. DESCRIPTION

      This type is used on *BSD systems to manage the pf firewall's ruleset.

      It will also enable and disable the pf firewall as requested in the state parameter.

      - -
      -

      16.121.3. REQUIRED PARAMETERS

      +
      +
      +

      16.122.3. REQUIRED PARAMETERS

      state

      Either "absent" (no ruleset at all) or "present", defaults to "present".

      - -
      -

      16.121.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.122.4. OPTIONAL PARAMETERS

      source

      Required when state is "present". Defines the ruleset to load onto the $__target_host for pf(4).

      - -
      -

      16.121.5. EXAMPLES

      +
      +
      +

      16.122.5. EXAMPLES

      # Remove the current ruleset in place and disable pf
 __pf_ruleset --state absent
 
@@ -405,54 +413,54 @@ __pf_ruleset --state absent
 __pf_ruleset --state present --source $__manifest/files/pf.conf
      - -
      -

      16.121.6. SEE ALSO

      +
      +
      +

      16.122.6. SEE ALSO

      pf(4)

      - -
      -

      16.121.7. AUTHORS

      +
      +
      +

      16.122.7. AUTHORS

      Kamila Součková <coding--@--kamila.is> Jake Guffey <jake.guffey--@--eprotex.com>

      - -
      -

      16.121.8. COPYING

      +
      +
      +

      16.122.8. COPYING

      Copyright (C) 2016 Kamila Součková. Copyright (C) 2012 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -461,7 +469,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.122. cdist-type__ping(7)
      • +
    • 16.123. cdist-type__ping(7)
    • - + View page source @@ -368,72 +376,72 @@
      -
      -

      16.122. cdist-type__ping(7)

      -
      -

      16.122.1. NAME

      +
      +

      16.123. cdist-type__ping(7)

      +
      +

      16.123.1. NAME

      cdist-type__ping - Try to connect to host and return 'pong' on success

      -
      -
      -

      16.122.2. DESCRIPTION

      +
      +
      +

      16.123.2. DESCRIPTION

      A simple type which tries to connect to a remote host and runs a simple command to ensure everything is working.

      - -
      -

      16.122.3. REQUIRED PARAMETERS

      +
      +
      +

      16.123.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.122.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.123.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.122.5. EXAMPLES

      +
      +
      +

      16.123.5. EXAMPLES

      __ping
      - -
      -

      16.122.6. AUTHORS

      +
      +
      +

      16.123.6. AUTHORS

      Olliver Schinagl <oliver--@--schinagl.nl>

      - -
      -

      16.122.7. COPYING

      +
      +
      +

      16.123.7. COPYING

      Copyright (C) 2018 Schinagl. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -442,7 +450,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.123. cdist-type__postfix(7)
      • +
    • 16.124. cdist-type__postfix(7)
    • - + View page source @@ -368,71 +376,71 @@
      -
      -

      16.123. cdist-type__postfix(7)

      -
      -

      16.123.1. NAME

      +
      +

      16.124. cdist-type__postfix(7)

      +
      +

      16.124.1. NAME

      cdist-type__postfix - Install postfix

      -
      -
      -

      16.123.2. DESCRIPTION

      +
      +
      +

      16.124.2. DESCRIPTION

      This space intentionally left blank.

      - -
      -

      16.123.3. REQUIRED PARAMETERS

      +
      +
      +

      16.124.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.123.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.124.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.123.5. EXAMPLES

      +
      +
      +

      16.124.5. EXAMPLES

      __postfix
      - -
      -

      16.123.6. AUTHORS

      +
      +
      +

      16.124.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.123.7. COPYING

      +
      +
      +

      16.124.7. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -441,7 +449,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.124. cdist-type__postfix_master(7)
      • +
    • 16.125. cdist-type__postfix_master(7)
    • - + View page source @@ -370,34 +378,34 @@
      -
      -

      16.124. cdist-type__postfix_master(7)

      -
      -

      16.124.1. NAME

      +
      +

      16.125. cdist-type__postfix_master(7)

      +
      +

      16.125.1. NAME

      cdist-type__postfix_master - Configure postfix master.cf

      -
      -
      -

      16.124.2. DESCRIPTION

      +
      +
      +

      16.125.2. DESCRIPTION

      See master(5) for more information.

      - -
      -

      16.124.3. REQUIRED PARAMETERS

      +
      +
      +

      16.125.3. REQUIRED PARAMETERS

      type

      See master(5)

      command

      See master(5)

      - -
      -

      16.124.4. BOOLEAN PARAMETERS

      +
      +
      +

      16.125.4. BOOLEAN PARAMETERS

      noreload

      don't reload postfix after changes

      - -
      -

      16.124.5. OPTIONAL PARAMETERS

      +
      +
      +

      16.125.5. OPTIONAL PARAMETERS

      state

      present or absent, defaults to present

      @@ -415,9 +423,9 @@ Can be specified multiple times.

      comment

      a textual comment to add with the master.cf entry

      - -
      -

      16.124.6. EXAMPLES

      +
      +
      +

      16.125.6. EXAMPLES

      __postfix_master smtp --type inet --command smtpd
 
 __postfix_master smtp --type inet --chroot y --command smtpd \
@@ -429,52 +437,52 @@ __postfix_master submission --type inet --command smtpd \"Run alternative smtp on submission port"
      - -
      -

      16.124.7. SEE ALSO

      +
      +
      +

      16.125.7. SEE ALSO

      master(5)

      - -
      -

      16.124.8. AUTHORS

      +
      +
      +

      16.125.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.124.9. COPYING

      +
      +
      +

      16.125.9. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -483,7 +491,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.125. cdist-type__postfix_postconf(7)
      • +
    • 16.126. cdist-type__postfix_postconf(7)
    • - + View page source @@ -369,85 +377,85 @@
      -
      -

      16.125. cdist-type__postfix_postconf(7)

      -
      -

      16.125.1. NAME

      +
      +

      16.126. cdist-type__postfix_postconf(7)

      +
      +

      16.126.1. NAME

      cdist-type__postfix_postconf - Configure postfix main.cf

      -
      -
      -

      16.125.2. DESCRIPTION

      +
      +
      +

      16.126.2. DESCRIPTION

      See postconf(5) for possible keys and values.

      Note that this type directly runs the postconf executable. It does not make changes to /etc/postfix/main.cf itself.

      - -
      -

      16.125.3. REQUIRED PARAMETERS

      +
      +
      +

      16.126.3. REQUIRED PARAMETERS

      value

      the value for the postfix parameter

      - -
      -

      16.125.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.126.4. OPTIONAL PARAMETERS

      key

      the name of the parameter. Defaults to __object_id

      - -
      -

      16.125.5. EXAMPLES

      +
      +
      +

      16.126.5. EXAMPLES

      __postfix_postconf mydomain --value somedomain.com
 
 __postfix_postconf bind-to-special-ip --key smtp_bind_address --value 127.0.0.5
      - -
      -

      16.125.6. SEE ALSO

      +
      +
      +

      16.126.6. SEE ALSO

      postconf(5)

      - -
      -

      16.125.7. AUTHORS

      +
      +
      +

      16.126.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.125.8. COPYING

      +
      +
      +

      16.126.8. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -456,7 +464,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.126. cdist-type__postfix_postmap(7)
      • +
    • 16.127. cdist-type__postfix_postmap(7)
    • - + View page source @@ -368,71 +376,71 @@
      -
      -

      16.126. cdist-type__postfix_postmap(7)

      -
      -

      16.126.1. NAME

      +
      +

      16.127. cdist-type__postfix_postmap(7)

      +
      +

      16.127.1. NAME

      cdist-type__postfix_postmap - Run postmap on the given file

      -
      -
      -

      16.126.2. DESCRIPTION

      +
      +
      +

      16.127.2. DESCRIPTION

      This space intentionally left blank.

      - -
      -

      16.126.3. REQUIRED PARAMETERS

      +
      +
      +

      16.127.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.126.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.127.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.126.5. EXAMPLES

      +
      +
      +

      16.127.5. EXAMPLES

      __postfix_postmap /etc/postfix/generic
      - -
      -

      16.126.6. AUTHORS

      +
      +
      +

      16.127.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.126.7. COPYING

      +
      +
      +

      16.127.7. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -441,7 +449,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.127. cdist-type__postfix_reload(7)
      • +
    • 16.128. cdist-type__postfix_reload(7)
    • - + View page source @@ -368,71 +376,71 @@
      -
      -

      16.127. cdist-type__postfix_reload(7)

      -
      -

      16.127.1. NAME

      +
      +

      16.128. cdist-type__postfix_reload(7)

      +
      +

      16.128.1. NAME

      cdist-type__postfix_reload - Tell postfix to reload its configuration

      -
      -
      -

      16.127.2. DESCRIPTION

      +
      +
      +

      16.128.2. DESCRIPTION

      This space intentionally left blank.

      - -
      -

      16.127.3. REQUIRED PARAMETERS

      +
      +
      +

      16.128.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.127.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.128.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.127.5. EXAMPLES

      +
      +
      +

      16.128.5. EXAMPLES

      __postfix_reload
      - -
      -

      16.127.6. AUTHORS

      +
      +
      +

      16.128.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.127.7. COPYING

      +
      +
      +

      16.128.7. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -441,7 +449,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.128. cdist-type__postgres_conf(7)
      • +
    • 16.129. cdist-type__postgres_conf(7)
    • - + View page source @@ -370,37 +378,37 @@
      -
      -

      16.128. cdist-type__postgres_conf(7)

      -
      -

      16.128.1. NAME

      +
      +

      16.129. cdist-type__postgres_conf(7)

      +
      +

      16.129.1. NAME

      cdist-type__postgres_conf - Alter PostgreSQL configuration

      -
      -
      -

      16.128.2. DESCRIPTION

      +
      +
      +

      16.129.2. DESCRIPTION

      Configure a running PostgreSQL server using ALTER SYSTEM.

      - -
      -

      16.128.3. REQUIRED PARAMETERS

      +
      +
      +

      16.129.3. REQUIRED PARAMETERS

      value

      The value to set (can be omitted if --state is set to absent).

      - -
      -

      16.128.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.129.4. OPTIONAL PARAMETERS

      state

      present or absent. Defaults to present.

      - -
      -

      16.128.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.129.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.128.6. EXAMPLES

      +
      +
      +

      16.129.6. EXAMPLES

      # set timezone
 __postgres_conf timezone --value Europe/Zurich
 
@@ -408,53 +416,53 @@ __postgres_conf timezone --value Europe/Zurich
 __postgres_conf max_connections --state absent
      - -
      -

      16.128.7. SEE ALSO

      +
      +
      +

      16.129.7. SEE ALSO

      None.

      - -
      -

      16.128.8. AUTHORS

      +
      +
      +

      16.129.8. AUTHORS

      Beni Ruef (bernhard.ruef--@--ssrq-sds-fds.ch) Dennis Camera (dennis.camera--@--ssrq-sds-fds.ch)

      - -
      -

      16.128.9. COPYING

      +
      +
      +

      16.129.9. COPYING

      Copyright (C) 2019-2021 SSRQ (www.ssrq-sds-fds.ch). You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -463,7 +471,6 @@ the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.129. cdist-type__postgres_database(7)
      • +
    • 16.130. cdist-type__postgres_database(7)
    • - + View page source @@ -368,18 +376,18 @@
      -
      -

      16.129. cdist-type__postgres_database(7)

      -
      -

      16.129.1. NAME

      +
      +

      16.130. cdist-type__postgres_database(7)

      +
      +

      16.130.1. NAME

      cdist-type__postgres_database - Create/drop postgres databases

      -
      -
      -

      16.129.2. DESCRIPTION

      +
      +
      +

      16.130.2. DESCRIPTION

      This cdist type allows you to create or drop postgres databases.

      - -
      -

      16.129.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.130.3. OPTIONAL PARAMETERS

      state

      Either 'present' or 'absent', defaults to 'present'.

      @@ -394,58 +402,58 @@
      template

      Specifies the template database from which to build this database.

      - -
      -

      16.129.4. EXAMPLES

      +
      +
      +

      16.130.4. EXAMPLES

      __postgres_database mydbname --owner mydbusername
      - -
      -

      16.129.5. SEE ALSO

      +
      +
      +

      16.130.5. SEE ALSO

      cdist-type__postgres_role(7)

      - -
      -

      16.129.6. AUTHORS

      +
      +
      +

      16.130.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.129.7. COPYING

      +
      +
      +

      16.130.7. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -454,7 +462,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.130. cdist-type__postgres_extension(7)
      • +
    • 16.131. cdist-type__postgres_extension(7)
    • - + View page source @@ -368,14 +376,14 @@
      -
      -

      16.130. cdist-type__postgres_extension(7)

      -
      -

      16.130.1. NAME

      +
      +

      16.131. cdist-type__postgres_extension(7)

      +
      +

      16.131.1. NAME

      cdist-type__postgres_extension - Manage PostgreSQL extensions

      -
      -
      -

      16.130.2. DESCRIPTION

      +
      +
      +

      16.131.2. DESCRIPTION

      This cdist type allows you to manage PostgreSQL extensions.

      The __object_id to pass to __postgres_extension is of the form dbname:extension, e.g.:

      @@ -394,16 +402,16 @@ script, allowing that user to acquire superuser privileges.
      – https://www.postgresql.org/docs/13/sql-createextension.html#id-1.9.3.64.7
    - -
    -

    16.130.3. OPTIONAL PARAMETERS

    + +
    +

    16.131.3. OPTIONAL PARAMETERS

    state

    either present or absent, defaults to present.

    -
    -
    -

    16.130.4. EXAMPLES

    + +
    +

    16.131.4. EXAMPLES

    # Install extension unaccent into database rails_test
 __postgres_extension rails_test:unaccent
 
@@ -411,59 +419,59 @@ __postgres_extension rails_test:unaccent
 __postgres_extension rails_test:unaccent --state absent
    -
    -
    -

    16.130.5. SEE ALSO

    + +
    +

    16.131.5. SEE ALSO

    -
    -
    -

    16.130.6. AUTHORS

    + +
    +

    16.131.6. AUTHORS

    Tomas Pospisek <tpo_deb--@--sourcepole.ch>
    Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>
    -
    -
    -

    16.130.7. COPYING

    + +
    +

    16.131.7. COPYING

    Copyright (C) 2014 Tomas Pospisek, 2021 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

    -
    - + + - @@ -472,7 +480,6 @@ the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.131. cdist-type__postgres_role(7)
      • +
    • 16.132. cdist-type__postgres_role(7)
    • - + View page source @@ -369,18 +377,18 @@
      -
      -

      16.131. cdist-type__postgres_role(7)

      -
      -

      16.131.1. NAME

      +
      +

      16.132. cdist-type__postgres_role(7)

      +
      +

      16.132.1. NAME

      cdist-type__postgres_role - Manage postgres roles

      -
      -
      -

      16.131.2. DESCRIPTION

      +
      +
      +

      16.132.2. DESCRIPTION

      This cdist type allows you to create or drop postgres roles.

      - -
      -

      16.131.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.132.3. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      @@ -388,9 +396,9 @@

      All other parameters map directly to the corresponding postgres createrole parameters.

      password

      - -
      -

      16.131.4. BOOLEAN PARAMETERS

      +
      +
      +

      16.132.4. BOOLEAN PARAMETERS

      All parameter map directly to the corresponding postgres createrole parameters.

      login @@ -398,9 +406,9 @@ createdb createrole superuser inherit

      - -
      -

      16.131.5. EXAMPLES

      +
      +
      +

      16.132.5. EXAMPLES

      __postgres_role myrole
 
 __postgres_role myrole --password 'secret'
@@ -410,54 +418,54 @@ __postgres_role admin --password 'very-secret' -
 __postgres_role dbcustomer --password 'bla' --createdb
      - -
      -

      16.131.6. SEE ALSO

      +
      +
      +

      16.132.6. SEE ALSO

      cdist-type__postgres_database(7)

      postgresql documentation at: <http://www.postgresql.org/docs/current/static/sql-createrole.html>.

      - -
      -

      16.131.7. AUTHORS

      +
      +
      +

      16.132.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.131.8. COPYING

      +
      +
      +

      16.132.8. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -466,7 +474,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.132. cdist-type__process(7)
      • +
    • 16.133. cdist-type__process(7)
    • - + View page source @@ -369,18 +377,18 @@
      -
      -

      16.132. cdist-type__process(7)

      -
      -

      16.132.1. NAME

      +
      +

      16.133. cdist-type__process(7)

      +
      +

      16.133.1. NAME

      cdist-type__process - Start or stop process

      -
      -
      -

      16.132.2. DESCRIPTION

      +
      +
      +

      16.133.2. DESCRIPTION

      This cdist type allows you to define the state of a process.

      - -
      -

      16.132.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.133.3. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      @@ -394,18 +402,18 @@ the object id by cdist.

      start

      Executable to use for starting the process.

      - -
      -

      16.132.4. MESSAGES

      +
      +
      +

      16.133.4. MESSAGES

      started

      The process was started.

      stopped

      The process was stopped.

      - -
      -

      16.132.5. EXAMPLES

      +
      +
      +

      16.133.5. EXAMPLES

      # Start if not running
 __process /usr/sbin/syslog-ng --state present
 
@@ -427,55 +435,55 @@ __process rpcstatd --state present --start "/etc/init.d/st
     --name "rpc.statd.*"
      - -
      -

      16.132.6. SEE ALSO

      +
      +
      +

      16.133.6. SEE ALSO

      cdist-type__start_on_boot(7)

      - -
      -

      16.132.7. AUTHORS

      +
      +
      +

      16.133.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>
      Thomas Eckert <tom--@--it-eckert.de>
      - -
      -

      16.132.8. COPYING

      +
      +
      +

      16.133.8. COPYING

      Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -484,7 +492,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.133. cdist-type__prometheus_alertmanager(7)
      • +
    • 16.134. cdist-type__prometheus_alertmanager(7)
    • - + View page source @@ -370,95 +378,95 @@
      -
      -

      16.133. cdist-type__prometheus_alertmanager(7)

      -
      -

      16.133.1. NAME

      +
      +

      16.134. cdist-type__prometheus_alertmanager(7)

      +
      +

      16.134.1. NAME

      cdist-type__prometheus_alertmanager - install Alertmanager

      -
      -
      -

      16.133.2. DESCRIPTION

      +
      +
      +

      16.134.2. DESCRIPTION

      Install and configure Prometheus Alertmanager (https://prometheus.io/docs/alerting/alertmanager/).

      Note that due to significant differences between Prometheus 1.x and 2.x, only 2.x is supported. It is your responsibility to make sure that your package manager installs 2.x. (On Devuan Ascii, the parameter --install-from-backports helps.)

      - -
      -

      16.133.3. REQUIRED PARAMETERS

      +
      +
      +

      16.134.3. REQUIRED PARAMETERS

      config

      Alertmanager configuration file. It will be saved as /etc/alertmanager/alertmanager.yml on the target.

      - -
      -

      16.133.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.134.4. OPTIONAL PARAMETERS

      storage-path

      Where to put data. Default: /data/alertmanager. (Directory will be created if needed.)

      retention-days

      How long to retain data. Default: 90 days.

      - -
      -

      16.133.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.134.5. BOOLEAN PARAMETERS

      install-from-backports

      Valid on Devuan only. Will enable the backports apt source and install the package from there. Useful for getting a newer version.

      - -
      -

      16.133.6. EXAMPLES

      +
      +
      +

      16.134.6. EXAMPLES

      __prometheus_alertmanager \
     --install-from-backports \
     --config "$__manifest/files/alertmanager.yml" \
     --storage-path /data/alertmanager
      - -
      -

      16.133.7. SEE ALSO

      +
      +
      +

      16.134.7. SEE ALSO

      cdist-type__prometheus_server(7), cdist-type__grafana_dashboard(7), Prometheus alerting documentation: https://prometheus.io/docs/alerting/overview/

      - -
      -

      16.133.8. AUTHORS

      +
      +
      +

      16.134.8. AUTHORS

      Kamila Součková <kamila--@--ksp.sk>

      - -
      -

      16.133.9. COPYING

      +
      +
      +

      16.134.9. COPYING

      Copyright (C) 2018 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -467,7 +475,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.134. cdist-type__prometheus_exporter(7)
      • +
    • 16.135. cdist-type__prometheus_exporter(7)
    • - + View page source @@ -370,14 +378,14 @@
      -
      -

      16.134. cdist-type__prometheus_exporter(7)

      -
      -

      16.134.1. NAME

      +
      +

      16.135. cdist-type__prometheus_exporter(7)

      +
      +

      16.135.1. NAME

      cdist-type__prometheus_exporter - install some Prometheus exporters

      -
      -
      -

      16.134.2. DESCRIPTION

      +
      +
      +

      16.135.2. DESCRIPTION

      Install and configure some exporters to be used by the Prometheus monitoring system (https://prometheus.io/).

      This type creates a daemontools-compatible service directory under /service/$__object_id. Daemontools (or something compatible) must be installed (in particular, the command svc must be executable).

      @@ -389,82 +397,82 @@ as build tools (make, g++, etc.) must be available.

    • blackbox

    • ceph

    - -
    -

    16.134.3. REQUIRED PARAMETERS

    +
    +
    +

    16.135.3. REQUIRED PARAMETERS

    None

    - -
    -

    16.134.4. OPTIONAL PARAMETERS

    +
    +
    +

    16.135.4. OPTIONAL PARAMETERS

    exporter

    Which exporter to install and configure. Default: $__object_id. Currently supported: node, blackbox, ceph.

    - -
    -

    16.134.5. BOOLEAN PARAMETERS

    +
    +
    +

    16.135.5. BOOLEAN PARAMETERS

    add-consul-service

    Add this exporter as a Consul service for automatic service discovery.

    - -
    -

    16.134.6. EXAMPLES

    +
    +
    +

    16.135.6. EXAMPLES

    __daemontools
 __golang_from_vendor --version 1.9  # required for prometheus and many exporters
 
 require="__daemontools __golang_from_vendor" __prometheus_exporter node
    - -
    -

    16.134.7. SEE ALSO

    +
    +
    +

    16.135.7. SEE ALSO

    cdist-type__daemontools(7), cdist-type__golang_from_vendor(7), cdist-type__prometheus_server(7), Prometheus documentation: https://prometheus.io/docs/introduction/overview/

    - -
    -

    16.134.8. AUTHORS

    +
    +
    +

    16.135.8. AUTHORS

    Kamila Součková <kamila--@--ksp.sk>

    - -
    -

    16.134.9. COPYING

    +
    +
    +

    16.135.9. COPYING

    Copyright (C) 2017 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

    - - +
    + - @@ -473,7 +481,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.135. cdist-type__prometheus_server(7)
      • +
    • 16.136. cdist-type__prometheus_server(7)
    • - + View page source @@ -370,26 +378,26 @@
      -
      -

      16.135. cdist-type__prometheus_server(7)

      -
      -

      16.135.1. NAME

      +
      +

      16.136. cdist-type__prometheus_server(7)

      +
      +

      16.136.1. NAME

      cdist-type__prometheus_server - install Prometheus

      -
      -
      -

      16.135.2. DESCRIPTION

      +
      +
      +

      16.136.2. DESCRIPTION

      Install and configure Prometheus (https://prometheus.io/).

      Note that due to significant differences between Prometheus 1.x and 2.x, only 2.x is supported. It is your responsibility to make sure that your package manager installs 2.x. (On Devuan Ascii, the parameter --install-from-backports helps.)

      - -
      -

      16.135.3. REQUIRED PARAMETERS

      +
      +
      +

      16.136.3. REQUIRED PARAMETERS

      config

      Prometheus configuration file. It will be saved as /etc/prometheus/prometheus.yml on the target.

      - -
      -

      16.135.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.136.4. OPTIONAL PARAMETERS

      retention-days

      How long to keep data. Default: 30

      @@ -398,16 +406,16 @@
      storage-path

      Where to put data. Default: /data/prometheus. (Directory will be created if needed.)

      - -
      -

      16.135.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.136.5. BOOLEAN PARAMETERS

      install-from-backports

      Valid on Devuan only. Will enable the backports apt source and install the package from there. Useful for getting a newer version.

      - -
      -

      16.135.6. EXAMPLES

      +
      +
      +

      16.136.6. EXAMPLES

      PROMPORT=9090
 ALERTPORT=9093
 
@@ -419,53 +427,53 @@ __prometheus_server \
     --rule-files "$__manifest/files/*.rules"
      - -
      -

      16.135.7. SEE ALSO

      +
      +
      +

      16.136.7. SEE ALSO

      cdist-type__prometheus_alertmanager(7), cdist-type__grafana_dashboard(7), Prometheus documentation: https://prometheus.io/docs/introduction/overview/

      - -
      -

      16.135.8. AUTHORS

      +
      +
      +

      16.136.8. AUTHORS

      Kamila Součková <kamila--@--ksp.sk>

      - -
      -

      16.135.9. COPYING

      +
      +
      +

      16.136.9. COPYING

      Copyright (C) 2018 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -474,7 +482,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.136. cdist-type__pyvenv(7)
      • +
    • 16.137. cdist-type__pyvenv(7)
    • - + View page source @@ -368,26 +376,26 @@
      -
      -

      16.136. cdist-type__pyvenv(7)

      -
      -

      16.136.1. NAME

      +
      +

      16.137. cdist-type__pyvenv(7)

      +
      +

      16.137.1. NAME

      cdist-type__pyvenv - Create or remove python virtual environment

      -
      -
      -

      16.136.2. DESCRIPTION

      +
      +
      +

      16.137.2. DESCRIPTION

      This cdist type allows you to create or remove python virtual environment using pyvenv on python3 -m venv. It assumes pyvenv is already installed. Concrete package depends on concrete OS and/or OS version/distribution. Ensure this for e.g. in your init manifest as in the following example:

      - -
      -

      16.136.3. REQUIRED PARAMETERS

      +
      +
      +

      16.137.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.136.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.137.4. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      @@ -402,9 +410,9 @@ Ensure this for e.g. in your init manifest as in the following example:

      venvparams

      Specific parameters to pass to pyvenv invocation

      - -
      -

      16.136.5. EXAMPLES

      +
      +
      +

      16.137.5. EXAMPLES

      __pyvenv /home/services/djangoenv
 
 # Use specific pyvenv
@@ -417,46 +425,46 @@ __pyvenv /home/foo/fooenv --group foo --owner foo
 __pyvenv /home/services/djangoenv --venvparams "--copies --system-site-packages"
      - -
      -

      16.136.6. AUTHORS

      +
      +
      +

      16.137.6. AUTHORS

      Darko Poljak <darko.poljak--@--gmail.com>

      - -
      -

      16.136.7. COPYING

      +
      +
      +

      16.137.7. COPYING

      Copyright (C) 2016 Darko Poljak. Free use of this software is granted under the terms of the GNU General Public License v3 or later (GPLv3+).

      - - +
      +
    - @@ -465,7 +473,6 @@ granted under the terms of the GNU General Public License v3 or later (GPLv3+).< - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.137. cdist-type__qemu_img(7)
      • +
    • 16.138. cdist-type__qemu_img(7)
    • - + View page source @@ -368,19 +376,19 @@
      -
      -

      16.137. cdist-type__qemu_img(7)

      -
      -

      16.137.1. NAME

      +
      +

      16.138. cdist-type__qemu_img(7)

      +
      +

      16.138.1. NAME

      cdist-type__qemu_img - Manage VM disk images

      -
      -
      -

      16.137.2. DESCRIPTION

      +
      +
      +

      16.138.2. DESCRIPTION

      The qemu-img program is used to create qemu images for qemu and (qemu-)kvm.

      - -
      -

      16.137.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.138.3. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      @@ -388,9 +396,9 @@ qemu and (qemu-)kvm.

      Required if state is "present".

      - -
      -

      16.137.4. EXAMPLES

      +
      +
      +

      16.138.4. EXAMPLES

      # Create a 50G size image
 __qemu_img /home/services/kvm/vm/myvmname/system-disk --size 50G
 
@@ -398,52 +406,52 @@ __qemu_img /home/services/kvm/vm/myvmname/system-disk --size 50G
 __qemu_img /home/services/kvm/vm/myoldvm/system-disk --state absent
      - -
      -

      16.137.5. SEE ALSO

      +
      +
      +

      16.138.5. SEE ALSO

      qemu-img(1)

      - -
      -

      16.137.6. AUTHORS

      +
      +
      +

      16.138.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.137.7. COPYING

      +
      +
      +

      16.138.7. COPYING

      Copyright (C) 2012-2014 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -452,7 +460,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.138. cdist-type__rbenv(7)
      • +
    • 16.139. cdist-type__rbenv(7)
    • - + View page source @@ -367,28 +375,28 @@
      -
      -

      16.138. cdist-type__rbenv(7)

      -
      -

      16.138.1. NAME

      +
      +

      16.139. cdist-type__rbenv(7)

      +
      +

      16.139.1. NAME

      cdist-type__rbenv - Manage rbenv installation

      -
      -
      -

      16.138.2. DESCRIPTION

      +
      +
      +

      16.139.2. DESCRIPTION

      This cdist type allows you to manage rbenv installations. It also installs ruby-build.

      - -
      -

      16.138.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.139.3. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      owner

      Which user should own the rbenv installation, defaults to root

      - -
      -

      16.138.4. EXAMPLES

      +
      +
      +

      16.139.4. EXAMPLES

      # Install rbenv including ruby-build for nico
 __rbenv /home/nico
 
@@ -399,48 +407,48 @@ __rbenv /home/nico --owner nico
 __rbenv /home/bastian --state absent
      - -
      -

      16.138.5. AUTHORS

      +
      +
      +

      16.139.5. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.138.6. COPYING

      +
      +
      +

      16.139.6. COPYING

      Copyright (C) 2012-2014 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -449,7 +457,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.139. cdist-type__rsync(7)
      • +
    • 16.140. cdist-type__rsync(7)
    • - + View page source @@ -371,140 +377,105 @@
      -
      -

      16.139. cdist-type__rsync(7)

      -
      -

      16.139.1. NAME

      -

      cdist-type__rsync - Mirror directories using rsync

      -
      -
      -

      16.139.2. DESCRIPTION

      -

      WARNING: This type is of BETA quality:

      -
        -

      • it has not been tested widely

        • -

      • interfaces may change

        • -

      • if there is a better approach to solve the problem -> the type may even vanish

        • -
      -

      If you are fine with these constraints, please read on.

      -

      This cdist type allows you to mirror local directories to the -target host using rsync. Rsync will be installed in the manifest of the type. -If group or owner are giveng, a recursive chown will be executed on the -target host.

      -

      A slash will be appended to the source directory so that only the contents -of the directory are taken and not the directory name itself.

      -
      -
      -

      16.139.3. REQUIRED PARAMETERS

      +
      +

      16.140. cdist-type__rsync(7)

      +
      +

      16.140.1. NAME

      +

      cdist-type__rsync - Mirror directories using rsync

      +
      +
      +

      16.140.2. DESCRIPTION

      +

      The purpose of this type is to bring power of rsync into cdist.

      +
      +
      +

      16.140.3. REQUIRED PARAMETERS

      -
      source

      Where to take files from

      +
      source

      Source directory in local machine. +If source is directory, slash (/) will be added to source and destination paths.

      -
      -
      -

      16.139.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.140.4. OPTIONAL PARAMETERS

      -
      group

      Group to chgrp to.

      +
      destination

      Destination directory. Defaults to $__object_id.

      -
      owner

      User to chown to.

      +
      owner

      Will be passed to rsync as --chown=OWNER. +Read rsync(1) for more details.

      -
      destination

      Use this as the base destination instead of the object id

      +
      group

      Will be passed to rsync as --chown=:GROUP. +Read rsync(1) for more details.

      -
      remote-user

      Use this user instead of the default "root" for rsync operations.

      +
      mode

      Will be passed to rsync as --chmod=MODE. +Read rsync(1) for more details.

      +
      +
      options

      Defaults to --recursive --links --perms --times. +Due to `bug in Python's argparse<https://bugs.python.org/issue9334>`_, value must be prefixed with \.

      +
      +
      remote-user

      Defaults to root.

      - -
      -

      16.139.5. OPTIONAL MULTIPLE PARAMETERS

      +
      +
      +

      16.140.5. OPTIONAL MULTIPLE PARAMETERS

      -
      rsync-opts

      Use this option to give rsync options with. -See rsync(1) for available options. -Only "--" options are supported. -Write the options without the beginning "--" -Can be specified multiple times.

      +
      option

      Pass additional options to rsync. +See rsync(1) for all possible options. +Due to `bug in Python's argparse<https://bugs.python.org/issue9334>`_, value must be prefixed with \.

      - -
      -

      16.139.6. MESSAGES

      -

      NONE

      -
      -
      -

      16.139.7. EXAMPLES

      -
      # You can use any source directory
-__rsync /tmp/testdir \
-    --source /etc
-
-# Use source from type
-__rsync /etc \
-    --source "$__type/files/package"
-
-# Allow multiple __rsync objects to write to the same dir
-__rsync mystuff \
-    --destination /usr/local/bin \
-    --source "$__type/files/package"
-
-__rsync otherstuff \
-    --destination /usr/local/bin \
-    --source "$__type/files/package2"
-
-# Use rsync option --exclude
-__rsync /tmp/testdir \
-    --source /etc \
-    --rsync-opts exclude=sshd_conf
-
-# Use rsync with multiple options --exclude --dry-run
-__rsync /tmp/testing \
-    --source /home/tester \
-    --rsync-opts exclude=id_rsa \
-    --rsync-opts dry-run
+
      +
      +

      16.140.6. EXAMPLES

      +
      __rsync /var/www/example.com \
+    --owner root \
+    --group www-data \
+    --mode 'D750,F640' \
+    --source "$__files/example.com/www"
      -
      -
      -

      16.139.8. SEE ALSO

      -

      rsync(1)

      -
      -
      -

      16.139.9. AUTHORS

      -

      Nico Schottelius <nico-cdist--@--schottelius.org>

      -
      -
      -

      16.139.10. COPYING

      -

      Copyright (C) 2015 Nico Schottelius. You can redistribute it -and/or modify it under the terms of the GNU General Public License as -published by the Free Software Foundation, either version 3 of the -License, or (at your option) any later version.

      -
      - +
      +
      +

      16.140.7. AUTHORS

      +

      Ander Punnar <ander-at-kvlt-dot-ee>

      +
      +
      +

      16.140.8. COPYING

      +

      Copyright (C) 2021 Ander Punnar. You can redistribute it and/or modify it +under the terms of the GNU General Public License as published by the Free +Software Foundation, either version 3 of the License, or (at your option) +any later version.

      +
      +
    - @@ -513,7 +484,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.140. cdist-type__rvm(7)
      • +
    • 16.141. cdist-type__rvm(7)
    • - + View page source @@ -368,25 +376,25 @@
      -
      -

      16.140. cdist-type__rvm(7)

      -
      -

      16.140.1. NAME

      +
      +

      16.141. cdist-type__rvm(7)

      +
      +

      16.141.1. NAME

      cdist-type__rvm - Install rvm for a given user

      -
      -
      -

      16.140.2. DESCRIPTION

      +
      +
      +

      16.141.2. DESCRIPTION

      RVM is the Ruby enVironment Manager for the Ruby programming language.

      - -
      -

      16.140.3. REQUIRED PARAMETERS

      +
      +
      +

      16.141.3. REQUIRED PARAMETERS

      state

      Either "present" or "absent", defaults to "present".

      - -
      -

      16.140.4. EXAMPLES

      +
      +
      +

      16.141.4. EXAMPLES

      # Install rvm for user billie
 __rvm billie --state present
 
@@ -394,51 +402,51 @@ __rvm billie --state present
 __rvm billie --state absent
      - -
      -

      16.140.5. SEE ALSO

      +
      +
      +

      16.141.5. SEE ALSO

      cdist-type__rvm_gem(7), cdist-type__rvm_gemset(7), cdist-type__rvm_ruby(7)

      - -
      -

      16.140.6. AUTHORS

      +
      +
      +

      16.141.6. AUTHORS

      Evax Software <contact@evax.fr>

      - -
      -

      16.140.7. COPYING

      +
      +
      +

      16.141.7. COPYING

      Copyright (C) 2012 Evax Software. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

      - - +
      +
    - @@ -447,7 +455,6 @@ the terms of the GNU General Public License version 3 (GPLv3).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.141. cdist-type__rvm_gemset(7)
      • +
    • 16.142. cdist-type__rvm_gemset(7)
    • - + View page source @@ -369,18 +377,18 @@
      -
      -

      16.141. cdist-type__rvm_gemset(7)

      -
      -

      16.141.1. NAME

      +
      +

      16.142. cdist-type__rvm_gemset(7)

      +
      +

      16.142.1. NAME

      cdist-type__rvm_gemset - Manage Ruby gems through rvm

      -
      -
      -

      16.141.2. DESCRIPTION

      +
      +
      +

      16.142.2. DESCRIPTION

      RVM is the Ruby enVironment Manager for the Ruby programming language.

      - -
      -

      16.141.3. REQUIRED PARAMETERS

      +
      +
      +

      16.142.3. REQUIRED PARAMETERS

      user

      The remote user account to use

      @@ -389,16 +397,16 @@
      state

      Either "present" or "absent", defaults to "present".

      - -
      -

      16.141.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.142.4. OPTIONAL PARAMETERS

      default

      Make the selected gemset the default

      - -
      -

      16.141.5. EXAMPLES

      +
      +
      +

      16.142.5. EXAMPLES

      # Install the rails gem in gemset ruby-1.9.3-p0@myset for user bill
 __rvm_gemset rails --gemset ruby-1.9.3-p0@myset --user bill --state present
 
@@ -410,51 +418,51 @@ __rvm_gemset rails --gemset ruby-1.9.3-p0@myset --user bill \
      - -
      -

      16.141.6. SEE ALSO

      +
      +
      +

      16.142.6. SEE ALSO

      cdist-type__rvm(7), cdist-type__rvm_gemset(7), cdist-type__rvm_ruby(7)

      - -
      -

      16.141.7. AUTHORS

      +
      +
      +

      16.142.7. AUTHORS

      Evax Software <contact@evax.fr>

      - -
      -

      16.141.8. COPYING

      +
      +
      +

      16.142.8. COPYING

      Copyright (C) 2012 Evax Software. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

      - - +
      +
    - @@ -463,7 +471,6 @@ the terms of the GNU General Public License version 3 (GPLv3).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.142. cdist-type__rvm_gemset(7)
      • +
    • 16.143. cdist-type__rvm_gemset(7)
    • - + View page source @@ -369,34 +377,34 @@
      -
      -

      16.142. cdist-type__rvm_gemset(7)

      -
      -

      16.142.1. NAME

      +
      +

      16.143. cdist-type__rvm_gemset(7)

      +
      +

      16.143.1. NAME

      cdist-type__rvm_gemset - Manage gemsets through rvm

      -
      -
      -

      16.142.2. DESCRIPTION

      +
      +
      +

      16.143.2. DESCRIPTION

      RVM is the Ruby enVironment Manager for the Ruby programming language.

      - -
      -

      16.142.3. REQUIRED PARAMETERS

      +
      +
      +

      16.143.3. REQUIRED PARAMETERS

      user

      The remote user account to use

      state

      Either "present" or "absent", defaults to "present".

      - -
      -

      16.142.4. BOOLEAN PARAMETERS

      +
      +
      +

      16.143.4. BOOLEAN PARAMETERS

      default

      If present, set the given gemset as default.

      - -
      -

      16.142.5. EXAMPLES

      +
      +
      +

      16.143.5. EXAMPLES

      # Install the gemset @myset for user charles on based on ruby-1.9.3-0
 __rvm_gemset ruby-1.9.3-p0@myset --user charles --state present
 
@@ -407,51 +415,51 @@ __rvm_gemset ruby-1.9.3-p0@myset --user charles --state present --default
 __rvm_ruby ruby-1.9.3-p0@myset --user john --state absent
      - -
      -

      16.142.6. SEE ALSO

      +
      +
      +

      16.143.6. SEE ALSO

      cdist-type__rvm(7), cdist-type__rvm_gem(7), cdist-type__rvm_ruby(7)

      - -
      -

      16.142.7. AUTHORS

      +
      +
      +

      16.143.7. AUTHORS

      Evax Software <contact@evax.fr>

      - -
      -

      16.142.8. COPYING

      +
      +
      +

      16.143.8. COPYING

      Copyright (C) 2012 Evax Software. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

      - - +
      +
    - @@ -460,7 +468,6 @@ the terms of the GNU General Public License version 3 (GPLv3).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.143. cdist-type__rvm_ruby(7)
      • +
    • 16.144. cdist-type__rvm_ruby(7)
    • - + View page source @@ -369,34 +377,34 @@
      -
      -

      16.143. cdist-type__rvm_ruby(7)

      -
      -

      16.143.1. NAME

      +
      +

      16.144. cdist-type__rvm_ruby(7)

      +
      +

      16.144.1. NAME

      cdist-type__rvm_ruby - Manage ruby installations through rvm

      -
      -
      -

      16.143.2. DESCRIPTION

      +
      +
      +

      16.144.2. DESCRIPTION

      RVM is the Ruby enVironment Manager for the Ruby programming language.

      - -
      -

      16.143.3. REQUIRED PARAMETERS

      +
      +
      +

      16.144.3. REQUIRED PARAMETERS

      user

      The remote user account to use

      state

      Either "present" or "absent", defaults to "present".

      - -
      -

      16.143.4. BOOLEAN PARAMETERS

      +
      +
      +

      16.144.4. BOOLEAN PARAMETERS

      default

      Set the given version as default

      - -
      -

      16.143.5. EXAMPLES

      +
      +
      +

      16.144.5. EXAMPLES

      # Install ruby 1.9.3 through rvm for user thelonious
 __rvm_ruby ruby-1.9.3-p0 --user thelonious --state present
 
@@ -407,51 +415,51 @@ __rvm_ruby ruby-1.9.3-p0 --user ornette --state present --default
 __rvm_ruby ruby-1.9.3-p0 --user john --state absent
      - -
      -

      16.143.6. SEE ALSO

      +
      +
      +

      16.144.6. SEE ALSO

      cdist-type__rvm(7), cdist-type__rvm_gem(7), cdist-type__rvm_gemset(7)

      - -
      -

      16.143.7. AUTHORS

      +
      +
      +

      16.144.7. AUTHORS

      Evax Software <contact@evax.fr>

      - -
      -

      16.143.8. COPYING

      +
      +
      +

      16.144.8. COPYING

      Copyright (C) 2012 Evax Software. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

      - - +
      +
    - @@ -460,7 +468,6 @@ the terms of the GNU General Public License version 3 (GPLv3).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.144. cdist-type__sensible_editor(7)
      • +
    • 16.145. cdist-type__sensible_editor(7)
    • - + View page source @@ -370,19 +378,19 @@
      -
      -

      16.144. cdist-type__sensible_editor(7)

      -
      -

      16.144.1. NAME

      +
      +

      16.145. cdist-type__sensible_editor(7)

      +
      +

      16.145.1. NAME

      cdist-type__sensible_editor - Select the sensible-editor

      -
      -
      -

      16.144.2. DESCRIPTION

      +
      +
      +

      16.145.2. DESCRIPTION

      This cdist type allows you to select the sensible-editor for a given user.

      - -
      -

      16.144.3. REQUIRED PARAMETERS

      +
      +
      +

      16.145.3. REQUIRED PARAMETERS

      editor

      Name or path of the editor to be selected. On systems other than Debian derivatives an absolute path is required.

      @@ -391,9 +399,9 @@ On systems other than Debian derivatives an absolute path is required.

      - -
      -

      16.144.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.145.4. OPTIONAL PARAMETERS

      state

      'present', 'absent', or 'exists'. Defaults to 'present', where:

      @@ -407,16 +415,16 @@ unless there already is a configuration on the target system.

      - -
      -

      16.144.5. EXAMPLES

      +
      +
      +

      16.145.5. EXAMPLES

      __sensible_editor root --editor /bin/ed  # ed(1) is the standard
 __sensible_editor noob --editor nano
      - -
      -

      16.144.6. LIMITATIONS

      +
      +
      +

      16.145.6. LIMITATIONS

      This type depends upon the sensible-editor(1) script which is part of the sensible-utils package.

      @@ -431,52 +439,52 @@ is part of the sensible-utils package.

      Note: on old versions of Ubuntu the sensible-* utils are part of the debianutils package.

      - -
      -

      16.144.7. SEE ALSO

      +
      +
      +

      16.145.7. SEE ALSO

      select-editor(1), sensible-editor(1).

      - -
      -

      16.144.8. AUTHOR

      +
      +
      +

      16.145.8. AUTHOR

      Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>

      - -
      -

      16.144.9. COPYING

      +
      +
      +

      16.145.9. COPYING

      Copyright (C) 2019 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -485,7 +493,6 @@ the License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.145. cdist-type__service(7)
      • +
    • 16.146. cdist-type__service(7)
    • - + View page source @@ -369,33 +377,33 @@
      -
      -

      16.145. cdist-type__service(7)

      -
      -

      16.145.1. NAME

      +
      +

      16.146. cdist-type__service(7)

      +
      +

      16.146.1. NAME

      cdist-type__service - Run action on a system service

      -
      -
      -

      16.145.2. DESCRIPTION

      +
      +
      +

      16.146.2. DESCRIPTION

      This type allows you to run an action against a system service.

      - -
      -

      16.145.3. REQUIRED PARAMETERS

      +
      +
      +

      16.146.3. REQUIRED PARAMETERS

      action

      Arbitrary parameter passed as action. Usually 'start', 'stop', 'reload' or 'restart'.

      - -
      -

      16.145.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.146.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.145.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.146.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.145.6. EXAMPLES

      +
      +
      +

      16.146.6. EXAMPLES

      # Restart nginx service.
 __service nginx --action restart
 
@@ -403,48 +411,48 @@ __service nginx --action restart
 __service postfix --action stop
      - -
      -

      16.145.7. AUTHORS

      +
      +
      +

      16.146.7. AUTHORS

      Timothée Floure <timothee.floure@ungleich.ch>

      - -
      -

      16.145.8. COPYING

      +
      +
      +

      16.146.8. COPYING

      Copyright (C) 2019 Timothée Floure. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -453,7 +461,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.146. cdist-type__snakeoil_cert(7)
      • +
    • 16.147. cdist-type__snakeoil_cert(7)
    • - + View page source @@ -367,22 +375,22 @@
      -
      -

      16.146. cdist-type__snakeoil_cert(7)

      -
      -

      16.146.1. NAME

      +
      +

      16.147. cdist-type__snakeoil_cert(7)

      +
      +

      16.147.1. NAME

      cdist-type__snakeoil_cert - Generate self-signed certificate

      -
      -
      -

      16.146.2. DESCRIPTION

      +
      +
      +

      16.147.2. DESCRIPTION

      The purpose of this type is to generate self-signed certificate and private key for testing purposes. Certificate will expire in 3650 days.

      Certificate's and key's access bits will be 644 and 640 respectively. If target system has ssl-cert group, then it will be used as key's group. Use require='__snakeoil_cert/...' __file ... to override.

      - -
      -

      16.146.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.147.3. OPTIONAL PARAMETERS

      common-name

      Defaults to $__object_id.

      @@ -397,51 +405,60 @@ Defaults to rsa:204 Defaults to /etc/ssl/certs/%s.pem.

      - -
      -

      16.146.4. EXAMPLES

      -
      -
      -

      16.146.5. AUTHORS

      +
      +
      +

      16.147.4. EXAMPLES

      +
      __snakeoil_cert localhost-rsa \
+    --common-name localhost \
+    --key-type rsa:4096
+
+__snakeoil_cert localhost-ec \
+    --common-name localhost \
+    --key-type ec:prime256v1
+
      +
      +
      +
      +

      16.147.5. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.146.6. COPYING

      +
      +
      +

      16.147.6. COPYING

      Copyright (C) 2021 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -450,7 +467,6 @@ any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.147. cdist-type__ssh_authorized_key(7)
      • +
    • 16.148. cdist-type__ssh_authorized_key(7)
    • - + View page source @@ -370,19 +378,19 @@
      -
      -

      16.147. cdist-type__ssh_authorized_key(7)

      -
      -

      16.147.1. NAME

      +
      +

      16.148. cdist-type__ssh_authorized_key(7)

      +
      +

      16.148.1. NAME

      cdist-type__ssh_authorized_key - Manage a single ssh authorized key entry

      -
      -
      -

      16.147.2. DESCRIPTION

      +
      +
      +

      16.148.2. DESCRIPTION

      Manage a single authorized key entry in an authorized_key file. This type was created to be used by the __ssh_authorized_keys type.

      - -
      -

      16.147.3. REQUIRED PARAMETERS

      +
      +
      +

      16.148.3. REQUIRED PARAMETERS

      file

      The authorized_keys file where the given key should be managed.

      @@ -392,9 +400,9 @@ optional trailing comment which shall be added to the given authorized_keys file.

      - -
      -

      16.147.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.148.4. OPTIONAL PARAMETERS

      comment

      Use this comment instead of the one which may be trailing in the key.

      @@ -405,18 +413,18 @@ See sshd(8) for available options.

      state

      If the managed key should be 'present' or 'absent', defaults to 'present'.

      - -
      -

      16.147.5. MESSAGES

      +
      +
      +

      16.148.5. MESSAGES

      added to file (entry)

      The key entry (with optional comment) was added to file.

      removed from file (entry)

      The key entry (with optional comment) was removed from file.

      - -
      -

      16.147.6. EXAMPLES

      +
      +
      +

      16.148.6. EXAMPLES

      __ssh_authorized_key some-id \
    --file "/home/user/.ssh/autorized_keys" \
    --key "$(cat ~/.ssh/id_rsa.pub)"
@@ -429,52 +437,52 @@ __ssh_authorized_key some-id \
    --comment 'one to rule them all'
      - -
      -

      16.147.7. SEE ALSO

      +
      +
      +

      16.148.7. SEE ALSO

      cdist-type__ssh_authorized_keys(7), sshd(8)

      - -
      -

      16.147.8. AUTHORS

      +
      +
      +

      16.148.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.147.9. COPYING

      +
      +
      +

      16.148.9. COPYING

      Copyright (C) 2014 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -483,7 +491,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.148. cdist-type__ssh_authorized_keys(7)
      • +
    • 16.149. cdist-type__ssh_authorized_keys(7)
    • - + View page source @@ -370,14 +378,14 @@
      -
      -

      16.148. cdist-type__ssh_authorized_keys(7)

      -
      -

      16.148.1. NAME

      +
      +

      16.149. cdist-type__ssh_authorized_keys(7)

      +
      +

      16.149.1. NAME

      cdist-type__ssh_authorized_keys - Manage ssh authorized_keys files

      -
      -
      -

      16.148.2. DESCRIPTION

      +
      +
      +

      16.149.2. DESCRIPTION

      Adds or removes ssh keys from a authorized_keys file.

      This type uses the __ssh_dot_ssh type to manage the directory containing the authorized_keys file. You can disable this feature with the --noparent @@ -386,9 +394,9 @@ boolean parameter.

      also managed. This can be disabled with the --nofile boolean parameter. It is then left to the user to ensure that the file exists and that ownership and permissions work with ssh.

      - -
      -

      16.148.3. REQUIRED MULTIPLE PARAMETERS

      +
      +
      +

      16.149.3. REQUIRED MULTIPLE PARAMETERS

      key

      An ssh key which shall be managed in this authorized_keys file. Must be a string containing the ssh keytype, base 64 encoded key and @@ -397,9 +405,9 @@ authorized_keys file. Can be specified multiple times.

      - -
      -

      16.148.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.149.4. OPTIONAL PARAMETERS

      comment

      Use this comment instead of the one which may be trailing in each key.

      @@ -414,9 +422,9 @@ See sshd(8) for available options.

      state

      If the given keys should be 'present' or 'absent', defaults to 'present'.

      - -
      -

      16.148.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.149.5. BOOLEAN PARAMETERS

      noparent

      Don't create or change ownership and permissions of the directory containing the authorized_keys file.

      @@ -427,9 +435,9 @@ file.

      remove-unknown

      Remove undefined keys.

      - -
      -

      16.148.6. EXAMPLES

      +
      +
      +

      16.149.6. EXAMPLES

      # add your ssh key to remote root's authorized_keys file
 __ssh_authorized_keys root \
    --key "$(cat ~/.ssh/id_rsa.pub)"
@@ -476,52 +484,52 @@ __ssh_authorized_keys some-fancy-id \
    --key "ssh-rsa AXYZAAB3NzaC1yc2..."
      - -
      -

      16.148.7. SEE ALSO

      +
      +
      +

      16.149.7. SEE ALSO

      sshd(8)

      - -
      -

      16.148.8. AUTHORS

      +
      +
      +

      16.149.8. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.148.9. COPYING

      +
      +
      +

      16.149.9. COPYING

      Copyright (C) 2012-2014 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -530,7 +538,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.149. cdist-type__ssh_dot_ssh(7)
      • +
    • 16.150. cdist-type__ssh_dot_ssh(7)
    • - + View page source @@ -368,26 +376,26 @@
      -
      -

      16.149. cdist-type__ssh_dot_ssh(7)

      -
      -

      16.149.1. NAME

      +
      +

      16.150. cdist-type__ssh_dot_ssh(7)

      +
      +

      16.150.1. NAME

      cdist-type__ssh_dot_ssh - Manage .ssh directory

      -
      -
      -

      16.149.2. DESCRIPTION

      +
      +
      +

      16.150.2. DESCRIPTION

      Adds or removes .ssh directory to a user home.

      This type is being used by __ssh_authorized_keys.

      - -
      -

      16.149.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.150.3. OPTIONAL PARAMETERS

      state

      if the directory should be 'present' or 'absent', defaults to 'present'.

      - -
      -

      16.149.4. EXAMPLES

      +
      +
      +

      16.150.4. EXAMPLES

      # Ensure root has ~/.ssh with the right permissions
 __ssh_dot_ssh root
 
@@ -395,52 +403,52 @@ __ssh_dot_ssh root
 __ssh_dot_ssh nico --state absent
      - -
      -

      16.149.5. SEE ALSO

      +
      +
      +

      16.150.5. SEE ALSO

      cdist-type__ssh_authorized_keys(7)

      - -
      -

      16.149.6. AUTHORS

      +
      +
      +

      16.150.6. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.149.7. COPYING

      +
      +
      +

      16.150.7. COPYING

      Copyright (C) 2014 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -449,7 +457,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.150. cdist-type__sshd_config(7)
      • +
    • 16.151. cdist-type__sshd_config(7)
    • - + View page source @@ -371,22 +379,22 @@
      -
      -

      16.150. cdist-type__sshd_config(7)

      -
      -

      16.150.1. NAME

      +
      +

      16.151. cdist-type__sshd_config(7)

      +
      +

      16.151.1. NAME

      cdist-type__sshd_config - Manage options in sshd_config

      -
      -
      -

      16.150.2. DESCRIPTION

      +
      +
      +

      16.151.2. DESCRIPTION

      This space intentionally left blank.

      - -
      -

      16.150.3. REQUIRED PARAMETERS

      +
      +
      +

      16.151.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.150.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.151.4. OPTIONAL PARAMETERS

      file

      The path to the sshd_config file to edit. Defaults to /etc/ssh/sshd_config.

      @@ -411,13 +419,13 @@ removed (if --state --state absent, all values for the given option are removed.

      - -
      -

      16.150.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.151.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.150.6. EXAMPLES

      +
      +
      +

      16.151.6. EXAMPLES

      # Disallow root logins with password
 __sshd_config PermitRootLogin --value without-password
 
@@ -432,13 +440,13 @@ __sshd_config git@ForceCommand --match 'User git''cd ~git && exec git-shell ${SSH_ORIGINAL_COMMAND:+-c "${SSH_ORIGINAL_COMMAND}"}'
      - -
      -

      16.150.7. SEE ALSO

      +
      +
      +

      16.151.7. SEE ALSO

      sshd_config(5)

      - -
      -

      16.150.8. BUGS

      +
      +
      +

      16.151.8. BUGS

      • This type assumes a nicely formatted config file, i.e. no config options spanning multiple lines.

        • @@ -453,48 +461,48 @@ is transformed to p
    - -
    -

    16.150.9. AUTHORS

    +
    +
    +

    16.151.9. AUTHORS

    Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>

    - -
    -

    16.150.10. COPYING

    +
    +
    +

    16.151.10. COPYING

    Copyright (C) 2020 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

    - - +
    + - @@ -503,7 +511,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.151. cdist-type__staged_file(7)
      • +
    • 16.152. cdist-type__staged_file(7)
    • - + View page source @@ -369,19 +377,19 @@
      -
      -

      16.151. cdist-type__staged_file(7)

      -
      -

      16.151.1. NAME

      +
      +

      16.152. cdist-type__staged_file(7)

      +
      +

      16.152.1. NAME

      cdist-type__staged_file - Manage staged files

      -
      -
      -

      16.151.2. DESCRIPTION

      +
      +
      +

      16.152.2. DESCRIPTION

      Manages a staged file that is downloaded on the server (the machine running cdist) and then deployed to the target host using the __file type.

      - -
      -

      16.151.3. REQUIRED PARAMETERS

      +
      +
      +

      16.152.3. REQUIRED PARAMETERS

      source

      the URL from which to retrieve the source file. e.g.

      @@ -402,9 +410,9 @@ $ cksum /tmp/foobar ignored if given.

      - -
      -

      16.151.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.152.4. OPTIONAL PARAMETERS

      fetch-command

      the command used to fetch the staged file using printf formatting. Where a single %s will be replaced with the value of the given --source @@ -436,9 +444,9 @@ Defaults to '/var/tmp/cdist/__staged_file'

      state

      see cdist-type__file

      - -
      -

      16.151.5. EXAMPLES

      +
      +
      +

      16.152.5. EXAMPLES

      __staged_file /usr/local/bin/consul \
    --source file:///path/to/local/copy/consul \
    --cksum '428915666 15738724' \
@@ -458,52 +466,52 @@ __staged_file /usr/local/bin/consul \
    --mode 755
      - -
      -

      16.151.6. SEE ALSO

      +
      +
      +

      16.152.6. SEE ALSO

      cdist-type__file(7)

      - -
      -

      16.151.7. AUTHORS

      +
      +
      +

      16.152.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.151.8. COPYING

      +
      +
      +

      16.152.8. COPYING

      Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -512,7 +520,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.152. cdist-type__start_on_boot(7)
      • +
    • 16.153. cdist-type__start_on_boot(7)
    • - + View page source @@ -369,34 +377,34 @@
      -
      -

      16.152. cdist-type__start_on_boot(7)

      -
      -

      16.152.1. NAME

      +
      +

      16.153. cdist-type__start_on_boot(7)

      +
      +

      16.153.1. NAME

      cdist-type__start_on_boot - Manage stuff to be started at boot

      -
      -
      -

      16.152.2. DESCRIPTION

      +
      +
      +

      16.153.2. DESCRIPTION

      This cdist type allows you to enable or disable stuff to be started at boot of your operating system.

      Warning: This type has not been tested intensively and is not fully supported.

      - -
      -

      16.152.3. REQUIRED PARAMETERS

      +
      +
      +

      16.153.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.152.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.153.4. OPTIONAL PARAMETERS

      state

      Either "present" or "absent", defaults to "present"

      target_runlevel

      Runlevel which should be modified, defaults to "default" (only used on gentoo systems).

      - -
      -

      16.152.5. EXAMPLES

      +
      +
      +

      16.153.5. EXAMPLES

      # Ensure snmpd is started at boot
 __start_on_boot snmpd
 
@@ -407,52 +415,52 @@ __start_on_boot snmpd --state present
 __start_on_boot puppet --state absent
      - -
      -

      16.152.6. SEE ALSO

      +
      +
      +

      16.153.6. SEE ALSO

      cdist-type__process(7)

      - -
      -

      16.152.7. AUTHORS

      +
      +
      +

      16.153.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org>

      - -
      -

      16.152.8. COPYING

      +
      +
      +

      16.153.8. COPYING

      Copyright (C) 2012-2019 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -461,7 +469,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -340,20 +346,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.153. cdist-type__sysctl(7)
      • +
    • 16.154. cdist-type__sysctl(7)
    • - + View page source @@ -367,27 +375,27 @@
      -
      -

      16.153. cdist-type__sysctl(7)

      -
      -

      16.153.1. NAME

      +
      +

      16.154. cdist-type__sysctl(7)

      +
      +

      16.154.1. NAME

      cdist-type__sysctl - manage sysctl settings

      -
      -
      -

      16.153.2. DESCRIPTION

      +
      +
      +

      16.154.2. DESCRIPTION

      Manages permanent as well as runtime sysctl settings. Permament settings are set by managing entries in /etc/sysctl.conf. Runtime settings are set by directly calling the sysctl executable.

      - -
      -

      16.153.3. REQUIRED PARAMETERS

      +
      +
      +

      16.154.3. REQUIRED PARAMETERS

      value

      The value to set for the given key (object_id)

      - -
      -

      16.153.4. EXAMPLES

      +
      +
      +

      16.154.4. EXAMPLES

      __sysctl net.ipv4.ip_forward --value 1
 
 # On some operating systems, e.g. NetBSD, to prevent an error if the
@@ -398,47 +406,47 @@ Runtime settings are set by directly calling the sysctl executable.
      
 __sysctl ddb.onpanic? --value -1
      - -
      -

      16.153.5. AUTHORS

      +
      +
      +

      16.154.5. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.153.6. COPYING

      +
      +
      +

      16.154.6. COPYING

      Copyright (C) 2014 Steven Armstrong. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

      - - +
      +
    - @@ -447,7 +455,6 @@ later (GPLv3+).

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.154. cdist-type__systemd_service(7)
      • +
    • 16.155. cdist-type__systemd_service(7)
    • - + View page source @@ -371,26 +379,26 @@
      -
      -

      16.154. cdist-type__systemd_service(7)

      -
      -

      16.154.1. NAME

      +
      +

      16.155. cdist-type__systemd_service(7)

      +
      +

      16.155.1. NAME

      cdist-type__systemd_service - Controls a systemd service state

      -
      -
      -

      16.154.2. DESCRIPTION

      +
      +
      +

      16.155.2. DESCRIPTION

      This type controls systemd services to define a state of the service, or an action like reloading or restarting. It is useful to reload a service after configuration applied or shutdown one service.

      The activation or deactivation is out of scope. Look for the cdist-type__systemd_util(7) type instead.

      - -
      -

      16.154.3. REQUIRED PARAMETERS

      +
      +
      +

      16.155.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.154.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.155.4. OPTIONAL PARAMETERS

      name

      String which will used as name instead of the object id.

      @@ -412,9 +420,9 @@ service keeps the state -

      16.154.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.155.5. BOOLEAN PARAMETERS

      if-required

      Only execute the action if at minimum one required type outputs a message to $__messages_out. Through this, the action should only executed if a @@ -422,9 +430,9 @@ dependency did something. The action will not executed if no dependencies given.

      - -
      -

      16.154.6. MESSAGES

      +
      +
      +

      16.155.6. MESSAGES

      start

      Started the service

      @@ -435,14 +443,14 @@ given.

      reload

      Reloaded the service

      - -
      -

      16.154.7. ABORTS

      +
      +
      +

      16.155.7. ABORTS

      Aborts in following cases:

      systemd or the service does not exist

      - -
      -

      16.154.8. EXAMPLES

      +
      +
      +

      16.155.8. EXAMPLES

      # service must run
 __systemd_service nginx
 
@@ -464,48 +472,48 @@ __systemd_service foo \
     --action reload --if-required
      - -
      -

      16.154.9. AUTHORS

      +
      +
      +

      16.155.9. AUTHORS

      Matthias Stecher <matthiasstecher at gmx.de>

      - -
      + +
    - @@ -514,7 +522,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.155. cdist-type__systemd_unit(7)
      • +
    • 16.156. cdist-type__systemd_unit(7)
    • - + View page source @@ -370,25 +378,25 @@
      -
      -

      16.155. cdist-type__systemd_unit(7)

      -
      -

      16.155.1. NAME

      +
      +

      16.156. cdist-type__systemd_unit(7)

      +
      +

      16.156.1. NAME

      cdist-type__systemd_unit - Install a systemd unit

      -
      -
      -

      16.155.2. DESCRIPTION

      +
      +
      +

      16.156.2. DESCRIPTION

      This type manages systemd units in /etc/systemd/system/. It can install, enable and start a systemd unit. This is particularly useful on systems which take advantage of systemd heavily (e.g., CoreOS). For more information about systemd units, see SYSTEMD.UNIT(5).

      - -
      -

      16.155.3. REQUIRED PARAMETERS

      +
      +
      +

      16.156.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.155.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.156.4. OPTIONAL PARAMETERS

      enablement-state

      'enabled', 'disabled' or 'masked', where:

      @@ -413,21 +421,21 @@ the mask is removed.

      - -
      -

      16.155.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.156.5. BOOLEAN PARAMETERS

      restart

      Start the unit if it was inactive. Restart the unit if the unit file changed. Stop the unit if new enablement-state is masked.

      - -
      -

      16.155.6. MESSAGES

      +
      +
      +

      16.156.6. MESSAGES

      None.

      - -
      -

      16.155.7. EXAMPLES

      +
      +
      +

      16.156.7. EXAMPLES

      # Installs, enables and starts foobar.service
 __systemd_unit foobar.service \
     --source "${__manifest}/files/foobar.service" \
@@ -441,48 +449,48 @@ __systemd_unit foobar.service --enablement-state disabled
 __systemd_unit foobar.service --state absent
      - -
      -

      16.155.8. AUTHORS

      +
      +
      +

      16.156.8. AUTHORS

      Ľubomír Kučera <lubomir.kucera.jr at gmail.com>

      - -
      -

      16.155.9. COPYING

      +
      +
      +

      16.156.9. COPYING

      Copyright (C) 2017 Ľubomír Kučera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -491,7 +499,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.156. cdist-type__timezone(7)
      • +
    • 16.157. cdist-type__timezone(7)
    • - + View page source @@ -368,30 +376,30 @@
      -
      -

      16.156. cdist-type__timezone(7)

      -
      -

      16.156.1. NAME

      +
      +

      16.157. cdist-type__timezone(7)

      +
      +

      16.157.1. NAME

      cdist-type__timezone - Allows one to configure the desired localtime timezone.

      -
      -
      -

      16.156.2. DESCRIPTION

      +
      +
      +

      16.157.2. DESCRIPTION

      This type creates a symlink (/etc/localtime) to the selected timezone (which should be available in /usr/share/zoneinfo).

      - -
      -

      16.156.3. REQUIRED PARAMETERS

      +
      +
      +

      16.157.3. REQUIRED PARAMETERS

      tz

      The name of timezone to set.

      - -
      -

      16.156.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.157.4. OPTIONAL PARAMETERS

      None.

      - -
      -

      16.156.5. EXAMPLES

      +
      +
      +

      16.157.5. EXAMPLES

      # Set up Europe/Andorra as our timezone.
 __timezone --tz Europe/Andorra
 
@@ -399,53 +407,53 @@ __timezone --tz Europe/Andorra
 __timezone --tz US/Central
      - -
      -

      16.156.6. AUTHORS

      +
      +
      +

      16.157.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>
      Nico Schottelius <nico-cdist--@--schottelius.org>
      Ramon Salvadó <rsalvado--@--gnuine--dot--com>
      Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>
      - -
      -

      16.156.7. COPYING

      +
      +
      +

      16.157.7. COPYING

      Copyright (C) 2012-2020 the AUTHORS. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -454,7 +462,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.157. cdist-type__uci(7)
      • +
    • 16.158. cdist-type__uci(7)
    • - + View page source @@ -370,19 +378,19 @@
      -
      -

      16.157. cdist-type__uci(7)

      -
      -

      16.157.1. NAME

      +
      +

      16.158. cdist-type__uci(7)

      +
      +

      16.158.1. NAME

      cdist-type__uci - Manage configuration values in UCI

      -
      -
      -

      16.157.2. DESCRIPTION

      +
      +
      +

      16.158.2. DESCRIPTION

      This cdist type can be used to alter configuration options in OpenWrt's Unified Configuration Interface (UCI) system.

      - -
      -

      16.157.3. REQUIRED PARAMETERS

      +
      +
      +

      16.158.3. REQUIRED PARAMETERS

      value

      The value to be set. Can be used multiple times. This parameter is ignored if --state is absent.

      @@ -392,9 +400,9 @@ characters.

      value is passed to the type as a single shell argument.

      - -
      -

      16.157.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.158.4. OPTIONAL PARAMETERS

      state

      present or absent, defaults to present.

      @@ -403,13 +411,13 @@ One of: option--value parameters.

      - -
      -

      16.157.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.158.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.157.6. EXAMPLES

      +
      +
      +

      16.158.6. EXAMPLES

      # Set the system hostname
 __uci system.@system[0].hostname --value 'OpenWrt'
 
@@ -426,54 +434,54 @@ __uci system.ntp.server --type list \
     --value '3.openwrt.pool.ntp.org'
      - -
      -

      16.157.7. SEE ALSO

      +
      +
      +

      16.158.7. SEE ALSO

      - -
      -

      16.157.8. AUTHORS

      +
      +
      +

      16.158.8. AUTHORS

      Dennis Camera <dennis.camera@ssrq-sds-fds.ch>

      - -
      -

      16.157.9. COPYING

      +
      +
      +

      16.158.9. COPYING

      Copyright (C) 2020 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -482,7 +490,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.158. cdist-type__uci_section(7)
      • +
    • 16.159. cdist-type__uci_section(7)
    • - + View page source @@ -370,14 +378,14 @@
      -
      -

      16.158. cdist-type__uci_section(7)

      -
      -

      16.158.1. NAME

      +
      +

      16.159. cdist-type__uci_section(7)

      +
      +

      16.159.1. NAME

      cdist-type__uci_section - Manage configuration sections in UCI

      -
      -
      -

      16.158.2. DESCRIPTION

      +
      +
      +

      16.159.2. DESCRIPTION

      This cdist type can be used to replace whole configuration sections in OpenWrt's Unified Configuration Interface (UCI) system. It can be thought of as syntactic sugar for cdist-type__uci(7), @@ -387,13 +395,13 @@ contain exactly the options specified using --match parameter.

      NOTE: Options already present on the target and not listed in --option or --list will be deleted.

      - -
      -

      16.158.3. REQUIRED PARAMETERS

      +
      +
      +

      16.159.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.158.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.159.4. OPTIONAL PARAMETERS

      list

      An option that is part of a list and should be present in the section (as part of a list). Lists with multiple options can be expressed by using the @@ -418,13 +426,13 @@ shell argument.

      type

      The type of the section in the format: <config>.<section-type>

      - -
      -

      16.158.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.159.5. BOOLEAN PARAMETERS

      None.

      - -
      -

      16.158.6. EXAMPLES

      +
      +
      +

      16.159.6. EXAMPLES

      # Configure the dropbear daemon
 __uci_section dropbear --type dropbear.dropbear \
     --match Port=22 --option Port=22 \
@@ -458,55 +466,55 @@ __uci_section wireless.default_radio0 --type wireless.wifi-iface     --option key='hunter2'
      - -
      -

      16.158.7. SEE ALSO

      +
      +
      +

      16.159.7. SEE ALSO

      - -
      -

      16.158.8. AUTHORS

      +
      +
      +

      16.159.8. AUTHORS

      Dennis Camera <dennis.camera@ssrq-sds-fds.ch>

      - -
      -

      16.158.9. COPYING

      +
      +
      +

      16.159.9. COPYING

      Copyright (C) 2020 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -515,7 +523,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.159. cdist-type__ufw(7)
      • +
    • 16.160. cdist-type__ufw(7)
    • - + View page source @@ -368,19 +376,19 @@
      -
      -

      16.159. cdist-type__ufw(7)

      -
      -

      16.159.1. NAME

      +
      +

      16.160. cdist-type__ufw(7)

      +
      +

      16.160.1. NAME

      cdist-type__ufw - Install the Uncomplicated FireWall

      -
      -
      -

      16.159.2. DESCRIPTION

      +
      +
      +

      16.160.2. DESCRIPTION

      Installs the Uncomplicated FireWall. Most modern distributions carry UFW in their main repositories, but on CentOS this type will automatically enable the EPEL repository.

      Some global configuration can also be set with this type.

      - -
      -

      16.159.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.160.3. OPTIONAL PARAMETERS

      state

      Either "enabled", "running", "present", or "absent". Defaults to "enabled", which registers UFW to start on boot.

      @@ -393,61 +401,61 @@
      default_routed

      Either "allow", "deny", or "reject". The default policy for dealing with routed packets (passing through this machine).

      - -
      -

      16.159.4. EXAMPLES

      +
      +
      +

      16.160.4. EXAMPLES

      # Install UFW
 __ufw
 # Setup UFW with maximum logging and no restrictions on routed packets.
 __ufw --logging full --default_routed allow
      - -
      -

      16.159.5. SEE ALSO

      +
      +
      +

      16.160.5. SEE ALSO

      ufw(8)

      - -
      -

      16.159.6. AUTHORS

      +
      +
      +

      16.160.6. AUTHORS

      Mark Polyakov <mark@markasoftware.com>

      - -
      -

      16.159.7. COPYING

      +
      +
      +

      16.160.7. COPYING

      Copyright (C) 2019 Mark Polyakov. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -456,7 +464,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.160. cdist-type__ufw_rule(7)
      • +
    • 16.161. cdist-type__ufw_rule(7)
    • - + View page source @@ -368,28 +376,28 @@
      -
      -

      16.160. cdist-type__ufw_rule(7)

      -
      -

      16.160.1. NAME

      +
      +

      16.161. cdist-type__ufw_rule(7)

      +
      +

      16.161.1. NAME

      cdist-type__ufw_rule - A single UFW rule

      -
      -
      -

      16.160.2. DESCRIPTION

      +
      +
      +

      16.161.2. DESCRIPTION

      Adds or removes a single UFW rule. This type supports adding and deleting rules for port ranges or applications.

      Understanding what is "to" and what is "from" can be confusing. If the rule is ingress (default), then "from" is the remote machine and "to" is the local one. The opposite is true for egress traffic (--out).

      - -
      -

      16.160.3. OPTIONAL PARAMETERS

      +
      +
      +

      16.161.3. OPTIONAL PARAMETERS

      state

      Either "present" or "absent". Defaults to "present". If "absent", only removes rules that exactly match the rule expected.

      rule

      A firewall rule in UFW syntax. This is what you would usually write after ufw on the command line. Defaults to "allow" followed by the object ID. You can use either the short syntax (just allow|deny|reject|limit followed by a port or application name) or the full syntax. Do not include delete in your command. Set --state absent instead.

      - -
      -

      16.160.4. EXAMPLES

      +
      +
      +

      16.161.4. EXAMPLES

      # open port 80 (ufw allow 80)
 __ufw_rule 80
 # Allow mosh application (if installed)
@@ -400,52 +408,52 @@ __ufw_rule local --rule 'allow from
 __ufw_rule block_smtp --rule 'deny out on eth0 from any port 25 to 111.55.55.55'
      - -
      -

      16.160.5. SEE ALSO

      +
      +
      +

      16.161.5. SEE ALSO

      ufw(8)

      - -
      -

      16.160.6. AUTHORS

      +
      +
      +

      16.161.6. AUTHORS

      Mark Polyakov <mark@markasoftware.com>

      - -
      -

      16.160.7. COPYING

      +
      +
      +

      16.161.7. COPYING

      Copyright (C) 2019 Mark Polyakov. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -454,7 +462,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.161. cdist-type__unpack(7)
      • +
    • 16.162. cdist-type__unpack(7)
    • - + View page source @@ -369,30 +377,30 @@
      -
      -

      16.161. cdist-type__unpack(7)

      -
      -

      16.161.1. NAME

      +
      +

      16.162. cdist-type__unpack(7)

      +
      +

      16.162.1. NAME

      cdist-type__unpack - Unpack archives

      -
      -
      -

      16.161.2. DESCRIPTION

      +
      +
      +

      16.162.2. DESCRIPTION

      Unpack .tar, .tgz, .tar.*, .7z, .bz2, .gz, .lzma, .xz, .rar and .zip archives. Archive type is detected by extension.

      To achieve idempotency, checksum file will be created in target. See --sum-file parameter for details.

      - -
      -

      16.161.3. REQUIRED PARAMETERS

      +
      +
      +

      16.162.3. REQUIRED PARAMETERS

      destination

      Depending on archive format file or directory to where archive contents will be written.

      - -
      -

      16.161.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.162.4. OPTIONAL PARAMETERS

      sum-file

      Override archive's checksum file in target. By default XXX.cdist__unpack_sum will be used, where XXX is source @@ -404,9 +412,9 @@ archive path. This file must be kept in target's persistent storage.

      See man tar for possible arguments.

      - -
      -

      16.161.5. OPTIONAL BOOLEAN PARAMETERS

      +
      +
      +

      16.162.5. OPTIONAL BOOLEAN PARAMETERS

      backup-destination

      By default destination file will be overwritten. In case destination is directory, files from archive will be added to or overwritten in @@ -419,9 +427,9 @@ directory. This parameter moves existing destination to

      onchange

      Execute this command after unpack.

      - -
      -

      16.161.6. EXAMPLES

      +
      +
      +

      16.162.6. EXAMPLES

      __directory /opt/cpma
 
 require='__directory/opt/cpma' \
@@ -443,48 +451,48 @@ __unpack /root/strelaysrv.tar.gz \
     --tar-extra-args '--wildcards "*/strelaysrv"'
      - -
      -

      16.161.7. AUTHORS

      +
      +
      +

      16.162.7. AUTHORS

      Ander Punnar <ander-at-kvlt-dot-ee>

      - -
      -

      16.161.8. COPYING

      +
      +
      +

      16.162.8. COPYING

      Copyright (C) 2020 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -493,7 +501,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.162. cdist-type__update_alternatives(7)
      • +
    • 16.163. cdist-type__update_alternatives(7)
    • - + View page source @@ -369,85 +377,85 @@
      -
      -

      16.162. cdist-type__update_alternatives(7)

      -
      -

      16.162.1. NAME

      +
      +

      16.163. cdist-type__update_alternatives(7)

      +
      +

      16.163.1. NAME

      cdist-type__update_alternatives - Configure alternatives

      -
      -
      -

      16.162.2. DESCRIPTION

      +
      +
      +

      16.163.2. DESCRIPTION

      On Debian and alike systems update-alternatives(1) can be used to setup alternatives for various programs. One of the most common used targets is the "editor".

      - -
      -

      16.162.3. REQUIRED PARAMETERS

      +
      +
      +

      16.163.3. REQUIRED PARAMETERS

      path

      Use this path for the given alternative

      - -
      -

      16.162.4. BOOLEAN PARAMETERS

      +
      +
      +

      16.163.4. BOOLEAN PARAMETERS

      install

      Add (update-alternatives --install) missing path to alternatives.

      - -
      -

      16.162.5. EXAMPLES

      +
      +
      +

      16.163.5. EXAMPLES

      # Setup vim as the default editor
 __update_alternatives editor --path /usr/bin/vim.basic
      - -
      -

      16.162.6. SEE ALSO

      +
      +
      +

      16.163.6. SEE ALSO

      cdist-type__debconf_set_selections(7), update-alternatives(8)

      - -
      -

      16.162.7. AUTHORS

      +
      +
      +

      16.163.7. AUTHORS

      Nico Schottelius <nico-cdist--@--schottelius.org> Ander Punnar <ander@kvlt.ee>

      - -
      -

      16.162.8. COPYING

      +
      +
      +

      16.163.8. COPYING

      Copyright (C) 2013 Nico Schottelius and 2020 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -456,7 +464,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.163. cdist-type__user(7)
      • +
    • 16.164. cdist-type__user(7)
    • - + View page source @@ -371,22 +379,22 @@
      -
      -

      16.163. cdist-type__user(7)

      -
      -

      16.163.1. NAME

      +
      +

      16.164. cdist-type__user(7)

      +
      +

      16.164.1. NAME

      cdist-type__user - Manage users

      -
      -
      -

      16.163.2. DESCRIPTION

      +
      +
      +

      16.164.2. DESCRIPTION

      This cdist type allows you to create or modify users on the target.

      - -
      -

      16.163.3. REQUIRED PARAMETERS

      +
      +
      +

      16.164.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.163.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.164.4. OPTIONAL PARAMETERS

      state

      absent or present, defaults to present

      @@ -403,9 +411,9 @@
      uid

      see above

      - -
      -

      16.163.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.164.5. BOOLEAN PARAMETERS

      system

      see useradd(8), apply only on user create

      @@ -414,9 +422,9 @@
      remove-home

      see userdel(8), apply only on user delete

      - -
      -

      16.163.6. MESSAGES

      +
      +
      +

      16.164.6. MESSAGES

      mod

      User is modified

      @@ -427,9 +435,9 @@
      userdel

      If user was deleted (keeping homedir)

      - -
      -

      16.163.7. EXAMPLES

      +
      +
      +

      16.164.7. EXAMPLES

      # Create user account for foobar with operating system default settings
 __user foobar
 
@@ -446,52 +454,52 @@ __user foobar --uid 1001 --shell /bin/zsh --home /home/fo
 __user foobar --state absent
      - -
      -

      16.163.8. SEE ALSO

      +
      +
      +

      16.164.8. SEE ALSO

      pw(8), usermod(8)

      - -
      -

      16.163.9. AUTHORS

      +
      +
      +

      16.164.9. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.163.10. COPYING

      +
      +
      +

      16.164.10. COPYING

      Copyright (C) 2011 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -500,7 +508,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.164. cdist-type__user_groups(7)
      • +
    • 16.165. cdist-type__user_groups(7)
    • - + View page source @@ -368,35 +376,35 @@
      -
      -

      16.164. cdist-type__user_groups(7)

      -
      -

      16.164.1. NAME

      +
      +

      16.165. cdist-type__user_groups(7)

      +
      +

      16.165.1. NAME

      cdist-type__user_groups - Manage user groups

      -
      -
      -

      16.164.2. DESCRIPTION

      +
      +
      +

      16.165.2. DESCRIPTION

      Adds or removes a user from one or more groups.

      - -
      -

      16.164.3. REQUIRED PARAMETERS

      +
      +
      +

      16.165.3. REQUIRED PARAMETERS

      group

      the group to which this user should be added or removed. Can be specified multiple times.

      - -
      -

      16.164.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.165.4. OPTIONAL PARAMETERS

      user

      the name of the user. Defaults to object_id

      state

      absent or present. Defaults to present.

      - -
      -

      16.164.5. EXAMPLES

      +
      +
      +

      16.165.5. EXAMPLES

      __user_groups nginx --group webuser1 --group webuser2
 
 # remove user nginx from groups webuser2
@@ -404,48 +412,48 @@ __user_groups nginx-webuser2 --user nginx \
    --group webuser2 --state absent
      - -
      -

      16.164.6. AUTHORS

      +
      +
      +

      16.165.6. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.164.7. COPYING

      +
      +
      +

      16.165.7. COPYING

      Copyright (C) 2012 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -454,7 +462,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.165. cdist-type__xymon_apache(7)
      • +
    • 16.166. cdist-type__xymon_apache(7)
    • - + View page source @@ -371,25 +379,25 @@
      -
      -

      16.165. cdist-type__xymon_apache(7)

      -
      -

      16.165.1. NAME

      +
      +

      16.166. cdist-type__xymon_apache(7)

      +
      +

      16.166.1. NAME

      cdist-type__xymon_apache - Configure apache2-webserver for Xymon

      -
      -
      -

      16.165.2. DESCRIPTION

      +
      +
      +

      16.166.2. DESCRIPTION

      This cdist type installs and configures apache2 to be used "exclusively" (in the sense that no other use is taken care of) with Xymon (the systems and network monitor).

      It depends on __xymon_server.

      - -
      -

      16.165.3. REQUIRED PARAMETERS

      +
      +
      +

      16.166.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.165.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.166.4. OPTIONAL PARAMETERS

      state

      'present', 'absent', defaults to 'present'.

      @@ -397,9 +405,9 @@ network monitor).

      syntax suitable for Require ip .... Example: 192.168.1.0/24 10.0.0.0/8

      - -
      -

      16.165.5. MESSAGES

      +
      +
      +

      16.166.5. MESSAGES

      mod:rewrite enabled

      apache module enabled

      @@ -410,70 +418,70 @@ syntax suitable for Require ip .... Example: 192.168.1.0/24 1
      apache reloaded

      apache2.service was restarted

      - -
      -

      16.165.6. EXPLORERS

      +
      +
      +

      16.166.6. EXPLORERS

      active-conf

      lists apache2 conf-enabled

      active-modules

      lists active apache2-modules

      - -
      -

      16.165.7. EXAMPLES

      +
      +
      +

      16.166.7. EXAMPLES

      # minmal, only localhost-access:
 __xymon_apache
 # allow more IPs to access the Xymon-webinterface:
 __xymon_apache --ipacl "192.168.0.0/16 10.0.0.0/8" --state "present"
      - -
      -

      16.165.8. SEE ALSO

      +
      +
      +

      16.166.8. SEE ALSO

      cdist__xymon_server(7)

      - -
      -

      16.165.9. AUTHORS

      +
      +
      +

      16.166.9. AUTHORS

      Thomas Eckert <tom--@--it-eckert.de>

      - -
      -

      16.165.10. COPYING

      +
      +
      +

      16.166.10. COPYING

      Copyright (C) 2018-2019 Thomas Eckert. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -482,7 +490,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.166. cdist-type__xymon_client(7)
      • +
    • 16.167. cdist-type__xymon_client(7)
    • - + View page source @@ -370,23 +378,23 @@
      -
      -

      16.166. cdist-type__xymon_client(7)

      -
      -

      16.166.1. NAME

      +
      +

      16.167. cdist-type__xymon_client(7)

      +
      +

      16.167.1. NAME

      cdist-type__xymon_client - Install the Xymon client

      -
      -
      -

      16.166.2. DESCRIPTION

      +
      +
      +

      16.167.2. DESCRIPTION

      This cdist type installs the Xymon client and configures it to report with FQDN.

      - -
      -

      16.166.3. REQUIRED PARAMETERS

      +
      +
      +

      16.167.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.166.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.167.4. OPTIONAL PARAMETERS

      state

      'present', 'absent', defaults to 'present'.

      @@ -394,17 +402,17 @@ FQDN.

      to. While DNS-names are ok it is discouraged, defaults to 127.0.0.1.

      - -
      -

      16.166.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.167.5. BOOLEAN PARAMETERS

      msgcache

      Enable xymon msgcache. Note: XYMONSERVER has to be 127.0.0.1 for using msgcache (see msgcache (8) of the xymon documentation for details).

      - -
      -

      16.166.6. EXAMPLES

      +
      +
      +

      16.167.6. EXAMPLES

      # minimal, report to 127.0.0.1
 __xymon_client
 
@@ -415,52 +423,52 @@ __xymon_client --servers "192.168.1.1"
 __xymon_client --msgcache
      - -
      -

      16.166.7. SEE ALSO

      +
      +
      +

      16.167.7. SEE ALSO

      cdist__xymon_server(7), xymon(7), msgcache(8)

      - -
      -

      16.166.8. AUTHORS

      +
      +
      +

      16.167.8. AUTHORS

      Thomas Eckert <tom--@--it-eckert.de>

      - -
      -

      16.166.9. COPYING

      +
      +
      +

      16.167.9. COPYING

      Copyright (C) 2018-2019 Thomas Eckert. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -469,7 +477,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -344,20 +350,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.167. cdist-type__xymon_config(7)
      • +
    • 16.168. cdist-type__xymon_config(7)
    • - + View page source @@ -371,52 +379,52 @@
      -
      -

      16.167. cdist-type__xymon_config(7)

      -
      -

      16.167.1. NAME

      +
      +

      16.168. cdist-type__xymon_config(7)

      +
      +

      16.168.1. NAME

      cdist-type__xymon_config - Deploy a Xymon configuration-directory

      -
      -
      -

      16.167.2. DESCRIPTION

      +
      +
      +

      16.168.2. DESCRIPTION

      This cdist type deploys a full Xymon configuration directory from the files-dir to the host. This type requires an installed Xymon server, e.g. deployed by __xymon_server.

      WARNING: This type _replaces_ the /etc/xymon/-directory! The previous contents is replaced/deleted!

      - -
      -

      16.167.3. REQUIRED PARAMETERS

      +
      +
      +

      16.168.3. REQUIRED PARAMETERS

      confdir

      The directory in ./files/ that contains the /etc/xymon/-content to be deployed.

      - -
      -

      16.167.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.168.4. OPTIONAL PARAMETERS

      owner

      passed as-is as --owner to __rsync

      group

      passed as-is as --group to __rsync

      - -
      -

      16.167.5. OPTIONAL MULTIPLE PARAMETERS

      +
      +
      +

      16.168.5. OPTIONAL MULTIPLE PARAMETERS

      rsync-opts

      identical to __rsync type, only ---options are supported

      - -
      -

      16.167.6. REQUIRED FILES

      +
      +
      +

      16.168.6. REQUIRED FILES

      The directory specified by confdir has to contain a valid xymon-configuration (/etc/xymon/) _plus_ the ext/-directory that normally resides in /usr/lib/xymon/server/.

      - -
      -

      16.167.7. EXAMPLES

      +
      +
      +

      16.168.7. EXAMPLES

      __xymon_config --confdir=xymon.example.com
 # this will replace /etc/xymon/ on the target host with
 # the contents from __xymon_config/files/xymon.example.com/
@@ -428,52 +436,52 @@ __xymon_config --confdir=xymon.example.com "exclude=netrc"
      - -
      -

      16.167.8. SEE ALSO

      +
      +
      +

      16.168.8. SEE ALSO

      cdist__xymon_server(7), cdist__rsync(7), xymon(7)

      - -
      -

      16.167.9. AUTHORS

      +
      +
      +

      16.168.9. AUTHORS

      Thomas Eckert <tom--@--it-eckert.de>

      - -
      -

      16.167.10. COPYING

      +
      +
      +

      16.168.10. COPYING

      Copyright (C) 2018-2019 Thomas Eckert. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -482,7 +490,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -343,20 +349,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.168. cdist-type__xymon_server(7)
      • +
    • 16.169. cdist-type__xymon_server(7)
    • - + View page source @@ -370,14 +378,14 @@
      -
      -

      16.168. cdist-type__xymon_server(7)

      -
      -

      16.168.1. NAME

      +
      +

      16.169. cdist-type__xymon_server(7)

      +
      +

      16.169.1. NAME

      cdist-type__xymon_server - Install a Xymon server

      -
      -
      -

      16.168.2. DESCRIPTION

      +
      +
      +

      16.169.2. DESCRIPTION

      This cdist type installs a Xymon (https://www.xymon.com/) server and (optional) required helper packages.

      This includes the Xymon client as a dependency, so NO NEED to install @@ -387,29 +395,29 @@ required helper packages.

      the use with Xymon.

      Further and day-to-day configuration of Xymon can either be done manually in /etc/xymon/ or the directory can be deployed and managed by __xymon_config.

      - -
      -

      16.168.3. REQUIRED PARAMETERS

      +
      +
      +

      16.169.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.168.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.169.4. OPTIONAL PARAMETERS

      state

      'present', 'absent', defaults to 'present'. If '--install_helpers' is specified for 'absent' the helper packages will be un-installed.

      - -
      -

      16.168.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.169.5. BOOLEAN PARAMETERS

      install_helpers

      Install helper packages used by Xymon (fping, heirloom-mailx, traceroute, ntpdate).

      - -
      -

      16.168.6. EXAMPLES

      +
      +
      +

      16.169.6. EXAMPLES

      # minmal
 __xymon_server
 
@@ -431,53 +439,53 @@ __xymon_config --confdir=xymon.example.com
 __xymon_client --servers "192.168.1.1"
      - -
      -

      16.168.7. SEE ALSO

      +
      +
      +

      16.169.7. SEE ALSO

      cdist__xymon_apache(7), cdist__xymon_config(7), cdist__xymon_client(7), xymon(7)

      - -
      -

      16.168.8. AUTHORS

      +
      +
      +

      16.169.8. AUTHORS

      Thomas Eckert <tom--@--it-eckert.de>

      - -
      -

      16.168.9. COPYING

      +
      +
      +

      16.169.9. COPYING

      Copyright (C) 2018-2019 Thomas Eckert. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -486,7 +494,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.169. cdist-type__yum_repo(7)
      • +
    • 16.170. cdist-type__yum_repo(7)
    • - + View page source @@ -369,22 +377,22 @@
      -
      -

      16.169. cdist-type__yum_repo(7)

      -
      -

      16.169.1. NAME

      +
      +

      16.170. cdist-type__yum_repo(7)

      +
      +

      16.170.1. NAME

      cdist-type__yum_repo - Manage yum repositories

      -
      -
      -

      16.169.2. DESCRIPTION

      +
      +
      +

      16.170.2. DESCRIPTION

      For all undocumented parameters see yum.conf(5).

      - -
      -

      16.169.3. REQUIRED PARAMETERS

      +
      +
      +

      16.170.3. REQUIRED PARAMETERS

      None.

      - -
      -

      16.169.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.170.4. OPTIONAL PARAMETERS

      state

      'present' or 'absent'. Defaults to 'present'

      @@ -425,9 +433,9 @@

      username

      password

      cost

      - -
      -

      16.169.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.170.5. BOOLEAN PARAMETERS

      enabled

      repo_gpgcheck

      @@ -436,9 +444,9 @@

      keepalive

      skip_if_unavailable

      - -
      -

      16.169.6. EXAMPLES

      +
      +
      +

      16.170.6. EXAMPLES

      __yum_repo epel \
    --name 'Extra Packages for Enterprise Linux 6 - $basearch' \
    --mirrorlist 'https://mirrors.fedoraproject.org/metalink?repo=epel-$releasever&arch=$basearch' \
@@ -448,48 +456,48 @@
    --gpgkey https://fedoraproject.org/static/0608B895.txt
      - -
      -

      16.169.7. AUTHORS

      +
      +
      +

      16.170.7. AUTHORS

      Steven Armstrong <steven-cdist--@--armstrong.cc>

      - -
      -

      16.169.8. COPYING

      +
      +
      +

      16.170.8. COPYING

      Copyright (C) 2014 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -498,7 +506,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - - + + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -341,20 +347,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.170. cdist-type__zypper_repo(7)
      • +
    • 16.171. cdist-type__zypper_repo(7)
    • - + View page source @@ -368,22 +376,22 @@
      -
      -

      16.170. cdist-type__zypper_repo(7)

      -
      -

      16.170.1. NAME

      +
      +

      16.171. cdist-type__zypper_repo(7)

      +
      +

      16.171.1. NAME

      cdist-type__zypper_repo - Repository management with zypper

      -
      -
      -

      16.170.2. DESCRIPTION

      +
      +
      +

      16.171.2. DESCRIPTION

      zypper is usually used on the SuSE distribution to manage repositories.

      - -
      -

      16.170.3. REQUIRED PARAMETERS

      +
      +
      +

      16.171.3. REQUIRED PARAMETERS

      None

      - -
      -

      16.170.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.171.4. OPTIONAL PARAMETERS

      state

      Either "present" or "absent" or "enabled" or "disabled", defaults to "present"

        @@ -400,9 +408,9 @@
        repo_id

        If supplied, use the id and not the object id as repo id, can be used with state absent, enabled and disabled

      - -
      -

      16.170.5. EXAMPLES

      +
      +
      +

      16.171.5. EXAMPLES

      # Ensure testrepo in installed
 __zypper_repo testrepo --state present --uri http://url.to.your.repo/with/path
 
@@ -422,48 +430,48 @@ __zypper_repo testrepo3 --state enabled --uri http://url.to.your.repo/with/path
 __zypper_repo testrepo4 --state disabled --repo_id 4
      - -
      -

      16.170.6. AUTHORS

      +
      +
      +

      16.171.6. AUTHORS

      Daniel Heule <hda--@--sfs.biz>

      - -
      -

      16.170.7. COPYING

      +
      +
      +

      16.171.7. COPYING

      Copyright (C) 2013 Daniel Heule. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -472,7 +480,6 @@ License, or (at your option) any later version.

    - + @@ -29,14 +36,10 @@ - - - - - + @@ -63,7 +66,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +83,7 @@ + + @@ -342,20 +348,22 @@ + +
      -
    • Docs »
      • +
    • »
    • 16. cdist types »
      • -
    • 16.171. cdist-type__zypper_service(7)
      • +
    • 16.172. cdist-type__zypper_service(7)
    • - + View page source @@ -369,25 +377,25 @@
      -
      -

      16.171. cdist-type__zypper_service(7)

      -
      -

      16.171.1. NAME

      +
      +

      16.172. cdist-type__zypper_service(7)

      +
      +

      16.172.1. NAME

      cdist-type__zypper_service - Service management with zypper

      -
      -
      -

      16.171.2. DESCRIPTION

      +
      +
      +

      16.172.2. DESCRIPTION

      zypper is usually used on SuSE systems to manage services.

      - -
      -

      16.171.3. REQUIRED PARAMETERS

      +
      +
      +

      16.172.3. REQUIRED PARAMETERS

      uri

      Uri of the service

      - -
      -

      16.171.4. OPTIONAL PARAMETERS

      +
      +
      +

      16.172.4. OPTIONAL PARAMETERS

      service_desc

      If supplied, use the service_desc and not the object id as description for the service.

      @@ -396,18 +404,18 @@
      type

      Defaults to "ris", the standard type of services at SLES11. For other values, see manpage of zypper.

      - -
      -

      16.171.5. BOOLEAN PARAMETERS

      +
      +
      +

      16.172.5. BOOLEAN PARAMETERS

      remove-all-other-services

      Drop all other services found on the target host before adding the new one.

      remove-all-repos

      If supplied, remove all existing repos prior to setup the new service.

      - -
      -

      16.171.6. EXAMPLES

      +
      +
      +

      16.172.6. EXAMPLES

      # Ensure that internal SLES11 SP3 RIS is in installed and all other services and repos are discarded
 __zypper_service INTERNAL_SLES11_SP3 --service_desc "Internal SLES11 SP3 RIS" --uri "http://path/to/your/ris/dir" --remove-all-other-services --remove-all-repos
 
@@ -418,48 +426,48 @@ __zypper_service INTERNAL_SLES11_SP3 --service_desc "Inter
 __zypper_service INTERNAL_SLES11_SP3 --state absent --uri "http://path/to/your/ris/dir"
      - -
      -

      16.171.7. AUTHORS

      +
      +
      +

      16.172.7. AUTHORS

      Daniel Heule <hda--@--sfs.biz>

      - -
      -

      16.171.8. COPYING

      +
      +
      +

      16.172.8. COPYING

      Copyright (C) 2013 Daniel Heule. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

      - - +
      +
    - @@ -468,7 +476,6 @@ License, or (at your option) any later version.

    - + + - - - - - - - + + @@ -63,7 +67,7 @@
    - 6.9.7 + 6.9.8
    @@ -80,6 +84,7 @@ + + @@ -159,19 +165,19 @@ + +
      -
    • Docs »
      • +
    • »
    • Search
    • - -
    @@ -185,8 +191,7 @@ @@ -200,20 +205,25 @@
    - @@ -222,7 +232,6 @@ -