cdist manpages update: 4.3.1

blog/cdist-4.3.1-released.mdwn

@@ -0,0 +1,12 @@
+[[!meta title="Cdist 4.3.1 released"]]
+
+Here's a short overview about the changes found in version 4.3.1:
+
+	* Documentation: Spelling fixes (Darko Poljak)
+	* Type __filesystem: Spelling fixes (Dmitry Bogatov)
+	* Core: Add target_host file to cache since cache dir name can be hash (Darko Poljak)
+	* Core: Improve hostfile: support comments, skip empty lines (Darko Poljak)
+
+For more information visit the [[cdist homepage|software/cdist]].
+
+[[!tag cdist config unix]]

software/cdist/man/4.3.1/_sources/cdist-best-practice.txt

@@ -0,0 +1,223 @@
+Best practice
+=============
+Practices used in real environments
+
+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).
+
+
+Speeding up ssh connections
+---------------------------
+When connecting to a new host, the initial delay with ssh connections
+is pretty big. You can work around this by
+"sharing of multiple sessions over a single network connection"
+(quote from ssh_config(5)). The following code is suitable for
+inclusion into your ~/.ssh/config::
+
+    Host *
+      ControlPath ~/.ssh/master-%l-%r@%h:%p
+      ControlMaster auto
+      ControlPersist 10
+
+
+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
+
+
+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
+control git. For instance if you plan to use the typical three
+environments production, integration and development, you can
+realise this with git branches::
+
+    # Go to cdist checkout
+    cd /path/to/cdist
+
+    # Create branches
+    git branch development
+    git branch integration
+    git branch production
+
+    # Make use of a branch, for instance production
+    git checkout production
+
+Similar if you want to have cdist checked out at multiple machines,
+you can clone it multiple times::
+
+    machine-a % git clone git://your-git-server/cdist
+    machine-b % git clone git://your-git-server/cdist
+
+
+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
+their manifests. You can use the following snippet in
+**conf/manifests/init**::
+
+    # Include other groups
+    sh -e "$__manifest/systems"
+
+    sh -e "$__manifest/cbrg"
+
+
+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.
+Including a possible common base that is reused across the different sites::
+
+    # create branches
+    git branch company_a company_b common private
+
+    # make stuff for company a
+    git checkout company_a
+    # work, commit, etc.
+
+    # make stuff for company b
+    git checkout company_b
+    # work, commit, etc.
+
+    # make stuff relevant for all sites
+    git checkout common
+    # work, commit, etc.
+
+    # change to private and include latest common stuff
+    git checkout private
+    git merge common
+
+
+The following **.git/config** is taken from a a real world scenario::
+
+    # Track upstream, merge from time to time
+    [remote "upstream"]
+       url = git://git.schottelius.org/cdist
+       fetch = +refs/heads/*:refs/remotes/upstream/*
+
+    # Same as upstream, but works when being offline
+    [remote "local"]
+       fetch = +refs/heads/*:refs/remotes/local/*
+       url = /home/users/nico/p/cdist
+
+    # Remote containing various ETH internal branches
+    [remote "eth"]
+       url = sans.ethz.ch:/home/services/sans/git/cdist-eth
+       fetch = +refs/heads/*:refs/remotes/eth/*
+
+    # Public remote that contains my private changes to cdist upstream
+    [remote "nico"]
+       url = git.schottelius.org:/home/services/git/cdist-nico
+       fetch = +refs/heads/*:refs/remotes/nico/*
+
+    # The "nico" branch will be synced with the remote nico, branch master
+    [branch "nico"]
+       remote = nico
+       merge = refs/heads/master
+
+    # ETH stable contains rock solid configurations used in various places
+    [branch "eth-stable"]
+       remote = eth
+       merge = refs/heads/stable
+
+Have a look at git-remote(1) to adjust the remote configuration, which allows
+
+
+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
+implement this scenario with a gateway host and sudo:
+
+- Create a dedicated user (for instance **cdist**)
+- Setup the ssh-pubkey for this user that has the right to configure all hosts
+- Create a wrapper to update the cdist configuration in ~cdist/cdist
+- Allow every developer to execute this script via sudo as the user cdist
+- Allow run of cdist as user cdist on specific hosts on a per user/group base
+
+    - f.i. nico ALL=(ALL) NOPASSWD: /home/cdist/bin/cdist config hostabc
+
+For more details consult sudoers(5)
+
+
+Templating
+----------
+* create directory files/ in your type (convention)
+* create the template as an executable file like files/basic.conf.sh, it will output text using shell variables for the values
+
+.. code-block:: sh
+
+    #!/bin/sh
+    # in the template, use cat << eof (here document) to output the text
+    # and use standard shell variables in the template
+    # output everything in the template script to stdout
+    cat << EOF
+    server {
+      listen                          80;
+      server_name                     $SERVERNAME;
+      root                            $ROOT;
+
+      access_log /var/log/nginx/$SERVERNAME_access.log
+      error_log /var/log/nginx/$SERVERNAME_error.log
+    }
+    EOF
+
+* in the manifest, export the relevant variables and add the following lines in your manifest:
+
+.. code-block:: console
+
+    # export variables needed for the template
+      export SERVERNAME='test"
+      export ROOT='/var/www/test'
+    # render the template
+      mkdir -p "$__object/files"
+      "$__type/files/basic.conf.sh" > "$__object/files/basic.conf"
+    # send the rendered template
+      __file /etc/nginx/sites-available/test.conf  \
+        --state present
+        --source "$__object/files/basic.conf"
+
+
+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
+with - (stdin) as argument and feed object into stdin
+of cdist:
+
+.. code-block:: sh
+
+    # Singleton type without parameter
+    echo __ungleich_munin_server | cdist --initial-manifest - munin.panter.ch
+
+    # Singleton type with parameter
+    echo __ungleich_munin_node --allow 1.2.3.4 | \
+        cdist --initial-manifest - rails-19.panter.ch
+
+    # Normal type
+    echo __file /tmp/stdintest --mode 0644 | \
+        cdist --initial-manifest - cdist-dev-01.ungleich.ch
+
+
+Other content in cdist repository
+---------------------------------
+Usually the cdist repository contains all configuration
+items. Sometimes you may have additional resources that
+you would like to store in your central configuration
+repositiory (like password files from KeepassX,
+Libreoffice diagrams, etc.).
+
+It is recommended to use a subfolder named "non-cdist"
+in the repository for such content: It allows you to
+easily distinguish what is used by cdist and what not
+and also to store all important files in one
+repository.

software/cdist/man/4.3.1/_sources/cdist-bootstrap.txt

@@ -0,0 +1,118 @@
+Bootstrap
+=========
+This document describes the usual steps recommended for a new
+cdist setup. It is recommended that you have read and understood
+`cdist quickstart <cdist-quickstart.html>`_ before digging into this.
+
+
+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
+think about where to configure your hosts from, which may be a different
+location.
+
+For starters, having cdist (which includes the configuration database) on
+your notebook should be fine.
+Additionally an external copy of the git repository the configuration
+relies on is recommended, for use as backup as well as to allow easy collaboration
+with others.
+
+For more sophisticated setups developing cdist configurations with multiple
+people, have a look at `cdist best practice <cdist-best-practice.html>`_.
+
+
+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 <cdist-quickstart.html>`_ if you don't).
+Entering the command "git branch" should show you "* master", which indicates
+you are on the **master** branch.
+
+The master branch reflects the latest development of cdist. As this is the
+development branch, it may or may not work. There are also version branches 
+available, which are kept in a stable state. Let's use **git branch -r**
+to list all branches::
+
+    cdist% git branch -r
+      origin/1.0
+      origin/1.1
+      origin/1.2
+      origin/1.3
+      origin/1.4
+      origin/1.5
+      origin/1.6
+      origin/1.7
+      origin/2.0
+      origin/HEAD -> origin/master
+      origin/archive_shell_function_approach
+      origin/master
+
+So **2.0** is the latest version branch in this example.
+All versions (2.0.x) within one version branch (2.0) are compatible to each
+other and won't break your configuration when updating.
+
+It's up to you to decide which branch you want to base your own work on:
+master contains more recent changes, newer types, but may also break.
+The version branches are stable, but may lack the latest features.
+Your decision can be changed later on, but may result in merge conflicts,
+which you will need to solve.
+
+Let's assume you want latest stuff and select the master branch as base for
+your own work. Now it's time to create your branch, which contains your
+local changes. I usually name it by the company/area I am working for:
+ethz-systems, localch, customerX, ... But this is pretty much up to you.
+
+In this tutorial I use the branch **mycompany**::
+
+    cdist% git checkout -b mycompany origin/master 
+    Branch mycompany set up to track remote branch master from origin.
+    Switched to a new branch 'mycompany'
+    cdist-user% git branch
+      master
+    * mycompany
+
+From now on, you can use git as usual to commit your changes in your own branch.
+
+
+Publishing the configuration
+----------------------------
+Usually a development machine like a notebook should be considered
+temporary only. For this reason and to enable shareability, the configuration
+should be published to another device as early as possible. The following
+example shows how to publish the configuration to another host that is
+reachable via ssh and has git installed::
+
+    # Create bare git repository on the host named "loch"
+    cdist% ssh loch "GIT_DIR=/home/nutzer/cdist git init"
+    Initialized empty Git repository in /home/nutzer/cdist/
+
+    # Add remote git repo to git config
+    cdist% git remote add loch loch:/home/nutzer/cdist 
+
+    # Configure the mycompany branch to push to loch
+    cdist% git config branch.mycompany.remote loch
+
+    # Configure mycompany branch to push into remote master branch
+    cdist% git config branch.mycompany.merge refs/heads/master
+
+    # Push mycompany branch to remote branch master initially
+    cdist% git push loch mycompany:refs/heads/master
+
+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**.
+
+
+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
+    cdist% git fetch origin
+
+    # Update current branch with master branch from origin
+    cdist% git merge origin/master
+
+    # Alternative: Update current branch with 2.0 branch from origin
+    cdist% git merge origin/2.0

software/cdist/man/4.3.1/_sources/cdist-explorer.txt

@@ -0,0 +1,54 @@
+Explorer
+========
+
+Description
+-----------
+Explorer are small shell scripts, which will be executed on the target
+host. The aim of the explorer is to give hints to types on how to act on the
+target system. An explorer outputs the result to stdout, which is usually
+a one liner, but may be empty or multi line especially in the case of
+type explorers.
+
+There are general explorers, which are run in an early stage, and
+type explorers. Both work almost exactly the same way, with the difference
+that the values of the general explorers are stored in a general location and
+the type specific below the object.
+
+Explorers can reuse other explorers on the target system by calling
+
+::
+
+    $__explorer/<explorer_name> (general and type explorer)
+
+or
+
+::
+
+    $__type_explorer/<explorer name> (type explorer).
+
+In case of significant errors, the explorer may exit non-zero and return an
+error message on stderr, which will cause cdist to abort.
+
+You can also use stderr for debugging purposes while developing a new
+explorer.
+
+Examples
+--------
+A very simple explorer may look like this::
+
+    hostname
+
+Which is in practise the **hostname** explorer.
+
+A type explorer, which could check for the status of a package may look like this:
+
+.. code-block:: sh
+
+    if [ -f "$__object/parameter/name" ]; then
+       name="$(cat "$__object/parameter/name")"
+    else
+       name="$__object_id"
+    fi
+
+    # Expect dpkg failing, if package is not known / installed
+    dpkg -s "$name" 2>/dev/null || exit 0

software/cdist/man/4.3.1/_sources/cdist-features.txt

@@ -0,0 +1,48 @@
+Features
+========
+
+But cdist ticks differently, here is the feature set that makes it unique:
+
+Simplicity
+    There is only one type to extend cdist called **type**
+
+Design
+    + Type and core cleanly separated
+    + Sticks completly to the KISS (keep it simple and stupid) paradigma
+    + Meaningful error messages - do not lose time debugging error messages
+    + Consistency in behaviour, naming and documentation
+    + No surprise factor: Only do what is obviously clear, no magic
+    + Define target state, do not focus on methods or scripts
+    + Push architecture: Instantly apply your changes
+
+Small core
+    cdist's core is very small - less code, less bugs
+
+Fast development
+    Focus on straightforwardness of type creation is a main development objective
+    Batteries included: A lot of requirements can be solved using standard types
+
+Modern Programming Language
+    cdist is written in Python
+
+Requirements, Scalability
+    No central server needed, cdist operates in push mode and can be run from any computer
+
+Requirements, Scalability, Upgrade
+    cdist only needs to be updated on the master, not on the target hosts
+
+Requirements, Security
+    Uses well-know `SSH <http://www.openssh.com/>`_ as transport protocol
+
+Requirements, Simplicity
+    Requires only shell and SSH server on the target
+
+UNIX
+    Reuse of existing tools like cat, find, mv, ...
+
+UNIX, familar environment, documentation
+    Is available as manpages and HTML
+
+UNIX, simplicity, familar environment
+    cdist is configured in POSIX shell
+

software/cdist/man/4.3.1/_sources/cdist-hacker.txt

@@ -0,0 +1,146 @@
+Hacking
+=======
+
+Welcome
+-------
+Welcome dear hacker! I invite you to a tour of pointers to
+get into the usable configuration mangament system, cdist.
+
+The first thing to know is probably that cdist is brought to
+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.
+
+
+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 github.
+
+
+Coding conventions (everywhere)
+-------------------------------
+If something should be better done or needs to fixed, add the word FIXME
+nearby, so grepping for FIXME gives all positions that need to be fixed.
+
+Indention is 4 spaces (welcome to the python world).
+
+
+How to submit stuff for inclusion into upstream cdist
+-----------------------------------------------------
+If you did some cool changes to cdist, which you value as a benefit for
+everybody using cdist, you're welcome to propose inclusion into upstream.
+
+There are though some requirements to ensure your changes don't break others
+work nor kill the authors brain:
+
+- All files should contain the usual header (Author, Copying, etc.)
+- Code submission must be done via git
+- Do not add cdist/conf/manifest/init - This file should only be touched in your
+  private branch!
+- Code to be included should be branched of the upstream "master" branch
+
+   - Exception: Bugfixes to a version branch
+
+- On a merge request, always name the branch I should pull from
+- Always ensure **all** manpages build. Use **./build man** to test.
+- If you developed more than **one** feature, consider submitting them in
+  separate branches. This way one feature can already be included, even if
+  the other needs to be improved.
+
+As soon as your work meets these requirements, write a mail
+for inclusion to the mailinglist **cdist at cdist -- at -- l.schottelius.org**
+or open a pull request at http://github.com/telmich/cdist.
+
+
+How to submit a new type
+------------------------
+For detailed information about types, see `cdist type <cdist-type.html>`_.
+
+Submitting a type works as described above, with the additional requirement
+that a corresponding manpage named man.text in asciidoc format with
+the manpage-name "cdist-type__NAME" is included in the type directory
+AND asciidoc is able to compile it (i.e. do NOT have to many "=" in the second
+line).
+
+Warning: Submitting "exec" or "run" types that simply echo their parameter in
+**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.
+
+
+Example git workflow
+---------------------
+The following workflow works fine for most developers
+
+.. code-block:: sh
+
+    # get latest upstream master branch
+    git clone https://github.com/telmich/cdist.git
+
+    # update if already existing
+    cd cdist; git fetch -v; git merge origin/master
+
+    # create a new branch for your feature/bugfix
+    cd cdist # if you haven't done before
+    git checkout -b documentation_cleanup
+
+    # *hack*
+    *hack*
+
+    # clone the cdist repository on github if you haven't done so
+
+    # configure your repo to know about your clone (only once)
+    git remote add github git@github.com:YOURUSERNAME/cdist.git
+
+    # push the new branch to github 
+    git push github documentation_cleanup
+
+    # (or everything)
+    git push --mirror github
+
+    # create a pull request at github (use a browser)
+    # *fixthingsbecausequalityassurancefoundissuesinourpatch*
+    *hack*
+
+    # push code to github again
+    git push ... # like above
+
+    # add comment that everything should be green now (use a browser)
+
+    # go back to master branch
+    git checkout master
+
+    # update master branch that includes your changes now
+    git fetch -v origin
+    git diff master..origin/master
+    git merge origin/master
+
+If at any point you want to go back to the original master branch, you can
+use **git stash** to stash your changes away::
+
+.. code-block:: sh
+
+    # assume you are on documentation_cleanup
+    git stash
+
+    # change to master and update to most recent upstream version
+    git checkout master
+    git fetch -v origin
+    git merge origin/master
+
+Similar when you want to develop another new feature, you go back
+to the master branch and create another branch based on it::
+
+.. code-block:: sh
+
+    # change to master and update to most recent upstream version
+    git checkout master
+    git fetch -v origin
+    git merge origin/master
+
+    git checkout -b another_feature
+
+(you can repeat the code above for as many features as you want to develop
+in parallel)

software/cdist/man/4.3.1/_sources/cdist-install.txt

@@ -0,0 +1,130 @@
+How to install cdist
+====================
+
+Requirements
+-------------
+
+Source Host
+~~~~~~~~~~~
+
+This is the machine you use to configure the target hosts.
+
+ * /bin/sh: A posix like shell (for instance bash, dash, zsh)
+ * Python >= 3.2
+ * SSH client
+ * sphinx (for building html docs and/or the man pages)
+
+Target Hosts
+~~~~~~~~~~~~
+
+ * /bin/sh: A posix like shell (for instance bash, dash, zsh)
+ * SSH server
+
+Install cdist
+-------------
+
+You can install cdist either from git or as a python package.
+
+From git
+~~~~~~~~
+
+Cloning cdist from git gives you the advantage of having
+a version control in place for development of your own stuff
+immediately.
+
+To install cdist, execute the following commands:
+
+.. code-block:: sh
+
+    git clone https://github.com/ungleich/cdist.git
+    cd cdist
+    export PATH=$PATH:$(pwd -P)/bin
+
+Available versions in git
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ * The active development takes place in the **master** branch
+ * The released versions can be found in the tags
+
+Other branches may be available for features or bugfixes, but they
+may vanish at any point. To select a specific branch use
+
+.. code-block:: sh
+
+    # Generic code
+    git checkout -b <localbranchname> origin/<branchname>
+
+So for instance if you want to use and stay with version 4.1, you can use
+
+.. code-block:: sh
+
+    git checkout -b 4.1 origin/4.1
+
+Git mirrors
+^^^^^^^^^^^
+
+If the main site is down, you can acquire cdist from one of the following sites:
+
+ * git://github.com/telmich/cdist.git `github <https://github.com/telmich/cdist>`_
+ * git://git.code.sf.net/p/cdist/code `sourceforge <https://sourceforge.net/p/cdist/code>`_
+
+Building and using documentation (man and html)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you want to build and use the documentation, run:
+
+.. code-block:: sh
+
+    make docs
+
+Documentation comes in two formats, man pages and full HTML
+documentation. Documentation is built into distribution's
+docs/dist directory. man pages are in docs/dist/man and
+HTML documentation in docs/dist/html.
+
+If you want to use man pages, run:
+
+.. code-block:: sh
+
+    export MANPATH=$MANPATH:$(pwd -P)/docs/dist/man
+
+Or you can move man pages from docs/dist/man directory to some
+other directory and add it to MANPATH.
+
+Full HTML documentation can be accessed at docs/dist/html/index.html.
+
+You can also build only man pages or only html documentation, for
+only man pages run:
+
+.. code-block:: sh
+
+    make man
+
+for only html documentation run:
+
+.. code-block:: sh
+
+    make html
+
+You can also build man pages for types in your ~/.cdist directory:
+
+.. code-block:: sh
+
+    make dotman
+
+Built man pages are now in docs/dist/man directory. If you have
+some other custom .cdist directory, e.g. /opt/cdist then use:
+
+.. code-block:: sh
+
+    DOT_CDIST_PATH=/opt/cdist make dotman
+
+Python package
+~~~~~~~~~~~~~~
+
+Cdist is available as a python package at
+`PyPi <http://pypi.python.org/pypi/cdist/>`_. You can install it using
+
+.. code-block:: sh
+
+    pip install cdist

software/cdist/man/4.3.1/_sources/cdist-intro.txt

@@ -0,0 +1,15 @@
+cdist - usable configuration management
+=======================================
+
+.. image:: cdist-logo.png
+    :alt: cdist-logo
+
+cdist is a usable configuration management system.
+It adheres to the KISS principle and 
+is being used in small up to enterprise grade environments.
+cdist is an alternative to other configuration management systems like
+
+* `bcfg2 <http://trac.mcs.anl.gov/projects/bcfg2>`_
+* `chef <http://wiki.opscode.com/display/chef/>`_
+* `cfengine <http://www.cfengine.org/>`_
+* `puppet <http://www.puppetlabs.com/>`_.

software/cdist/man/4.3.1/_sources/cdist-manifest.txt

@@ -0,0 +1,255 @@
+Manifest
+========
+
+Description
+-----------
+Manifests are used to define which objects to create.
+Objects are instances of **types**, like in object oriented programming languages.
+An object is represented by the combination of
+**type + slash + object name**: **\__file/etc/cdist-configured** is an
+object of the type **__file** with the name **etc/cdist-configured**.
+
+All available types can be found in the **cdist/conf/type/** directory,
+use **ls cdist/conf/type** to get the list of available types. If you have
+setup the MANPATH correctly, you can use **man cdist-reference** to access
+the reference with pointers to the manpages.
+
+
+Types in manifests are used like normal command line tools. Let's have a look
+at an example::
+
+    # Create object of type __package with the parameter state = absent
+    __package apache2 --state absent
+
+    # Same with the __directory type
+    __directory /tmp/cdist --state present
+
+These two lines create objects, which will later be used to realise the 
+configuration on the target host.
+
+Manifests are executed locally as a shell script using **/bin/sh -e**.
+The resulting objects are stored in an internal database.
+
+The same object can be redefined in multiple different manifests as long as
+the parameters are exactly the same.
+
+In general, manifests are used to define which types are used depending
+on given conditions.
+
+
+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 <cdist-type.html>`_.
+
+
+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.
+Cdist expects the initial manifest at **cdist/conf/manifest/init**.
+
+Within this initial manifest you define, which objects should be
+created on which host. To distinguish between hosts, you can use the
+environment variable **__target_host** and/or **__target_hostname** and/or
+**__target_fqdn**. Let's have a look at a simple example::
+
+    __cdistmarker
+
+    case "$__target_host" in
+       localhost)
+            __directory /home/services/kvm-vm --parents yes
+       ;;
+    esac
+
+This manifest says: Independent of the host, always use the type 
+**__cdistmarker**, which creates the file **/etc/cdist-configured**,
+with the timestamp as content.
+The directory **/home/services/kvm-vm**, including all parent directories, 
+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.
+
+
+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**.
+Cdist provides the environment variable **__manifest** to reference
+the directory containing the initial manifest (see `cdist reference <cdist-reference.html>`_).
+
+The following example would include every file with a **.sh** suffix::
+
+    # Include *.sh
+    for manifest in $__manifest/*.sh; do
+        # And source scripts into our shell environment
+        . "$manifest"
+    done
+
+
+Dependencies
+------------
+If you want to describe that something requires something else, just
+setup the variable "require" to contain the requirements. Multiple
+requirements can be added white space separated.
+
+::
+
+     1 # No dependency
+     2 __file /etc/cdist-configured
+     3 
+     4 # Require above object
+     5 require="__file/etc/cdist-configured" __link /tmp/cdist-testfile \
+     6    --source /etc/cdist-configured  --type symbolic
+     7 
+     8 # Require two objects
+     9 require="__file/etc/cdist-configured __link/tmp/cdist-testfile" \
+    10    __file /tmp/cdist-another-testfile
+
+
+Above the "require" variable is only set for the command that is 
+immediately following it. Dependencies should always be declared that way.
+
+On line 4 you can see that the instantion of a type "\__link" object needs
+the object "__file/etc/cdist-configured" to be present, before it can proceed.
+
+This also means that the "\__link" command must make sure, that either
+"\__file/etc/cdist-configured" already is present, or, if it's not, it needs
+to be created. The task of cdist is to make sure, that the dependency will be
+resolved appropriately and thus "\__file/etc/cdist-configured" be created
+if necessary before "__link" proceeds (or to abort execution with an error).
+
+If you really need to make all types depend on a common dependency, you can
+export the "require" variable as well. But then, if you need to add extra
+dependencies to a specific type, you have to make sure that you append these
+to the globally already defined one.
+
+::
+
+    # First of all, update the package index
+    __package_update_index
+    # Upgrade all the installed packages afterwards
+    require="__package_update_index" __package_upgrade_all
+    # Create a common dependency for all the next types so that they get to
+    # be executed only after the package upgrade has finished
+    export require="__package_upgrade_all"
+
+    # Ensure that lighttpd is installed after we have upgraded all the packages
+    __package lighttpd --state present
+    # Ensure that munin is installed after lighttpd is present and after all
+    # the packages are upgraded
+    require="$require __package/lighttpd" __package munin --state present
+
+
+All objects that are created in a type manifest are automatically required
+from the type that is calling them. This is called "autorequirement" in
+cdist jargon.
+
+You can find an more in depth description of the flow execution of manifests
+in `cdist execution stages <cdist-stages.html>`_ and of how types work in `cdist type <cdist-type.html>`_.
+
+
+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.
+When cdist sees that this variable is setup, the current created object
+automatically depends 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).
+
+
+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.
+If you wish, you can setup the environment variable CDIST_OVERRIDE
+(any value or even empty is ok) to tell cdist, that this object override is 
+wanted and should be accepted.
+ATTENTION: Only use this feature if you are 100% sure in which order 
+cdist encounters the affected objects, otherwise this results
+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.
+
+
+Examples
+--------
+The initial manifest may for instance contain the following code:
+
+.. code-block:: sh
+
+    # Always create this file, so other sysadmins know cdist is used.
+    __file /etc/cdist-configured
+
+    case "$__target_host" in
+       my.server.name)
+          __directory /root/bin/
+          __file /etc/issue.net --source "$__manifest/issue.net
+       ;;
+    esac
+
+The manifest of the type "nologin" may look like this:
+
+.. code-block:: sh
+
+    __file /etc/nologin --source "$__type/files/default.nologin"
+
+This example makes use of dependencies:
+
+.. code-block:: sh
+
+    # Ensure that lighttpd is installed
+    __package lighttpd --state present
+    # Ensure that munin makes use of lighttpd instead of the default webserver
+    # package as decided by the package manager
+    require="__package/lighttpd" __package munin --state present
+
+How to override objects:
+
+.. code-block:: sh
+
+    # for example in the initial manifest
+
+    # create user account foobar with some hash for password
+    __user foobar --password 'some_fancy_hash' --home /home/foobarexample
+
+    # ... many statements and includes in the manifest later ...
+    # somewhere in a conditionally sourced manifest
+    # (e.g. for example only sourced if a special application is on the target host)
+
+    # this leads to an error ...
+    __user foobar --password 'some_other_hash' 
+
+    # this tells cdist, that you know that this is an override and should be accepted
+    CDIST_OVERRIDE=yes __user foobar --password 'some_other_hash'
+    # it's only an override, means the parameter --home is not touched 
+    # and stays at the original value of /home/foobarexample
+
+Dependencies defined by execution order work as following:
+
+.. code-block:: sh
+
+    # Tells cdist to execute all types in the order in which they are created ...
+    export CDIST_ORDER_DEPENDENCY=on
+    __sample_type 1
+    require="__some_type_somewhere/id" __sample_type 2
+    __example_type 23
+    # Now this types are executed in the creation order until the variable is unset
+    unset CDIST_ORDER_DEPENDENCY
+    # all now following types cdist makes the order ..
+    __not_in_order_type 42
+
+    # how it works :
+    # this lines above are translated to:
+    __sample_type 1
+    require="__some_type_somewhere/id __sample_type/1" __sample_type 2
+    require="__sample_type/2" __example_type 23
+    __not_in_order_type 42

software/cdist/man/4.3.1/_sources/cdist-messaging.txt

@@ -0,0 +1,94 @@
+Messaging
+=========
+
+Description
+-----------
+cdist has a simple but powerful way of allowing communication between
+the initial manifest and types as well as types and types.
+
+Whenever execution is passed from cdist to one of the
+scripts described below, cdist generate 2 new temporary files
+and exports the environment variables **__messages_in** and
+**__messages_out** to point to them. 
+
+Before handing over the control, the content of the global message 
+file is copied into the file referenced by **$__messages_in**.
+
+After cdist gained control back, the content of the file referenced
+by **$__messages_out** is appended to the global message file.
+
+This way overwriting any of the two files by accident does not 
+interfere with other types.
+
+The order of execution is not defined unless you create dependencies 
+between the different objects (see `cdist manifest <cdist-manifest.html>`_) and thus you
+can only react reliably on messages by objects that you depend on.
+
+
+Availability
+------------
+Messaging is possible between all **local** scripts:
+
+- initial manifest
+- type/manifest
+- type/gencode-local
+- type/gencode-remote
+
+
+Examples
+--------
+When you want to emit a message use:
+
+.. code-block:: sh
+
+    echo "something" >> "$__messages_out"
+
+When you want to react on a message use:
+
+.. code-block:: sh
+
+    if grep -q "^__your_type/object/id:something" "$__messages_in"; then
+        echo "I do something else"
+    fi
+
+Some real life examples:
+
+.. code-block:: sh
+
+    # Reacting on changes from block for keepalive
+    if grep -q "^__block/keepalive-vrrp" "$__messages_in"; then
+        echo /etc/init.d/keepalived restart
+    fi
+
+    # Reacting on changes of configuration files
+    if grep -q "^__file/etc/one" $__messages_in; then
+        echo 'for init in /etc/init.d/opennebula*; do $init restart; done'
+    fi
+
+Restart sshd on changes
+
+.. code-block:: sh
+
+    os="$(cat "$__global/explorer/os")"
+
+    case "$os" in
+        centos|redhat|suse)
+            restart="/etc/init.d/sshd restart"
+        ;;
+        debian|ubuntu)
+            restart="/etc/init.d/ssh restart"
+        ;;
+        *)
+            cat << eof >&2
+    Unsupported os $os.
+    If you would like to have this type running on $os,
+    you can either develop the changes and send a pull
+    request or ask for a quote at www.ungleich.ch
+    eof
+            exit 1
+        ;;
+    esac
+
+    if grep -q "^__key_value/PermitRootLogin" "$__messages_in"; then
+        echo $restart
+    fi

software/cdist/man/4.3.1/_sources/cdist-os.txt

@@ -0,0 +1,16 @@
+Supported Operating Systems
+===========================
+
+cdist was tested or is know to run on at least
+
+* `Archlinux <http://www.archlinux.org/>`_
+* `Debian <http://www.debian.org/>`_
+* `CentOS <http://www.centos.org/>`_
+* `Fedora <http://fedoraproject.org/>`_
+* `FreeBSD <http://www.freebsd.org>`_
+* `Gentoo <http://www.gentoo.org/>`_
+* `Mac OS X <http://www.apple.com/macosx/>`_
+* `OpenBSD <http://www.openbsd.org>`_
+* `Redhat <http://www.redhat.com/>`_
+* `Ubuntu <http://www.ubuntu.com/>`_
+* `XenServer <http://www.citrix.com/xenserver/>`_

