puppet 3.1.0.rc1 → 3.1.0.rc2

data/man/man8/puppet-file.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-FILE" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-FILE" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-file\fR \- Retrieve and store files in a filebucket
@@ -13,16 +13,12 @@ puppet file \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 This subcommand interacts with objects stored in a local or remote filebucket\. File objects are accessed by their MD5 sum; see the examples for the relevant syntax\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .
@@ -115,7 +111,7 @@ puppet file info [\-\-terminus TERMINUS] [\-\-extra HASH]
 \fBDESCRIPTION\fR
 .
 .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\.
+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 \'\-\-run_mode\' option\.
 .
 .TP
 \fBsave\fR \- API only: create or overwrite an object\.
@@ -210,6 +206,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
 .IP "\(bu" 4
 \fBrest\fR
 .
+.IP "\(bu" 4
+\fBselector\fR
+.
 .IP "" 0
 .
 .SH "COPYRIGHT AND LICENSE"

data/man/man8/puppet-filebucket.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-FILEBUCKET" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-FILEBUCKET" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-filebucket\fR \- Store and retrieve files in a filebucket

data/man/man8/puppet-help.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-HELP" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-HELP" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-help\fR \- Display Puppet help\.
@@ -10,16 +10,12 @@
 puppet help \fIaction\fR
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .

data/man/man8/puppet-inspect.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-INSPECT" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-INSPECT" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-inspect\fR \- Send an inspection report

data/man/man8/puppet-instrumentation_data.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-INSTRUMENTATION_DATA" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-INSTRUMENTATION_DATA" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-instrumentation_data\fR \- Manage instrumentation listener accumulated data\.
@@ -13,16 +13,12 @@ puppet instrumentation_data \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH
 This subcommand allows to retrieve the various listener data\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .
@@ -93,7 +89,7 @@ puppet instrumentation_data info [\-\-terminus TERMINUS] [\-\-extra HASH]
 \fBDESCRIPTION\fR
 .
 .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\.
+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 \'\-\-run_mode\' option\.
 .
 .TP
 \fBsave\fR \- Invalid for this subcommand\.

data/man/man8/puppet-instrumentation_listener.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-INSTRUMENTATION_LISTENER" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-INSTRUMENTATION_LISTENER" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-instrumentation_listener\fR \- Manage instrumentation listeners\.
@@ -13,16 +13,12 @@ puppet instrumentation_listener \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra
 This subcommand enables/disables or list instrumentation listeners\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .
@@ -131,7 +127,7 @@ puppet instrumentation_listener info [\-\-terminus TERMINUS] [\-\-extra HASH]
 \fBDESCRIPTION\fR
 .
 .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\.
+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 \'\-\-run_mode\' option\.
 .
 .TP
 \fBsave\fR \- API only: modify an instrumentation listener status\.

data/man/man8/puppet-instrumentation_probe.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-INSTRUMENTATION_PROBE" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-INSTRUMENTATION_PROBE" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-instrumentation_probe\fR \- Manage instrumentation probes\.
@@ -13,16 +13,12 @@ puppet instrumentation_probe \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HAS
 This subcommand enables/disables or list instrumentation listeners\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .
@@ -125,7 +121,7 @@ puppet instrumentation_probe info [\-\-terminus TERMINUS] [\-\-extra HASH]
 \fBDESCRIPTION\fR
 .
 .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\.
+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 \'\-\-run_mode\' option\.
 .
 .TP
 \fBsave\fR \- API only: enable all instrumentation probes\.

data/man/man8/puppet-key.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-KEY" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-KEY" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-key\fR \- Create, save, and remove certificate keys\.
@@ -13,16 +13,12 @@ puppet key \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 This subcommand manages certificate private keys\. Keys are created automatically by puppet agent and when certificate requests are generated with \'puppet certificate generate\'; it should not be necessary to use this subcommand directly\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .
@@ -87,7 +83,7 @@ puppet key info [\-\-terminus TERMINUS] [\-\-extra HASH]
 \fBDESCRIPTION\fR
 .
 .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\.
+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 \'\-\-run_mode\' option\.
 .
 .TP
 \fBsave\fR \- API only: create or overwrite an object\.
@@ -122,6 +118,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
 \fBca\fR
 .
 .IP "\(bu" 4
+\fBdisabled_ca\fR
+.
+.IP "\(bu" 4
 \fBfile\fR
 .
 .IP "" 0

data/man/man8/puppet-kick.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-KICK" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-KICK" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-kick\fR \- Remotely control puppet agent
@@ -101,6 +101,10 @@ Whether the client should ignore schedules when running its configuration\. This
 How parallel to make the connections\. Parallelization is provided by forking for each client to which to connect\. The default is 1, meaning serial execution\.
 .
 .TP
