From 1f9afd323e185be45bef127c1faf80bb2c0e99e6 Mon Sep 17 00:00:00 2001
From: Darko Poljak
Date: Fri, 2 Dec 2016 20:52:13 +0100
Subject: [PATCH] Update beta docs.
---
.../man/beta/_sources/cdist-reference.txt | 4 +
.../cdist/man/beta/_sources/man1/cdist.txt | 64 ++-
.../man7/cdist-type__postgres_extension.txt | 59 +++
.../cdist/man/beta/cdist-best-practice.html | 8 +-
software/cdist/man/beta/cdist-bootstrap.html | 8 +-
software/cdist/man/beta/cdist-explorer.html | 12 +-
software/cdist/man/beta/cdist-features.html | 8 +-
software/cdist/man/beta/cdist-hacker.html | 8 +-
software/cdist/man/beta/cdist-install.html | 8 +-
software/cdist/man/beta/cdist-intro.html | 8 +-
software/cdist/man/beta/cdist-inventory.html | 8 +-
software/cdist/man/beta/cdist-manifest.html | 8 +-
software/cdist/man/beta/cdist-messaging.html | 8 +-
software/cdist/man/beta/cdist-os.html | 8 +-
.../cdist/man/beta/cdist-parallelization.html | 8 +-
software/cdist/man/beta/cdist-preos.html | 8 +-
software/cdist/man/beta/cdist-quickstart.html | 8 +-
software/cdist/man/beta/cdist-reference.html | 11 +-
.../man/beta/cdist-remote-exec-copy.html | 8 +-
software/cdist/man/beta/cdist-stages.html | 8 +-
software/cdist/man/beta/cdist-support.html | 8 +-
software/cdist/man/beta/cdist-trigger.html | 8 +-
.../cdist/man/beta/cdist-troubleshooting.html | 8 +-
software/cdist/man/beta/cdist-type.html | 8 +-
software/cdist/man/beta/cdist-types.html | 102 ++---
software/cdist/man/beta/cdist-update.html | 8 +-
software/cdist/man/beta/cdist-why.html | 8 +-
software/cdist/man/beta/genindex.html | 27 +-
software/cdist/man/beta/index.html | 55 +--
software/cdist/man/beta/man1/cdist.html | 73 +++-
.../man/beta/man7/cdist-type__apt_key.html | 55 +--
.../beta/man7/cdist-type__apt_key_uri.html | 55 +--
.../man/beta/man7/cdist-type__apt_mark.html | 55 +--
.../man7/cdist-type__apt_norecommends.html | 55 +--
.../man/beta/man7/cdist-type__apt_ppa.html | 55 +--
.../man/beta/man7/cdist-type__apt_source.html | 55 +--
.../man7/cdist-type__apt_update_index.html | 55 +--
.../man/beta/man7/cdist-type__block.html | 55 +--
.../man7/cdist-type__ccollect_source.html | 55 +--
.../man/beta/man7/cdist-type__cdist.html | 55 +--
.../man7/cdist-type__cdist_preos_trigger.html | 55 +--
.../beta/man7/cdist-type__cdistmarker.html | 55 +--
.../beta/man7/cdist-type__chroot_mount.html | 55 +--
.../beta/man7/cdist-type__chroot_umount.html | 55 +--
.../beta/man7/cdist-type__config_file.html | 55 +--
.../man/beta/man7/cdist-type__consul.html | 55 +--
.../beta/man7/cdist-type__consul_agent.html | 55 +--
.../beta/man7/cdist-type__consul_check.html | 55 +--
.../beta/man7/cdist-type__consul_reload.html | 55 +--
.../beta/man7/cdist-type__consul_service.html | 55 +--
.../man7/cdist-type__consul_template.html | 55 +--
.../cdist-type__consul_template_template.html | 55 +--
.../man7/cdist-type__consul_watch_checks.html | 55 +--
.../man7/cdist-type__consul_watch_event.html | 55 +--
.../man7/cdist-type__consul_watch_key.html | 55 +--
.../cdist-type__consul_watch_keyprefix.html | 55 +--
.../man7/cdist-type__consul_watch_nodes.html | 55 +--
.../cdist-type__consul_watch_service.html | 55 +--
.../cdist-type__consul_watch_services.html | 55 +--
.../cdist/man/beta/man7/cdist-type__cron.html | 55 +--
.../cdist-type__debconf_set_selections.html | 55 +--
.../man/beta/man7/cdist-type__directory.html | 55 +--
.../man/beta/man7/cdist-type__dog_vdi.html | 55 +--
.../cdist/man/beta/man7/cdist-type__file.html | 55 +--
.../man/beta/man7/cdist-type__filesystem.html | 55 +--
.../beta/man7/cdist-type__firewalld_rule.html | 55 +--
.../man7/cdist-type__firewalld_start.html | 55 +--
.../cdist/man/beta/man7/cdist-type__git.html | 55 +--
.../man/beta/man7/cdist-type__group.html | 55 +--
.../man/beta/man7/cdist-type__hostname.html | 55 +--
.../cdist-type__install_bootloader_grub.html | 55 +--
.../cdist-type__install_chroot_mount.html | 55 +--
.../cdist-type__install_chroot_umount.html | 55 +--
.../beta/man7/cdist-type__install_config.html | 55 +--
.../beta/man7/cdist-type__install_file.html | 55 +--
.../beta/man7/cdist-type__install_fstab.html | 55 +--
.../cdist-type__install_generate_fstab.html | 55 +--
.../beta/man7/cdist-type__install_mkfs.html | 55 +--
.../beta/man7/cdist-type__install_mount.html | 55 +--
.../cdist-type__install_partition_msdos.html | 55 +--
...t-type__install_partition_msdos_apply.html | 55 +--
.../beta/man7/cdist-type__install_reboot.html | 55 +--
.../man7/cdist-type__install_reset_disk.html | 55 +--
.../beta/man7/cdist-type__install_stage.html | 55 +--
.../beta/man7/cdist-type__install_umount.html | 55 +--
.../beta/man7/cdist-type__iptables_apply.html | 55 +--
.../beta/man7/cdist-type__iptables_rule.html | 55 +--
.../man/beta/man7/cdist-type__issue.html | 55 +--
.../cdist/man/beta/man7/cdist-type__jail.html | 55 +--
.../beta/man7/cdist-type__jail_freebsd10.html | 55 +--
.../beta/man7/cdist-type__jail_freebsd9.html | 55 +--
.../man/beta/man7/cdist-type__key_value.html | 55 +--
.../man/beta/man7/cdist-type__keyboard.html | 55 +--
.../cdist/man/beta/man7/cdist-type__line.html | 55 +--
.../cdist/man/beta/man7/cdist-type__link.html | 55 +--
.../man/beta/man7/cdist-type__locale.html | 55 +--
.../beta/man7/cdist-type__locale_system.html | 55 +--
.../cdist/man/beta/man7/cdist-type__motd.html | 55 +--
.../man/beta/man7/cdist-type__mount.html | 55 +--
.../beta/man7/cdist-type__mysql_database.html | 55 +--
.../man/beta/man7/cdist-type__package.html | 55 +--
.../beta/man7/cdist-type__package_apt.html | 55 +--
.../beta/man7/cdist-type__package_emerge.html | 55 +--
...ist-type__package_emerge_dependencies.html | 55 +--
.../man7/cdist-type__package_luarocks.html | 55 +--
.../beta/man7/cdist-type__package_opkg.html | 55 +--
.../beta/man7/cdist-type__package_pacman.html | 55 +--
.../beta/man7/cdist-type__package_pip.html | 55 +--
.../man7/cdist-type__package_pkg_freebsd.html | 55 +--
.../man7/cdist-type__package_pkg_openbsd.html | 55 +--
.../cdist-type__package_pkgng_freebsd.html | 55 +--
.../man7/cdist-type__package_rubygem.html | 55 +--
.../cdist-type__package_update_index.html | 55 +--
.../man7/cdist-type__package_upgrade_all.html | 55 +--
.../beta/man7/cdist-type__package_yum.html | 55 +--
.../beta/man7/cdist-type__package_zypper.html | 55 +--
.../beta/man7/cdist-type__pacman_conf.html | 55 +--
.../cdist-type__pacman_conf_integrate.html | 55 +--
.../man/beta/man7/cdist-type__pf_apply.html | 55 +--
.../man/beta/man7/cdist-type__pf_ruleset.html | 55 +--
.../man/beta/man7/cdist-type__postfix.html | 55 +--
.../beta/man7/cdist-type__postfix_master.html | 55 +--
.../man7/cdist-type__postfix_postconf.html | 55 +--
.../man7/cdist-type__postfix_postmap.html | 55 +--
.../beta/man7/cdist-type__postfix_reload.html | 55 +--
.../man7/cdist-type__postgres_database.html | 59 +--
.../man7/cdist-type__postgres_extension.html | 406 ++++++++++++++++++
.../beta/man7/cdist-type__postgres_role.html | 99 ++---
.../man/beta/man7/cdist-type__process.html | 95 ++--
.../man/beta/man7/cdist-type__pyvenv.html | 95 ++--
.../man/beta/man7/cdist-type__qemu_img.html | 95 ++--
.../man/beta/man7/cdist-type__rbenv.html | 91 ++--
.../man/beta/man7/cdist-type__rsync.html | 107 ++---
.../cdist/man/beta/man7/cdist-type__rvm.html | 95 ++--
.../man/beta/man7/cdist-type__rvm_gem.html | 99 ++---
.../man/beta/man7/cdist-type__rvm_gemset.html | 99 ++---
.../man/beta/man7/cdist-type__rvm_ruby.html | 99 ++---
.../man7/cdist-type__ssh_authorized_key.html | 99 ++---
.../man7/cdist-type__ssh_authorized_keys.html | 103 ++---
.../beta/man7/cdist-type__ssh_dot_ssh.html | 95 ++--
.../beta/man7/cdist-type__staged_file.html | 99 ++---
.../beta/man7/cdist-type__start_on_boot.html | 99 ++---
.../man/beta/man7/cdist-type__sysctl.html | 91 ++--
.../man/beta/man7/cdist-type__timezone.html | 95 ++--
.../man7/cdist-type__update_alternatives.html | 95 ++--
.../cdist/man/beta/man7/cdist-type__user.html | 107 ++---
.../beta/man7/cdist-type__user_groups.html | 95 ++--
.../man/beta/man7/cdist-type__yum_repo.html | 99 ++---
.../beta/man7/cdist-type__zypper_repo.html | 95 ++--
.../beta/man7/cdist-type__zypper_service.html | 95 ++--
software/cdist/man/beta/objects.inv | Bin 2520 -> 2551 bytes
software/cdist/man/beta/search.html | 8 +-
software/cdist/man/beta/searchindex.js | 2 +-
153 files changed, 4601 insertions(+), 3915 deletions(-)
create mode 100644 software/cdist/man/beta/_sources/man7/cdist-type__postgres_extension.txt
create mode 100644 software/cdist/man/beta/man7/cdist-type__postgres_extension.html
diff --git a/software/cdist/man/beta/_sources/cdist-reference.txt b/software/cdist/man/beta/_sources/cdist-reference.txt
index c650ade1..c6c8eb3b 100644
--- a/software/cdist/man/beta/_sources/cdist-reference.txt
+++ b/software/cdist/man/beta/_sources/cdist-reference.txt
@@ -226,6 +226,7 @@ The following types are available:
- __postfix_postmap (`cdist-type__postfix_postmap(7) `_)
- __postfix_reload (`cdist-type__postfix_reload(7) `_)
- __postgres_database (`cdist-type__postgres_database(7) `_)
+- __postgres_extension (`cdist-type__postgres_extension(7) `_)
- __postgres_role (`cdist-type__postgres_role(7) `_)
- __process (`cdist-type__process(7) `_)
- __pyvenv (`cdist-type__pyvenv(7) `_)
@@ -357,3 +358,6 @@ CDIST_INVENTORY_DIR
CDIST_BETA
Enable beta functionalities.
+
+CDIST_CACHE_PATH_PATTERN
+ Custom cache path pattern.
diff --git a/software/cdist/man/beta/_sources/man1/cdist.txt b/software/cdist/man/beta/_sources/man1/cdist.txt
index ed0f6d93..8efaea72 100644
--- a/software/cdist/man/beta/_sources/man1/cdist.txt
+++ b/software/cdist/man/beta/_sources/man1/cdist.txt
@@ -15,16 +15,16 @@ SYNOPSIS
cdist banner [-h] [-d] [-v]
- cdist config [-h] [-d] [-v] [-b] [-c CONF_DIR] [-i MANIFEST]
- [-j [JOBS]] [-n] [-o OUT_PATH] [--remote-copy REMOTE_COPY]
- [--remote-exec REMOTE_EXEC] [-I INVENTORY_DIR] [-A] [-a]
- [-f HOSTFILE] [-p] [-s] [-t]
+ cdist config [-h] [-d] [-v] [-b] [-C CACHE_PATH_PATTERN] [-c CONF_DIR]
+ [-i MANIFEST] [-j [JOBS]] [-n] [-o OUT_PATH]
+ [--remote-copy REMOTE_COPY] [--remote-exec REMOTE_EXEC]
+ [-I INVENTORY_DIR] [-A] [-a] [-f HOSTFILE] [-p] [-s] [-t]
[host [host ...]]
- cdist install [-h] [-d] [-v] [-b] [-c CONF_DIR] [-i MANIFEST]
- [-j [JOBS]] [-n] [-o OUT_PATH] [--remote-copy REMOTE_COPY]
- [--remote-exec REMOTE_EXEC] [-I INVENTORY_DIR] [-A] [-a]
- [-f HOSTFILE] [-p] [-s] [-t]
+ cdist install [-h] [-d] [-v] [-b] [-C CACHE_PATH_PATTERN] [-c CONF_DIR]
+ [-i MANIFEST] [-j [JOBS]] [-n] [-o OUT_PATH]
+ [--remote-copy REMOTE_COPY] [--remote-exec REMOTE_EXEC]
+ [-I INVENTORY_DIR] [-A] [-a] [-f HOSTFILE] [-p] [-s] [-t]
[host [host ...]]
cdist inventory [-h] [-d] [-v] [-b] [-I INVENTORY_DIR]
@@ -68,8 +68,8 @@ SYNOPSIS
cdist shell [-h] [-d] [-v] [-s SHELL]
- cdist trigger [-h] [-d] [-v] [-b] [-c CONF_DIR] [-i MANIFEST]
- [-j [JOBS]] [-n] [-o OUT_PATH]
+ cdist trigger [-h] [-d] [-v] [-b] [-C CACHE_PATH_PATTERN] [-c CONF_DIR]
+ [-i MANIFEST] [-j [JOBS]] [-n] [-o OUT_PATH]
[--remote-copy REMOTE_COPY] [--remote-exec REMOTE_EXEC]
[-6] [-H HTTP_PORT]
@@ -92,11 +92,13 @@ All commands accept the following options:
.. option:: -d, --debug
- Set log level to debug
+ Set log level to debug (deprecated, use -vvv instead)
.. option:: -v, --verbose
- Set log level to info, be more verbose
+ Increase log level, be more verbose. Use it more than once to increase
+ log level. The order of levels from the lowest to the highest are:
+ ERROR, WARNING, INFO, DEBUG.
.. option:: -V, --version
@@ -128,6 +130,13 @@ Configure/install one or more hosts.
Can also be enabled using CDIST_BETA env var.
+.. option:: -C CACHE_PATH_PATTERN, --cache-path-pattern CACHE_PATH_PATTERN
+
+ Sepcify custom cache path pattern. It can also be set by
+ CDIST_CACHE_PATH_PATTERN environment variable. If it is not set then
+ default hostdir is used. For more info on format see
+ :strong:`CACHE PATH PATTERN FORMAT` below.
+
.. option:: -c CONF_DIR, --conf-dir CONF_DIR
Add a configuration directory. Can be specified multiple times.
@@ -143,7 +152,8 @@ Configure/install one or more hosts.
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.
+ read hosts from stdin. For the file format see
+ :strong:`HOSTFILE FORMAT` below.
.. option:: -I INVENTORY_DIR, --inventory INVENTORY_DIR
@@ -205,6 +215,24 @@ 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.
+CACHE PATH PATTERN FORMAT
+~~~~~~~~~~~~~~~~~~~~~~~~~
+Cache path pattern specifies path for a cache directory subdirectory.
+In the path, '%N' will be substituted by the target host, '%h' will
+be substituted by the calculated host directory, '%P' will be substituted
+by the current process id. All format codes that
+:strong:`python` :strong:`datetime.strftime()` function supports, except
+'%h', are supported. These date/time directives format cdist config/install
+start time.
+
+If empty pattern is specified then default calculated host directory
+is used.
+
+Calculated host directory is a hash of a host cdist operates on.
+
+Resulting path is used to specify cache path subdirectory under which
+current host cache data are saved.
+
INVENTORY
---------
@@ -664,6 +692,13 @@ Request path recognizes following requests:
Can also be enabled using CDIST_BETA env var.
+.. option:: -C CACHE_PATH_PATTERN, --cache-path-pattern CACHE_PATH_PATTERN
+
+ Sepcify custom cache path pattern. It can also be set by
+ CDIST_CACHE_PATH_PATTERN environment variable. If it is not set then
+ default hostdir is used. For more info on format see
+ :strong:`CACHE PATH PATTERN FORMAT` below.
+
.. option:: -c CONF_DIR, --conf-dir CONF_DIR
Add configuration directory (can be repeated, last one wins)
@@ -864,6 +899,9 @@ CDIST_INVENTORY_DIR
CDIST_BETA
Enable beta functionalities.
+CDIST_CACHE_PATH_PATTERN
+ Custom cache path pattern.
+
EXIT STATUS
-----------
The following exit values shall be returned:
diff --git a/software/cdist/man/beta/_sources/man7/cdist-type__postgres_extension.txt b/software/cdist/man/beta/_sources/man7/cdist-type__postgres_extension.txt
new file mode 100644
index 00000000..ead51c83
--- /dev/null
+++ b/software/cdist/man/beta/_sources/man7/cdist-type__postgres_extension.txt
@@ -0,0 +1,59 @@
+cdist-type__postgres_extension(7)
+=================================
+
+NAME
+----
+cdist-type__postgres_extension - manage postgres extensions
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to create or drop postgres extensions.
+
+The object you need to pass to __postgres_extension consists of
+the database name and the extension name joined by a colon in the
+following form:
+
+.. code-block::
+
+ dbname:extension
+
+f.ex.
+
+.. code-block::
+
+ rails_test:unaccent
+
+
+OPTIONAL PARAMETERS
+-------------------
+state
+ either "present" or "absent", defaults to "present"
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+ __postgres_extension rails_test:unaccent
+ __postgres_extension --present rails_test:unaccent
+ __postgres_extension --absent rails_test:unaccent
+
+
+SEE ALSO
+--------
+:strong:`cdist-type__postgre_database`\ (7)
+
+Postgres "Create Extension" documentation at: .
+
+AUTHOR
+-------
+Tomas Pospisek
+
+COPYING
+-------
+Copyright \(C) 2014 Tomas Pospisek. You can redistribute it
+and/or modify it under the terms of the GNU General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
diff --git a/software/cdist/man/beta/cdist-best-practice.html b/software/cdist/man/beta/cdist-best-practice.html
index 3984e701..e55d62ea 100644
--- a/software/cdist/man/beta/cdist-best-practice.html
+++ b/software/cdist/man/beta/cdist-best-practice.html
@@ -8,7 +8,7 @@
- 21. Best practice — cdist 4.3.2-330-g1b086e4 documentation
+ 21. Best practice — cdist 4.3.2-364-gfb6e850 documentation
@@ -33,7 +33,7 @@
-
+
@@ -63,7 +63,7 @@
- 4.3.2-330-g1b086e4
+ 4.3.2-364-gfb6e850
@@ -433,7 +433,7 @@ repository.
@@ -63,7 +63,7 @@
- 4.3.2-330-g1b086e4
+ 4.3.2-364-gfb6e850
@@ -215,7 +215,7 @@ dpkg -s " $name Next
- Previous
+ Previous
@@ -246,7 +246,7 @@ dpkg -s " $name
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
- VERSION:'4.3.2-330-g1b086e4',
+ VERSION:'4.3.2-364-gfb6e850',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
diff --git a/software/cdist/man/beta/cdist-features.html b/software/cdist/man/beta/cdist-features.html
index eaa85a1c..22f47d9c 100644
--- a/software/cdist/man/beta/cdist-features.html
+++ b/software/cdist/man/beta/cdist-features.html
@@ -8,7 +8,7 @@
- 7. Features — cdist 4.3.2-330-g1b086e4 documentation
+ 7. Features — cdist 4.3.2-364-gfb6e850 documentation
@@ -33,7 +33,7 @@
-
+
@@ -63,7 +63,7 @@
- 4.3.2-330-g1b086e4
+ 4.3.2-364-gfb6e850
@@ -236,7 +236,7 @@ Batteries included: A lot of requirements can be solved using standard types
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
- VERSION:'4.3.2-330-g1b086e4',
+ VERSION:'4.3.2-364-gfb6e850',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
diff --git a/software/cdist/man/beta/cdist-hacker.html b/software/cdist/man/beta/cdist-hacker.html
index ef8775e8..b95b4032 100644
--- a/software/cdist/man/beta/cdist-hacker.html
+++ b/software/cdist/man/beta/cdist-hacker.html
@@ -8,7 +8,7 @@
- 24. Hacking — cdist 4.3.2-330-g1b086e4 documentation
+ 24. Hacking — cdist 4.3.2-364-gfb6e850 documentation
@@ -33,7 +33,7 @@
-
+
@@ -63,7 +63,7 @@
- 4.3.2-330-g1b086e4
+ 4.3.2-364-gfb6e850
@@ -348,7 +348,7 @@ in parallel)
@@ -62,7 +62,7 @@
- 4.3.2-330-g1b086e4
+ 4.3.2-364-gfb6e850
@@ -253,6 +253,17 @@
+
+ -C CACHE_PATH_PATTERN, --cache-path-pattern CACHE_PATH_PATTERN
+
+
+
+
+ command line option , [1]
+
+
+
+
-c CDIST_PARAMS, --cdist-params CDIST_PARAMS
@@ -373,6 +384,8 @@
+
+
-i MANIFEST, --initial-manifest MANIFEST
@@ -384,8 +397,6 @@
-
-
-j [JOBS], --jobs [JOBS]
@@ -628,6 +639,10 @@
+ -C CACHE_PATH_PATTERN, --cache-path-pattern CACHE_PATH_PATTERN , [1]
+
+
+
-C, --configure , [1]
@@ -842,7 +857,7 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ cdist
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
13.97. cdist-type__postgres_extension(7)
+
+
13.97.1. NAME
+
cdist-type__postgres_extension - manage postgres extensions
+
+
+
13.97.2. DESCRIPTION
+
This cdist type allows you to create or drop postgres extensions.
+
The object you need to pass to __postgres_extension consists of
+the database name and the extension name joined by a colon in the
+following form:
+
f.ex.
+
+
+
13.97.3. OPTIONAL PARAMETERS
+
+state
+either "present" or "absent", defaults to "present"
+
+
+
+
13.97.4. EXAMPLES
+
__postgres_extension rails_test:unaccent
+__postgres_extension --present rails_test:unaccent
+__postgres_extension --absent rails_test:unaccent
+
+
+
+
+
+
+
13.97.7. COPYING
+
Copyright (C) 2014 Tomas Pospisek. You can redistribute it
+and/or modify it under the terms of the GNU General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+