From 8ebd2a01e8416402bfe50b7c1d03eb6110e3c4dd Mon Sep 17 00:00:00 2001 From: Nico Schottelius Date: Tue, 9 Jul 2013 18:39:18 +0200 Subject: [PATCH] cdist manpages update: 2.1.2 --- .../man/2.1.2/man7/cdist-type__apt_ppa.html | 13 ++++ .../man7/cdist-type__apt_update_index.html | 5 ++ .../man/2.1.2/man7/cdist-type__cdist.html | 28 +++++++ .../2.1.2/man7/cdist-type__cdistmarker.html | 22 ++++++ .../man/2.1.2/man7/cdist-type__cron.html | 56 +++++++++++++ .../cdist-type__debconf_set_selections.html | 18 +++++ .../man/2.1.2/man7/cdist-type__directory.html | 52 +++++++++++++ .../man/2.1.2/man7/cdist-type__file.html | 55 +++++++++++++ .../cdist/man/2.1.2/man7/cdist-type__git.html | 32 ++++++++ .../man/2.1.2/man7/cdist-type__group.html | 20 +++++ .../man/2.1.2/man7/cdist-type__issue.html | 12 +++ .../man/2.1.2/man7/cdist-type__jail.html | 78 +++++++++++++++++++ .../man/2.1.2/man7/cdist-type__key_value.html | 39 ++++++++++ .../man/2.1.2/man7/cdist-type__line.html | 37 +++++++++ .../man/2.1.2/man7/cdist-type__link.html | 30 +++++++ .../man/2.1.2/man7/cdist-type__motd.html | 14 ++++ .../man7/cdist-type__mysql_database.html | 18 +++++ .../man/2.1.2/man7/cdist-type__package.html | 34 ++++++++ .../2.1.2/man7/cdist-type__package_apt.html | 23 ++++++ .../man7/cdist-type__package_luarocks.html | 19 +++++ .../2.1.2/man7/cdist-type__package_opkg.html | 19 +++++ .../man7/cdist-type__package_pacman.html | 22 ++++++ .../2.1.2/man7/cdist-type__package_pip.html | 24 ++++++ .../man7/cdist-type__package_pkg_freebsd.html | 37 +++++++++ .../man7/cdist-type__package_pkg_openbsd.html | 29 +++++++ .../man7/cdist-type__package_rubygem.html | 19 +++++ .../2.1.2/man7/cdist-type__package_yum.html | 24 ++++++ .../man7/cdist-type__package_zypper.html | 22 ++++++ .../man/2.1.2/man7/cdist-type__pf_apply.html | 17 ++++ .../2.1.2/man7/cdist-type__pf_ruleset.html | 21 +++++ .../man7/cdist-type__postgres_database.html | 15 ++++ .../2.1.2/man7/cdist-type__postgres_role.html | 33 ++++++++ .../man/2.1.2/man7/cdist-type__process.html | 43 ++++++++++ .../man/2.1.2/man7/cdist-type__qemu_img.html | 19 +++++ .../cdist/man/2.1.2/man7/cdist-type__rvm.html | 19 +++++ .../man/2.1.2/man7/cdist-type__rvm_gem.html | 35 +++++++++ .../2.1.2/man7/cdist-type__rvm_gemset.html | 30 +++++++ .../man/2.1.2/man7/cdist-type__rvm_ruby.html | 27 +++++++ .../man7/cdist-type__ssh_authorized_keys.html | 68 ++++++++++++++++ .../2.1.2/man7/cdist-type__start_on_boot.html | 20 +++++ .../man/2.1.2/man7/cdist-type__timezone.html | 10 +++ .../man7/cdist-type__update_alternatives.html | 16 ++++ .../man/2.1.2/man7/cdist-type__user.html | 38 +++++++++ .../2.1.2/man7/cdist-type__user_groups.html | 22 ++++++ 44 files changed, 1234 insertions(+) create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__apt_ppa.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__apt_update_index.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__cdist.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__cdistmarker.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__cron.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__debconf_set_selections.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__directory.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__file.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__git.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__group.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__issue.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__jail.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__key_value.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__line.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__link.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__motd.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__mysql_database.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_apt.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_luarocks.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_opkg.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_pacman.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_pip.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_pkg_freebsd.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_pkg_openbsd.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_rubygem.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_yum.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__package_zypper.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__pf_apply.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__pf_ruleset.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__postgres_database.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__postgres_role.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__process.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__qemu_img.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__rvm.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__rvm_gem.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__rvm_gemset.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__rvm_ruby.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__ssh_authorized_keys.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__start_on_boot.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__timezone.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__update_alternatives.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__user.html create mode 100644 software/cdist/man/2.1.2/man7/cdist-type__user_groups.html diff --git a/software/cdist/man/2.1.2/man7/cdist-type__apt_ppa.html b/software/cdist/man/2.1.2/man7/cdist-type__apt_ppa.html new file mode 100644 index 00000000..aec0e7db --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__apt_ppa.html @@ -0,0 +1,13 @@ + +cdist-type__apt_ppa(7)