+\-\-puppetport
+Use the specified TCP port to connect to agents\. Defaults to 8139\.
+.
+.TP
 \-\-tag
 Specify a tag for selecting the objects to apply\. Does not work with the \-\-test option\.
 .

data/man/man8/puppet-man.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-MAN" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-MAN" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-man\fR \- Display Puppet manual pages\.
@@ -13,16 +13,12 @@ puppet man \fIaction\fR
 This subcommand displays manual pages for all Puppet subcommands\. If the \fBronn\fR gem (\fIhttps://github\.com/rtomayko/ronn/\fR) is installed on your system, puppet man will display fully\-formated man pages\. If \fBronn\fR is not available, puppet man will display the raw (but human\-readable) source text in a pager\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .

data/man/man8/puppet-master.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-MASTER" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-MASTER" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-master\fR \- The puppet master daemon
@@ -75,4 +75,4 @@ Close file descriptors for log files and reopen them\. Used with logrotate\.
 Luke Kanies
 .
 .SH "COPYRIGHT"
-Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2\.0 License
+Copyright (c) 2012 Puppet Labs, LLC Licensed under the Apache 2\.0 License

data/man/man8/puppet-module.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-MODULE" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-MODULE" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.
@@ -13,16 +13,12 @@ puppet module \fIaction\fR [\-\-environment production ] [\-\-modulepath $confdi
 This subcommand can find, install, and manage modules from the Puppet Forge, a repository of user\-contributed Puppet code\. It can also generate empty modules, and prepare locally developed modules for release on the Forge\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .
@@ -49,7 +45,7 @@ The search path for modules, as a list of directories separated by the system pa
 \fBSYNOPSIS\fR
 .
 .IP
-puppet module build \fIpath\fR
+puppet module build [\fIpath\fR]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -124,7 +120,7 @@ puppet module install [\-\-force | \-f] [\-\-target\-dir DIR | \-i DIR] [\-\-ign
 Installs a module from the Puppet Forge or from a release archive file\.
 .
 .IP
-The specified module will be installed into the directory specified with the \fB\-\-target\-dir\fR option, which defaults to /Users/matthaus/\.puppet/modules\.
+The specified module will be installed into the directory specified with the \fB\-\-target\-dir\fR option, which defaults to /Users/josh/\.puppet/modules\.
 .
 .IP
 \fBOPTIONS\fR \fI\-\-force\fR | \fI\-f\fR \- Force overwrite of existing module, if any\.
@@ -251,7 +247,13 @@ Hash
 Build a module release:
 .
 .P
-$ puppet module build puppetlabs\-apache notice: Building /Users/kelseyhightower/puppetlabs\-apache for release puppetlabs\-apache/pkg/puppetlabs\-apache\-0\.0\.1\.tar\.gz
+$ puppet module build puppetlabs\-apache notice: Building /Users/kelseyhightower/puppetlabs\-apache for release Module built: /Users/kelseyhightower/puppetlabs\-apache/pkg/puppetlabs\-apache\-0\.0\.1\.tar\.gz
+.
+.P
+Build the module in the current working directory:
+.
+.P
+$ cd /Users/kelseyhightower/puppetlabs\-apache $ puppet module build notice: Building /Users/kelseyhightower/puppetlabs\-apache for release Module built: /Users/kelseyhightower/puppetlabs\-apache/pkg/puppetlabs\-apache\-0\.0\.1\.tar\.gz
 .
 .P
 \fBchanges\fR

data/man/man8/puppet-node.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-NODE" "8" "May 2012" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-NODE" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-node\fR \- View and manage node definitions\.
@@ -13,16 +13,12 @@ puppet node \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 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\.
 .
 .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\.
+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 and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
 .
 .TP
-\-\-mode MODE
-The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
-.
-.TP
 \-\-render\-as FORMAT
 The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
 .
@@ -50,8 +46,9 @@ The terminus for an action is often determined by context, but occasionally need
 .
 .SH "ACTIONS"
 .
-.IP "\(bu" 4
-\fBclean\fR \- Clean up everything a puppetmaster knows about a node: \fBSYNOPSIS\fR
+.TP
+\fBclean\fR \- Clean up everything a puppetmaster knows about a node\.
+\fBSYNOPSIS\fR
 .
 .IP
 puppet node clean [\-\-terminus TERMINUS] [\-\-extra HASH] [\-\-[no\-]unexport] \fIhost1\fR [\fIhost2\fR \.\.\.]
@@ -60,33 +57,32 @@ puppet node clean [\-\-terminus TERMINUS] [\-\-extra HASH] [\-\-[no\-]unexport]
 \fBDESCRIPTION\fR
 .
 .IP
-This includes
+Clean up everything a puppet master knows about a node, including certificates and storeconfigs data\.
 .
-.IP "\(bu" 4
-Signed certificates ($vardir/ssl/ca/signed/node\.domain\.pem)
-.
-.IP "\(bu" 4
-Cached facts ($vardir/yaml/facts/node\.domain\.yaml)
+.IP
+The full list of info cleaned by this action is:
 .
-.IP "\(bu" 4
-Cached node stuff ($vardir/yaml/node/node\.domain\.yaml)
+.IP
+\fISigned certificates\fR \- ($vardir/ssl/ca/signed/node\.domain\.pem)
 .
-.IP "\(bu" 4
-Reports ($vardir/reports/node\.domain)
+.IP
+\fICached facts\fR \- ($vardir/yaml/facts/node\.domain\.yaml)
 .
-.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
+\fICached node objects\fR \- ($vardir/yaml/node/node\.domain\.yaml)
 .
-.IP "" 0
+.IP
+\fIReports\fR \- ($vardir/reports/node\.domain)
 .
 .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\.
+\fIStored configs\fR \- (in database) The clean action can either remove all data from a host in your storeconfigs database, or, with the \fI\-\-unexport\fR option, turn every exported resource supporting ensure to absent so that any other host that collected those resources can remove them\. Without unexporting, a removed node\'s exported resources become unmanaged by Puppet, and may linger as cruft unless you are purging that resource type\.
 .
 .IP
-\fBOPTIONS\fR \fI\-\-[no\-]unexport\fR \- Unexport exported resources
+\fBOPTIONS\fR \fI\-\-[no\-]unexport\fR \- Whether to remove this node\'s exported resources from other nodes
 .
-.IP "\(bu" 4
-\fBdestroy\fR \- Invalid for this subcommand\.: \fBSYNOPSIS\fR
+.TP
+\fBdestroy\fR \- Invalid for this subcommand\.
+\fBSYNOPSIS\fR
 .
 .IP
 puppet node destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
@@ -97,8 +93,9 @@ puppet node destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .IP
 Invalid for this subcommand\.
 .
-.IP "\(bu" 4
-\fBfind\fR \- Retrieve a node object\.: \fBSYNOPSIS\fR
+.TP
+\fBfind\fR \- Retrieve a node object\.
+\fBSYNOPSIS\fR
 .
 .IP
 puppet node find [\-\-terminus TERMINUS] [\-\-extra HASH] \fIhost\fR
@@ -118,8 +115,9 @@ 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\.
 .
-.IP "\(bu" 4
-\fBinfo\fR \- Print the default terminus class for this face\.: \fBSYNOPSIS\fR
+.TP
+\fBinfo\fR \- Print the default terminus class for this face\.
+\fBSYNOPSIS\fR
 .
 .IP
 puppet node info [\-\-terminus TERMINUS] [\-\-extra HASH]
@@ -128,10 +126,11 @@ puppet node info [\-\-terminus TERMINUS] [\-\-extra HASH]
 \fBDESCRIPTION\fR
 .
 .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\.
+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 \'\-\-run_mode\' option\.
 .
-.IP "\(bu" 4
-\fBsave\fR \- Invalid for this subcommand\.: \fBSYNOPSIS\fR
+.TP
+\fBsave\fR \- Invalid for this subcommand\.
+\fBSYNOPSIS\fR
 .
 .IP
 puppet node save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
@@ -142,8 +141,9 @@ puppet node save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
 .IP
 Invalid for this subcommand\.
 .
-.IP "\(bu" 4
-\fBsearch\fR \- Invalid for this subcommand\.: \fBSYNOPSIS\fR
+.TP
+\fBsearch\fR \- Invalid for this subcommand\.
+\fBSYNOPSIS\fR
 .
 .IP
 puppet node search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
@@ -154,8 +154,6 @@ puppet node search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
 .IP
 Invalid for this subcommand\.
 .
-.IP "" 0
-.
 .SH "EXAMPLES"
 \fBfind\fR
 .
@@ -169,7 +167,7 @@ $ puppet node find somenode\.puppetlabs\.lan \-\-terminus plain \-\-render\-as y
 Retrieve a node using the puppet master\'s configured ENC:
 .
 .P
-$ puppet node find somenode\.puppetlabs\.lan \-\-terminus exec \-\-mode master \-\-render\-as yaml
+$ puppet node find somenode\.puppetlabs\.lan \-\-terminus exec \-\-run_mode master \-\-render\-as yaml
 .
 .P
 Retrieve the same node from the puppet master:
@@ -202,6 +200,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
 \fBstore_configs\fR
 .
 .IP "\(bu" 4
+\fBwrite_only_yaml\fR
+.
+.IP "\(bu" 4
 \fByaml\fR
 .
 .IP "" 0