cdist-best-practice - Practices used in real environments
2. 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).
3. SPEEDING UP SSH CONNECTIONS
When connecting to a new host, the initial delay with ssh connections
diff --git a/software/cdist/man/cdist-cache.html b/software/cdist/man/cdist-cache.html
index 9229be09..34d0dd07 100644
--- a/software/cdist/man/cdist-cache.html
+++ b/software/cdist/man/cdist-cache.html
@@ -1,6 +1,6 @@
-
cdist-code-run executes generated code from a given OBJECT.
The OBJECT must be located below OBJECT_DIR.
TYPE must be either local or remote and determines which
code part is to be executed.
Cdist-config is sourced by cdist programs and provides hints on where to find
types, manifests, etc. Generally speaking, it’s just usable from within the
core and is only of interest for cdist-developers.
3. SEE ALSO
cdist(7)
4. COPYING
Copyright (C) 2010-2011 Nico Schottelius. Free use of this software is
granted under the terms of the GNU General Public License version 3 (GPLv3).
Deploy configurations to the specified host, as configured in the initial
manifest. This script triggers the execution of several other scripts, in so
called stages. It is intented to run either from the command line or from cron.
4. ENVIRONMENT
If the environment variable cdist_conf_dir is not set, the
configuration is read from /etc/cdist. The local output directory can
diff --git a/software/cdist/man/cdist-dir.html b/software/cdist/man/cdist-dir.html
index ea49ed88..22e5960a 100644
--- a/software/cdist/man/cdist-dir.html
+++ b/software/cdist/man/cdist-dir.html
@@ -1,6 +1,6 @@
-cdist-dir(1)
cdist-dir either pushes a local directory to the target host
or pulls a remote directory from a target host to the local host.
In the push case SRC_DIR is local, in the pull case remote.
In the push case DST_DIR is remote, in the pull case local.
cdist-dir does not cleanup DST_DIR and thus it may contain old
stuff if used multiple times.
cdist-dir does not rely on rsync or other high level tools, because
diff --git a/software/cdist/man/cdist-env.html b/software/cdist/man/cdist-env.html
index a4051698..81bc87b9 100644
--- a/software/cdist/man/cdist-env.html
+++ b/software/cdist/man/cdist-env.html
@@ -1,6 +1,6 @@
-
cdist-env outputs two strings suitable for usage in your current shell,
so you can use cdist from the checkout. cdist-env essentially helps you
to easily setup PATH and MANPATH.
If you’ve multiple checkouts of cdist and run cdist-env from the various
checkouts, a new run will prepend the last directory, thus ensures you
diff --git a/software/cdist/man/cdist-explorer-run-global.html b/software/cdist/man/cdist-explorer-run-global.html
index a8f4e4f5..73ba7c3d 100644
--- a/software/cdist/man/cdist-explorer-run-global.html
+++ b/software/cdist/man/cdist-explorer-run-global.html
@@ -1,6 +1,6 @@
-
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
diff --git a/software/cdist/man/cdist-hacker.html b/software/cdist/man/cdist-hacker.html
index d9f0d896..45854d77 100644
--- a/software/cdist/man/cdist-hacker.html
+++ b/software/cdist/man/cdist-hacker.html
@@ -1,6 +1,6 @@
-
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
diff --git a/software/cdist/man/cdist-manifest-run-init.html b/software/cdist/man/cdist-manifest-run-init.html
index 3e75152e..28c38725 100644
--- a/software/cdist/man/cdist-manifest-run-init.html
+++ b/software/cdist/man/cdist-manifest-run-init.html
@@ -1,6 +1,6 @@
-
Manifests exist to define which configurations should be applied to a specific
host as well as to define which configurations should be applied within a
type. Manifests are executed locally and the resulting objects are stored in
an internal database.
The same object can be redefined in multiple different manifests as long as
diff --git a/software/cdist/man/cdist-object-code-run.html b/software/cdist/man/cdist-object-code-run.html
new file mode 100644
index 00000000..b2b56fc8
--- /dev/null
+++ b/software/cdist/man/cdist-object-code-run.html
@@ -0,0 +1,12 @@
+
+
+
cdist-object-code-run - Execute the generated code for a object
2. SYNOPSIS
cdist-object-code-run HOSTNAME OBJECT
3. DESCRIPTION
Execute the local and remote code for the given object.
4. SEE ALSO
+cdist(7)
+
+cdist-object-run-all(1)
+
+cdist-code-run(1)
+
+cdist-run-remote(1)
+
5. COPYING
Copyright (C) 2011 Nico Schottelius, Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).
cdist-object-explorer-run - Run type explorers for a object
2. SYNOPSIS
cdist-object-explorer-run HOSTNAME OBJECT
3. DESCRIPTION
Runs the explorers for the given object on the target host.
4. SEE ALSO
+cdist(7)
+
+cdist-deploy-to(1)
+
+cdist-remote-explorer-run(1)
+
5. COPYING
Copyright (C) 2011 Nico Schottelius, Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).
cdist-object-gencode-run - Generate code for a object
2. SYNOPSIS
cdist-object-gencode-run HOSTNAME OBJECT
3. DESCRIPTION
For the given object, generate the code for local and remote execution.
4. SEE ALSO
+cdist(7)
+
+cdist-code-run(1)
+
+cdist-object-run-all(1)
+
+cdist-object-gencode(1)
+
5. COPYING
Copyright (C) 2011 Nico Schottelius, Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).
cdist-object-manifest-run - Run an objects manifest
2. SYNOPSIS
cdist-object-manifest-run HOSTNAME OBJECT
3. DESCRIPTION
Run the manifest for the given object.
4. SEE ALSO
+cdist(7)
+
+cdist-deploy-to(1)
+
+cdist-manifest-run(1)
+
5. COPYING
Copyright (C) 2011 Nico Schottelius, Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).
cdist-object-push - Transfer a object to the target host
2. SYNOPSIS
cdist-object-push HOSTNAME OBJECT
3. DESCRIPTION
Transfers the given object to the target host.
4. SEE ALSO
+cdist(7)
+
+cdist-object-run-all(1)
+
+cdist-type(1)
+
5. COPYING
Copyright (C) 2011 Nico Schottelius, Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).
cdist-object-run-all - Run all created objects on the target host
2. SYNOPSIS
cdist-object-run-all HOSTNAME
3. DESCRIPTION
Transfers type explorers to the target then runs cdist-object-run(1)
+for each created object.
4. SEE ALSO
+cdist(7)
+
+cdist-type-explorer-push(1)
+
+cdist-object-run(1)
+
+cdist-type(1)
+
5. COPYING
Copyright (C) 2011 Nico Schottelius, Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).
Runs the given object on the given target host.
+The different subtasks are dispatched to specialized exectuables.
+See related man pages for details.
4. SEE ALSO
+cdist(7)
+
+cdist-object-explorer-run(1)
+
+cdist-object-gencode-run(1)
+
+cdist-object-push(1)
+
+cdist-object-code-run(1)
+
+cdist-type(1)
+
5. COPYING
Copyright (C) 2011 Nico Schottelius, Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).
cdist-reference - Variable, path and type reference for cdist
2. DESCRIPTION
Various scripts which are not in the core need information on how
-to find information. This manpage summarises the available environment
-variables, types and paths and clearifies with part may access which variables.
3. PATHS
If not specified otherwise, all paths are relative to the checkout directory.
-conf/
-
- Contains the (static) configuration like manifests, types and explorers.
-
-conf/manifest/init
-
- This is the central entry point used by cdist-manifest-init(1).
- 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.
-
It should be primary used to define mapping from configurations to hosts.
-conf/manifest/*
-
- All other files in this directory are not directly used by cdist, but you
- can seperate configuration mappings, if you have a lot of code in the
- manifest/init file. This may also be very helpful to have different admins
- maintain different groups of hosts.
-
-conf/explorer/<name>
-
- Contains explorers to be run on the target hosts, see cdist-explorer(7).
-
-conf/type/
-
- Contains all available types, which are used to provide
- some kind of functionality. See cdist-type(7).
-
-conf/type/<name>/
-
- Home of the type <name>.
-
This directory is referenced by the variable __type (see below).
-conf/type/<name>/man.text
-
- Manpage in Asciidoc format (nequired for inclusion into upstream)
-
-conf/type/<name>/manifest
-
- Used to generate additional objects from a type.
-
-conf/type/<name>/gencode-local
-
- Used to generate code to be executed on the server.
-
-conf/type/<name>/gencode-remote
-
- Used to generate code to be executed on the client.
-
-conf/type/<name>/parameters/required
-
- Parameters required by type, \n seperated list.
-
-conf/type/<name>/parameters/optional
-
- Parameters optionally accepted by type, \n seperated list.
-
-conf/type/<name>/explorer
-
- Location of the type specific explorers.
-
This directory is referenced by the variable __type_explorer (see below).
See cdist-explorer(7).
-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.
-
-tmp_dir
-
- A tempdir and a tempfile is used by cdist internally,
- which will be removed when the scripts end automatically.
- See cdist-config(1).
-
4. TYPES
The following types are available:
-__*
-
5. VARIABLES
-__explorer
-
- Directory that contains all explorers.
- Available for: explorer
-
-__manifest
-
- Directory that contains the initial manifest.
- Available for: initial manifest
-
-__global
-
- Directory that contains generic output like explorer.
- Available for: initial manifest, type manifest, type explorer, type codegen
-
-__object
-
- Directory that contains the current object.
- Available for: type manifest, type explorer, type codegen
-
-__object_id
-
- The type unique object id.
- Available for: type manifest, type explorer, type codegen
-
-__self
-
- The full qualified name of the current object.
- Available for: type manifest, type explorer, type codegen
-
-__target_host
-
- The host we are deploying to.
- Available for: initial manifest, type manifest, type codegen
-
-__target_user
-
- User to use for authentication on remote host.
- Currently static in core.
-
-__type
-
- Path to the current type.
- Available for: type manifest
-
-__type_explorers
-
- Directory that contains the type explorers.
- Available for: type explorer
-
6. SEE ALSO
-cdist(7)
-
-cdist-type__*(7)
-
7. COPYING
Copyright (C) 2011 Nico Schottelius. Free use of this software is
-granted under the terms of the GNU General Public License version 3 (GPLv3).
cdist-remote-explorer-run is executed on the target.
It sets up the variable VARIABLE_NAME to point to the given
EXPLORER_DIR and runs all explorer found in EXPLORER_DIR.
The output of every run explorer is saved into OUT_DIR.
cdist-stages - Stages used during configuration deployment
2. DESCRIPTION
Starting the execution of deployment with cdist-deploy-to(1), cdist passes
through different stages, each can be triggered and debugged on its own.
Reading the source of the cdist-deploy-to and cdist-object-run-all executables
shows the scripts responsible for each stage.
3. STAGE 0: INTERNAL PREPERATION
Before running the user facing stages, cdist prepares the target host
diff --git a/software/cdist/man/cdist-type-build-emulation.html b/software/cdist/man/cdist-type-build-emulation.html
index a83c66ff..9eed17ab 100644
--- a/software/cdist/man/cdist-type-build-emulation.html
+++ b/software/cdist/man/cdist-type-build-emulation.html
@@ -1,6 +1,6 @@
-
cdist-type-build-emulation - Build executables for types
2. SYNOPSIS
cdist-type-build-emulation OUT_DIR
3. DESCRIPTION
cdist-type-build-emulation creates a link to cdist-type-emulator
for every TYPE. These links are placed in a OUT_DIR, which
is prepended into $PATH. This way the user can use TYPE in the
manifests like any other executable.
cdist-type-emulator - Emulate type and record parameters and dependencies
2. SYNOPSIS
cdist-type-emulator [TYPE ARGS]
3. DESCRIPTION
cdist-type-emulator is normally called through a link to it of the
name of a specifc type. It saves the given parameters into
a parameters directory and the requirements into a require file.
It checks whether the parameters are valid:
are required parameter given?
diff --git a/software/cdist/man/cdist-type-template.html b/software/cdist/man/cdist-type-template.html
index a7efda6f..f7a581d7 100644
--- a/software/cdist/man/cdist-type-template.html
+++ b/software/cdist/man/cdist-type-template.html
@@ -1,5 +1,5 @@
-cdist-type-template(1)
This cdist type allows manage ubuntu ppa repositories.
3. REQUIRED PARAMETERS
state
The state the ppa should be in, either "enabled" or "disabled".
diff --git a/software/cdist/man/cdist-type__directory.html b/software/cdist/man/cdist-type__directory.html
index 48a09151..0f96bbb6 100644
--- a/software/cdist/man/cdist-type__directory.html
+++ b/software/cdist/man/cdist-type__directory.html
@@ -1,6 +1,6 @@
-cdist-type__directory(7)
This cdist type allows you to create directories on the target.
3. REQUIRED PARAMETERS
None.
4. OPTIONAL PARAMETERS
group
Group to chgrp to.
diff --git a/software/cdist/man/cdist-type__file.html b/software/cdist/man/cdist-type__file.html
index 10ad0551..e717f309 100644
--- a/software/cdist/man/cdist-type__file.html
+++ b/software/cdist/man/cdist-type__file.html
@@ -1,6 +1,6 @@
-cdist-type__file(7)
This cdist type allows you to create files on the target.
3. REQUIRED PARAMETERS
None.
4. OPTIONAL PARAMETERS
group
Group to chgrp to.
diff --git a/software/cdist/man/cdist-type__group.html b/software/cdist/man/cdist-type__group.html
index f54ad7b3..ea29c8a3 100644
--- a/software/cdist/man/cdist-type__group.html
+++ b/software/cdist/man/cdist-type__group.html
@@ -1,6 +1,6 @@
-cdist-type__group(7)
This cdist type allows you to easily setup /etc/issue.
3. REQUIRED PARAMETERS
None.
4. OPTIONAL PARAMETERS
source
If supplied, use this file as /etc/issue instead of default.
diff --git a/software/cdist/man/cdist-type__key_value.html b/software/cdist/man/cdist-type__key_value.html
index 7aa365e1..4ed7c4e2 100644
--- a/software/cdist/man/cdist-type__key_value.html
+++ b/software/cdist/man/cdist-type__key_value.html
@@ -1,10 +1,10 @@
-cdist-type__key_value(7)
cdist-type__key_value - Change property values in files
2. DESCRIPTION
This cdist type allows you to change values in a key value based config
file.
3. REQUIRED PARAMETERS
value
- The value for the key. Setting the value to NOTSET will remove the key
+ The value for the key. Setting the value to __NOTSET__ will remove the key
from the file.
This cdist type allows you to easily setup /etc/motd.
3. REQUIRED PARAMETERS
None.
4. OPTIONAL PARAMETERS
source
If supplied, copy this file from the host running cdist to the target.
diff --git a/software/cdist/man/cdist-type__package.html b/software/cdist/man/cdist-type__package.html
index 3b42c838..0ce0325c 100644
--- a/software/cdist/man/cdist-type__package.html
+++ b/software/cdist/man/cdist-type__package.html
@@ -1,6 +1,6 @@
-cdist-type__user(7)
This cdist type allows you to define the state of a process.
3. REQUIRED PARAMETERS
state
State of the process: Either stopped or running.
diff --git a/software/cdist/man/cdist-type__removeline.html b/software/cdist/man/cdist-type__removeline.html
index 3835eecd..03709c08 100644
--- a/software/cdist/man/cdist-type__removeline.html
+++ b/software/cdist/man/cdist-type__removeline.html
@@ -1,6 +1,6 @@
-cdist-type__removeline(7)