software/cdist/man/4.3.1/_sources/cdist-parallelization.txt

@@ -0,0 +1,73 @@
+Parallelization
+===============
+
+Description
+-----------
+cdist has two modes of parallel operation.
+
+One of them is to operate on each host in separate process. This is enabled
+with :strong:`-p/--parallel` option.
+
+The other way is to operate in parallel within one host where you specify
+the number of jobs. This is enabled with :strong:`-j/--jobs` option where you
+can specify the number of parallel jobs. By default,
+:strong:`multiprocessing.cpu_count()` is used. For this mode only global
+explorers are currently supported and this option is still in :strong:`beta`.
+
+You can, of course, use those two options together. This means that each host
+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 :strong:`cdist`\ (1).
+
+
+Examples
+--------
+
+.. code-block:: sh
+
+    # Configure hosts read from file hosts.file in parallel
+    $ cdist config -p -f hosts.file
+
+    # Configure hosts read from file hosts.file sequentially but using default
+    # number of parallel jobs
+    $ cdist config -b -j -f hosts.file
+
+    # Configure hosts read from file hosts.file in parallel using 16
+    # parallel jobs
+    $ cdist config -b -j 16 -p -f hosts.file
+
+
+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
+on target SSH server and its configuration you may encounter connection drops.
+This is controlled with sshd :strong:MaxStartups configuration options.
+You may also encounter session open refusal. This happens with ssh multiplexing
+when you reach maximum number of open sessions permitted per network 
+connection. In this case ssh will disable multiplexing.
+This limit is controlled with sshd :strong:MaxSessions configuration
+options. For more details refer to :strong:`sshd_config`\ (5).
+
+For example, if you reach :strong:`MaxSessions` sessions you may get the
+following output:
+
+.. code-block:: sh
+
+    $ cdist config -b -j 11 -v 78.47.116.244
+    INFO: cdist: version 4.2.2-55-g640b7f9
+    INFO: 78.47.116.244: Running global explorers
+    INFO: 78.47.116.244: Remote transfer in 11 parallel jobs
+    channel 22: open failed: administratively prohibited: open failed
+    mux_client_request_session: session request failed: Session open refused by peer
+    ControlSocket /tmp/tmpuah6fw_t/d886d4b7e4425a102a54bfaff4d2288b/ssh-control-path already exists, disabling multiplexing
+    INFO: 78.47.116.244: Running global explorers in 11 parallel jobs
+    channel 22: open failed: administratively prohibited: open failed
+    mux_client_request_session: session request failed: Session open refused by peer
+    ControlSocket /tmp/tmpuah6fw_t/d886d4b7e4425a102a54bfaff4d2288b/ssh-control-path already exists, disabling multiplexing
+    INFO: 78.47.116.244: Running initial manifest /tmp/tmpuah6fw_t/d886d4b7e4425a102a54bfaff4d2288b/data/conf/manifest/init
+    INFO: 78.47.116.244: Running manifest and explorers for __file/root/host.file
+    INFO: 78.47.116.244: Generating code for __file/root/host.file
+    INFO: 78.47.116.244: Finished successful run in 18.655028820037842 seconds
+    INFO: cdist: Total processing time for 1 host(s): 19.159148693084717

software/cdist/man/4.3.1/_sources/cdist-quickstart.txt

@@ -0,0 +1,79 @@
+Quickstart
+==========
+
+This tutorial is aimed at people learning cdist and shows
+typical approaches as well as gives an easy start into
+the world of configuration management.
+
+For those who just want to configure a system with the
+cdist configuration management and do not need (or want)
+to understand everything.
+
+This tutorial assumes you are configuring **localhost**, because
+it is always available. Just replace **localhost** with your target
+host for real life usage.
+
+Cdist uses **ssh** for communication and transportation
+and usually logs into the **target host** as the
+**root** user. So you need to configure the **ssh server**
+of the target host to allow root logins: Edit
+the file **/etc/ssh/sshd_config** and add one of the following
+lines::
+
+    # Allow login only via public key
+    PermitRootLogin without-password
+
+    # Allow login via password and public key
+    PermitRootLogin yes
+
+As cdist uses ssh intensively, it is recommended to setup authentication
+with public keys::
+
+    # Generate pubkey pair as a normal user
+    ssh-keygen
+
+    # Copy pubkey over to target host
+    ssh-copy-id root@localhost
+
+Have a look at ssh-agent(1) and ssh-add(1) on how to cache the password for
+your public key.  Usually it looks like this::
+
+    # Start agent and export variables
+    eval `ssh-agent`
+
+    # Add keys (requires password for every identity file)
+    ssh-add
+
+At this point you should be able to **ssh root@localhost** without
+re-entering the password. If something failed until here, ensure that
+all steps went successfully and you have read and understood the
+documentation.
+
+As soon as you are able to login without password to localhost,
+we can use cdist to configure it. You can copy and paste the following
+code into your shell to get started and configure localhost::
+
+    # Get cdist 
+    # Mirrors can be found on
+    # http://www.nico.schottelius.org/software/cdist/install/#index2h4
+    git clone git://git.schottelius.org/cdist
+
+    # Create manifest (maps configuration to host(s)
+    cd cdist
+    echo '__file /etc/cdist-configured' > cdist/conf/manifest/init
+
+    # Configure localhost in verbose mode
+    ./bin/cdist config -v localhost
+
+    # Find out that cdist created /etc/cdist-configured
+    ls -l /etc/cdist-configured
+
+Note: cdist/conf is configuration directory shipped with cdist distribution.
+If exists, ~/.cdist, is also automatically used as cdist configuration
+directory. So in the above example you could create ~/.cdist directory,
+then ~/.cdist/manifest sub-directory and create init manifest
+~/.cdist/manifest/init.
+
+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.

software/cdist/man/4.3.1/_sources/cdist-reference.txt