cdist-type__apt_ppa(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__apt_ppa - Manage ppa repositories

2. DESCRIPTION

This cdist type allows manage ubuntu ppa repositories.

3. REQUIRED PARAMETERS

+state +
+ The state the ppa should be in, either "present" or "absent". +

4. OPTIONAL PARAMETERS

None.

5. EXAMPLES

# Enable a ppa repository
+__apt_ppa ppa:sans-intern/missing-bits --state present
+
+# Disable a ppa repository
+__apt_ppa ppa:sans-intern/missing-bits --state absent

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__apt_update_index.html b/software/cdist/man/2.1.2/man7/cdist-type__apt_update_index.html new file mode 100644 index 00000000..fbd56be2 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__apt_update_index.html @@ -0,0 +1,5 @@ + +cdist-type__apt_update_index(7)

cdist-type__apt_update_index(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__apt_update_index - update apt’s package index

2. DESCRIPTION

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

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

None.

5. EXAMPLES

__apt_update_index

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__cdist.html b/software/cdist/man/2.1.2/man7/cdist-type__cdist.html new file mode 100644 index 00000000..50494714 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__cdist.html @@ -0,0 +1,28 @@ + +cdist-type__cdist(7)

cdist-type__cdist(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__cdist - Manage cdist installations

2. 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

3. REQUIRED PARAMETERS

4. 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". +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2013 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__cdistmarker.html b/software/cdist/man/2.1.2/man7/cdist-type__cdistmarker.html new file mode 100644 index 00000000..d7d6e0b8 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__cdistmarker.html @@ -0,0 +1,22 @@ + +cdist-type__cdistmarker(7)

cdist-type__cdistmarker(7)

Daniel Maher

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__cdistmarker - Add a timestamped cdist marker.

2. DESCRIPTION

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

3. REQUIRED PARAMETERS

None.

4. 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 +

5. EXAMPLES

# Creates the marker as normal.
+__cdistmarker
+
+# Creates the marker differently.
+__cdistmarker --file /tmp/cdist_marker --format '+%s'

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011 Daniel Maher. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__cron.html b/software/cdist/man/2.1.2/man7/cdist-type__cron.html new file mode 100644 index 00000000..c2c267d2 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__cron.html @@ -0,0 +1,56 @@ + +cdist-type__cron(7)

cdist-type__cron(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__cron - installs and manages cron jobs

2. DESCRIPTION

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

3. REQUIRED PARAMETERS

+user +
+ The user who’s crontab is edited +
+command +
+ The command to run. +

4. 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. +

5. EXAMPLES

# run Monday to Saturday at 23:15
+__cron some-id --user root --command "/path/to/script" \
+   --hour 23 --minute 15 --day_of_week 1-6
+
+# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +crontab(5) +

7. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__debconf_set_selections.html b/software/cdist/man/2.1.2/man7/cdist-type__debconf_set_selections.html new file mode 100644 index 00000000..3e46a2e1 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__debconf_set_selections.html @@ -0,0 +1,18 @@ + +cdist-type__debconf_set_selections(7)

cdist-type__debconf_set_selections(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__debconf_set_selections - Setup debconf selections

2. DESCRIPTION

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

3. REQUIRED PARAMETERS

+file +
+ Use the given filename as input for debconf-set-selections(1) +

4. EXAMPLES

# 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"

5. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__update_alternatives(7) +
  • +debconf-set-selections(1) +

6. COPYING

Copyright (C) 2011-2013 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__directory.html b/software/cdist/man/2.1.2/man7/cdist-type__directory.html new file mode 100644 index 00000000..4aeda74b --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__directory.html @@ -0,0 +1,52 @@ + +cdist-type__directory(7)

cdist-type__directory(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. BOOLEAN PARAMETERS
6. EXAMPLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-type__directory - Manage a directory

2. DESCRIPTION

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

3. REQUIRED PARAMETERS

None.

4. 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. +

5. 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. +

6. EXAMPLES

# 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

7. SEE ALSO

  • +cdist-type(7) +

8. 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).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__file.html b/software/cdist/man/2.1.2/man7/cdist-type__file.html new file mode 100644 index 00000000..6a1376c9 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__file.html @@ -0,0 +1,55 @@ + +cdist-type__file(7)

cdist-type__file(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__file - Manage files

2. DESCRIPTION

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

3. REQUIRED PARAMETERS

None.

4. 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. +

5. EXAMPLES

# Create  /etc/cdist-configured as an empty file
+__file /etc/cdist-configured
+# The same thing
+__file /etc/cdist-configured --state present
+# Delete existing file
+__file /etc/cdist-configured --state absent
+
+# Use __file from another type
+__file /etc/issue --source "$__type/files/archlinux" --state present
+
+# 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

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__git.html b/software/cdist/man/2.1.2/man7/cdist-type__git.html new file mode 100644 index 00000000..a64621ad --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__git.html @@ -0,0 +1,32 @@ + +cdist-type__git(7)

cdist-type__git(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__git - Get and or keep git repositories up-to-date

2. DESCRIPTION

This cdist type allows you to clone git repositories

3. REQUIRED PARAMETERS

+source +
+ Specifies the git remote to clone from +

4. OPTIONAL PARAMETERS

+state +
+ Either "present" or "absent", defaults to "present" +
+branch +
+ Create this branch by checking out the remote branch of this name +
+group +
+ Group to chgrp to. +
+mode +
+ Unix permissions, suitable for chmod. +
+owner +
+ User to chown to. +

5. EXAMPLES

__git /home/services/dokuwiki --source git://github.com/splitbrain/dokuwiki.git
+
+# Checkout cdist, stay on branch 2.1
+__git /home/nico/cdist --source git://github.com/telmich/cdist.git --branch 2.1

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__group.html b/software/cdist/man/2.1.2/man7/cdist-type__group.html new file mode 100644 index 00000000..6fad8b7e --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__group.html @@ -0,0 +1,20 @@ + +cdist-type__group(7)

cdist-type__group(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__group - Manage groups

2. DESCRIPTION

This cdist type allows you to create or modify groups on the target.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+gid +
+ see groupmod(8) +
+password +
+ see above +

5. EXAMPLES

# Create a group 'foobar' with operating system default settings
+__group foobar
+
+# 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'

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__issue.html b/software/cdist/man/2.1.2/man7/cdist-type__issue.html new file mode 100644 index 00000000..464c6d64 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__issue.html @@ -0,0 +1,12 @@ + +cdist-type__issue(7)

cdist-type__issue(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__issue - Manage issue

2. DESCRIPTION

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. +

5. EXAMPLES

__issue
+
+# When called from another type
+__issue --source "$__type/files/myfancyissue"

6. SEE ALSO

  • +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).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__jail.html b/software/cdist/man/2.1.2/man7/cdist-type__jail.html new file mode 100644 index 00000000..a350b331 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__jail.html @@ -0,0 +1,78 @@ + +cdist-type__jail(7)

cdist-type__jail(7)

Jake Guffey

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. BOOLEAN PARAMETERS
6. CAVEATS
7. EXAMPLES
8. SEE ALSO
9. COPYING

1. NAME

cdist-type__jail - Manage FreeBSD jails

2. DESCRIPTION

This type is used on FreeBSD to manage jails.

3. REQUIRED PARAMETERS

+state +
+ Either "present" or "absent." +
+jailbase +
+ The location of the .tgz archive containing the base fs for your jails. +

4. 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. +

5. 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. +

6. CAVEATS

This type does not currently support modification of jail options. If, for +example a jail needs to have its IP address or netmask changed, the jail must +be removed then re-added with the correct IP address/netmask or the appropriate +line (jail_<name>_ip="…") modified within rc.conf through some alternate +means.

7. EXAMPLES

# 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

8. SEE ALSO

  • +cdist-type(7) +

9. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__key_value.html b/software/cdist/man/2.1.2/man7/cdist-type__key_value.html new file mode 100644 index 00000000..68f1b5c0 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__key_value.html @@ -0,0 +1,39 @@ + +cdist-type__key_value(7)

cdist-type__key_value(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

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

+file +
+ The file to operate on. +
+delimiter +
+ The delimiter which seperates the key from the value. +

4. OPTIONAL PARAMETERS

+state +
+ present or absent, defaults to present. If present, sets the key to value, + if absent, removes the key from the file. +
+key +
+ The key to change. Defaults to object_id. +
+value +
+ The value for the key. Optional if state=absent, required otherwise. +

5. EXAMPLES

# 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 '='
+
+# Remove existing key/value
+__key_value LEGACY_KEY --file /etc/somefile --state absent --delimiter '='

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__line.html b/software/cdist/man/2.1.2/man7/cdist-type__line.html new file mode 100644 index 00000000..1667e786 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__line.html @@ -0,0 +1,37 @@ + +cdist-type__line(7)

cdist-type__line(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__line - Manage lines in files

2. DESCRIPTION

This cdist type allows you to add lines and remove lines from files.

3. REQUIRED PARAMETERS

4. 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 (cannot be combined with
+the line parameter, if state is absent).
If the regular expression contains / (slashes), they need
+to be escaped with \ (backslash): / becomes \/.
+file +
+ If supplied, use this as the destination file. + Otherwise the object_id is used. +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__link.html b/software/cdist/man/2.1.2/man7/cdist-type__link.html new file mode 100644 index 00000000..e1a6c310 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__link.html @@ -0,0 +1,30 @@ + +cdist-type__link(7)

cdist-type__link(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__link - Manage links (hard and symbolic)

2. DESCRIPTION

This cdist type allows you to manage hard and symbolic links. +The given object id is the destination for the link.

3. REQUIRED PARAMETERS

+source +
+ Specifies the link source. +
+type +
+ Specifies the link type: Either hard or symoblic. +

4. OPTIONAL PARAMETERS

+state +
+ present or absent, defaults to present +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__motd.html b/software/cdist/man/2.1.2/man7/cdist-type__motd.html new file mode 100644 index 00000000..58fa0d7d --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__motd.html @@ -0,0 +1,14 @@ + +cdist-type__motd(7)

cdist-type__motd(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__motd - Manage message of the day

2. DESCRIPTION

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. + If not supplied, a default message will be placed onto the target. +

5. EXAMPLES

# Use cdist defaults
+__motd
+
+# Supply source file from a different type
+__motd --source "$__type/files/my-motd"

6. SEE ALSO

  • +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).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__mysql_database.html b/software/cdist/man/2.1.2/man7/cdist-type__mysql_database.html new file mode 100644 index 00000000..f4a1a2d7 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__mysql_database.html @@ -0,0 +1,18 @@ + +cdist-type__mysql_database(7)

cdist-type__mysql_database(7)

Benedikt Koeppel

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__mysql_database - Manage a MySQL database

2. DESCRIPTION

This cdist type allows you to install a MySQL database.

3. REQUIRED PARAMETERS

None.

4. 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 +

5. EXAMPLES

__mysql_database "cdist" --name "cdist" --user "myuser" --password "mypwd"

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Benedikt Koeppel. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package.html b/software/cdist/man/2.1.2/man7/cdist-type__package.html new file mode 100644 index 00000000..f3c19a31 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package.html @@ -0,0 +1,34 @@ + +cdist-type__package(7)

cdist-type__package(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package - Manage packages

2. DESCRIPTION

This cdist type allows you to install or uninstall packages on the target. +It dispatches the actual work to the package system dependant types.

3. REQUIRED PARAMETERS

None

4. 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 + choosen 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" +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_apt.html b/software/cdist/man/2.1.2/man7/cdist-type__package_apt.html new file mode 100644 index 00000000..cc6f844d --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_apt.html @@ -0,0 +1,23 @@ + +cdist-type__package_apt(7)

cdist-type__package_apt(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_apt - Manage packages with apt-get

2. DESCRIPTION

apt-get is usually used on Debian and variants (like Ubuntu) to +manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ Either "present" or "absent", defaults to "present" +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_luarocks.html b/software/cdist/man/2.1.2/man7/cdist-type__package_luarocks.html new file mode 100644 index 00000000..8d9e2e8a --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_luarocks.html @@ -0,0 +1,19 @@ + +cdist-type__package_luarocks(7)

cdist-type__package_luarocks(7)

Christian G. Warden

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_luarocks - Manage luarocks packages

2. DESCRIPTION

LuaRocks is a deployment and management system for Lua modules.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ Either "present" or "absent", defaults to "present" +

5. EXAMPLES

# Ensure luasocket is installed
+__package_luarocks luasocket --state present
+
+# Remove package
+__package_luarocks luasocket --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 SwellPath, Inc. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_opkg.html b/software/cdist/man/2.1.2/man7/cdist-type__package_opkg.html new file mode 100644 index 00000000..501b7e83 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_opkg.html @@ -0,0 +1,19 @@ + +cdist-type__package_opkg(7)

cdist-type__package_opkg(7)

Giel van Schijndel

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_opkg - Manage packages with opkg

2. DESCRIPTION

opkg is usually used on OpenWRT to manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ Either "present" or "absent", defaults to "present" +

5. EXAMPLES

# Ensure lsof is installed
+__package_opkg lsof --state present
+
+# Remove obsolete package
+__package_opkg dnsmasq --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Giel van Schijndel. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_pacman.html b/software/cdist/man/2.1.2/man7/cdist-type__package_pacman.html new file mode 100644 index 00000000..be10b4f3 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_pacman.html @@ -0,0 +1,22 @@ + +cdist-type__package_pacman(7)

cdist-type__package_pacman(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pacman - Manage packages with pacman

2. DESCRIPTION

Pacman is usually used on the Archlinux distribution to manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ Either "present" or "absent", defaults to "present" +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_pip.html b/software/cdist/man/2.1.2/man7/cdist-type__package_pip.html new file mode 100644 index 00000000..7792c6dd --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_pip.html @@ -0,0 +1,24 @@ + +cdist-type__package_pip(7)

cdist-type__package_pip(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pip - Manage packages with pip

2. DESCRIPTION

Pip is used in Python environments to install packages. +It is also included in the python virtualenv environment.

3. REQUIRED PARAMETERS

None

4. 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" +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_pkg_freebsd.html b/software/cdist/man/2.1.2/man7/cdist-type__package_pkg_freebsd.html new file mode 100644 index 00000000..71170870 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_pkg_freebsd.html @@ -0,0 +1,37 @@ + +cdist-type__package_pkg_freebsd(7)

cdist-type__package_pkg_freebsd(7)

Jake Guffey

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pkg_freebsd - Manage FreeBSD packages

2. DESCRIPTION

This type is usually used on FreeBSD to manage packages.

3. REQUIRED PARAMETERS

None

4. 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" +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_pkg_openbsd.html b/software/cdist/man/2.1.2/man7/cdist-type__package_pkg_openbsd.html new file mode 100644 index 00000000..558bbbf6 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_pkg_openbsd.html @@ -0,0 +1,29 @@ + +cdist-type__package_pkg(7)

cdist-type__package_pkg(7)

Andi Brönnimann

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_pkg_openbsd - Manage OpenBSD packages

2. DESCRIPTION

This type is usually used on OpenBSD to manage packages.

3. REQUIRED PARAMETERS

None

4. 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" +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. 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).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_rubygem.html b/software/cdist/man/2.1.2/man7/cdist-type__package_rubygem.html new file mode 100644 index 00000000..6585821c --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_rubygem.html @@ -0,0 +1,19 @@ + +cdist-type__package_rubygem(7)

cdist-type__package_rubygem(7)

Chase Allen James

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_rubygem - Manage rubygem packages

2. DESCRIPTION

Rubygems is the default package management system for the Ruby programming language.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ Either "present" or "absent", defaults to "present" +

5. EXAMPLES

# Ensure sinatra is installed
+__package_rubygem sinatra --state present
+
+# Remove package
+__package_rubygem rails --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011 Chase Allen James. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_yum.html b/software/cdist/man/2.1.2/man7/cdist-type__package_yum.html new file mode 100644 index 00000000..2af0e5ed --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_yum.html @@ -0,0 +1,24 @@ + +cdist-type__package_yum(7)

cdist-type__package_yum(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_yum - Manage packages with yum

2. DESCRIPTION

Yum is usually used on the Fedora distribution to manage packages. +If you specify an unknown package, yum will display the +slightly confusing error message "Error: Nothing to do".

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ Either "present" or "absent", defaults to "present" +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__package_zypper.html b/software/cdist/man/2.1.2/man7/cdist-type__package_zypper.html new file mode 100644 index 00000000..dfed3bc0 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__package_zypper.html @@ -0,0 +1,22 @@ + +cdist-type__package_zypper(7)

cdist-type__package_zypper(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_zypper - Manage packages with zypper

2. DESCRIPTION

Zypper is usually used on the SuSE distribution to manage packages.

3. REQUIRED PARAMETERS

None

4. OPTIONAL PARAMETERS

+name +
+ If supplied, use the name and not the object id as the package name. +
+state +
+ Either "present" or "absent", defaults to "present" +

5. EXAMPLES

# Ensure zsh in 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
+
+# Remove package
+__package_zypper cfengine --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__package(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__pf_apply.html b/software/cdist/man/2.1.2/man7/cdist-type__pf_apply.html new file mode 100644 index 00000000..6f9e3bdc --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__pf_apply.html @@ -0,0 +1,17 @@ + +cdist-type__pf_apply(7)

cdist-type__pf_apply(7)

Jake Guffey

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__pf_apply - Apply pf(4) ruleset on *BSD

2. DESCRIPTION

This type is used on *BSD systems to manage the pf firewall’s active ruleset.

3. REQUIRED PARAMETERS

NONE

4. OPTIONAL PARAMETERS

NONE

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__pf_ruleset(7) +
  • +pf(4) +

7. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__pf_ruleset.html b/software/cdist/man/2.1.2/man7/cdist-type__pf_ruleset.html new file mode 100644 index 00000000..3d837581 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__pf_ruleset.html @@ -0,0 +1,21 @@ + +cdist-type__pf_ruleset(7)

cdist-type__pf_ruleset(7)

Jake Guffey

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-typepf_ruleset - Copy a pf(4) ruleset to $target_host

2. DESCRIPTION

This type is used on *BSD systems to manage the pf firewall’s ruleset.

3. REQUIRED PARAMETERS

+state +
+ Either "absent" (no ruleset at all) or "present" +

4. 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. +

5. EXAMPLES

# 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

6. SEE ALSO

  • +cdist-type(7) +
  • +pf(4) +

7. COPYING

Copyright (C) 2012 Jake Guffey. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__postgres_database.html b/software/cdist/man/2.1.2/man7/cdist-type__postgres_database.html new file mode 100644 index 00000000..d5195341 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__postgres_database.html @@ -0,0 +1,15 @@ + +cdist-type__postgres_database(7)

cdist-type__postgres_database(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. OPTIONAL PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__postgres_database - create/drop postgres databases

2. DESCRIPTION

This cdist type allows you to create or drop postgres databases.

3. OPTIONAL PARAMETERS

+state +
+ either present or absent +
+owner +
+ the role owning this database +

4. EXAMPLES

__postgres_database mydbname --owner mydbusername

5. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__postgres_role(7) +

6. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__postgres_role.html b/software/cdist/man/2.1.2/man7/cdist-type__postgres_role.html new file mode 100644 index 00000000..94794713 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__postgres_role.html @@ -0,0 +1,33 @@ + +cdist-type__postgres_role(7)

cdist-type__postgres_role(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. OPTIONAL PARAMETERS
4. SEE ALSO
5. COPYING

1. NAME

cdist-type__postgres_role - manage postgres roles

2. DESCRIPTION

This cdist type allows you to create or drop postgres roles.

3. OPTIONAL PARAMETERS

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

All other parameters map directly to the corresponding postgres createrole +parameters.

+password +
+BOOLEAN PARAMETERS +
All parameter map directly to the corresponding postgres createrole
+parameters.
+
+login::
+createdb::
+createrole::
+superuser::
+inherit::
+
+EXAMPLES
__postgres_role myrole
+
+__postgres_role myrole --password 'secret'
+
+__postgres_role admin --password 'very-secret' --superuser
+
+__postgres_role dbcustomer --password 'bla' --createdb

4. SEE ALSO

5. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__process.html b/software/cdist/man/2.1.2/man7/cdist-type__process.html new file mode 100644 index 00000000..1987422f --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__process.html @@ -0,0 +1,43 @@ + +cdist-type__process(7)

cdist-type__process(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. OPTIONAL PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__process - Start or stop process

2. DESCRIPTION

This cdist type allows you to define the state of a process.

3. OPTIONAL PARAMETERS

+state +
+ Either "present" or "absent", defaults to "present" +
+name +

+ Process name to match on when using pgrep -f -x. +

This is useful, if the name starts with a "/",
+because the leading slash is stripped away from
+the object id by cdist.
+stop +
+ Executable to use for stopping the process. +
+start +
+ Executable to use for starting the process. +

4. EXAMPLES

# Start if not running
+__process /usr/sbin/syslog-ng --state present
+
+# Start if not running with a different binary
+__process /usr/sbin/nginx --state present --start "/etc/rc.d/nginx start"
+
+# Stop the process using kill (the type default) - DO NOT USE THIS
+__process /usr/sbin/sshd --state absent
+
+# Stop the process using /etc/rc.d/sshd stop - THIS ONE NOT AS WELL
+__process /usr/sbin/sshd --state absent --stop "/etc/rc.d/sshd stop"
+
+# Ensure cups is running, which runs with -C ...:
+__process cups --start "/etc/rc.d/cups start" --state present \
+   --name "/usr/sbin/cupsd -C /etc/cups/cupsd.conf"
+
+# Ensure rpc.statd is running (which usually runs with -L) using a regexp
+__process rpcstatd --state present --start "/etc/init.d/statd start" \
+    --name "rpc.statd.*"

5. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__start_on_boot(7) +

6. COPYING

Copyright (C) 2011-2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__qemu_img.html b/software/cdist/man/2.1.2/man7/cdist-type__qemu_img.html new file mode 100644 index 00000000..ab793a65 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__qemu_img.html @@ -0,0 +1,19 @@ + +cdist-type__qemu_img(7)

cdist-type__qemu_img(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__qemu_img - Manage VM disk images

2. DESCRIPTION

The qemu-img program is used to create qemu images for +qemu and (qemu-)kvm.

3. REQUIRED PARAMETERS

+size +
+ Size of the image in qemu-img compatible units. + See qemu-img(1). +

4. OPTIONAL PARAMETERS

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

5. EXAMPLES

# Create a 50G size image
+__qemu_img /home/services/kvm/vm/myvmname/system-disk --size 50G
+
+# Remove image
+__qemu_img /home/services/kvm/vm/myoldvm/system-disk --state absent

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__rvm.html b/software/cdist/man/2.1.2/man7/cdist-type__rvm.html new file mode 100644 index 00000000..c15b2bd8 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__rvm.html @@ -0,0 +1,19 @@ + +cdist-type__rvm(7)

cdist-type__rvm(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__rvm - Install rvm for a given user

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+state +
+ Either "present" or "absent". +

4. EXAMPLES

# Install rvm for user billie
+__rvm billie --state present
+
+# Remove rvm
+__rvm billie --state absent

5. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm_ruby(7) +
  • +cdist-type__rvm_gemset(7) +
  • +cdist-type__rvm_gem(7) +

6. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__rvm_gem.html b/software/cdist/man/2.1.2/man7/cdist-type__rvm_gem.html new file mode 100644 index 00000000..1e957dc2 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__rvm_gem.html @@ -0,0 +1,35 @@ + +cdist-type__rvm_gemset(7)

cdist-type__rvm_gemset(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__rvm_gem - Manage Ruby gems through rvm

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+user +
+ The remote user account to use +
+gemset +
+ The gemset to use +
+state +
+ Either "present" or "absent" +

4. OPTIONAL PARAMETERS

+default +
+ Make the selected gemset the default +

5. EXAMPLES

# Install the rails gem in gemset ruby-1.9.3-p0@myset for user bill
+__rvm_gemset rails --gemset ruby-1.9.3-p0@myset --user bill --state present
+
+# Do the same and also make ruby-1.9.3-p0@myset the default gemset
+__rvm_gemset rails --gemset ruby-1.9.3-p0@myset --user bill \
+                   --state present --default
+
+# Remove it
+__rvm_ruby rails --gemset ruby-1.9.3-p0@myset --user bill --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm(7) +
  • +cdist-type__rvm_ruby(7) +
  • +cdist-type__rvm_gemset(7) +

7. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__rvm_gemset.html b/software/cdist/man/2.1.2/man7/cdist-type__rvm_gemset.html new file mode 100644 index 00000000..478ed5ab --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__rvm_gemset.html @@ -0,0 +1,30 @@ + +cdist-type__rvm_gemset(7)

cdist-type__rvm_gemset(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. BOOLEAN PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__rvm_gemset - Manage gemsets through rvm

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+user +
+ The remote user account to use +
+state +
+ Either "present" or "absent". +

4. BOOLEAN PARAMETERS

+default +
+ If present, set the given gemset as default. +

5. EXAMPLES

# Install the gemset @myset for user charles on based on ruby-1.9.3-0
+__rvm_gemset ruby-1.9.3-p0@myset --user charles --state present
+
+# Do the same and make ruby-1.9.3-p0@myset the default gemset
+__rvm_gemset ruby-1.9.3-p0@myset --user charles --state present --default
+
+# Remove the gemset @myset for user john
+__rvm_ruby ruby-1.9.3-p0@myset --user john --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm(7) +
  • +cdist-type__rvm_ruby(7) +
  • +cdist-type__rvm_gem(7) +

7. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__rvm_ruby.html b/software/cdist/man/2.1.2/man7/cdist-type__rvm_ruby.html new file mode 100644 index 00000000..6e4b3c1e --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__rvm_ruby.html @@ -0,0 +1,27 @@ + +cdist-type__rvm_ruby(7)

cdist-type__rvm_ruby(7)

Evax Software

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. BOOLEAN PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__rvm_ruby - Manage ruby installations through rvm

2. DESCRIPTION

RVM is the Ruby enVironment Manager for the Ruby programming language.

3. REQUIRED PARAMETERS

+user +
+ The remote user account to use +
+state +
+ Either "present" or "absent". +

4. BOOLEAN PARAMETERS

default: + Set the given version as default

5. EXAMPLES

# Install ruby 1.9.3 through rvm for user thelonious
+__rvm_ruby ruby-1.9.3-p0 --user thelonious --state present
+
+# Install ruby 1.9.3 through rvm for user ornette and make it the default
+__rvm_ruby ruby-1.9.3-p0 --user ornette --state present --default
+
+# Remove ruby 1.9.3 for user john
+__rvm_ruby ruby-1.9.3-p0 --user john --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__rvm(7) +
  • +cdist-type__rvm_gemset(7) +
  • +cdist-type__rvm_gem(7) +

7. COPYING

Copyright (C) 2012 Evax Software. Free use of this software is granted under +the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__ssh_authorized_keys.html b/software/cdist/man/2.1.2/man7/cdist-type__ssh_authorized_keys.html new file mode 100644 index 00000000..2b6f4114 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__ssh_authorized_keys.html @@ -0,0 +1,68 @@ + +cdist-type__ssh_authorized_keys(7)

cdist-type__ssh_authorized_keys(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. BOOLEAN PARAMETERS
6. EXAMPLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-type__ssh_authorized_keys - manage ssh authorized_keys files

2. DESCRIPTION

Adds or removes ssh keys from a authorized_keys file.

This type also manages the directory containing the authorized_keys +file and sets strict ownership and permissions. You can disable this feature +with the --noparent boolean parameter.

The existence, ownership and permissions of the authorized_keys file itself are +also managed. This can be disabled with the --nofile boolean parameter. It is +then left to the user to ensure that the file exists and that ownership and +permissions work with ssh.

3. REQUIRED PARAMETERS

+key +
+ the ssh key which shall be added to this authorized_keys file. + Must be a string and can be specified multiple times. +

4. OPTIONAL PARAMETERS

+owner +
+ the user owning the authorized_keys file, defaults to object_id. +
+state +
+ if the given keys should be present or absent, defaults to present. +
+file +
+ an alternative destination file, defaults to ~$owner/.ssh/authorized_keys +
+comment +
+ an optional comment +

5. BOOLEAN PARAMETERS

+noparent +
+ don’t create or change ownership and permissions of the directory containing + the authorized_keys file +
+nofile +
+ don’t manage existence, ownership and permissions of the the authorized_keys + file +

6. EXAMPLES

# add your ssh key to remote root's authorized_keys file
+__ssh_authorized_keys root \
+   --key "$(cat ~/.ssh/id_rsa.pub)"
+
+# allow key to login as user-name
+__ssh_authorized_keys user-name \
+   --key "ssh-rsa AXYZAAB3NzaC1yc2..."
+
+# same as above, but with explicit owner, two keys and a comment
+__ssh_authorized_keys some-fancy-id \
+   --owner user-name \
+   --key "ssh-rsa AXYZAAB3NzaC1yc2..." \
+   --key "ssh-rsa AZXYAAB3NzaC1yc2..." \
+   --comment "allow the members of project foo to login"
+
+# same as above, but authorized_keys file in non standard location
+__ssh_authorized_keys some-fancy-id \
+   --file /etc/ssh/keys/user-name/authorized_keys \
+   --owner user-name \
+   --key "ssh-rsa AXYZAAB3NzaC1yc2..."
+
+# same as above, but directory and authorized_keys file is created elswhere
+__ssh_authorized_keys some-fancy-id \
+   --file /etc/ssh/keys/user-name/authorized_keys \
+   --owner user-name \
+   --noparent \
+   --nofile \
+   --key "ssh-rsa AXYZAAB3NzaC1yc2..."

7. SEE ALSO

  • +cdist-type(7) +

8. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__start_on_boot.html b/software/cdist/man/2.1.2/man7/cdist-type__start_on_boot.html new file mode 100644 index 00000000..e7361aa2 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__start_on_boot.html @@ -0,0 +1,20 @@ + +cdist-type__start_on_boot(7)

cdist-type__start_on_boot(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__start_on_boot - Manage stuff to be started at boot

2. DESCRIPTION

This cdist type allows you to enable or disable stuff to be started +at boot of your operating system.

Warning: This type has not been tested intensively and is not fully +supported (i.e. gentoo and *bsd are not implemented).

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

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

5. EXAMPLES

# Ensure snmpd is started at boot
+__start_on_boot snmpd
+
+# Same, but more explicit
+__start_on_boot snmpd --state present
+
+# Ensure legacy configuration management will not be started
+__start_on_boot puppet --state absent

6. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__process(7) +

7. COPYING

Copyright (C) 2012 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__timezone.html b/software/cdist/man/2.1.2/man7/cdist-type__timezone.html new file mode 100644 index 00000000..91d09737 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__timezone.html @@ -0,0 +1,10 @@ + +cdist-type__timezone(7)

cdist-type__timezone(7)

Ramon Salvadó

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__timezone - Allows to configure the desired localtime timezone.

2. DESCRIPTION

This type creates a symlink (/etc/localtime) to the selected timezone +(which should be available in /usr/share/zoneinfo).

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

None.

5. EXAMPLES

#Set up Europe/Andorra as our timezone.
+__timezone Europe/Andorra
+
+#Set up US/Central as our timezone.
+__timezone US/Central

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__update_alternatives.html b/software/cdist/man/2.1.2/man7/cdist-type__update_alternatives.html new file mode 100644 index 00000000..c0a9154b --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__update_alternatives.html @@ -0,0 +1,16 @@ + +cdist-type__update_alternatives(7)

cdist-type__update_alternatives(7)

Nico Schottelius

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__update_alternatives - Configure alternatives

2. DESCRIPTION

On Debian and alike systems update-alternatives(1) can be used +to setup alternatives for various programs. +One of the most common used targets is the "editor".

3. REQUIRED PARAMETERS

+path +
+ Use this path for the given alternative +

4. EXAMPLES

# Setup vim as the default editor
+__update_alternatives editor --path /usr/bin/vim.basic

5. SEE ALSO

  • +cdist-type(7) +
  • +cdist-type__debconf_set_selections(7) +
  • +update-alternatives(8) +

6. COPYING

Copyright (C) 2013 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__user.html b/software/cdist/man/2.1.2/man7/cdist-type__user.html new file mode 100644 index 00000000..13d66abb --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__user.html @@ -0,0 +1,38 @@ + +cdist-type__user(7)

cdist-type__user(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__user - Manage users

2. DESCRIPTION

This cdist type allows you to create or modify users on the target.

3. REQUIRED PARAMETERS

None.

4. OPTIONAL PARAMETERS

+comment +
+ see usermod(8) +
+home +
+ see above +
+gid +
+ see above +
+password +
+ see above +
+shell +
+ see above +
+uid +
+ see above +

5. EXAMPLES

# Create user account for foobar with operating system default settings
+__user foobar
+
+# Same but with a different shell
+__user foobar --shell /bin/zsh
+
+# Set explicit uid and home
+__user foobar --uid 1001 --shell /bin/zsh --home /home/foobar

6. SEE ALSO

  • +cdist-type(7) +
  • +usermod(8) or pw(8) +

7. COPYING

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

\ No newline at end of file diff --git a/software/cdist/man/2.1.2/man7/cdist-type__user_groups.html b/software/cdist/man/2.1.2/man7/cdist-type__user_groups.html new file mode 100644 index 00000000..21769319 --- /dev/null +++ b/software/cdist/man/2.1.2/man7/cdist-type__user_groups.html @@ -0,0 +1,22 @@ + +cdist-type__user_groups(7)

cdist-type__user_groups(7)

Steven Armstrong

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__user_groups - manage user groups

2. DESCRIPTION

Adds or removes a user from one or more groups.

3. REQUIRED PARAMETERS

+group +
+ the group to which this user should be added or removed. + Can be specified multiple times. +

4. OPTIONAL PARAMETERS

+user +
+ the name of the user. Defaults to object_id +
+state +
+ absent or present. Defaults to present. +

5. EXAMPLES

__user_groups nginx --group webuser1 --group webuser2
+
+# remove user nginx from groups webuser2
+__user_groups nginx-webuser2 --user nginx \
+   --group webuser2 --state absent

6. SEE ALSO

  • +cdist-type(7) +

7. COPYING

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

\ No newline at end of file