puppet 2.7.14 → 2.7.16

data/man/man8/puppet-node.8

@@ -1,13 +1,13 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-NODE" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-NODE" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-node\fR \- View and manage node definitions\.
 .
 .SH "SYNOPSIS"
-puppet node \fIaction\fR [\-\-terminus TERMINUS]
+puppet node \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .SH "DESCRIPTION"
 This subcommand interacts with node objects, which are used by Puppet to build a catalog\. A node object consists of the node\'s facts, environment, node parameters (exposed in the parser as top\-scope variables), and classes\.
@@ -35,6 +35,10 @@ Whether to log verbosely\.
 Whether to log debug information\.
 .
 .TP
+\-\-extra HASH
+A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
+.
+.TP
 \-\-terminus TERMINUS
 Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
 .
@@ -46,12 +50,49 @@ The terminus for an action is often determined by context, but occasionally need
 .
 .SH "ACTIONS"
 .
-.TP
-\fBdestroy\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
+.IP "\(bu" 4
+\fBclean\fR \- Clean up everything a puppetmaster knows about a node: \fBSYNOPSIS\fR
 .
 .IP
-puppet node destroy [\-\-terminus TERMINUS] \fIkey\fR
+puppet node clean [\-\-terminus TERMINUS] [\-\-extra HASH] [\-\-[no\-]unexport] \fIhost1\fR [\fIhost2\fR \.\.\.]
+.
+.IP
+\fBDESCRIPTION\fR
+.
+.IP
+This includes
+.
+.IP "\(bu" 4
+Signed certificates ($vardir/ssl/ca/signed/node\.domain\.pem)
+.
+.IP "\(bu" 4
+Cached facts ($vardir/yaml/facts/node\.domain\.yaml)
+.
+.IP "\(bu" 4
+Cached node stuff ($vardir/yaml/node/node\.domain\.yaml)
+.
+.IP "\(bu" 4
+Reports ($vardir/reports/node\.domain)
+.
+.IP "\(bu" 4
+Stored configs: it can either remove all data from an host in your storedconfig database, or with \-\-unexport turn every exported resource supporting ensure to absent so that any other host checking out their config can remove those exported configurations\.
+.
+.IP "" 0
+.
+.IP
+This will unexport exported resources of a host, so that consumers of these resources can remove the exported resources and we will safely remove the node from our infrastructure\.
+.
+.IP
+\fBOPTIONS\fR
+.
+.IP
+\fI\-\-[no\-]unexport\fR \- Unexport exported resources
+.
+.IP "\(bu" 4
+\fBdestroy\fR \- Invalid for this subcommand\.: \fBSYNOPSIS\fR
+.
+.IP
+puppet node destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -59,12 +100,11 @@ puppet node destroy [\-\-terminus TERMINUS] \fIkey\fR
 .IP
 Invalid for this subcommand\.
 .
-.TP
-\fBfind\fR \- Retrieve a node object\.
-\fBSYNOPSIS\fR
+.IP "\(bu" 4
+\fBfind\fR \- Retrieve a node object\.: \fBSYNOPSIS\fR
 .
 .IP
-puppet node find [\-\-terminus TERMINUS] \fIhost\fR
+puppet node find [\-\-terminus TERMINUS] [\-\-extra HASH] \fIhost\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -81,12 +121,11 @@ A hash containing the node\'s \fBclasses\fR, \fBenvironment\fR, \fBexpiration\fR
 .IP
 RENDERING ISSUES: Rendering as string and json are currently broken; node objects can only be rendered as yaml\.
 .
-.TP
-\fBinfo\fR \- Print the default terminus class for this face\.
-\fBSYNOPSIS\fR
+.IP "\(bu" 4
+\fBinfo\fR \- Print the default terminus class for this face\.: \fBSYNOPSIS\fR
 .
 .IP
