aboutsummaryrefslogtreecommitdiff
path: root/REFERENCE.md
diff options
context:
space:
mode:
authorJosh Cooper <josh@puppet.com>2018-06-28 15:18:24 -0700
committerJosh Cooper <josh@puppet.com>2018-06-28 15:18:24 -0700
commitd3fd7f3df72ecf502c455d9ba2622ac33f1621de (patch)
treea408fc9f0cdbedea7c5ef1c4ffe46f191510a43b /REFERENCE.md
parenta4160770880aa7f696e0593551795c5bffb2576c (diff)
downloadpuppet-augeas_core-d3fd7f3df72ecf502c455d9ba2622ac33f1621de.tar.gz
puppet-augeas_core-d3fd7f3df72ecf502c455d9ba2622ac33f1621de.tar.bz2
Document module using puppet strings
Diffstat (limited to 'REFERENCE.md')
-rw-r--r--REFERENCE.md172
1 files changed, 172 insertions, 0 deletions
diff --git a/REFERENCE.md b/REFERENCE.md
new file mode 100644
index 0000000..5304160
--- /dev/null
+++ b/REFERENCE.md
@@ -0,0 +1,172 @@
+# Reference
+<!-- DO NOT EDIT: This document was generated by Puppet Strings -->
+
+## Table of Contents
+
+**Resource types**
+
+* [`augeas`](#augeas): Apply a change or an array of changes to the filesystem using the augeas tool. Requires: - [Augeas](http://www.augeas.net) - The ruby-augea
+
+## Resource types
+
+### augeas
+
+Apply a change or an array of changes to the filesystem
+using the augeas tool.
+
+Requires:
+
+- [Augeas](http://www.augeas.net)
+- The ruby-augeas bindings
+
+Sample usage with a string:
+
+ augeas{"test1" :
+ context => "/files/etc/sysconfig/firstboot",
+ changes => "set RUN_FIRSTBOOT YES",
+ onlyif => "match other_value size > 0",
+ }
+
+Sample usage with an array and custom lenses:
+
+ augeas{"jboss_conf":
+ context => "/files",
+ changes => [
+ "set etc/jbossas/jbossas.conf/JBOSS_IP $ipaddress",
+ "set etc/jbossas/jbossas.conf/JAVA_HOME /usr",
+ ],
+ load_path => "$/usr/share/jbossas/lenses",
+ }
+
+#### Properties
+
+The following properties are available in the `augeas` type.
+
+##### `returns`
+
+The expected return code from the augeas command. Should not be set.
+
+Default value: 0
+
+#### Parameters
+
+The following parameters are available in the `augeas` type.
+
+##### `name`
+
+namevar
+
+The name of this task. Used for uniqueness.
+
+##### `context`
+
+Optional context path. This value is prepended to the paths of all
+changes if the path is relative. If the `incl` parameter is set,
+defaults to `/files + incl`; otherwise, defaults to the empty string.
+
+Default value: ''
+
+##### `onlyif`
+
+Optional augeas command and comparisons to control the execution of this type.
+
+Note: `values` is not an actual augeas API command. It calls `match` to retrieve an array of paths
+ in <MATCH_PATH> and then `get` to retrieve the values from each of the returned paths.
+
+Supported onlyif syntax:
+
+* `get <AUGEAS_PATH> <COMPARATOR> <STRING>`
+* `values <MATCH_PATH> include <STRING>`
+* `values <MATCH_PATH> not_include <STRING>`
+* `values <MATCH_PATH> == <AN_ARRAY>`
+* `values <MATCH_PATH> != <AN_ARRAY>`
+* `match <MATCH_PATH> size <COMPARATOR> <INT>`
+* `match <MATCH_PATH> include <STRING>`
+* `match <MATCH_PATH> not_include <STRING>`
+* `match <MATCH_PATH> == <AN_ARRAY>`
+* `match <MATCH_PATH> != <AN_ARRAY>`
+
+where:
+
+* `AUGEAS_PATH` is a valid path scoped by the context
+* `MATCH_PATH` is a valid match syntax scoped by the context
+* `COMPARATOR` is one of `>, >=, !=, ==, <=,` or `<`
+* `STRING` is a string
+* `INT` is a number
+* `AN_ARRAY` is in the form `['a string', 'another']`
+
+Default value: ''
+
+##### `changes`
+
+The changes which should be applied to the filesystem. This
+can be a command or an array of commands. The following commands are supported:
+
+* `set <PATH> <VALUE>` --- Sets the value `VALUE` at location `PATH`
+* `setm <PATH> <SUB> <VALUE>` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `VALUE`
+* `rm <PATH>` --- Removes the node at location `PATH`
+* `remove <PATH>` --- Synonym for `rm`
+* `clear <PATH>` --- Sets the node at `PATH` to `NULL`, creating it if needed
+* `clearm <PATH> <SUB>` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `NULL`
+* `touch <PATH>` --- Creates `PATH` with the value `NULL` if it does not exist
+* `ins <LABEL> (before|after) <PATH>` --- Inserts an empty node `LABEL` either before or after `PATH`.
+* `insert <LABEL> <WHERE> <PATH>` --- Synonym for `ins`
+* `mv <PATH> <OTHER PATH>` --- Moves a node at `PATH` to the new location `OTHER PATH`
+* `move <PATH> <OTHER PATH>` --- Synonym for `mv`
+* `rename <PATH> <LABEL>` --- Rename a node at `PATH` to a new `LABEL`
+* `defvar <NAME> <PATH>` --- Sets Augeas variable `$NAME` to `PATH`
+* `defnode <NAME> <PATH> <VALUE>` --- Sets Augeas variable `$NAME` to `PATH`, creating it with `VALUE` if needed
+
+If the `context` parameter is set, that value is prepended to any relative `PATH`s.
+
+##### `root`
+
+A file system path; all files loaded by Augeas are loaded underneath `root`.
+
+Default value: /
+
+##### `load_path`
+
+Optional colon-separated list or array of directories; these directories are searched for schema definitions. The agent's `$libdir/augeas/lenses` path will always be added to support pluginsync.
+
+Default value: ''
+
+##### `force`
+
+Optional command to force the augeas type to execute even if it thinks changes
+will not be made. This does not override the `onlyif` parameter.
+
+Default value: `false`
+
+##### `type_check`
+
+Valid values: `true`, `false`
+
+Whether augeas should perform typechecking. Defaults to false.
+
+Default value: `false`
+
+##### `lens`
+
+Use a specific lens, such as `Hosts.lns`. When this parameter is set, you
+must also set the `incl` parameter to indicate which file to load.
+The Augeas documentation includes [a list of available lenses](http://augeas.net/stock_lenses.html).
+
+##### `incl`
+
+Load only a specific file, such as `/etc/hosts`. This can greatly speed
+up the execution the resource. When this parameter is set, you must also
+set the `lens` parameter to indicate which lens to use.
+
+##### `show_diff`
+
+Valid values: `true`, `false`, yes, no
+
+Whether to display differences when the file changes, defaulting to
+true. This parameter is useful for files that may contain passwords or
+other secret data, which might otherwise be included in Puppet reports or
+other insecure outputs. If the global `show_diff` setting
+is false, then no diffs will be shown even if this parameter is true.
+
+Default value: `true`
+