@@ -0,0 +1,328 @@
+Reference
+=========
+Variable, path and type reference for cdist
+
+Explorers
+---------
+The following global explorers are available:
+
+- cpu_cores
+- cpu_sockets
+- hostname
+- init
+- interfaces
+- lsb_codename
+- lsb_description
+- lsb_id
+- lsb_release
+- machine
+- machine_type
+- memory
+- os
+- os_version
+- runlevel
+
+Paths
+-----
+$HOME/.cdist
+    The standard cdist configuration directory relative to your home directory.
+    This is usually the place you want to store your site specific configuration.
+
+cdist/conf/
+    The distribution configuration directory.
+    This contains types and explorers to be used.
+
+confdir
+    Cdist will use all available configuration directories and create
+    a temporary confdir containing links to the real configuration directories.
+    This way it is possible to merge configuration directories.
+    By default it consists of everything in $HOME/.cdist and cdist/conf/.
+    For more details see cdist(1).
+
+confdir/files/
+    Cdist does not care about this directory besides providing access to it.
+    It is thought to be a general file storage area.
+
+confdir/manifest/init
+    This is the central entry point.
+    It is an executable (+x bit set) shell script that can use
+    values from the explorers to decide which configuration to create
+    for the specified target host.
+    Its intent is to used to define mapping from configurations to hosts.
+
+confdir/manifest/*
+    All other files in this directory are not directly used by cdist, but you
+    can separate configuration mappings, if you have a lot of code in the
+    conf/manifest/init file. This may also be helpful to have different admins
+    maintain different groups of hosts.
+
+confdir/explorer/<name>
+    Contains explorers to be run on the target hosts, see `cdist explorer <cdist-explorer.html>`_.
+
+confdir/type/
+    Contains all available types, which are used to provide
+    some kind of functionality. See `cdist type <cdist-type.html>`_.
+
+confdir/type/<name>/
+    Home of the type <name>.
+    This directory is referenced by the variable __type (see below).
+
+confdir/type/<name>/man.rst
+    Manpage in reStructuredText format (required for inclusion into upstream).
+
+confdir/type/<name>/manifest
+    Used to generate additional objects from a type.
+
+confdir/type/<name>/gencode-local
+    Used to generate code to be executed on the source host.
+
+confdir/type/<name>/gencode-remote
+    Used to generate code to be executed on the target host.
+
+confdir/type/<name>/parameter/required
+    Parameters required by type, \n separated list.
+
+confdir/type/<name>/parameter/optional
+    Parameters optionally accepted by type, \n separated list.
+
+confdir/type/<name>/parameter/default/*
+    Default values for optional parameters.
+    Assuming an optional parameter name of 'foo', it's default value would
+    be read from the file confdir/type/<name>/parameter/default/foo.
+
+confdir/type/<name>/parameter/boolean
+    Boolean parameters accepted by type, \n separated list.
+
+confdir/type/<name>/explorer
+    Location of the type specific explorers.
+    This directory is referenced by the variable __type_explorer (see below).
+    See `cdist explorer <cdist-explorer.html>`_.
+
+confdir/type/<name>/files
+    This directory is reserved for user data and will not be used
+    by cdist at any time. It can be used for storing supplementary
+    files (like scripts to act as a template or configuration files).
+
+out/
+    This directory contains output of cdist and is usually located
+    in a temporary directory and thus will be removed after the run.
+    This directory is referenced by the variable __global (see below).
+
+out/explorer
+    Output of general explorers.
+
+out/object
+    Objects created for the host.
+
+out/object/<object>
+    Contains all object specific information.
+    This directory is referenced by the variable __object (see below).
+
+out/object/<object>/explorers
+    Output of type specific explorers, per object.
+
+Types
+-----
+The following types are available:
+
+- __apt_key (`cdist-type__apt_key(7) <man7/cdist-type__apt_key.html>`_)
+- __apt_key_uri (`cdist-type__apt_key_uri(7) <man7/cdist-type__apt_key_uri.html>`_)
+- __apt_norecommends (`cdist-type__apt_norecommends(7) <man7/cdist-type__apt_norecommends.html>`_)
+- __apt_ppa (`cdist-type__apt_ppa(7) <man7/cdist-type__apt_ppa.html>`_)
+- __apt_source (`cdist-type__apt_source(7) <man7/cdist-type__apt_source.html>`_)
+- __apt_update_index (`cdist-type__apt_update_index(7) <man7/cdist-type__apt_update_index.html>`_)
+- __block (`cdist-type__block(7) <man7/cdist-type__block.html>`_)
+- __ccollect_source (`cdist-type__ccollect_source(7) <man7/cdist-type__ccollect_source.html>`_)
+- __cdist (`cdist-type__cdist(7) <man7/cdist-type__cdist.html>`_)
+- __cdistmarker (`cdist-type__cdistmarker(7) <man7/cdist-type__cdistmarker.html>`_)
+- __config_file (`cdist-type__config_file(7) <man7/cdist-type__config_file.html>`_)
+- __consul (`cdist-type__consul(7) <man7/cdist-type__consul.html>`_)
+- __consul_agent (`cdist-type__consul_agent(7) <man7/cdist-type__consul_agent.html>`_)
+- __consul_check (`cdist-type__consul_check(7) <man7/cdist-type__consul_check.html>`_)
+- __consul_reload (`cdist-type__consul_reload(7) <man7/cdist-type__consul_reload.html>`_)
+- __consul_service (`cdist-type__consul_service(7) <man7/cdist-type__consul_service.html>`_)
+- __consul_template (`cdist-type__consul_template(7) <man7/cdist-type__consul_template.html>`_)
+- __consul_template_template (`cdist-type__consul_template_template(7) <man7/cdist-type__consul_template_template.html>`_)
+- __consul_watch_checks (`cdist-type__consul_watch_checks(7) <man7/cdist-type__consul_watch_checks.html>`_)
+- __consul_watch_event (`cdist-type__consul_watch_event(7) <man7/cdist-type__consul_watch_event.html>`_)
+- __consul_watch_key (`cdist-type__consul_watch_key(7) <man7/cdist-type__consul_watch_key.html>`_)
+- __consul_watch_keyprefix (`cdist-type__consul_watch_keyprefix(7) <man7/cdist-type__consul_watch_keyprefix.html>`_)
+- __consul_watch_nodes (`cdist-type__consul_watch_nodes(7) <man7/cdist-type__consul_watch_nodes.html>`_)
+- __consul_watch_service (`cdist-type__consul_watch_service(7) <man7/cdist-type__consul_watch_service.html>`_)
+- __consul_watch_services (`cdist-type__consul_watch_services(7) <man7/cdist-type__consul_watch_services.html>`_)
+- __cron (`cdist-type__cron(7) <man7/cdist-type__cron.html>`_)
+- __debconf_set_selections (`cdist-type__debconf_set_selections(7) <man7/cdist-type__debconf_set_selections.html>`_)
+- __directory (`cdist-type__directory(7) <man7/cdist-type__directory.html>`_)
+- __dog_vdi (`cdist-type__dog_vdi(7) <man7/cdist-type__dog_vdi.html>`_)
+- __file (`cdist-type__file(7) <man7/cdist-type__file.html>`_)
+- __filesystem (`cdist-type__filesystem(7) <man7/cdist-type__filesystem.html>`_)
+- __firewalld_rule (`cdist-type__firewalld_rule(7) <man7/cdist-type__firewalld_rule.html>`_)
+- __git (`cdist-type__git(7) <man7/cdist-type__git.html>`_)
+- __group (`cdist-type__group(7) <man7/cdist-type__group.html>`_)
+- __hostname (`cdist-type__hostname(7) <man7/cdist-type__hostname.html>`_)
+- __iptables_apply (`cdist-type__iptables_apply(7) <man7/cdist-type__iptables_apply.html>`_)
+- __iptables_rule (`cdist-type__iptables_rule(7) <man7/cdist-type__iptables_rule.html>`_)
+- __issue (`cdist-type__issue(7) <man7/cdist-type__issue.html>`_)
+- __jail (`cdist-type__jail(7) <man7/cdist-type__jail.html>`_)
+- __jail_freebsd10 (`cdist-type__jail_freebsd10(7) <man7/cdist-type__jail_freebsd10.html>`_)
+- __jail_freebsd9 (`cdist-type__jail_freebsd9(7) <man7/cdist-type__jail_freebsd9.html>`_)
+- __key_value (`cdist-type__key_value(7) <man7/cdist-type__key_value.html>`_)
+- __keyboard (`cdist-type__keyboard(7) <man7/cdist-type__keyboard.html>`_)
+- __line (`cdist-type__line(7) <man7/cdist-type__line.html>`_)
+- __link (`cdist-type__link(7) <man7/cdist-type__link.html>`_)
+- __locale (`cdist-type__locale(7) <man7/cdist-type__locale.html>`_)
+- __locale_system (`cdist-type__locale_system(7) <man7/cdist-type__locale_system.html>`_)
+- __motd (`cdist-type__motd(7) <man7/cdist-type__motd.html>`_)
+- __mount (`cdist-type__mount(7) <man7/cdist-type__mount.html>`_)
+- __mysql_database (`cdist-type__mysql_database(7) <man7/cdist-type__mysql_database.html>`_)
+- __package (`cdist-type__package(7) <man7/cdist-type__package.html>`_)
+- __package_apt (`cdist-type__package_apt(7) <man7/cdist-type__package_apt.html>`_)
+- __package_emerge (`cdist-type__package_emerge(7) <man7/cdist-type__package_emerge.html>`_)
+- __package_emerge_dependencies (`cdist-type__package_emerge_dependencies(7) <man7/cdist-type__package_emerge_dependencies.html>`_)
+- __package_luarocks (`cdist-type__package_luarocks(7) <man7/cdist-type__package_luarocks.html>`_)
+- __package_opkg (`cdist-type__package_opkg(7) <man7/cdist-type__package_opkg.html>`_)
+- __package_pacman (`cdist-type__package_pacman(7) <man7/cdist-type__package_pacman.html>`_)
+- __package_pip (`cdist-type__package_pip(7) <man7/cdist-type__package_pip.html>`_)
+- __package_pkg_freebsd (`cdist-type__package_pkg_freebsd(7) <man7/cdist-type__package_pkg_freebsd.html>`_)
+- __package_pkg_openbsd (`cdist-type__package_pkg_openbsd(7) <man7/cdist-type__package_pkg_openbsd.html>`_)
+- __package_pkgng_freebsd (`cdist-type__package_pkgng_freebsd(7) <man7/cdist-type__package_pkgng_freebsd.html>`_)
+- __package_rubygem (`cdist-type__package_rubygem(7) <man7/cdist-type__package_rubygem.html>`_)
+- __package_update_index (`cdist-type__package_update_index(7) <man7/cdist-type__package_update_index.html>`_)
+- __package_upgrade_all (`cdist-type__package_upgrade_all(7) <man7/cdist-type__package_upgrade_all.html>`_)
+- __package_yum (`cdist-type__package_yum(7) <man7/cdist-type__package_yum.html>`_)
+- __package_zypper (`cdist-type__package_zypper(7) <man7/cdist-type__package_zypper.html>`_)
+- __pacman_conf (`cdist-type__pacman_conf(7) <man7/cdist-type__pacman_conf.html>`_)
+- __pacman_conf_integrate (`cdist-type__pacman_conf_integrate(7) <man7/cdist-type__pacman_conf_integrate.html>`_)
+- __pf_apply (`cdist-type__pf_apply(7) <man7/cdist-type__pf_apply.html>`_)
+- __pf_ruleset (`cdist-type__pf_ruleset(7) <man7/cdist-type__pf_ruleset.html>`_)
+- __postfix (`cdist-type__postfix(7) <man7/cdist-type__postfix.html>`_)
+- __postfix_master (`cdist-type__postfix_master(7) <man7/cdist-type__postfix_master.html>`_)
+- __postfix_postconf (`cdist-type__postfix_postconf(7) <man7/cdist-type__postfix_postconf.html>`_)
+- __postfix_postmap (`cdist-type__postfix_postmap(7) <man7/cdist-type__postfix_postmap.html>`_)
+- __postfix_reload (`cdist-type__postfix_reload(7) <man7/cdist-type__postfix_reload.html>`_)
+- __postgres_database (`cdist-type__postgres_database(7) <man7/cdist-type__postgres_database.html>`_)
+- __postgres_role (`cdist-type__postgres_role(7) <man7/cdist-type__postgres_role.html>`_)
+- __process (`cdist-type__process(7) <man7/cdist-type__process.html>`_)
+- __pyvenv (`cdist-type__pyvenv(7) <man7/cdist-type__pyvenv.html>`_)
+- __qemu_img (`cdist-type__qemu_img(7) <man7/cdist-type__qemu_img.html>`_)
+- __rbenv (`cdist-type__rbenv(7) <man7/cdist-type__rbenv.html>`_)
+- __rsync (`cdist-type__rsync(7) <man7/cdist-type__rsync.html>`_)
+- __rvm (`cdist-type__rvm(7) <man7/cdist-type__rvm.html>`_)
+- __rvm_gem (`cdist-type__rvm_gem(7) <man7/cdist-type__rvm_gem.html>`_)
+- __rvm_gemset (`cdist-type__rvm_gemset(7) <man7/cdist-type__rvm_gemset.html>`_)
+- __rvm_ruby (`cdist-type__rvm_ruby(7) <man7/cdist-type__rvm_ruby.html>`_)
+- __ssh_authorized_key (`cdist-type__ssh_authorized_key(7) <man7/cdist-type__ssh_authorized_key.html>`_)
+- __ssh_authorized_keys (`cdist-type__ssh_authorized_keys(7) <man7/cdist-type__ssh_authorized_keys.html>`_)
+- __ssh_dot_ssh (`cdist-type__ssh_dot_ssh(7) <man7/cdist-type__ssh_dot_ssh.html>`_)
+- __staged_file (`cdist-type__staged_file(7) <man7/cdist-type__staged_file.html>`_)
+- __start_on_boot (`cdist-type__start_on_boot(7) <man7/cdist-type__start_on_boot.html>`_)
+- __sysctl (`cdist-type__sysctl(7) <man7/cdist-type__sysctl.html>`_)
+- __timezone (`cdist-type__timezone(7) <man7/cdist-type__timezone.html>`_)
+- __update_alternatives (`cdist-type__update_alternatives(7) <man7/cdist-type__update_alternatives.html>`_)
+- __user (`cdist-type__user(7) <man7/cdist-type__user.html>`_)
+- __user_groups (`cdist-type__user_groups(7) <man7/cdist-type__user_groups.html>`_)
+- __yum_repo (`cdist-type__yum_repo(7) <man7/cdist-type__yum_repo.html>`_)
+- __zypper_repo (`cdist-type__zypper_repo(7) <man7/cdist-type__zypper_repo.html>`_)
+- __zypper_service (`cdist-type__zypper_service(7) <man7/cdist-type__zypper_service.html>`_)
+
+
+Objects
+-------
+For object to object communication and tests, the following paths are
+usable within a object directory:
+
+files
+    This directory is reserved for user data and will not be used
+    by cdist at any time. It can be used freely by the type 
+    (for instance to store template results).
+changed
+    This empty file exists in an object directory, if the object has
+    code to be executed (either remote or local).
+stdin
+    This file exists and contains data, if data was provided on stdin 
+    when the type was called.
+
+
+Environment variables (for reading)
+-----------------------------------
+The following environment variables are exported by cdist:
+
+__explorer
+    Directory that contains all global explorers.
+    Available for: initial manifest, explorer, type explorer, shell.
+__files
+    Directory that contains content from the "files" subdirectories
+    from the configuration directories.
+    Available for: initial manifest, type manifest, type gencode, shell.
+__manifest
+    Directory that contains the initial manifest.
+    Available for: initial manifest, type manifest, shell.
+__global
+    Directory that contains generic output like explorer.
+    Available for: initial manifest, type manifest, type gencode, shell.
+__messages_in
+    File to read messages from.
+    Available for: initial manifest, type manifest, type gencode.
+__messages_out
+    File to write messages.
+    Available for: initial manifest, type manifest, type gencode.
+__object
+    Directory that contains the current object.
+    Available for: type manifest, type explorer, type gencode and code scripts.
+__object_id
+    The type unique object id.
+    Available for: type manifest, type explorer, type gencode and code scripts.
+    Note: The leading and the trailing "/" will always be stripped (caused by
+    the filesystem database and ensured by the core).
+    Note: Double slashes ("//") will not be fixed and result in an error.
+__object_name
+    The full qualified name of the current object.
+    Available for: type manifest, type explorer, type gencode.
+__target_host
+    The host we are deploying to. This is primary variable. It's content is
+    literally the one user passed in.
+    Available for: explorer, initial manifest, type explorer, type manifest, type gencode, shell.
+__target_hostname
+    The hostname of host we are deploying to. This variable is derived from
+    **__target_host** (using **socket.getaddrinfo(__target_host)** and then
+    **socket.gethostbyaddr()**).
+    Available for: explorer, initial manifest, type explorer, type manifest, type gencode, shell.
+__target_fqdn
+    The fully qualified domain name of the host we are deploying to.
+    This variable is derived from **__target_host**
+    (using **socket.getfqdn()**).
+    Available for: explorer, initial manifest, type explorer, type manifest, type gencode, shell.
+__type
+    Path to the current type.
+    Available for: type manifest, type gencode.
+__type_explorer
+    Directory that contains the type explorers.
+    Available for: type explorer.
+
+Environment variables (for writing)
+-----------------------------------
+The following environment variables influence the behaviour of cdist:
+
+require
+    Setup dependencies between objects (see `cdist manifest <cdist-manifest.html>`_).
+
+CDIST_PATH
+    Colon delimited list of config directories.
+
+CDIST_LOCAL_SHELL
+    Use this shell locally instead of /bin/sh to execute scripts.
+
+CDIST_REMOTE_SHELL
+    Use this shell remotely instead of /bin/sh to execute scripts.
+
+CDIST_OVERRIDE
+    Allow overwriting type parameters (see  `cdist manifest <cdist-manifest.html>`_).
+
+CDIST_ORDER_DEPENDENCY
+    Create dependencies based on the execution order (see  `cdist manifest <cdist-manifest.html>`_).
+
+CDIST_REMOTE_EXEC
+    Use this command for remote execution (should behave like ssh).
+
+CDIST_REMOTE_COPY
+    Use this command for remote copy (should behave like scp).

software/cdist/man/4.3.1/_sources/cdist-remote-exec-copy.txt

@@ -0,0 +1,23 @@
+Remote exec and copy commands
+=============================
+
+Cdist interacts with the target host in two ways:
+
+- it executes code (__remote_exec)
+- and it copies files (__remote_copy)
+
+By default this is accomplished with ssh and scp respectively.
+The default implementations used by cdist are::
+
+    __remote_exec: ssh -o User=root
+    __remote_copy: scp -o User=root
+
+The user can override these defaults by providing custom implementations and
+passing them to cdist with the --remote-exec and/or --remote-copy arguments.
+
+For __remote_exec, the custom implementation must behave as if it where ssh.
+For __remote_copy, it must behave like scp.
+
+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.

software/cdist/man/4.3.1/_sources/cdist-stages.txt

@@ -0,0 +1,71 @@
+Execution stages
+================
+
+Description
+-----------
+Starting the execution of deployment with cdist, cdist passes
+through different stages.
+
+
+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.
+
+
+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.
+
+
+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.
+
+
+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, 
+one type can reuse other types.
+
+For instance the object __apache/www.example.org is of type __apache, which may 
+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.
+
+
+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.
+
+
+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.
+
+
+Stage 7: cache
+--------------
+The cache stores the information from the current run for later use.
+
+
+Summary
+-------
+If, and only if, all the stages complete without an errors, the configuration
+will be applied to the target.

software/cdist/man/4.3.1/_sources/cdist-support.txt

@@ -0,0 +1,28 @@
+Support
+-------
+
+IRC
+~~~
+
+You can join the development ***IRC channel***
+`#cstar on irc.freenode.net <irc://irc.freenode.org/#cstar>`_.
+
+Mailing list
+~~~~~~~~~~~~
+
+Bug reports, questions, patches, etc. should be send to the
+`cdist mailing list <https://groups.google.com/forum/#!forum/cdist-configuration-management>`_.
+
+Linkedin
+~~~~~~~~
+
+If you have an account
+at `Linked in <http://www.linkedin.com/>`_,
+you can join the
+`cdist group <http://www.linkedin.com/groups/cdist-configuration-management-3952797>`_.
+
+Commercial support
+~~~~~~~~~~~~~~~~~~
+
+You can request commercial support for cdist from
+`my company <http://www.ungleich.ch/>`_.

software/cdist/man/4.3.1/_sources/cdist-troubleshooting.txt

@@ -0,0 +1,45 @@
+Troubleshooting
+===============
+
+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.
+An example script would be something like this:
+
+.. code-block:: sh
+
+    % cat ~/.cdist/manifest/init
+    "$__manifest/special"
+    % cat ~/.cdist/manifest/special
+    #!/bin/sh
+    echo "Here is an unclean exiting script"
+    somecommandthatdoesnotexist
+    echo "I continue here although previous command failed"
+
+We can clearly see that **somecommandthatdoesnotexist**
+will fail in ~/.cdist/manifest/special. But as the custom
+script is not called with the -e flag (exit on failure) of shell, 
+it does not lead to an error. And thus cdist sees the exit 0
+code of the last echo line instead of the failing command.
+
+All scripts executed by cdist carry the -e flag. 
+To prevent the above from happening, there are three solutions available,
+two of which can be used in the calling script:
+
+.. code-block:: sh
+
+    # Execute as before, but abort on failure
+    sh -e "$__manifest/special"
+
+    # Source the script in our namespace, runs in a set -e environment:
+    . "$__manifest/special"
+
+The third solution is to include a shebang header in every script
+you write to use the -e flag:
+
+.. code-block:: sh
+
+    % cat ~/.cdist/manifest/special
+    #!/bin/sh -e
+    ...

software/cdist/man/4.3.1/_sources/cdist-type.txt

@@ -0,0 +1,297 @@
+cdist type
+==========
+
+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.
+
+Synopsis
+--------
+
+.. code-block:: sh
+
+    __TYPE ID --parameter value [--parameter value ...]
+    __TYPE --parameter value [--parameter value ...] (for singletons)
+
+
+How to use a type
+-----------------
+
+You can use types from the initial manifest or the type manifest like a
+normal shell command:
+
+.. code-block:: sh
+
+    # Creates empty file /etc/cdist-configured
+    __file /etc/cdist-configured --type file
+
+    # Ensure tree is installed
+    __package tree --state installed
+
+A list of supported types can be found in the `cdist reference <cdist-reference.html>`_ manpage.
+
+
+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
+system. Singleton types do not take an object name as argument.
+
+
+Example:
+
+.. code-block:: sh
+
+    # __issue type manages /etc/issue
+    __issue
+
+    # Probably your own type - singletons may use parameters
+    __myfancysingleton --colour green
+
+
+How to write a new type
+-----------------------
+A type consists of
+
+- parameter (optional)
+- manifest  (optional)
+- singleton (optional)
+- explorer  (optional)
+- gencode   (optional)
+
+Types are stored below cdist/conf/type/. Their name should always be prefixed with
+two underscores (__) to prevent collisions with other executables in $PATH.
+
+To implement a new type, create the directory **cdist/conf/type/__NAME**.
+
+
+Defining parameters
+-------------------
+Every type consists of required, optional and boolean parameters, which must
+each be declared in a newline separated file in **parameter/required**,
+**parameter/required_multiple**, **parameter/optional**, 
+**parameter/optional_multiple** and **parameter/boolean**.
+Parameters which are allowed multiple times should be listed in
+required_multiple or optional_multiple respectively. All other parameters
+follow the standard unix behaviour "the last given wins".
+If either is missing, the type will have no required, no optional, no boolean
+or no parameters at all. 
+
+Default values for optional parameters can be predefined in
+**parameter/default/<name>**.
+
+Example:
+
+.. code-block:: sh
+
+    echo servername >> cdist/conf/type/__nginx_vhost/parameter/required
+    echo logdirectory >> cdist/conf/type/__nginx_vhost/parameter/optional
+    echo loglevel >> cdist/conf/type/__nginx_vhost/parameter/optional
+    mkdir cdist/conf/type/__nginx_vhost/parameter/default
+    echo warning > cdist/conf/type/__nginx_vhost/parameter/default/loglevel
+    echo server_alias >> cdist/conf/type/__nginx_vhost/parameter/optional_multiple
+    echo use_ssl >> cdist/conf/type/__nginx_vhost/parameter/boolean
+
+
+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
+represented by file existence. File exists -> True,
+file does not exist -> False
+
+Example: (e.g. in cdist/conf/type/__nginx_vhost/manifest)
+
+.. code-block:: sh
+
+    # required parameter
+    servername="$(cat "$__object/parameter/servername")"
+
+    # optional parameter
+    if [ -f "$__object/parameter/logdirectory" ]; then
+       logdirectory="$(cat "$__object/parameter/logdirectory")"
+    fi
+
+    # optional parameter with predefined default
+    loglevel="$(cat "$__object/parameter/loglevel")"
+
+    # boolean parameter
+    if [ -f "$__object/parameter/use_ssl" ]; then
+       # file exists -> True
+       # do some fancy ssl stuff
+    fi
+
+    # parameter with multiple values
+    if [ -f "$__object/parameter/server_alias" ]; then
+       for alias in $(cat "$__object/parameter/server_alias"); do
+          echo $alias > /some/where/useful
+       done
+    fi
+
+
+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.
+
+Example use of a type: (e.g. in cdist/conf/type/__archlinux_hostname)
+
+.. code-block:: sh
+
+    __file /etc/rc.conf --source - << eof
+    ...
+    HOSTNAME="$__target_host"
+    ...
+    eof
+
+If you have not seen this syntax (<< eof) before, it may help you to read
+about "here documents".
+
+In the __file type, stdin is used as source for the file, if - is used for source:
+
+.. code-block:: sh
+
+    if [ -f "$__object/parameter/source" ]; then
+        source="$(cat "$__object/parameter/source")"
+        if [ "$source" = "-" ]; then
+            source="$__object/stdin"
+        fi  
+    ....
+
+
+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
+a shortened version looks like this:
+
+.. code-block:: sh
+
+    os="$(cat "$__global/explorer/os")"
+    case "$os" in
+          archlinux) type="pacman" ;;
+          debian|ubuntu) type="apt" ;;
+          gentoo) type="emerge" ;;
+          *)
+             echo "Don't know how to manage packages on: $os" >&2
+             exit 1
+          ;;
+    esac
+
+    __package_$type "$@"
+
+As you can see, the type can reference different environment variables,
+which are documented in `cdist reference <cdist-reference.html>`_.
+
+Always ensure the manifest is executable, otherwise cdist will not be able
+to execute it. For more information about manifests see `cdist manifest <cdist-manifest.html>`_.
+
+
+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
+directory:
+
+.. code-block:: sh
+
+    touch cdist/conf/type/__NAME/singleton
+
+This will also change the way your type must be called:
+
+.. code-block:: sh
+
+    __YOURTYPE --parameter value
+
+As you can see, the object ID is omitted, because it does not make any sense,
+if your type can be used only once.
+
+
+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.
+
+The explorers are stored under the "explorer" directory below the type.
+It could for instance contain code to check the md5sum of a file on the
+client, like this (shortened version from the type __file):
+
+.. code-block:: sh
+
+    if [ -f "$__object/parameter/destination" ]; then
+       destination="$(cat "$__object/parameter/destination")"
+    else
+       destination="/$__object_id"
+    fi
+
+    if [ -e "$destination" ]; then
+       md5sum < "$destination"
+    fi
+
+
+Writing the gencode script
+--------------------------
+There are two gencode scripts: **gencode-local** and **gencode-remote**.
+The output of gencode-local is executed locally, whereas
+the output of gencode-remote is executed on the target.
+The gencode scripts can make use of the parameters, the global explorers
+and the type specific explorers.
+
+If the gencode scripts encounters an error, it should print diagnostic
+messages to stderr and exit non-zero. If you need to debug the gencode
+script, you can write to stderr:
+
+.. code-block:: sh
+
+    # Debug output to stderr
+    echo "My fancy debug line" >&2
+
+    # Output to be saved by cdist for execution on the target
+    echo "touch /etc/cdist-configured"
+
+
+Variable access from the generated scripts
+------------------------------------------
+In the generated scripts, you have access to the following cdist variables
+
+- __object
+- __object_id
+
+but only for read operations, means there is no back copy of this
+files after the script execution.
+
+So when you generate a script with the following content, it will work:
+
+.. code-block:: sh
+
+    if [ -f "$__object/parameter/name" ]; then
+       name="$(cat "$__object/parameter/name")"
+    else
+       name="$__object_id"
+    fi
+
+
+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
+on the target, there must be another type that provides this tool and the first
+type should create an object of the specific type.
+
+If your type wants to save temporary data, that may be used by other types
+later on (for instance \__file), you can save them in the subdirectory
+"files" below $__object (but you must create it yourself).
+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).
+
+
+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 <cdist-hacker.html>`_ on
+how to submit it.

software/cdist/man/4.3.1/_sources/cdist-types.txt

@@ -0,0 +1,8 @@
+cdist types
+===========
+
+.. toctree::
+   :titlesonly:
+   :glob:
+
+   man7/*

software/cdist/man/4.3.1/_sources/cdist-update.txt

@@ -0,0 +1,188 @@
+How to update cdist
+===================
+
+Update the git installation
+---------------------------
+
+To upgrade cdist in the current branch use
+
+.. code-block:: sh
+
+    git pull
+
+    # Also update the manpages
+    ./build man
+    export MANPATH=$MANPATH:$(pwd -P)/doc/man
+
+If you stay on a version branche (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.
+
+Safely upgrading to new versions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To upgrade to **any** further cdist version, you can take the
+following procedure to do a safe upgrade:
+
+.. code-block:: sh
+
+    # Create new branch to try out the update
+    git checkout -b upgrade_cdist
+
+    # Get latest cdist version in git database
+    git fetch -v
+
+    # see what will happen on merge - replace
+    # master with the branch you plan to merge
+    git diff upgrade_cdist..origin/master
+
+    # Merge the new version
+    git merge origin/master
+
+Now you can ensure all custom types work with the new version.
+Assume that you need to go back to an older version during
+the migration/update, you can do so as follows:
+
+.. code-block:: sh
+
+    # commit changes
+    git commit -m ...
+
+    # go back to original branch
+    git checkout master
+
+After that, you can go back and continue the upgrade:
+
+.. code-block:: sh
+
+    # git checkout upgrade_cdist
+
+
+Update the python package
+-------------------------
+
+To upgrade to the lastet version do
+
+.. code-block:: sh
+
+    pip install --upgrade cdist
+
+General update instructions
+---------------------------
+
+Updating from 3.0 to 3.1
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The type **\_\_ssh_authorized_keys** now also manages existing keys, 
+not only the ones added by cdist.
+
+Updating from 2.3 to 3.0
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The **changed** attribute of objects has been removed.
+Use `messaging </software/cdist/man/3.0.0/man7/cdist-messaging.html>`_ instead.
+
+Updating from 2.2 to 2.3
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+No incompatibilities.
+
+Updating from 2.1 to 2.2
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting with 2.2, the syntax for requiring a singleton type changed:
+Old format:
+
+.. code-block:: sh
+
+    require="__singleton_type/singleton" ...
+
+New format:
+
+.. code-block:: sh
+
+    require="__singleton_type" ...
+
+Internally the "singleton" object id was dropped to make life more easy.
+You can probably fix your configuration by running the following code
+snippet (currently untested, please report back if it works for you):
+
+.. code-block:: sh
+
+    find ~/.cdist/* -type f -exec sed -i 's,/singleton,,' {} \;
+
+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]].
+
+ * Type **\_\_package* and \_\_process** use --state **present** or **absent**.
+   The states **removed/installed** and **stopped/running** have been removed.
+   Support for the new states is already present in 2.0.
+ * Type **\_\_directory**: Parameter --parents and --recursive are now boolean
+   The old "yes/no" values need to be removed.
+ * Type **\_\_rvm_ruby**: Parameter --default is now boolean
+   The old "yes/no" values need to be removed.
+ * Type **\_\_rvm_gemset**: Parameter --default is now boolean
+   The old "yes/no" values need to be removed.
+ * Type **\_\_addifnosuchline** and **\_\_removeline** have been replaced by **\_\_line**
+ * The **conf** directory is now located at **cdist/conf**.
+   You need to migrate your types, explorers and manifests
+   manually to the new location.
+ * Replace the variable **\_\_self** by **\_\_object_name**
+   Support for the variable **\_\_object_name** is already present in 2.0.
+ * The types **\_\_autofs**, **\_\_autofs_map** and **\_\_autofs_reload** have been removed
+   (no maintainer, no users)
+ * Type **\_\_user**: Parameter --groups removed (use the new \_\_user_groups type)
+ * Type **\_\_ssh_authorized_key** has been replaced by more flexible type 
+    **\_\_ssh_authorized_keys**
+
+Updating from 1.7 to 2.0
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+* Ensure python (>= 3.2) is installed on the source host
+* Use "cdist config host" instead of "cdist-deploy-to host"
+* Use "cdist config -p host1 host2" instead of "cdist-mass-deploy"
+* Use "cdist banner" for fun
+* Use **\_\_object_name** instead of **\_\_self** in manifests
+
+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.
+
+Updating from 1.5 to 1.6
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+* If you used **\_\_package_apt --preseed**, you need to use the new
+  type **\_\_debconf_set_selections** instead.
+* The **\_\_package** types accepted either --state deinstalled or
+  --state uninstaaled. Starting with 1.6, it was made consistently
+  to --state removed.
+
+Updating from 1.3 to 1.5
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+No incompatibilities.
+
+Updating from 1.2 to 1.3
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Rename **gencode** of every type to **gencode-remote**.
+
+Updating from 1.1 to 1.2
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+No incompatibilities.
+
+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
+need to replace **\_\_file** calls in your manifests:
+
+ * Remove --type from all \_\_file calls
+ * If type was symlink, use \_\_link and --type symbolic
+ * If type was directory, use \_\_directory

software/cdist/man/4.3.1/_sources/cdist-why.txt

@@ -0,0 +1,72 @@
+Why should I use cdist?
+=======================
+
+There are several motivations to use cdist, these
+are probably the most popular ones.
+
+Known language
+--------------
+
+Cdist is being configured in
+`shell script <https://en.wikipedia.org/wiki/Shell_script>`_.
+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 <https://en.wikipedia.org/wiki/Domain-specific_language>`_
+or programming language.
+
+Powerful language
+-----------------
+
+Not only is shell scripting widely known by system engineers,
+but it is also a very powerful language. Here are some features
+which make daily work easy:
+
+ * Configuration can react dynamicly on explored values
+ * High level string manipulation (using sed, awk, grep)
+ * Conditional support (**if, case**)
+ * Loop support (**for, while**)
+ * Support for dependencies between cdist types
+
+More than shell scripting
+-------------------------
+
+If you compare regular shell scripting with cdist, there is one major
+difference: When using cdist types,
+the results are
+`idempotent <https://en.wikipedia.org/wiki/Idempotence>`_.
+In practise that means it does not matter in which order you
+call cdist types, the result is always the same.
+
+Zero dependency configuration management
+----------------------------------------
+
+Cdist requires very litte on a target system. Even better,
+in almost all cases all dependencies are usually fulfilled.
+Cdist does not require an agent or a high level programming
+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.
+
+Push based distribution
+-----------------------
+
+Cdist uses the push based model for configuration. In this
+scenario, one (or more) computers connect the target hosts
+and apply the configuration. That way the source host has
+very little requirements: Cdist can even run on a sysadmin
+notebook that is loosely connected to the network and has
+limited amount of resources.
+
+Furthermore, from a security point of view, only one machine
+needs access to the target hosts. No target hosts will ever
+need to connect back to the source host, which contains the
+full configuration.
+
+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.

software/cdist/man/4.3.1/_sources/index.txt

@@ -0,0 +1,32 @@
+Welcome to cdist documentation
+==============================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   :numbered:
+
+   cdist-intro
+   cdist-why
+   cdist-os
+   cdist-install
+   cdist-update
+   cdist-support
+   cdist-features
+   cdist-quickstart
+   man1/cdist
+   cdist-bootstrap
+   cdist-manifest
+   cdist-type
+   cdist-types
+   cdist-explorer
+   cdist-messaging
+   cdist-parallelization
+   cdist-reference
+   cdist-best-practice
+   cdist-stages
+   cdist-remote-exec-copy
+   cdist-hacker
+   cdist-troubleshooting

software/cdist/man/4.3.1/_sources/man1/cdist.txt

@@ -0,0 +1,252 @@
+cdist(1)
+========
+
+NAME
+----
+cdist - Usable Configuration Management
+
+
+SYNOPSIS
+--------
+
+::
+
+    cdist [-h] [-d] [-v] [-V] {banner,config,shell} ...
+
+    cdist banner [-h] [-d] [-v]
+
+    cdist config [-h] [-d] [-v] [-b] [-c CONF_DIR] [-f HOSTFILE]
+                 [-i MANIFEST] [-j [JOBS]] [-n] [-o OUT_PATH] [-p] [-s]
+                 [--remote-copy REMOTE_COPY] [--remote-exec REMOTE_EXEC]
+                 [host [host ...]]
+
+    cdist shell [-h] [-d] [-v] [-s SHELL]
+
+
+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 :strong:`python`\ (1) to be installed.
+It requires a minimal Python version 3.2.
+
+GENERAL
+-------
+All commands accept the following options:
+
+.. option:: -h, --help
+
+    Show the help screen
+
+.. option:: -d, --debug
+
+    Set log level to debug
+
+.. option:: -v, --verbose
+
+    Set log level to info, be more verbose
+
+.. option:: -V, --version
+
+   Show version and exit
+
+
+BANNER
+------
+Displays the cdist banner. Useful for printing
+cdist posters - a must have for every office.
+
+
+CONFIG
+------
+Configure one or more hosts.
+
+.. option:: -b, --enable-beta
+
+    Enable beta functionalities. Beta functionalities include the
+    following options: -j/--jobs.
+
+.. option:: -c CONF_DIR, --conf-dir CONF_DIR
+
+    Add a configuration directory. Can be specified multiple times.
+    If configuration directories contain conflicting types, explorers or
+    manifests, then the last one found is used. Additionally this can also
+    be configured by setting the CDIST_PATH environment variable to a colon
+    delimited list of config directories. Directories given with the
+    --conf-dir argument have higher precedence over those set through the
+    environment variable.
+
+.. option:: -f HOSTFILE, --file HOSTFILE
+
+    Read additional hosts to operate on from specified file
+    or from stdin if '-' (each host on separate line).
+    If no host or host file is specified then, by default,
+    read hosts from stdin. For the file format see below.
+
+.. option:: -i MANIFEST, --initial-manifest MANIFEST
+
+    Path to a cdist manifest or - to read from stdin
+
+.. option:: -j [JOBS], --jobs [JOBS]
+
+    Specify the maximum number of parallel jobs; currently only
+    global explorers are supported (currently in beta)
+
+.. option:: -n, --dry-run
+
+    Do not execute code
+
+.. option:: -o OUT_PATH, --out-dir OUT_PATH
+
+    Directory to save cdist output in
+
+.. option:: -p, --parallel
+
+    Operate on multiple hosts in parallel
+
+.. option:: -s, --sequential
+
+    Operate on multiple hosts sequentially (default)
+
+.. option:: --remote-copy REMOTE_COPY
+
+    Command to use for remote copy (should behave like scp)
+
+.. option:: --remote-exec REMOTE_EXEC
+
+    Command to use for remote execution (should behave like ssh)
+
+
+HOSTFILE FORMAT
+~~~~~~~~~~~~~~~
+HOSTFILE contains hosts per line. 
+All characters after and including '#' until the end of line is a comment.
+In a line, all leading and trailing whitespace characters are ignored.
+Empty lines are ignored/skipped.
+
+Hostfile line is processed like the following. First, all comments are
+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.
+
+
+SHELL
+-----
+This command allows you to spawn a shell that enables access
+to the types as commands. It can be thought as an
+"interactive manifest" environment. See below for example
+usage. Its primary use is for debugging type parameters.
+
+.. option:: -s SHELL, --shell SHELL
+
+    Select shell to use, defaults to current shell. Used shell should
+    be POSIX compatible shell.
+
+FILES
+-----
+~/.cdist
+    Your personal cdist config directory. If exists it will be
+    automatically used.
+cdist/conf
+    The distribution configuration directory. It contains official types and
+    explorers. This path is relative to cdist installation directory.
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Configure ikq05.ethz.ch with debug enabled
+    % cdist config -d ikq05.ethz.ch
+
+    # Configure hosts in parallel and use a different configuration directory
+    % cdist config -c ~/p/cdist-nutzung \
+        -p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch
+
+    # Use custom remote exec / copy commands
+    % cdist config --remote-exec /path/to/my/remote/exec \
+        --remote-copy /path/to/my/remote/copy \
+        -p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch
+
+    # Configure hosts read from file loadbalancers
+    % cdist config -f loadbalancers
+
+    # Configure hosts read from file web.hosts using 16 parallel jobs
+    # (beta functionality)
+    % cdist config -b -j 16 -f web.hosts
+
+    # Display banner
+    cdist banner
+
+    # Show help
+    % cdist --help
+
+    # Show Version
+    % cdist --version
+
+    # Enter a shell that has access to emulated types
+    % cdist shell
+    % __git
+    usage: __git --source SOURCE [--state STATE] [--branch BRANCH]
+                 [--group GROUP] [--owner OWNER] [--mode MODE] object_id
+
+
+ENVIRONMENT
+-----------
+TMPDIR, TEMP, TMP
+    Setup the base directory for the temporary directory.
+    See http://docs.python.org/py3k/library/tempfile.html for
+    more information. This is rather useful, if the standard
+    directory used does not allow executables.
+
+CDIST_PATH
+    Colon delimited list of config directories.
+
+CDIST_LOCAL_SHELL
+    Selects shell for local script execution, defaults to /bin/sh.
+
+CDIST_REMOTE_SHELL
+    Selects shell for remote script execution, defaults to /bin/sh.
+
+CDIST_OVERRIDE
+    Allow overwriting type parameters.
+
+CDIST_ORDER_DEPENDENCY
+    Create dependencies based on the execution order.
+
+CDIST_REMOTE_EXEC
+    Use this command for remote execution (should behave like ssh).
+
+CDIST_REMOTE_COPY
+    Use this command for remote copy (should behave like scp).
+
+EXIT STATUS
+-----------
+The following exit values shall be returned:
+
+0   Successful completion.
+
+1   One or more host configurations failed.
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+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
+on target SSH server and its configuration you may encounter connection drops.
+This is controlled with sshd :strong:`MaxStartups` configuration options.
+You may also encounter session open refusal. This happens with ssh multiplexing
+when you reach maximum number of open sessions permitted per network
+connection. In this case ssh will disable multiplexing.
+This limit is controlled with sshd :strong:`MaxSessions` configuration
+options. For more details refer to :strong:`sshd_config`\ (5).
+
+COPYING
+-------
+Copyright \(C) 2011-2013 Nico Schottelius. Free use of this software is
+granted under the terms of the GNU General Public License v3 or later (GPLv3+).

software/cdist/man/4.3.1/_sources/man7/cdist-type__apt_key.txt

@@ -0,0 +1,61 @@
+cdist-type__apt_key(7)
+======================
+
+NAME
+----
+cdist-type__apt_key - Manage the list of keys used by apt
+
+
+DESCRIPTION
+-----------
+Manages the list of keys used by apt to authenticate packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present' or 'absent'. Defaults to 'present'
+
+keyid
+   the id of the key to add. Defaults to __object_id
+
+keyserver
+   the keyserver from which to fetch the key. If omitted the default set
+   in ./parameter/default/keyserver is used.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Add Ubuntu Archive Automatic Signing Key
+    __apt_key 437D05B5
+    # Same thing
+    __apt_key 437D05B5 --state present
+    # Get rid of it
+    __apt_key 437D05B5 --state absent
+
+    # same thing with human readable name and explicit keyid
+    __apt_key UbuntuArchiveKey --keyid 437D05B5
+
+    # same thing with other keyserver
+    __apt_key UbuntuArchiveKey --keyid 437D05B5 --keyserver keyserver.ubuntu.com
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__apt_key_uri.txt

@@ -0,0 +1,51 @@
+cdist-type__apt_key_uri(7)
+==========================
+
+NAME
+----
+cdist-type__apt_key_uri - Add apt key from uri
+
+
+DESCRIPTION
+-----------
+Download a key from an uri and add it to the apt keyring.
+
+
+REQUIRED PARAMETERS
+-------------------
+uri
+   the uri from which to download the key
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present' or 'absent', defaults to 'present'
+
+name
+   a name for this key, used when testing if it is already installed.
+   Defaults to __object_id
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __apt_key_uri rabbitmq \
+       --name 'RabbitMQ Release Signing Key <info@rabbitmq.com>' \
+       --uri http://www.rabbitmq.com/rabbitmq-signing-key-public.asc \
+       --state present
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__apt_norecommends.txt

@@ -0,0 +1,42 @@
+cdist-type__apt_norecommends(7)
+===============================
+
+NAME
+----
+cdist-type__apt_norecommends - Configure apt to not install recommended packages
+
+
+DESCRIPTION
+-----------
+Configure apt to not install any recommended or suggested packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+None.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __apt_norecommends
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__apt_ppa.txt

@@ -0,0 +1,50 @@
+cdist-type__apt_ppa(7)
+======================
+
+NAME
+----
+cdist-type__apt_ppa - Manage ppa repositories
+
+
+DESCRIPTION
+-----------
+This cdist type allows manage ubuntu ppa repositories.
+
+
+REQUIRED PARAMETERS
+-------------------
+state
+   The state the ppa should be in, either 'present' or 'absent'.
+   Defaults to 'present'
+
+
+OPTIONAL PARAMETERS
+-------------------
+None.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Enable a ppa repository
+    __apt_ppa ppa:sans-intern/missing-bits
+    # same as
+    __apt_ppa ppa:sans-intern/missing-bits --state present
+
+    # Disable a ppa repository
+    __apt_ppa ppa:sans-intern/missing-bits --state absent
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__apt_source.txt

@@ -0,0 +1,69 @@
+cdist-type__apt_source(7)
+=========================
+
+NAME
+----
+cdist-type__apt_source - Manage apt sources
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to manage apt sources.
+
+
+REQUIRED PARAMETERS
+-------------------
+uri
+   the uri to the apt repository
+
+
+OPTIONAL PARAMETERS
+-------------------
+arch
+   set this if you need to force and specific arch (ubuntu specific)
+
+state
+   'present' or 'absent', defaults to 'present'
+
+distribution
+   the distribution codename to use. Defaults to DISTRIB_CODENAME from
+   the targets /etc/lsb-release
+
+component
+   space delimited list of components to enable. Defaults to an empty string.
+
+
+BOOLEAN PARAMETERS
+------------------
+include-src
+   include deb-src entries
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __apt_source rabbitmq \
+       --uri http://www.rabbitmq.com/debian/ \
+       --distribution testing \
+       --component main \
+       --include-src \
+       --state present
+
+    __apt_source canonical_partner \
+       --uri http://archive.canonical.com/ \
+       --component partner --state present
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__apt_update_index.txt

@@ -0,0 +1,41 @@
+cdist-type__apt_update_index(7)
+===============================
+
+NAME
+----
+cdist-type__apt_update_index - Update apt's package index
+
+
+DESCRIPTION
+-----------
+This cdist type runs apt-get update whenever any apt sources have changed.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+OPTIONAL PARAMETERS
+-------------------
+None.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __apt_update_index
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__block.txt

@@ -0,0 +1,82 @@
+cdist-type__block(7)
+====================
+
+NAME
+----
+cdist-type__block - Manage blocks of text in files
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+text
+   the text to manage.
+   If text is '-' (dash), take what was written to stdin as the text.
+
+
+OPTIONAL PARAMETERS
+-------------------
+file
+   the file in which to manage the text block.
+   Defaults to object_id.
+
+prefix
+   the prefix to add before the text.
+   Defaults to #cdist:__block/$__object_id
+
+suffix
+   the suffix to add after the text.
+   Defaults to #/cdist:__block/$__object_id
+
+state
+   'present' or 'absent', defaults to 'present'
+
+
+MESSAGES
+--------
+add
+   block was added
+update
+   block was updated/changed
+remove
+   block was removed
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # text from argument
+    __block /path/to/file \
+       --prefix '#start' \
+       --suffix '#end' \
+       --text 'some\nblock of\ntext'
+
+    # text from stdin
+    __block some-id \
+       --file /path/to/file \
+       --text - << DONE
+    here some block
+    of text
+    DONE
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__ccollect_source.txt

@@ -0,0 +1,69 @@
+cdist-type__ccollect_source(7)
+==============================
+
+NAME
+----
+cdist-type__ccollect_source - Manage ccollect sources
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to create or delete ccollect sources.
+
+
+REQUIRED PARAMETERS
+-------------------
+source
+    The source from which to backup
+destination
+    The destination directory
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    'present' or 'absent', defaults to 'present'
+ccollectconf
+    The CCOLLECT_CONF directory. Defaults to /etc/ccollect.
+
+
+OPTIONAL MULTIPLE PARAMETERS
+----------------------------
+exclude
+    Paths to exclude of backup
+
+
+BOOLEAN PARAMETERS
+------------------
+verbose
+    Whether to report backup verbosely
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __ccollect_source doc.ungleich.ch \
+        --source doc.ungleich.ch:/ \
+        --destination /backup/doc.ungleich.ch \
+        --exclude '/proc/*' --exclude '/sys/*' \
+        --verbose
+
+
+SEE ALSO
+--------
+:strong:`ccollect`\ (1)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__cdist.txt

@@ -0,0 +1,63 @@
+cdist-type__cdist(7)
+====================
+
+NAME
+----
+cdist-type__cdist - Manage cdist installations
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to easily setup cdist
+on another box, to allow the other box to configure
+systems.
+
+This type is *NOT* required by target hosts.
+It is only helpful to build FROM which you configure
+other hosts.
+
+This type will use git to clone
+
+
+REQUIRED PARAMETERS
+-------------------
+
+OPTIONAL PARAMETERS
+-------------------
+username
+    Select the user to create for the cdist installation.
+    Defaults to "cdist".
+
+source
+    Select the source from which to clone cdist from.
+    Defaults to "git://github.com/telmich/cdist.git".
+
+
+branch
+    Select the branch to checkout from.
+    Defaults to "master".
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Install cdist for user cdist in her home as subfolder cdist
+    __cdist /home/cdist/cdist
+
+    # Use alternative source
+    __cdist --source "git://git.schottelius.org/cdist" /home/cdist/cdist
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__cdistmarker.txt

@@ -0,0 +1,55 @@
+cdist-type__cdistmarker(7)
+==========================
+
+NAME
+----
+cdist-type__cdistmarker - Add a timestamped cdist marker.
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+destination
+    The path and filename of the marker.
+    Default: /etc/cdist-configured
+
+format
+    The format of the timestamp. This is passed directly to system 'date'.
+    Default: -u
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Creates the marker as normal.
+    __cdistmarker
+
+    # Creates the marker differently.
+    __cdistmarker --destination /tmp/cdist_marker --format '+%s'
+
+
+AUTHORS
+-------
+Daniel Maher <phrawzty+cdist--@--gmail.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__config_file.txt

@@ -0,0 +1,64 @@
+cdist-type__config_file(7)
+==========================
+
+NAME
+----
+cdist-type__config_file - _Manages config files
+
+
+DESCRIPTION
+-----------
+Deploy config files using the file type.
+Run the given code if the files changes.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+group
+   see cdist-type__file
+mode
+   see cdist-type__file
+onchange
+   the code to run if the file changes
+owner
+   see cdist-type__file
+source
+   Path to the config file.
+   If source is '-' (dash), take what was written to stdin as the config file content.
+state
+   see cdist-type__file
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __config_file /etc/consul/conf.d/watch_foo.json \
+       --owner root --group consul --mode 640 \
+       --source "$__type/files/watch_foo.json" \
+       --state present \
+       --onchange 'service consul status >/dev/null && service consul reload || true'
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__file`\ (7)
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul.txt

@@ -0,0 +1,54 @@
+cdist-type__consul(7)
+=====================
+
+NAME
+----
+cdist-type__consul - Install consul
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   either 'present' or 'absent'. Defaults to 'present'
+
+version
+   which version of consul to install. See ./files/versions for a list of
+   supported versions. Defaults to the latest known version.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # just install using defaults
+    __consul
+
+    # specific version
+    __consul \
+       --version 0.4.1
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_agent.txt

@@ -0,0 +1,181 @@
+cdist-type__consul_agent(7)
+===========================
+
+NAME
+----
+cdist-type__consul_agent - Manage the consul agent
+
+
+DESCRIPTION
+-----------
+Configure and manage the consul agent.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+acl-datacenter
+   only used by servers. This designates the datacenter which is authoritative
+   for ACL information.
+
+acl-default-policy
+   either "allow" or "deny"; defaults to "allow". The default policy controls the
+   behavior of a token when there is no matching rule.
+
+acl-down-policy
+   either "allow", "deny" or "extend-cache"; "extend-cache" is the default.
+
+acl-master-token
+   only used for servers in the acl_datacenter. This token will be created with
+   management-level permissions if it does not exist. It allows operators to
+   bootstrap the ACL system with a token ID that is well-known.
+
+acl-token
+   when provided, the agent will use this token when making requests to the
+   Consul servers.
+
+acl-ttl
+   used to control Time-To-Live caching of ACLs.
+
+bind-addr
+   sets the bind address for cluster communication
+
+bootstrap-expect
+   sets server to expect bootstrap mode
+
+ca-file-source
+   path to a PEM encoded certificate authority file which will be uploaded and
+   configure using the ca_file config option.
+
+cert-file-source
+   path to a PEM encoded certificate file which will be uploaded and
+   configure using the cert_file config option.
+
+client-addr
+   sets the address to bind for client access
+
+datacenter
+   datacenter of the agent
+
+encrypt
+   provides the gossip encryption key
+
+group
+   the primary group for the agent
+
+json-config
+   path to a partial json config file without leading { and trailing }.
+   If json-config is '-' (dash), take what was written to stdin as the file content.
+
+key-file-source
+   path to a PEM encoded private key file which will be uploaded and
+   configure using the key_file config option.
+
+node-name
+   name of this node. Must be unique in the cluster
+
+retry-join
+   address to attempt joining every retry_interval until at least one join works.
+   Can be specified multiple times.
+
+user
+   the user to run the agent as
+
+state
+   if the agent is 'present' or 'absent'. Defaults to 'present'.
+   Currently state=absent is not working due to some dependency issues.
+
+
+BOOLEAN PARAMETERS
+------------------
+disable-remote-exec
+   disables support for remote execution. When set to true, the agent will ignore any incoming remote exec requests.
+
+disable-update-check
+   disables automatic checking for security bulletins and new version releases
+
+leave-on-terminate
+   gracefully leave cluster on SIGTERM
+
+rejoin-after-leave
+   rejoin the cluster using the previous state after leaving
+
+server
+   used to control if an agent is in server or client mode
+
+syslog
+   enables logging to syslog
+
+verify-incoming
+   enforce the use of TLS and verify a client's authenticity on incoming connections
+
+verify-outgoing
+   enforce the use of TLS and verify the peers authenticity on outgoing connections
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # configure as server, bootstrap and rejoin
+    hostname="$(cat "$__global/explorer/hostname")"
+    __consul_agent \
+       --datacenter dc1 \
+       --node-name "${hostname%%.*}" \
+       --disable-update-check \
+       --server \
+       --rejoin-after-leave \
+       --bootstrap-expect 3 \
+       --retry-join consul-01 \
+       --retry-join consul-02 \
+       --retry-join consul-03
+
+    # configure as server, bootstrap and rejoin with ssl support
+    hostname="$(cat "$__global/explorer/hostname")"
+    __consul_agent \
+       --datacenter dc1 \
+       --node-name "${hostname%%.*}" \
+       --disable-update-check \
+       --server \
+       --rejoin-after-leave \
+       --bootstrap-expect 3 \
+       --retry-join consul-01 \
+       --retry-join consul-02 \
+       --retry-join consul-03 \
+       --ca-file-source /path/to/ca.pem \
+       --cert-file-source /path/to/cert.pem \
+       --key-file-source /path/to/key.pem \
+       --verify-incoming \
+       --verify-outgoing
+
+    # configure as client and try joining existing cluster
+    __consul_agent \
+       --datacenter dc1 \
+       --node-name "${hostname%%.*}" \
+       --disable-update-check \
+       --retry-join consul-01 \
+       --retry-join consul-02 \
+       --retry-join consul-03
+
+
+SEE ALSO
+--------
+consul documentation at: <http://www.consul.io/docs/agent/options.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_check.txt

@@ -0,0 +1,102 @@
+cdist-type__consul_check(7)
+=============================
+
+NAME
+----
+cdist-type__consul_check - Manages consul checks
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+docker-container-id
+   the id of the docker container to run
+
+http
+   the url to check
+
+id
+   The id of this check.
+
+interval
+   the interval in which the check should run
+
+name
+   The name of this check. Defaults to __object_id
+
+notes
+   human readable description
+
+script
+   the shell command to run
+
+service-id
+   the id of the service this check is bound to
+
+shell
+   the shell to run inside the docker container
+
+state
+   if this check is 'present' or 'absent'. Defaults to 'present'.
+
+status
+   specify the initial state of this health check
+
+tcp
+   the host and port to check
+
+timeout
+   after how long to timeout checks which take to long
+
+token
+   ACL token to use for interacting with the catalog
+
+ttl
+   how long a TTL check is considered healthy without being updated through the
+   HTTP interface
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_check redis \
+       --script /usr/local/bin/check_redis.py \
+       --interval 10s
+
+    __consul_check some-object-id \
+       --id web-app \
+       --name "Web App Status" \
+       --notes "Web app does a curl internally every 10 seconds" \
+       --ttl 30s
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_reload.txt

@@ -0,0 +1,42 @@
+cdist-type__consul_reload(7)
+============================
+
+NAME
+----
+cdist-type__consul_reload - Reload consul
+
+
+DESCRIPTION
+-----------
+Reload consul after configuration changes.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+None.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_reload
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_service.txt

@@ -0,0 +1,82 @@
+cdist-type__consul_service(7)
+=============================
+
+NAME
+----
+cdist-type__consul_service - Manages consul services
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+check-interval
+   the interval in which the script given with --check-script should be run
+
+check-script
+   the shell command to run every --check-interval
+
+check-ttl
+   how long a service is considered healthy without being updated through the
+   HTTP interfave
+
+id
+   Defaults to --name
+
+name
+   The name of this service. Defaults to __object_id
+
+port
+   the port at which this service can be reached
+
+state
+   if this service is 'present' or 'absent'. Defaults to 'present'.
+
+tag
+   a tag to add to this service. Can be specified multiple times.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_service redis \
+       --tag master \
+       --tag production \
+       --port 8000 \
+       --check-script /usr/local/bin/check_redis.py \
+       --check-interval 10s
+
+    __consul_service webapp \
+       --port 80 \
+       --check-ttl 10s
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_template.txt

@@ -0,0 +1,141 @@
+cdist-type__consul_template(7)
+==============================
+
+NAME
+----
+cdist-type__consul_template - Manage the consul-template service
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+auth-username
+   specify a username for basic authentication.
+
+auth-password
+   specify a password for basic authentication.
+
+batch-size
+   the size of the batch when polling multiple dependencies.
+
+consul
+   the location of the Consul instance to query (may be an IP address or FQDN) with port.
+   Defaults to 'localhost:8500'.
+
+log-level
+   The log level for output. This applies to the stdout/stderr logging as well
+   as syslog logging (if enabled). Valid values are "debug", "info", "warn",
+   and "err". The default value is "warn".
+
+max-stale
+   the maximum staleness of a query. If specified, Consul will distribute work among all
+   servers instead of just the leader.
+
+retry
+   the amount of time to wait if Consul returns an error when communicating
+   with the API.
+
+state
+   either 'present' or 'absent'. Defaults to 'present'
+
+ssl-cert
+   Path to an SSL client certificate to use to authenticate to the consul server.
+   Useful if the consul server "verify_incoming" option is set.
+
+ssl-ca-cert
+   Path to a CA certificate file, containing one or more CA certificates to
+   use to validate the certificate sent by the consul server to us. This is a
+   handy alternative to setting --ssl-no-verify if you are using your own CA.
+
+syslog-facility
+   The facility to use when sending to syslog. This requires the use of --syslog.
+   The default value is LOCAL0.
+
+token
+   the Consul API token.
+
+vault-address
+   the location of the Vault instance to query (may be an IP address or FQDN) with port.
+
+vault-token
+   the Vault API token.
+
+vault-ssl-cert
+   Path to an SSL client certificate to use to authenticate to the vault server.
+
+vault-ssl-ca-cert
+   Path to a CA certificate file, containing one or more CA certificates to
+   use to validate the certificate sent by the vault server to us.
+
+version
+   which version of consul-template to install. See ./files/versions for a list of
+   supported versions. Defaults to the latest known version.
+
+wait
+   the minimum(:maximum) to wait before rendering a new template to disk and
+   triggering a command, separated by a colon (:). If the optional maximum
+   value is omitted, it is assumed to be 4x the required minimum value.
+
+
+BOOLEAN PARAMETERS
+------------------
+ssl
+   use HTTPS while talking to Consul. Requires the Consul server to be configured to serve secure connections.
+
+ssl-no-verify
+   ignore certificate warnings. Only used if ssl is enabled.
+
+syslog
+   Send log output to syslog (in addition to stdout and stderr).
+
+vault-ssl
+   use HTTPS while talking to Vault. Requires the Vault server to be configured to serve secure connections.
+
+vault-ssl-no-verify
+   ignore certificate warnings. Only used if vault is enabled.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_template \
+       --consul consul.service.consul:8500 \
+       --retry 30s
+
+    # specific version
+    __consul_template \
+       --version 0.6.5 \
+       --retry 30s
+
+
+SEE ALSO
+--------
+consul documentation at: <https://github.com/hashicorp/consul-template>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_template_template.txt

@@ -0,0 +1,84 @@
+cdist-type__consul_template_template(7)
+=======================================
+
+NAME
+----
+cdist-type__consul_template_template - Manage consul-template templates
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+destination
+   the destination where the generated file should go.
+
+
+OPTIONAL PARAMETERS
+-------------------
+command
+   an optional command to run after rendering the template to its destination.
+
+source
+   path to the template source. Conflicts --source-file.
+
+source-file
+   path to a local file which is uploaded using the __file type and configured
+   as the source.
+   If source is '-' (dash), take what was written to stdin as the file content.
+   Conflicts --source.
+
+state
+   if this template is 'present' or 'absent'. Defaults to 'present'.
+
+wait
+   The `minimum(:maximum)` time to wait before rendering a new template to
+   disk and triggering a command, separated by a colon (`:`). If the optional
+   maximum value is omitted, it is assumed to be 4x the required minimum value.
+   This is a numeric time with a unit suffix ("5s"). There is no default value.
+   The wait value for a template takes precedence over any globally-configured
+   wait.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # configure template on the target
+    __consul_template_template nginx \
+       --source /etc/my-consul-templates/nginx.ctmpl \
+       --destination /etc/nginx/nginx.conf \
+       --command 'service nginx restart'
+
+
+    # upload a local file to the target and configure it
+    __consul_template_template nginx \
+       --wait '2s:6s' \
+       --source-file "$__manifest/files/nginx.ctmpl" \
+       --destination /etc/nginx/nginx.conf \
+       --command 'service nginx restart'
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_template`\ (7), :strong:`cdist-type__consul_template_config`\ (7)
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_watch_checks.txt

@@ -0,0 +1,73 @@
+cdist-type__consul_watch_checks(7)
+==================================
+
+NAME
+----
+cdist-type__consul_watch_checks - Manages consul checks watches
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+handler
+   the handler to invoke when the data view updates
+
+
+OPTIONAL PARAMETERS
+-------------------
+datacenter
+   can be provided to override the agent's default datacenter
+
+filter-service
+   filter to a specific service. Conflicts with --filter-state.
+
+filter-state
+   filter to a specific state. Conflicts with --filter-service.
+
+state
+   if this watch is 'present' or 'absent'. Defaults to 'present'.
+
+token
+   can be provided to override the agent's default ACL token
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_watch_checks some-id \
+       --handler /usr/bin/my-handler.sh
+
+    __consul_watch_checks some-id \
+       --filter-service consul \
+       --handler /usr/bin/my-handler.sh
+
+    __consul_watch_checks some-id \
+       --filter-state passing \
+       --handler /usr/bin/my-handler.sh
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_watch_event.txt

@@ -0,0 +1,66 @@
+cdist-type__consul_watch_event(7)
+=================================
+
+NAME
+----
+cdist-type__consul_watch_event - Manages consul event watches
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+handler
+   the handler to invoke when the data view updates
+
+
+OPTIONAL PARAMETERS
+-------------------
+datacenter
+   can be provided to override the agent's default datacenter
+
+name
+   restrict the watch to only events with the given name
+
+state
+   if this watch is 'present' or 'absent'. Defaults to 'present'.
+
+token
+   can be provided to override the agent's default ACL token
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_watch_event some-id \
+       --handler /usr/bin/my-handler.sh
+
+    __consul_watch_event some-id \
+       --name web-deploy \
+       --handler /usr/bin/my-handler.sh
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_watch_key.txt

@@ -0,0 +1,63 @@
+cdist-type__consul_watch_key(7)
+===============================
+
+NAME
+----
+cdist-type__consul_watch_key - Manages consul key watches
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+handler
+   the handler to invoke when the data view updates
+
+key
+   the key to watch for changes
+
+
+OPTIONAL PARAMETERS
+-------------------
+datacenter
+   can be provided to override the agent's default datacenter
+
+state
+   if this watch is 'present' or 'absent'. Defaults to 'present'.
+
+token
+   can be provided to override the agent's default ACL token
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_watch_key some-id \
+       --key foo/bar/baz \
+       --handler /usr/bin/my-key-handler.sh
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_watch_keyprefix.txt

@@ -0,0 +1,63 @@
+cdist-type__consul_watch_keyprefix(7)
+=====================================
+
+NAME
+----
+cdist-type__consul_watch_keyprefix - Manages consul keyprefix watches
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+handler
+   the handler to invoke when the data view updates
+
+prefix
+   the prefix of keys to watch for changes
+
+
+OPTIONAL PARAMETERS
+-------------------
+datacenter
+   can be provided to override the agent's default datacenter
+
+state
+   if this watch is 'present' or 'absent'. Defaults to 'present'.
+
+token
+   can be provided to override the agent's default ACL token
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_watch_keyprefix some-id \
+       --prefix foo/ \
+       --handler /usr/bin/my-prefix-handler.sh
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_watch_nodes.txt

@@ -0,0 +1,59 @@
+cdist-type__consul_watch_nodes(7)
+=================================
+
+NAME
+----
+cdist-type__consul_watch_nodes - Manages consul nodes watches
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+handler
+   the handler to invoke when the data view updates
+
+
+OPTIONAL PARAMETERS
+-------------------
+datacenter
+   can be provided to override the agent's default datacenter
+
+state
+   if this watch is 'present' or 'absent'. Defaults to 'present'.
+
+token
+   can be provided to override the agent's default ACL token
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_watch_nodes some-id \
+       --handler /usr/bin/my-key-handler.sh
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_watch_service.txt

@@ -0,0 +1,83 @@
+cdist-type__consul_watch_service(7)
+===================================
+
+NAME
+----
+cdist-type__consul_watch_service - Manages consul service watches
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+handler
+   the handler to invoke when the data view updates
+
+service
+   the service to watch for changes
+
+
+OPTIONAL PARAMETERS
+-------------------
+datacenter
+   can be provided to override the agent's default datacenter
+
+state
+   if this watch is 'present' or 'absent'. Defaults to 'present'.
+
+token
+   can be provided to override the agent's default ACL token
+
+tag
+   filter by tag
+
+
+BOOLEAN PARAMETERS
+------------------
+passingonly
+   specifies if only hosts passing all checks are displayed
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_watch_service some-id \
+       --service consul \
+       --handler /usr/bin/my-handler.sh
+
+    __consul_watch_service some-id \
+       --service redis \
+       --tag production \
+       --handler /usr/bin/my-handler.sh
+
+    __consul_watch_service some-id \
+       --service redis \
+       --tag production \
+       --passingonly \
+       --handler /usr/bin/my-handler.sh
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__consul_watch_services.txt

@@ -0,0 +1,59 @@
+cdist-type__consul_watch_services(7)
+====================================
+
+NAME
+----
+cdist-type__consul_watch_services - Manages consul services watches
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+handler
+   the handler to invoke when the data view updates
+
+
+OPTIONAL PARAMETERS
+-------------------
+datacenter
+   can be provided to override the agent's default datacenter
+
+state
+   if this watch is 'present' or 'absent'. Defaults to 'present'.
+
+token
+   can be provided to override the agent's default ACL token
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __consul_watch_services some-id \
+       --handler /usr/bin/my-key-handler.sh
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__consul_agent`\ (7)
+
+consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__cron.txt

@@ -0,0 +1,84 @@
+cdist-type__cron(7)
+===================
+
+NAME
+----
+cdist-type__cron - Installs and manages cron jobs
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to manage entries in a users crontab.
+
+
+REQUIRED PARAMETERS
+-------------------
+user
+   The user who's crontab is edited
+command
+   The command to run.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   Either present or absent. Defaults to present.
+minute
+   See crontab(5). Defaults to *
+hour
+   See crontab(5). Defaults to *
+day_of_month
+   See crontab(5). Defaults to *
+month
+   See crontab(5). Defaults to *
+day_of_week
+   See crontab(5). Defaults to *
+raw
+   Take whatever the user has given instead of time and date fields.
+   If given, all other time and date fields are ignored.
+   Can for example be used to specify cron EXTENSIONS like reboot, yearly etc.
+   See crontab(5) for the extensions if any that your cron implementation
+   implements.
+raw_command
+   Take whatever the user has given in the command and ignore everything else.
+   If given, the command will be added to crontab.
+   Can for example be used to define variables like SHELL or MAILTO.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # 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
+
+    # run on reboot
+    __cron some-id --user root --command "/path/to/script" \
+       --raw @reboot
+
+    # remove cronjob
+    __cron some-id --user root --command "/path/to/script" --state absent
+
+    # define default shell
+    __cron some-id --user root --raw_command --command "SHELL=/bin/bash" \
+       --state present
+
+
+SEE ALSO
+--------
+:strong:`crontab`\ (5)
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__debconf_set_selections.txt

@@ -0,0 +1,53 @@
+cdist-type__debconf_set_selections(7)
+=====================================
+
+NAME
+----
+cdist-type__debconf_set_selections - Setup debconf selections
+
+
+DESCRIPTION
+-----------
+On Debian and alike systems debconf-set-selections(1) can be used
+to setup configuration parameters.
+
+
+REQUIRED PARAMETERS
+-------------------
+file
+   Use the given filename as input for debconf-set-selections(1)
+   If filename is "-", read from stdin.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Setup configuration for nslcd
+    __debconf_set_selections nslcd --file /path/to/file
+
+    # Setup configuration for nslcd from another type
+    __debconf_set_selections nslcd --file "$__type/files/preseed/nslcd"
+
+    __debconf_set_selections nslcd --file - << eof
+    gitolite gitolite/gituser string git
+    eof
+
+
+SEE ALSO
+--------
+:strong:`debconf-set-selections`\ (1), :strong:`cdist-type__update_alternatives`\ (7)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+COPYING
+-------
+Copyright \(C) 2011-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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__directory.txt

@@ -0,0 +1,101 @@
+cdist-type__directory(7)
+========================
+
+NAME
+----
+cdist-type__directory - Manage a directory
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to create or remove directories on the target.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present' or 'absent', defaults to 'present'
+
+group
+   Group to chgrp to.
+
+mode
+   Unix permissions, suitable for chmod.
+
+owner
+   User to chown to.
+
+
+BOOLEAN PARAMETERS
+------------------
+parents
+   Whether to create parents as well (mkdir -p behaviour).
+   Warning: all intermediate directory permissions default
+   to whatever mkdir -p does. 
+
+   Usually this means root:root, 0700.
+
+recursive
+   If supplied the chgrp and chown call will run recursively.
+   This does *not* influence the behaviour of chmod.
+
+MESSAGES
+--------
+chgrp <group>
+    Changed group membership
+chown <owner>
+    Changed owner
+chmod <mode>
+    Changed mode
+create
+    Empty directory was created
+remove
+    Directory exists, but state is absent, directory will be removed by generated code.
+remove non directory
+    Something other than a directory with the same name exists and was removed prior to create.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # A silly example
+    __directory /tmp/foobar
+
+    # Remove a directory
+    __directory /tmp/foobar --state absent
+
+    # Ensure /etc exists correctly
+    __directory /etc --owner root --group root --mode 0755
+
+    # Create nfs service directory, including parents
+    __directory /home/services/nfs --parents
+
+    # Change permissions recursively
+    __directory /home/services --recursive --owner root --group root
+
+    # Setup a temp directory
+    __directory /local --mode 1777
+
+    # Take it all
+    __directory /home/services/kvm --recursive --parents \
+        --owner root --group root --mode 0755 --state present
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__dog_vdi.txt

@@ -0,0 +1,59 @@
+cdist-type__dog_vdi(7)
+======================
+
+NAME
+----
+cdist-type__dog_vdi - Manage Sheepdog VM images
+
+
+DESCRIPTION
+-----------
+The dog program is used to create images for sheepdog
+to be used in qemu.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    Either "present" or "absent", defaults to "present"
+size
+    Size of the image in "dog vdi" compatible units.
+
+    Required if state is "present".
+
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Create a 50G size image
+    __dog_vdi nico-privat.sky.ungleich.ch --size 50G
+
+    # Create a 50G size image (more explicit)
+    __dog_vdi nico-privat.sky.ungleich.ch --size 50G --state present
+
+    # Remove image
+    __dog_vdi nico-privat.sky.ungleich.ch --state absent
+
+    # Remove image - keeping --size is ok
+    __dog_vdi nico-privat.sky.ungleich.ch --size 50G --state absent
+
+
+SEE ALSO
+--------
+:strong:`qemu`\ (1), :strong:`dog`\ (8)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__file.txt

@@ -0,0 +1,112 @@
+cdist-type__file(7)
+===================
+
+NAME
+----
+cdist-type__file - Manage files.
+
+
+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:
+
+regular file, and state is:
+  present
+    replace it with the source file if they are not equal
+  exists
+    do nothing
+symlink
+  replace it with the source file
+directory
+  replace it with the source file
+
+In any case, make sure that the file attributes are as specified.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present', 'absent' or 'exists', defaults to 'present' where:
+
+   present
+      the file is exactly the one from source
+   absent
+      the file does not exist
+   exists
+      the file from source but only if it doesn't already exist
+
+group
+   Group to chgrp to.
+
+mode
+   Unix permissions, suitable for chmod.
+
+owner
+   User to chown to.
+
+source
+   If supplied, copy this file from the host running cdist to the target.
+   If not supplied, an empty file or directory will be created.
+   If source is '-' (dash), take what was written to stdin as the file content.
+
+MESSAGES
+--------
+chgrp <group>
+   Changed group membership
+chown <owner>
+   Changed owner
+chmod <mode>
+   Changed mode
+create
+   Empty file was created (no --source specified)
+remove
+   File exists, but state is absent, file will be removed by generated code.
+upload
+   File was uploaded
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Create  /etc/cdist-configured as an empty file
+    __file /etc/cdist-configured
+    # The same thing
+    __file /etc/cdist-configured --state present
+    # Use __file from another type
+    __file /etc/issue --source "$__type/files/archlinux" --state present
+    # Delete existing file
+    __file /etc/cdist-configured --state absent
+    # Supply some more settings
+    __file /etc/shadow --source "$__type/files/shadow" \
+       --owner root --group shadow --mode 0640 \
+       --state present
+    # Provide a default file, but let the user change it
+    __file /home/frodo/.bashrc --source "/etc/skel/.bashrc" \
+       --state exists \
+       --owner frodo --mode 0600
+    # Take file content from stdin
+    __file /tmp/whatever --owner root --group root --mode 644 --source - << DONE
+        Here goes the content for /tmp/whatever
+    DONE
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__filesystem.txt

@@ -0,0 +1,81 @@
+cdist-type__filesystem(7)
+=========================
+
+NAME
+----
+cdist-type__filesystem - Create Filesystems.
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+fstype
+    Filesystem type, for example 'ext3', 'btrfs' or 'xfs'.
+
+
+
+OPTIONAL PARAMETERS
+-------------------
+device
+    Blockdevice for filesystem, Defaults to object_id.
+    On linux, it can be any lsblk accepted device notation.
+
+    |
+    | For example:
+    |    /dev/sdx
+    |    or /dev/disk/by-xxxx/xxx
+    |    or /dev/mapper/xxxx
+
+label
+   Label which should be applied on the filesystem.
+
+mkfsoptions
+   Additional options which are inserted to the mkfs.xxx call.
+
+
+BOOLEAN PARAMETERS
+------------------
+force
+   Normally, this type does nothing if a filesystem is found
+   on the target device. If you specify force, it's formatted
+   if the filesystem type or label differs from parameters.
+   Warning: This option can easily lead into data loss!
+
+MESSAGES
+--------
+filesystem <fstype> on <device> \: <discoverd device> created
+   Filesystem was created on <discoverd device>
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # 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
+    __filesystem dev_sdb --fstype btrfs --device /dev/disk/by-path/pci-0000:0b:00.0-scsi-0:0:0:0 --label Testdisk2
+    # Make sure that a multipath san device has a filesystem ...
+    __filesystem dev_sdb --fstype xfs --device /dev/mapper/360060e80432f560050202f22000023ff --label Testdisk3
+
+
+AUTHORS
+-------
+Daniel Heule <hda--@--sfs.biz>
+
+
+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+).

software/cdist/man/4.3.1/_sources/man7/cdist-type__firewalld_rule.txt

@@ -0,0 +1,81 @@
+cdist-type__firewalld_rule(7)
+=============================
+
+NAME
+----
+cdist-type__firewalld_rule - Configure firewalld rules
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to manage rules in firewalld
+using the *direct* way (i.e. no zone support).
+
+
+REQUIRED PARAMETERS
+-------------------
+rule
+    The rule to apply. Essentially an firewalld command
+    line without firewalld in front of it.
+protocol
+    Either ipv4, ipv4 or eb. See firewall-cmd(1)
+table
+    The table to use (like filter or nat). See firewall-cmd(1).
+chain
+    The chain to use (like INPUT_direct or FORWARD_direct). See firewall-cmd(1).
+priority
+    The priority to use (0 is topmost). See firewall-cmd(1).
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present' or 'absent', defaults to 'present'
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Allow acces from entrance.place4.ungleich.ch
+    __firewalld_rule entrance \
+        --protocol ipv4 \
+        --table filter \
+        --chain INPUT_direct \
+        --priority 0 \
+        --rule '-s entrance.place4.ungleich.ch -j ACCEPT'
+
+    # Allow forwarding of traffic from br0
+    __firewalld_rule vm-forward --protocol ipv4 \
+        --table filter \
+        --chain FORWARD_direct \
+        --priority 0 \
+        --rule '-i br0 -j ACCEPT'
+
+    # Ensure old rule is absent - warning, the rule part must stay the same!
+    __firewalld_rule vm-forward
+        --protocol ipv4 \
+        --table filter \
+        --chain FORWARD_direct \
+        --priority 0 \
+        --rule '-i br0 -j ACCEPT' \
+        --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__iptables_rule`\ (7), :strong:`firewalld`\ (8)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__git.txt

@@ -0,0 +1,60 @@
+cdist-type__git(7)
+==================
+
+NAME
+----
+cdist-type__git -  Get and or keep git repositories up-to-date
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to clone git repositories
+
+
+REQUIRED PARAMETERS
+-------------------
+source
+    Specifies the git remote to clone from
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    Either "present" or "absent", defaults to "present"
+
+branch
+    Create this branch by checking out the remote branch of this name
+    Default branch is "master"
+
+group
+   Group to chgrp to.
+
+mode
+   Unix permissions, suitable for chmod.
+
+owner
+   User to chown to.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __git /home/services/dokuwiki --source git://github.com/splitbrain/dokuwiki.git
+
+    # Checkout cdist, stay on branch 2.1
+    __git /home/nico/cdist --source git://github.com/telmich/cdist.git --branch 2.1
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__group.txt

@@ -0,0 +1,80 @@
+cdist-type__group(7)
+====================
+
+NAME
+----
+cdist-type__group - Manage groups
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to create or modify groups on the target.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    absent or present, defaults to present
+gid
+   see groupmod(8)
+password
+   see above
+
+
+BOOLEAN PARAMETERS
+------------------
+system
+    see groupadd(8), apply only on group creation
+
+
+MESSAGES
+--------
+mod
+    group is modified
+add
+    New group added
+remove
+    group is removed
+change <property> <new_value> <current_value>
+    Changed group property from current_value to new_value
+set <property> <new_value>
+    set property to new value, property was not set before
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Create a group 'foobar' with operating system default settings
+    __group foobar
+
+    # Remove the 'foobar' group
+    __group foobar --state absent
+
+    # Create a system group 'myservice' with operating system default settings
+    __group myservice --system
+
+    # Same but with a specific gid
+    __group foobar --gid 1234
+
+    # Same but with a gid and password
+    __group foobar --gid 1234 --password 'crypted-password-string'
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__hostname.txt

@@ -0,0 +1,52 @@
+cdist-type__hostname(7)
+=======================
+
+NAME
+----
+cdist-type__hostname - Set the hostname
+
+
+DESCRIPTION
+-----------
+Set's the hostname on various operating systems.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+OPTIONAL PARAMETERS
+-------------------
+name
+   The hostname to set. Defaults to the first segment of __target_host 
+   (${__target_host%%.*})
+
+
+MESSAGES
+--------
+changed
+    Changed the hostname
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # take hostname from __target_host
+    __hostname
+
+    # set hostname explicitly
+    __hostname --name some-static-hostname
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__iptables_apply.txt

@@ -0,0 +1,45 @@
+cdist-type__iptables_apply(7)
+=============================
+
+NAME
+----
+cdist-type__iptables_apply - Apply the rules
+
+
+DESCRIPTION
+-----------
+This cdist type deploys an init script that triggers
+the configured rules and also re-applies them on
+configuration.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+OPTIONAL PARAMETERS
+-------------------
+None
+
+EXAMPLES
+--------
+
+None (__iptables_apply is used by __iptables_rule)
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__iptables_rule`\ (7), :strong:`iptables`\ (8)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__iptables_rule.txt

@@ -0,0 +1,66 @@
+cdist-type__iptables_rule(7)
+============================
+
+NAME
+----
+cdist-type__iptables_rule - Deploy iptable rulesets
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to manage iptable rules
+in a distribution independent manner.
+
+
+REQUIRED PARAMETERS
+-------------------
+rule
+    The rule to apply. Essentially an iptables command
+    line without iptables in front of it.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present' or 'absent', defaults to 'present'
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Deploy some policies
+    __iptables_rule policy-in  --rule "-P INPUT DROP"
+    __iptables_rule policy-out  --rule "-P OUTPUT ACCEPT"
+    __iptables_rule policy-fwd  --rule "-P FORWARD DROP"
+
+    # The usual established rule
+    __iptables_rule established  --rule "-A INPUT -m state --state RELATED,ESTABLISHED -j ACCEPT"
+
+    # Some service rules
+    __iptables_rule http  --rule "-A INPUT -p tcp --dport 80 -j ACCEPT"
+    __iptables_rule ssh   --rule "-A INPUT -p tcp --dport 22 -j ACCEPT"
+    __iptables_rule https --rule "-A INPUT -p tcp --dport 443 -j ACCEPT"
+
+    # Ensure some rules are not present anymore
+    __iptables_rule munin --rule "-A INPUT -p tcp --dport 4949 -j ACCEPT" \
+        --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__iptables_apply`\ (7), :strong:`iptables`\ (8)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__issue.txt

@@ -0,0 +1,47 @@
+cdist-type__issue(7)
+====================
+
+NAME
+----
+cdist-type__issue - Manage issue
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to easily setup /etc/issue.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+source
+   If supplied, use this file as /etc/issue instead of default.
+
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __issue
+
+    # When called from another type
+    __issue --source "$__type/files/myfancyissue"
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__jail.txt

@@ -0,0 +1,124 @@
+cdist-type__jail(7)
+===================
+
+NAME
+----
+cdist-type__jail - Manage FreeBSD jails
+
+
+DESCRIPTION
+-----------
+This type is used on FreeBSD to manage jails by calling the appropriate per-version subtype.
+
+
+REQUIRED PARAMETERS
+-------------------
+state
+   Either "present" or "absent", defaults to "present".
+
+jailbase
+   The location of the .tgz archive containing the base fs for your jails.
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+   The name of the jail. Default is to use the object_id as the jail name.
+
+ip
+   The ifconfig style IP/netmask combination to use for the jail guest. If
+   the state parameter is "present," this parameter is required.
+
+hostname
+   The FQDN to use for the jail guest. Defaults to the name parameter.
+
+interface
+   The name of the physical interface on the jail server to bind the jail to.
+   Defaults to the first interface found in the output of ifconfig -l.
+
+devfs-ruleset
+   The name of the devfs ruleset to associate with the jail. Defaults to
+   "jailrules." This ruleset must be copied to the server via another type.
+   To use this option, devfs-enable must be "true."
+
+jaildir
+   The location on the remote server to use for hosting jail filesystems.
+   Defaults to /usr/jail.
+
+BOOLEAN PARAMETERS
+------------------
+stopped
+   Do not start the jail
+
+devfs-disable
+   Whether to disallow devfs mounting within the jail
+
+onboot
+   Whether to add the jail to rc.conf's jail_list variable. 
+
+
+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.
+
+MESSAGES
+--------
+start
+   The jail was started
+stop
+   The jail was stopped
+create:
+   The jail was created
+delete
+   The jail was deleted
+onboot
+   The jail was configured to start on boot
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Create a jail called www
+    __jail www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
+
+    # Remove the jail called www
+    __jail www --state absent --jailbase /my/jail/base.tgz
+
+    # The jail www should not be started
+    __jail www --state present --stopped \
+       --ip "192.168.1.2 netmask 255.255.255.0" \
+       --jailbase /my/jail/base.tgz
+
+    # Use the name variable explicitly
+    __jail thisjail --state present --name www \
+       --ip "192.168.1.2" \
+       --jailbase /my/jail/base.tgz
+
+    # Go nuts
+    __jail lotsofoptions --state present --name testjail \
+       --ip "192.168.1.100 netmask 255.255.255.0" \
+       --hostname "testjail.example.com" --interface "em0" \
+       --onboot --jailbase /my/jail/base.tgz --jaildir /jails
+
+
+SEE ALSO
+--------
+:strong:`jail`\ (8)
+
+
+AUTHORS
+-------
+Jake Guffey <jake.guffey--@--jointheirstm.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__jail_freebsd10.txt

@@ -0,0 +1,123 @@
+cdist-type__jail_freebsd10(7)
+=============================
+
+NAME
+----
+cdist-type__jail_freeebsd10 - Manage FreeBSD jails
+
+
+DESCRIPTION
+-----------
+This type is used on FreeBSD >= 10.0 to manage jails.
+
+
+REQUIRED PARAMETERS
+-------------------
+state
+   Either "present" or "absent", defaults to "present".
+
+jailbase
+   The location of the .tgz archive containing the base fs for your jails.
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+   The name of the jail. Default is to use the object_id as the jail name.
+
+ip
+   The ifconfig style IP/netmask combination to use for the jail guest. If
+   the state parameter is "present," this parameter is required.
+
+hostname
+   The FQDN to use for the jail guest. Defaults to the name parameter.
+
+interface
+   The name of the physical interface on the jail server to bind the jail to.
+   Defaults to the first interface found in the output of ifconfig -l.
+
+devfs-ruleset
+   The name of the devfs ruleset to associate with the jail. Defaults to
+   "jailrules." This ruleset must be copied to the server via another type.
+   To use this option, devfs-enable must be "true."
+
+jaildir
+   The location on the remote server to use for hosting jail filesystems.
+   Defaults to /usr/jail.
+
+BOOLEAN PARAMETERS
+------------------
+stopped
+   Do not start the jail
+
+devfs-disable
+   Whether to disallow devfs mounting within the jail
+
+onboot
+   Whether to add the jail to rc.conf's jail_list variable. 
+
+
+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.
+
+MESSAGES
+--------
+start
+   The jail was started
+stop
+   The jail was stopped
+create:
+   The jail was created
+delete
+   The jail was deleted
+onboot
+   The jail was configured to start on boot
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Create a jail called www
+    __jail_freebsd10 www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
+
+    # Remove the jail called www
+    __jail_freebsd10 www --state absent --jailbase /my/jail/base.tgz
+
+    # The jail www should not be started
+    __jail_freebsd10 www --state present --stopped \
+       --ip "192.168.1.2 netmask 255.255.255.0" \
+       --jailbase /my/jail/base.tgz
+
+    # Use the name variable explicitly
+    __jail_freebsd10 thisjail --state present --name www \
+       --ip "192.168.1.2" \
+       --jailbase /my/jail/base.tgz
+
+    # Go nuts
+    __jail_freebsd10 lotsofoptions --state present --name testjail \
+       --ip "192.168.1.100 netmask 255.255.255.0" \
+       --hostname "testjail.example.com" --interface "em0" \
+       --onboot --jailbase /my/jail/base.tgz --jaildir /jails
+
+
+SEE ALSO
+--------
+:strong:`jail`\ (8)
+
+
+AUTHORS
+-------
+Jake Guffey <jake.guffey--@--jointheirstm.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__jail_freebsd9.txt

@@ -0,0 +1,124 @@
+cdist-type__jail_freebsd9(7)
+============================
+
+NAME
+----
+cdist-type__jail_freebsd9 - Manage FreeBSD jails
+
+
+DESCRIPTION
+-----------
+This type is used on FreeBSD <= 9.x to manage jails.
+
+
+REQUIRED PARAMETERS
+-------------------
+state
+   Either "present" or "absent", defaults to "present".
+
+jailbase
+   The location of the .tgz archive containing the base fs for your jails.
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+   The name of the jail. Default is to use the object_id as the jail name.
+
+ip
+   The ifconfig style IP/netmask combination to use for the jail guest. If
+   the state parameter is "present," this parameter is required.
+
+hostname
+   The FQDN to use for the jail guest. Defaults to the name parameter.
+
+interface
+   The name of the physical interface on the jail server to bind the jail to.
+   Defaults to the first interface found in the output of ifconfig -l.
+
+devfs-ruleset
+   The name of the devfs ruleset to associate with the jail. Defaults to
+   "jailrules." This ruleset must be copied to the server via another type.
+   To use this option, devfs-enable must be "true."
+
+jaildir
+   The location on the remote server to use for hosting jail filesystems.
+   Defaults to /usr/jail.
+
+BOOLEAN PARAMETERS
+------------------
+stopped
+   Do not start the jail
+
+devfs-disable
+   Whether to disallow devfs mounting within the jail
+
+onboot
+   Whether to add the jail to rc.conf's jail_list variable. 
+
+
+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.
+
+MESSAGES
+--------
+start
+   The jail was started
+stop
+   The jail was stopped
+create:
+   The jail was created
+delete
+   The jail was deleted
+onboot
+   The jail was configured to start on boot
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Create a jail called www
+    __jail_freebsd9 www --state present --ip "192.168.1.2" --jailbase /my/jail/base.tgz
+
+    # Remove the jail called www
+    __jail_freebsd9 www --state absent --jailbase /my/jail/base.tgz
+
+    # The jail www should not be started
+    __jail_freebsd9 www --state present --stopped \
+       --ip "192.168.1.2 netmask 255.255.255.0" \
+       --jailbase /my/jail/base.tgz
+
+    # Use the name variable explicitly
+    __jail_freebsd9 thisjail --state present --name www \
+       --ip "192.168.1.2" \
+       --jailbase /my/jail/base.tgz
+
+    # Go nuts
+    __jail_freebsd9 lotsofoptions --state present --name testjail \
+       --ip "192.168.1.100 netmask 255.255.255.0" \
+       --hostname "testjail.example.com" --interface "em0" \
+       --onboot --jailbase /my/jail/base.tgz --jaildir /jails
+
+
+SEE ALSO
+--------
+:strong:`jail`\ (8)
+
+
+AUTHORS
+-------
+Jake Guffey <jake.guffey--@--eprotex.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__key_value.txt

@@ -0,0 +1,94 @@
+cdist-type__key_value(7)
+========================
+
+NAME
+----
+cdist-type__key_value - Change property values in files
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to change values in a key value based config
+file.
+
+
+REQUIRED PARAMETERS
+-------------------
+file
+   The file to operate on.
+delimiter
+   The delimiter which separates the key from the value.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    present or absent, defaults to present. If present, sets the key to value,
+    if absent, removes the key from the file.
+key
+    The key to change. Defaults to object_id.
+value
+    The value for the key. Optional if state=absent, required otherwise.
+comment
+    If supplied, the value will be inserted before the line with the key,
+    but only if the key or value must be changed.
+    You need to ensure yourself that the line is prefixed with the correct
+    comment sign. (for example # or ; or wathever ..)
+
+
+BOOLEAN PARAMETERS
+------------------
+exact_delimiter
+    If supplied, treat additional whitespaces between key, delimiter and value
+    as wrong value.
+
+
+MESSAGES
+--------
+remove
+    Removed existing key and value
+insert
+    Added key and value
+change
+    Changed value of existing key
+create
+    A new line was inserted in a new file
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Set the maximum system user id
+    __key_value SYS_UID_MAX --file /etc/login.defs --value 666 --delimiter ' '
+
+    # Same with fancy id
+    __key_value my-fancy-id --file /etc/login.defs --key SYS_UID_MAX --value 666 \
+       --delimiter ' '
+
+    # Enable packet forwarding
+    __key_value net.ipv4.ip_forward --file /etc/sysctl.conf --value 1 \
+       --delimiter ' = ' --comment '# my linux kernel should act as a router'
+
+    # Remove existing key/value
+    __key_value LEGACY_KEY --file /etc/somefile --state absent --delimiter '='
+
+
+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.
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__keyboard.txt

@@ -0,0 +1,37 @@
+cdist-type__keyboard(7)
+=======================
+
+NAME
+----
+cdit-type__keyboard - Set keyboard layout
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to modify keyboard layout.
+
+
+REQUIRED PARAMETERS
+-------------------
+type
+   Any valid type, for example "us"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Set keyboard type to "us"
+    __keyboard --type "us"
+
+
+AUTHORS
+-------
+Carlos Ortigoza <carlos.ortigoza--@--ungleich.ch>
+
+
+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+).

software/cdist/man/4.3.1/_sources/man7/cdist-type__line.txt

@@ -0,0 +1,77 @@
+cdist-type__line(7)
+===================
+
+NAME
+----
+cdist-type__line - Manage lines in files
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to add lines and remove lines from files.
+
+
+REQUIRED PARAMETERS
+-------------------
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    'present' or 'absent', defaults to 'present'
+
+line
+    Specifies the line which should be absent or present
+
+    Must be present, if state is present.
+    Must not be combined with regex, if state is absent.
+
+regex
+    If state is present, search for this pattern and add
+    given line, if the given regular expression does not match.
+
+    In case of absent, ensure all lines matching the
+    regular expression are absent.
+
+    The regular expression is interpreted by grep.
+
+    Must not be combined with line, if state is absent.
+
+file
+    If supplied, use this as the destination file.
+    Otherwise the object_id is used.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Manage the DAEMONS line in rc.conf
+    __line daemons --file /etc/rc.conf --line 'DAEMONS=(hwclock !network sshd crond postfix)'
+
+    # Ensure the home mount is present in /etc/fstab - explicitly make it present
+    __line home-fstab \
+        --file /etc/fstab \
+        --line 'filer.fs:/vol/home /home  nfs    defaults        0 0' \
+        --state present
+
+    # Removes the line specifiend in "include_www" from the file "lighttpd.conf"
+    __line legacy_timezone --file /etc/rc.conf --regex 'TIMEZONE=.*' --state absent
+
+
+SEE ALSO
+--------
+:strong:`grep`\ (1)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+COPYING
+-------
+Copyright \(C) 2012-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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__link.txt

@@ -0,0 +1,60 @@
+cdist-type__link(7)
+===================
+
+NAME
+----
+cdist-type__link - Manage links (hard and symbolic)
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to manage hard and symbolic links.
+The given object id is the destination for the link.
+
+
+REQUIRED PARAMETERS
+-------------------
+source
+   Specifies the link source.
+
+type
+   Specifies the link type: Either hard or symoblic.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present' or 'absent', defaults to 'present'
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Create hard link of /etc/shadow
+    __link /root/shadow --source /etc/shadow --type hard
+
+    # Relative symbolic link
+    __link /etc/apache2/sites-enabled/www.test.ch   \
+       --source ../sites-available/www.test.ch      \
+       --type symbolic
+
+    # Absolute symbolic link
+    __link /opt/plone --source /home/services/plone --type symbolic
+
+    # Remove link
+    __link /opt/plone --state absent
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__locale.txt

@@ -0,0 +1,49 @@
+cdist-type__locale(7)
+=====================
+
+NAME
+----
+cdist-type__locale - Configure locales
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to setup locales.
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   'present' or 'absent', defaults to present
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Add locale de_CH.UTF-8
+    __locale de_CH.UTF-8
+
+    # Same as above, but more explicit
+    __locale de_CH.UTF-8 --state present
+
+    # Remove colourful British English
+    __locale en_GB.UTF-8 --state absent
+
+
+SEE ALSO
+--------
+:strong:`locale`\ (1), :strong:`localedef`\ (1), :strong:`cdist-type__locale_system`\ (7)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+COPYING
+-------
+Copyright \(C) 2013-2016 Nico Schottelius. Free use of this software is
+granted under the terms of the GNU General Public License version 3 or
+later (GPLv3+).

software/cdist/man/4.3.1/_sources/man7/cdist-type__locale_system.txt

@@ -0,0 +1,64 @@
+cdist-type__locale_system(7)
+============================
+
+NAME
+----
+cdist-type__locale_system - Set system-wide locale
+
+
+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).
+
+
+OPTIONAL PARAMETERS
+-------------------
+
+state
+    present or absent, defaults to present.
+    If present, sets the locale category to the given value.
+    If absent, removes the locale category from the system file.
+
+value
+    The value for the locale category.
+    Defaults to en_US.UTF-8.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Set LANG to en_US.UTF-8
+    __locale_system LANG
+
+    # Same as above, but more explicit
+    __locale_system LANG --value en_US.UTF-8
+
+    # Set category LC_MESSAGES to de_CH.UTF-8
+    __locale_system LC_MESSAGES --value de_CH.UTF-8
+
+    # Remove setting for LC_ALL
+    __locale_system LC_ALL --state absent
+
+
+
+SEE ALSO
+--------
+:strong:`locale`\ (1), :strong:`localedef`\ (1), :strong:`cdist-type__locale`\ (7)
+
+
+AUTHORS
+-------
+| Steven Armstrong <steven-cdist--@--armstrong.cc>
+| Carlos Ortigoza <carlos.ortigoza--@--ungleich.ch>
+| Nico Schottelius <nico.schottelius--@--ungleich.ch>
+
+
+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+).

software/cdist/man/4.3.1/_sources/man7/cdist-type__motd.txt

@@ -0,0 +1,48 @@
+cdist-type__motd(7)
+===================
+
+NAME
+----
+cdist-type__motd - Manage message of the day
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to easily setup /etc/motd.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+source
+   If supplied, copy this file from the host running cdist to the target.
+   If not supplied, a default message will be placed onto the target.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Use cdist defaults
+    __motd
+
+    # Supply source file from a different type
+    __motd --source "$__type/files/my-motd"
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__mount.txt

@@ -0,0 +1,84 @@
+cdist-type__mount(7)
+====================
+
+NAME
+----
+cdit-type__mount - Manage filesystem mounts
+
+
+DESCRIPTION
+-----------
+Manage filesystem mounts either via /etc/fstab or manually.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+device
+   device to mount at path, defaults to 'none'. see mount(8)
+
+dump
+   value for the dump field in fstab. see fstab(5)
+   defaults to 0.
+
+   This parameter is ignored, if the nofstab parameter is given.
+
+options
+   comma separated string of options, see mount(8)
+
+pass
+   value for the pass field in fstab. see fstab(5)
+   defaults to 0.
+
+   This parameter is ignored, if the nofstab parameter is given.
+
+path
+   mount point where to mount the device, see mount(8).
+   Defaults to __object_id
+
+state
+   either present or absent. Defaults to present.
+
+type
+   vfstype, see mount(8)
+
+
+BOOLEAN PARAMETERS
+------------------
+nofstab
+   do not manage an entry in /etc/fstab
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __mount /some/dir \
+       --device /dev/sdc3 \
+       --type xfs \
+       --options "defaults,ro"
+       --dump 0 \
+       --pass 1
+
+    __mount /var/lib/one \
+       --device mfsmount \
+       --type fuse \
+       --options "mfsmaster=mfsmaster.domain.tld,mfssubfolder=/one,nonempty,_netdev"
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__mysql_database.txt

@@ -0,0 +1,49 @@
+cdist-type__mysql_database(7)
+=============================
+
+NAME
+----
+cdist-type__mysql_database - Manage a MySQL database
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to install a MySQL database.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+OPTIONAL PARAMETERS
+-------------------
+name
+   The name of the database to install
+   defaults to the object id
+
+user
+   A user that should have access to the database
+
+password
+   The password for the user who manages the database
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __mysql_database "cdist" --name "cdist" --user "myuser" --password "mypwd"
+
+
+AUTHORS
+-------
+Benedikt Koeppel <code@benediktkoeppel.ch>
+
+
+COPYING
+-------
+Copyright \(C) 2012 Benedikt Koeppel. 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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package.txt

@@ -0,0 +1,64 @@
+cdist-type__package(7)
+======================
+
+NAME
+----
+cdist-type__package - Manage packages
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+    The name of the package to install. Default is to use the object_id as the
+    package name.
+version
+    The version of the package to install. Default is to install the version
+    chosen by the local package manager.
+type
+    The package type to use. Default is determined based on the $os explorer
+    variable.
+    e.g.
+    * __package_apt for Debian
+    * __package_emerge for Gentoo
+
+state
+    Either "present" or "absent", defaults to "present"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Install the package vim on the target
+    __package vim --state present
+
+    # Same but install specific version
+    __package vim --state present --version 7.3.50
+
+    # Force use of a specific package type
+    __package vim --state present --type __package_apt
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_apt.txt

@@ -0,0 +1,62 @@
+cdist-type__package_apt(7)
+==========================
+
+NAME
+----
+cdist-type__package_apt - Manage packages with apt-get
+
+
+DESCRIPTION
+-----------
+apt-get is usually used on Debian and variants (like Ubuntu) to
+manage packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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"
+
+target-release
+    Passed on to apt-get install, see apt-get(8).
+    Essentially allows you to retrieve packages from a different release
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure zsh in installed
+    __package_apt zsh --state present
+
+    # In case you only want *a* webserver, but don't care which one
+    __package_apt webserver --state present --name nginx
+
+    # Remove obsolete package
+    __package_apt puppet --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_emerge.txt

@@ -0,0 +1,63 @@
+cdist-type__package_emerge(7)
+=============================
+
+NAME
+----
+cdist-type__package_emerge - Manage packages with portage
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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".
+
+version
+    If supplied, use to install or uninstall a specific version of the package named.
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure sys-devel/gcc is installed
+    __package_emerge sys-devel/gcc --state present
+
+    # If you want a specific version of a package
+    __package_emerge app-portage/gentoolkit --state present --version 0.3.0.8-r2
+
+    # Remove package
+    __package_emerge sys-devel/gcc --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7), :strong:`cdist-type__package_emerge_dependencies`\ (7)
+
+
+AUTHORS
+-------
+Thomas Oettli <otho--@--sfs.biz>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_emerge_dependencies.txt

@@ -0,0 +1,52 @@
+cdist-type__package_emerge_dependencies(7)
+==========================================
+
+NAME
+----
+cdist-type__package_emerge_dependencies - Install dependencies for __package_emerge
+
+
+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
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+None
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure app-portage/flaggie and app-portage/gentoolkit are installed
+    __package_emerge_dependencies
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7), :strong:`cdist-type__package_emerge`\ (7)
+
+
+AUTHORS
+-------
+Thomas Oettli <otho--@--sfs.biz>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_luarocks.txt

@@ -0,0 +1,55 @@
+cdist-type__package_luarocks(7)
+===============================
+
+NAME
+----
+cdist-type__package_luarocks - Manage luarocks packages
+
+
+DESCRIPTION
+-----------
+LuaRocks is a deployment and management system for Lua modules.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure luasocket is installed
+    __package_luarocks luasocket --state present
+
+    # Remove package
+    __package_luarocks luasocket --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Christian G. Warden <cwarden@xerus.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_opkg.txt

@@ -0,0 +1,55 @@
+cdist-type__package_opkg(7)
+===========================
+
+NAME
+----
+cdist-type__package_opkg - Manage packages with opkg
+
+
+DESCRIPTION
+-----------
+opkg is usually used on OpenWRT to manage packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure lsof is installed
+    __package_opkg lsof --state present
+
+    # Remove obsolete package
+    __package_opkg dnsmasq --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Giel van Schijndel <giel+cdist--@--mortis.eu>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_pacman.txt

@@ -0,0 +1,58 @@
+cdist-type__package_pacman(7)
+=============================
+
+NAME
+----
+cdist-type__package_pacman - Manage packages with pacman
+
+
+DESCRIPTION
+-----------
+Pacman is usually used on the Archlinux distribution to manage packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure zsh in installed
+    __package_pacman zsh --state present
+
+    # If you don't want to follow pythonX packages, but always use python
+    __package_pacman python --state present --name python2
+
+    # Remove obsolete package
+    __package_pacman puppet --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_pip.txt

@@ -0,0 +1,65 @@
+cdist-type__package_pip(7)
+==========================
+
+NAME
+----
+cdist-type__package_pip - Manage packages with pip
+
+
+DESCRIPTION
+-----------
+Pip is used in Python environments to install packages.
+It is also included in the python virtualenv environment.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+    If supplied, use the name and not the object id as the package name.
+
+pip
+    Instead of using pip from PATH, use the specific pip path.
+
+state
+    Either "present" or "absent", defaults to "present" 
+
+runas
+    Run pip as specified user. By default it runs as root.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Install a package
+    __package_pip pyro --state present
+
+    # Use pip in a virtualenv located at /root/shinken_virtualenv
+    __package_pip pyro --state present --pip /root/shinken_virtualenv/bin/pip
+
+    # Use pip in a virtualenv located at /foo/shinken_virtualenv as user foo
+    __package_pip pyro --state present --pip /foo/shinken_virtualenv/bin/pip --runas foo
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_pkg_freebsd.txt

@@ -0,0 +1,70 @@
+cdist-type__package_pkg_freebsd(7)
+==================================
+
+NAME
+----
+cdist-type__package_pkg_freebsd - Manage FreeBSD packages 
+
+
+DESCRIPTION
+-----------
+This type is usually used on FreeBSD to manage packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+    If supplied, use the name and not the object id as the package name.
+
+flavor
+    If supplied, use to avoid ambiguity.
+
+version
+    If supplied, use to install a specific version of the package named.
+
+pkgsite
+    If supplied, use to install from a specific package repository.
+
+state
+    Either "present" or "absent", defaults to "present"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure zsh is installed
+    __package_pkg_freebsd zsh --state present
+
+    # Ensure vim is installed, use flavor no_x11
+    __package_pkg_freebsd vim --state present --flavor no_x11
+
+    # If you don't want to follow pythonX packages, but always use python
+    __package_pkg_freebsd python --state present --name python2
+
+    # Remove obsolete package
+    __package_pkg_freebsd puppet --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Jake Guffey <jake.guffey--@--eprotex.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_pkg_openbsd.txt

@@ -0,0 +1,68 @@
+cdist-type__package_pkg(7)
+==========================
+
+NAME
+----
+cdist-type__package_pkg - Manage OpenBSD packages
+
+
+DESCRIPTION
+-----------
+This type is usually used on OpenBSD to manage packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+    If supplied, use the name and not the object id as the package name.
+
+flavor
+    If supplied, use to avoid ambiguity.
+
+state
+    Either "present" or "absent", defaults to "present"
+
+pkg_path
+    Manually specify a PKG_PATH to add packages from.
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure zsh is installed
+    __package_pkg_openbsd zsh --state present
+
+    # Ensure vim is installed, use flavor no_x11
+    __package_pkg_openbsd vim --state present --flavor no_x11
+
+    # If you don't want to follow pythonX packages, but always use python
+    __package_pkg_openbsd python --state present --name python2
+
+    # Remove obsolete package
+    __package_pkg_openbsd puppet --state absent
+
+    # Add a package using a particular mirror
+    __package_pkg_openbsd bash \
+      --pkg_path http://openbsd.mirrorcatalogs.com/snapshots/packages/amd64
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Andi Brönnimann <andi-cdist--@--v-net.ch>
+
+
+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).

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_pkgng_freebsd.txt

@@ -0,0 +1,101 @@
+cdist-type__package_pkgng_freebsd(7)
+====================================
+
+NAME
+----
+cdist-type__package_pkgng_freebsd - Manage FreeBSD packages with pkg-ng
+
+
+DESCRIPTION
+-----------
+This type is usually used on FreeBSD to manage packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+name
+    If supplied, use the name and not the object id as the package name.
+
+flavor
+    If supplied, use to avoid ambiguity.
+
+version
+    If supplied, use to install a specific version of the package named.
+
+repo
+    If supplied, use to install the package named from a particular repo.
+
+state
+    Either "present" or "absent", defaults to "present"
+
+
+BOOLEAN PARAMETERS
+------------------
+upgrade
+    If supplied, allow upgrading to the latest version of a package.
+
+
+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.
+
+
+MESSAGES
+--------
+install
+   The package was installed
+remove
+   The package was removed
+upgrade
+   The package was upgraded
+exist
+   The package was already present and thus not installed
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure zsh is installed
+    __package_pkgng_freebsd zsh --state present
+
+    # Ensure vim is installed, use flavor no_x11
+    __package_pkgng_freebsd vim --state present --flavor no_x11
+
+    # If you don't want to follow pythonX packages, but always use python
+    __package_pkgng_freebsd python --state present --name python2
+
+    # Install a package from a particular repository when multiples exist
+    __package_pkgng_freebsd bash --state present --repo myrepo
+
+    # Remove obsolete package
+    __package_pkgng_freebsd puppet --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Jake Guffey <jake.guffey--@--eprotex.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_rubygem.txt

@@ -0,0 +1,56 @@
+cdist-type__package_rubygem(7)
+==============================
+
+NAME
+----
+cdist-type__package_rubygem - Manage rubygem packages
+
+
+DESCRIPTION
+-----------
+Rubygems is the default package management system for the Ruby programming language.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure sinatra is installed
+    __package_rubygem sinatra --state present
+
+    # Remove package
+    __package_rubygem rails --state absent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Chase Allen James <nx-cdist@nu-ex.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_update_index.txt

@@ -0,0 +1,54 @@
+cdist-type__package_update_index(7)
+===================================
+
+NAME
+----
+cdist-type__update_index - Update the package index
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to update the package index on the target.
+It will automatically use the appropriate package manager.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+type
+    The package manager to use. Default is determined based on the $os
+    explorer variable.
+    e.g.
+    * apt for Debian
+    * yum for Red Hat
+    * pacman for Arch Linux
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Update the package index on the target
+    __package_update_index
+
+    # Force use of a specific package manager
+    __package_update_index --type apt
+
+
+AUTHORS
+-------
+Ricardo Catalinas Jiménez <jimenezrick--@--gmail.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_upgrade_all.txt

@@ -0,0 +1,53 @@
+cdist-type__package_upgrade_all(7)
+==================================
+
+NAME
+----
+cdist-type__package_upgrade_all - Upgrade all the installed packages
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to upgrade all the installed packages on the
+target. It will automatically use the appropriate package manager.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+OPTIONAL PARAMETERS
+-------------------
+type
+    The package manager to use. Default is determined based on the $os
+    explorer variable.
+    e.g.
+    * apt for Debian
+    * yum for Red Hat
+    * pacman for Arch Linux
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Upgrade all the installed packages on the target
+    __package_upgrade_all
+
+    # Force use of a specific package manager
+    __package_upgrade_all --type apt
+
+
+AUTHORS
+-------
+Ricardo Catalinas Jiménez <jimenezrick--@--gmail.com>
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_yum.txt

@@ -0,0 +1,65 @@
+cdist-type__package_yum(7)
+==========================
+
+NAME
+----
+cdist-type__package_yum - Manage packages with yum
+
+
+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".
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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"
+url
+    URL to use for the package
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure zsh in installed
+    __package_yum zsh --state present
+
+    # If you don't want to follow pythonX packages, but always use python
+    __package_yum python --state present --name python2
+
+    # Remove obsolete package
+    __package_yum puppet --state absent
+
+    __package epel-release-6-8 \
+        --url http://mirror.switch.ch/ftp/mirror/epel/6/i386/epel-release-6-8.noarch.rpm
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__package_zypper.txt

@@ -0,0 +1,73 @@
+cdist-type__package_zypper(7)
+=============================
+
+NAME
+----
+cdist-type__package_zypper - Manage packages with zypper
+
+
+DESCRIPTION
+-----------
+Zypper is usually used on the SuSE distribution to manage packages.
+
+
+REQUIRED PARAMETERS
+-------------------
+None
+
+
+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"
+
+version
+    The version of the package to install. Default is to install the version
+    chosen by the local package manager. For a list of available versions,
+    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.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Ensure zsh is installed
+    __package_zypper zsh --state present
+
+    # If you don't want to follow pythonX packages, but always use python
+    __package_zypper python --state present --name python2
+
+    # Ensure binutils is installed and the version is forced to be 2.23.1-0.19.2
+    __package_zypper binutils --state present --version 2.23.1-0.19.2
+
+    # Remove package
+    __package_zypper cfengine --state absent
+
+    # install all packages which belongs to pattern x11
+    __package_zypper x11 --ptype pattern --state present
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__package`\ (7)
+
+
+AUTHORS
+-------
+Daniel Heule <hda--@--sfs.biz>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__pacman_conf.txt

@@ -0,0 +1,75 @@
+cdist-type__pacman_conf(7)
+==========================
+
+NAME
+----
+cdist-type__pacman_conf - Manage pacman configuration
+
+
+DESCRIPTION
+-----------
+The type allows you to configure options section, add or delete repositories and manage mirrorlists
+
+
+REQUIRED PARAMETERS
+-------------------
+section
+    'options' for configure options section
+
+    Otherwise it specifies a repository or a plain file
+
+key
+    Specifies the key which will be set
+
+    If section = 'options' or file is not set the key will
+    be checked against available keys from pacman.conf
+
+value
+    Specifies the value which will be set against the key
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    'present' or 'absent', defaults to 'present'
+
+file
+    Specifies the filename.
+
+    The managed file will be named like 'plain_file_filename'
+
+    If supplied the key will not be checked.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Manage options section in pacman.conf
+    __pacman_conf options_Architecture --section options --key Architecture --value auto
+
+    # Add new repository
+    __pacman_conf localrepo_Server --section localrepo --key Server --value "file:///var/cache/pacman/pkg"
+
+    # Add mirror to a mirrorlist
+    __pacman_conf customlist_Server --file customlist --section customlist --key Server\
+        --value "file:///var/cache/pacman/pkg"
+
+
+SEE ALSO
+--------
+:strong:`grep`\ (1)
+
+
+AUTHORS
+-------
+Dominique Roux <dominique.roux4@gmail.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__pacman_conf_integrate.txt

@@ -0,0 +1,51 @@
+cdist-type__pacman_conf_integrate(7)
+====================================
+
+NAME
+----
+cdist-type__pacman_conf_integrate - Integrate default pacman.conf to cdist conform and vice versa
+
+
+DESCRIPTION
+-----------
+The type allows you to convert the default pacman.conf to a cdist conform one and vice versa
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+OPTIONAL PARAMETERS
+-------------------
+state
+    'present' or 'absent', defaults to 'present'
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Convert normal to cdist conform
+    __pacman_conf_integrate convert
+
+    # Convert cdist conform to normal
+    __pacman_conf_integrate convert --state absent
+
+
+SEE ALSO
+--------
+:strong:`grep`\ (1)
+
+
+AUTHORS
+-------
+Dominique Roux <dominique.roux4@gmail.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__pf_apply.txt

@@ -0,0 +1,55 @@
+cdist-type__pf_apply(7)
+=======================
+
+NAME
+----
+cdist-type__pf_apply - Apply pf(4) ruleset on \*BSD
+
+
+DESCRIPTION
+-----------
+This type is used on \*BSD systems to manage the pf firewall's active ruleset.
+
+
+REQUIRED PARAMETERS
+-------------------
+NONE
+
+
+OPTIONAL PARAMETERS
+-------------------
+NONE
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Modify the ruleset on $__target_host:
+    __pf_ruleset --state present --source /my/pf/ruleset.conf
+    require="__pf_ruleset" \
+       __pf_apply
+
+    # Remove the ruleset on $__target_host (implies disabling pf(4):
+    __pf_ruleset --state absent
+    require="__pf_ruleset" \
+       __pf_apply
+
+
+SEE ALSO
+--------
+:strong:`pf`\ (4), :strong:`cdist-type__pf_ruleset`\ (7)
+
+
+AUTHORS
+-------
+Jake Guffey <jake.guffey--@--eprotex.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__pf_ruleset.txt

@@ -0,0 +1,55 @@
+cdist-type__pf_ruleset(7)
+=========================
+
+NAME
+----
+cdist-type__pf_ruleset - Copy a pf(4) ruleset to $__target_host
+
+
+DESCRIPTION
+-----------
+This type is used on \*BSD systems to manage the pf firewall's ruleset.
+
+
+REQUIRED PARAMETERS
+-------------------
+state
+   Either "absent" (no ruleset at all) or "present", defaults to "present".
+
+
+OPTIONAL PARAMETERS
+-------------------
+source
+   If supplied, use to define the ruleset to load onto the $__target_host for pf(4).
+   Note that this type is almost useless without a ruleset defined, but it's technically not
+   needed, e.g. for the case of disabling the firewall temporarily.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Remove the current ruleset in place
+    __pf_ruleset --state absent
+
+    # Enable the firewall with the ruleset defined in $__manifest/files/pf.conf
+    __pf_ruleset --state present --source $__manifest/files/pf.conf
+
+
+SEE ALSO
+--------
+:strong:`pf`\ (4)
+
+
+AUTHORS
+-------
+Jake Guffey <jake.guffey--@--eprotex.com>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__postfix.txt

@@ -0,0 +1,42 @@
+cdist-type__postfix(7)
+======================
+
+NAME
+----
+cdist-type__postfix - Install postfix
+
+
+DESCRIPTION
+-----------
+This space intentionally left blank.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+None.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __postfix
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__postfix_master.txt

@@ -0,0 +1,84 @@
+cdist-type__postfix_master(7)
+=============================
+
+NAME
+----
+cdist-type__postfix_master - Configure postfix master.cf
+
+
+DESCRIPTION
+-----------
+See master(5) for more information.
+
+
+REQUIRED PARAMETERS
+-------------------
+type
+   See master(5)
+command
+   See master(5)
+
+
+BOOLEAN PARAMETERS
+------------------
+noreload
+   don't reload postfix after changes
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+   present or absent, defaults to present
+
+service
+
+private
+
+unpriv
+
+chroot
+
+wakeup
+
+maxproc
+
+option
+   Pass an option to a service. Same as using -o in master.cf.
+   Can be specified multiple times.
+
+comment
+   a textual comment to add with the master.cf entry
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __postfix_master smtp --type inet --command smtpd
+
+    __postfix_master smtp --type inet --chroot y --command smtpd \
+       --option smtpd_enforce_tls=yes \
+       --option smtpd_sasl_auth_enable=yes \
+       --option smtpd_client_restrictions=permit_sasl_authenticated,reject
+
+    __postfix_master submission --type inet --command smtpd \
+       --comment "Run alternative smtp on submission port"
+
+
+SEE ALSO
+--------
+:strong:`master`\ (5)
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__postfix_postconf.txt

@@ -0,0 +1,54 @@
+cdist-type__postfix_postconf(7)
+===============================
+
+NAME
+----
+cdist-type__postfix_postconf - Configure postfix main.cf
+
+
+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.
+
+
+REQUIRED PARAMETERS
+-------------------
+value
+   the value for the postfix parameter
+
+
+OPTIONAL PARAMETERS
+-------------------
+key
+   the name of the parameter. Defaults to __object_id
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __postfix_postconf mydomain --value somedomain.com
+
+    __postfix_postconf bind-to-special-ip --key smtp_bind_address --value 127.0.0.5
+
+
+SEE ALSO
+--------
+:strong:`postconf`\ (5)
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__postfix_postmap.txt

@@ -0,0 +1,42 @@
+cdist-type__postfix_postmap(7)
+==============================
+
+NAME
+----
+cdist-type__postfix_postmap - Run postmap on the given file
+
+
+DESCRIPTION
+-----------
+This space intentionally left blank.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+None.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __postfix_postmap /etc/postfix/generic
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.

software/cdist/man/4.3.1/_sources/man7/cdist-type__postfix_reload.txt

@@ -0,0 +1,42 @@
+cdist-type__postfix_reload(7)
+=============================
+
+NAME
+----
+cdist-type__postfix_reload - Tell postfix to reload its configuration
+
+
+DESCRIPTION
+-----------
+This space intentionally left blank.
+
+
+REQUIRED PARAMETERS
+-------------------
+None.
+
+
+OPTIONAL PARAMETERS
+-------------------
+None.
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    __postfix_reload
+
+
+AUTHORS
+-------
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+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.