-puppet node info [\-\-terminus TERMINUS]
+puppet node info [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -94,12 +133,11 @@ puppet node info [\-\-terminus TERMINUS]
 .IP
 Prints the default terminus class for this subcommand\. Note that different run modes may have different default termini; when in doubt, specify the run mode with the \'\-\-mode\' option\.
 .
-.TP
-\fBsave\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
+.IP "\(bu" 4
+\fBsave\fR \- Invalid for this subcommand\.: \fBSYNOPSIS\fR
 .
 .IP
-puppet node save [\-\-terminus TERMINUS]
+puppet node save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -107,12 +145,11 @@ puppet node save [\-\-terminus TERMINUS]
 .IP
 Invalid for this subcommand\.
 .
-.TP
-\fBsearch\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
+.IP "\(bu" 4
+\fBsearch\fR \- Invalid for this subcommand\.: \fBSYNOPSIS\fR
 .
 .IP
-puppet node search [\-\-terminus TERMINUS] \fIquery\fR
+puppet node search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -120,6 +157,8 @@ puppet node search [\-\-terminus TERMINUS] \fIquery\fR
 .IP
 Invalid for this subcommand\.
 .
+.IP "" 0
+.
 .SH "EXAMPLES"
 \fBfind\fR
 .
@@ -163,6 +202,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
 \fBrest\fR
 .
 .IP "\(bu" 4
+\fBstore_configs\fR
+.
+.IP "\(bu" 4
 \fByaml\fR
 .
 .IP "" 0

data/man/man8/puppet-parser.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-PARSER" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-PARSER" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-parser\fR \- Interact directly with the parser\.

data/man/man8/puppet-plugin.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-PLUGIN" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-PLUGIN" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-plugin\fR \- Interact with the Puppet plugin system\.

data/man/man8/puppet-queue.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-QUEUE" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-QUEUE" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-queue\fR \- Queuing daemon for asynchronous storeconfigs

data/man/man8/puppet-report.8

@@ -1,13 +1,13 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-REPORT" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-REPORT" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-report\fR \- Create, display, and submit reports\.
 .
 .SH "SYNOPSIS"
-puppet report \fIaction\fR [\-\-terminus TERMINUS]
+puppet report \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .SH "OPTIONS"
 Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR is a valid configuration parameter, so you can specify \fB\-\-server <servername>\fR as an argument\.
@@ -32,6 +32,10 @@ Whether to log verbosely\.
 Whether to log debug information\.
 .
 .TP
+\-\-extra HASH
+A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
+.
+.TP
 \-\-terminus TERMINUS
 Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
 .
@@ -48,7 +52,7 @@ The terminus for an action is often determined by context, but occasionally need
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report destroy [\-\-terminus TERMINUS] \fIkey\fR
+puppet report destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -61,7 +65,7 @@ Invalid for this face\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report find [\-\-terminus TERMINUS] \fIkey\fR
+puppet report find [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -74,7 +78,7 @@ Invalid for this face\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report info [\-\-terminus TERMINUS]
+puppet report info [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -87,7 +91,7 @@ Prints the default terminus class for this subcommand\. Note that different run
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report save [\-\-terminus TERMINUS] \fIreport\fR
+puppet report save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIreport\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -106,7 +110,7 @@ Nothing\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report search [\-\-terminus TERMINUS] \fIquery\fR
+puppet report search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -119,7 +123,7 @@ Invalid for this face\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report submit [\-\-terminus TERMINUS] \fIreport\fR
+puppet report submit [\-\-terminus TERMINUS] [\-\-extra HASH] \fIreport\fR
 .
 .IP
 \fBDESCRIPTION\fR

data/man/man8/puppet-resource.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-RESOURCE" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-RESOURCE" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-resource\fR \- The resource abstraction layer shell

data/man/man8/puppet-resource_type.8

@@ -1,13 +1,13 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-RESOURCE_TYPE" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-RESOURCE_TYPE" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-resource_type\fR \- View classes, defined resource types, and nodes from all manifests\.
 .
 .SH "SYNOPSIS"
-puppet resource_type \fIaction\fR [\-\-terminus TERMINUS]
+puppet resource_type \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .SH "DESCRIPTION"
 This subcommand reads information about the resource collections (classes, nodes, and defined types) available in Puppet\'s site manifest and modules\.
@@ -38,6 +38,10 @@ Whether to log verbosely\.
 Whether to log debug information\.
 .
 .TP
+\-\-extra HASH
+A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
+.
+.TP
 \-\-terminus TERMINUS
 Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
 .
@@ -54,7 +58,7 @@ The terminus for an action is often determined by context, but occasionally need
 \fBSYNOPSIS\fR
 .
 .IP
-puppet resource_type destroy [\-\-terminus TERMINUS] \fIkey\fR
+puppet resource_type destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -67,7 +71,7 @@ Invalid for this subcommand\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet resource_type find [\-\-terminus TERMINUS] \fIcollection_name\fR
+puppet resource_type find [\-\-terminus TERMINUS] [\-\-extra HASH] \fIcollection_name\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -95,7 +99,7 @@ If two resource collections share the same name (e\.g\. you have both a node and
 \fBSYNOPSIS\fR
 .
 .IP
-puppet resource_type info [\-\-terminus TERMINUS]
+puppet resource_type info [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -108,7 +112,7 @@ Prints the default terminus class for this subcommand\. Note that different run
 \fBSYNOPSIS\fR
 .
 .IP
-puppet resource_type save [\-\-terminus TERMINUS]
+puppet resource_type save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -121,7 +125,7 @@ Invalid for this subcommand\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet resource_type search [\-\-terminus TERMINUS] \fIregular_expression\fR
+puppet resource_type search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIregular_expression\fR
 .
 .IP
 \fBDESCRIPTION\fR

data/man/man8/puppet-secret_agent.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-SECRET_AGENT" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-SECRET_AGENT" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-secret_agent\fR \- Mimics puppet agent\.

data/man/man8/puppet-status.8

@@ -1,13 +1,13 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-STATUS" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-STATUS" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-status\fR \- View puppet server status\.
 .
 .SH "SYNOPSIS"
-puppet status \fIaction\fR [\-\-terminus TERMINUS]
+puppet status \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .SH "OPTIONS"
 Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR is a valid configuration parameter, so you can specify \fB\-\-server <servername>\fR as an argument\.
@@ -32,6 +32,10 @@ Whether to log verbosely\.
 Whether to log debug information\.
 .
 .TP
+\-\-extra HASH
+A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
+.
+.TP
 \-\-terminus TERMINUS
 Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
 .
@@ -48,7 +52,7 @@ The terminus for an action is often determined by context, but occasionally need
 \fBSYNOPSIS\fR
 .
 .IP
-puppet status destroy [\-\-terminus TERMINUS] \fIkey\fR
+puppet status destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -61,7 +65,7 @@ Invalid for this subcommand\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet status find [\-\-terminus TERMINUS] \fIdummy_text\fR
+puppet status [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -92,7 +96,7 @@ Although this action always returns an unnamed status object, it requires a dumm
 \fBSYNOPSIS\fR
 .
 .IP
-puppet status info [\-\-terminus TERMINUS]
+puppet status info [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -105,7 +109,7 @@ Prints the default terminus class for this subcommand\. Note that different run
 \fBSYNOPSIS\fR
 .
 .IP
-puppet status save [\-\-terminus TERMINUS]
+puppet status save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -118,7 +122,7 @@ Invalid for this subcommand\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet status search [\-\-terminus TERMINUS] \fIquery\fR
+puppet status search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
 .
 .IP
 \fBDESCRIPTION\fR

data/man/man8/puppet.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\fR

data/man/man8/puppetca.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-CERT" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-CERT" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-cert\fR \- Manage certificates and requests