puppet 6.0.5-x64-mingw32 → 8.8.1-x64-mingw32

data/man/man8/puppet-facts.8

@@ -1,13 +1,13 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-FACTS" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-FACTS" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-facts\fR \- Retrieve and store facts\.
 .
 .SH "SYNOPSIS"
-puppet facts \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet facts \fIaction\fR [\-\-terminus _TERMINUS]
 .
 .SH "DESCRIPTION"
 This subcommand manages facts, which are collections of normalized system information used by Puppet\. It can read facts directly from the local system (with the default \fBfacter\fR terminus)\.
@@ -31,10 +31,6 @@ 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\.
 .
@@ -51,7 +47,7 @@ The terminus for an action is often determined by context, but occasionally need
 \fBSYNOPSIS\fR
 .
 .IP
-puppet facts [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fInode_certname\fR]
+puppet facts find [\-\-terminus _TERMINUS] [\fInode_certname\fR]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -79,7 +75,7 @@ When using the \fBfacter\fR terminus, the host argument is ignored\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet facts info [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet facts info [\-\-terminus _TERMINUS]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -92,7 +88,7 @@ Prints the default terminus class for this subcommand\. Note that different run
 \fBSYNOPSIS\fR
 .
 .IP
-puppet facts save [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIkey\fR
+puppet facts save [\-\-terminus _TERMINUS] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -101,11 +97,57 @@ puppet facts save [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIkey\fR
 API only: create or overwrite an object\. As the Faces framework does not currently accept data from STDIN, save actions cannot currently be invoked from the command line\.
 .
 .TP
+\fBshow\fR \- Retrieve current node\'s facts\.
+\fBSYNOPSIS\fR
+.
+.IP
+puppet facts [\-\-terminus _TERMINUS] [\-\-config\-file \fIpath\fR] [\-\-custom\-dir \fIpath\fR] [\-\-external\-dir \fIpath\fR] [\-\-no\-block] [\-\-no\-cache] [\-\-show\-legacy] [\-\-value\-only] [\-\-timing] [\fIfacts\fR]
+.
+.IP
+\fBDESCRIPTION\fR
+.
+.IP
+Reads facts from the local system using \fBfacter\fR terminus\. A query can be provided to retrieve just a specific fact or a set of facts\.
+.
+.IP
+\fBOPTIONS\fR \fI\-\-config\-file <path\fR> \- The location of the config file for Facter\.
+.
+.IP
+\fI\-\-custom\-dir <path\fR> \- The path to a directory that contains custom facts\.
+.
+.IP
+\fI\-\-external\-dir <path\fR> \- The path to a directory that contains external facts\.
+.
+.IP
+\fI\-\-no\-block\fR \- Disable fact blocking mechanism\.
+.
+.IP
+\fI\-\-no\-cache\fR \- Disable fact caching mechanism\.
+.
+.IP
+\fI\-\-show\-legacy\fR \- Show legacy facts when querying all facts\.
+.
+.IP
+\fI\-\-timing\fR \- Show how much time it took to resolve each fact\.
+.
+.IP
+\fI\-\-value\-only\fR \- Show only the value when the action is called with a single query
+.
+.IP
+\fBRETURNS\fR
+.
+.IP
+The output of facter with added puppet specific facts\.
+.
+.IP
+\fBNOTES\fR
+.
+.TP
 \fBupload\fR \- Upload local facts to the puppet master\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet facts upload [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet facts upload [\-\-terminus _TERMINUS]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -123,7 +165,7 @@ Nothing\.
 \fBNOTES\fR
 .
 .IP
-This action requires that the puppet master\'s \fBauth\.conf\fR file allow \fBPUT\fR or \fBsave\fR access to the \fB/puppet/v3/facts\fR API endpoint\.
+This action requires that the Puppet Server\'s \fBauth\.conf\fR file allow \fBPUT\fR or \fBsave\fR access to the \fB/puppet/v3/facts\fR API endpoint\.
 .
 .IP
 For details on configuring Puppet Server\'s \fBauth\.conf\fR, see:
@@ -131,12 +173,6 @@ For details on configuring Puppet Server\'s \fBauth\.conf\fR, see:
 .IP
 \fIhttps://puppet\.com/docs/puppetserver/latest/config_file_auth\.html\fR
 .
-.IP
-For legacy Rack\-based Puppet Masters, see:
-.
-.IP
-\fIhttps://puppet\.com/docs/puppet/latest/config_file_auth\.html\fR
-.
 .SH "EXAMPLES"
 \fBfind\fR
 .
@@ -147,6 +183,15 @@ Get facts from the local system:
 $ puppet facts find
 .
 .P
+\fBshow\fR
+.
+.P
+retrieve facts:
+.
+.P
+$ puppet facts show os
+.
+.P
 \fBupload\fR
 .
 .P
@@ -162,6 +207,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
 \fBfacter\fR
 .
 .IP "\(bu" 4
+\fBjson\fR
+.
+.IP "\(bu" 4
 \fBmemory\fR
 .
 .IP "\(bu" 4

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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-FILEBUCKET" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-filebucket\fR \- Store and retrieve files in a filebucket
@@ -16,13 +16,13 @@ puppet filebucket \fImode\fR [\-h|\-\-help] [\-V|\-\-version] [\-d|\-\-debug] [\
 Puppet filebucket can operate in three modes, with only one mode per call:
 .
 .P
-backup: Send one or more files to the specified file bucket\. Each sent file is printed with its resulting md5 sum\.
+backup: Send one or more files to the specified file bucket\. Each sent file is printed with its resulting sha256 sum\.
 .
 .P
-get: Return the text associated with an md5 sum\. The text is printed to stdout, and only one file can be retrieved at a time\.
+get: Return the text associated with an sha256 sum\. The text is printed to stdout, and only one file can be retrieved at a time\.
 .
 .P
-restore: Given a file path and an md5 sum, store the content associated with the sum into the specified file path\. You can specify an entirely new path to this argument; you are not restricted to restoring the content to its original location\.
+restore: Given a file path and an sha256 sum, store the content associated with the sum into the specified file path\. You can specify an entirely new path to this argument; you are not restricted to restoring the content to its original location\.
 .
 .P
 diff: Print a diff in unified format between two checksums in the filebucket or between a checksum and its matching file\.
@@ -36,6 +36,21 @@ This is a stand\-alone filebucket client for sending files to a local or central
 .P
 Note that \'filebucket\' defaults to using a network\-based filebucket available on the server named \'puppet\'\. To use this, you\'ll have to be running as a user with valid Puppet certificates\. Alternatively, you can use your local file bucket by specifying \'\-\-local\', or by specifying \'\-\-bucket\' with a local path\.
 .
+.IP "" 4
+.
+.nf
+
+  find /opt/puppetlabs/server/data/puppetserver/bucket \-type f \-mtime +45 \-atime +45 \-print0 | xargs \-0 rm
+.
+.fi
+.
+.IP "" 0
+.
+.IP "\(bu" 4
+Restrict the directory to a maximum size after which the oldest items are removed\.
+.
+.IP "" 0
+.
 .SH "OPTIONS"
 Note that any setting that\'s valid in the configuration file is also a valid long argument\. For example, \'ssldir\' is a valid setting, so you can specify \'\-\-ssldir \fIdirectory\fR\' as an argument\.
 .
@@ -67,8 +82,12 @@ Use the local filebucket\. This uses the default configuration information and t
 Use a remote filebucket\. This uses the default configuration information and the bucket located at the \'$bucketdir\' setting by default\.
 .
 .TP
+\-\-server_list
+A list of comma separated servers; only the first entry is used for file storage\. This setting takes precidence over \fBserver\fR\.
+.
+.TP
 \-\-server
-The server to send the file to, instead of locally\.
+The server to use for file storage\. This setting is only used if \fBserver_list\fR is not set\.
 .
 .TP
 \-\-todate
@@ -133,8 +152,8 @@ $ puppet filebucket \-b /tmp/TestBucket backup /tmp/TestFile2
 $ puppet filebucket \-b /tmp/TestBucket list
 d41d8cd98f00b204e9800998ecf8427e 2015\-05\-11 09:33:22 /tmp/TestFile2
 
-## From a Puppet master, list files in the master bucketdir
-$ puppet filebucket \-b $(puppet config print bucketdir \-\-section master) list
+## From a Puppet Server, list files in the server bucketdir
+$ puppet filebucket \-b $(puppet config print bucketdir \-\-section server) list
 d43a6ecaa892a1962398ac9170ea9bf2 2015\-05\-11 09:27:56 /tmp/TestFile
 7ae322f5791217e031dc60188f4521ef 2015\-05\-11 09:52:15 /tmp/TestFile
 .

data/man/man8/puppet-generate.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-GENERATE" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-GENERATE" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-generate\fR \- Generates Puppet code from Ruby definitions\.

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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-HELP" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-help\fR \- Display Puppet help\.
@@ -34,7 +34,7 @@ Whether to log debug information\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet help [\-\-version VERSION] [\fIsubcommand\fR] [\fIaction\fR]
+puppet help [\-\-version VERSION] [\-\-ronn] [\fIsubcommand\fR] [\fIaction\fR]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -43,7 +43,10 @@ puppet help [\-\-version VERSION] [\fIsubcommand\fR] [\fIaction\fR]
 Display help about Puppet subcommands and their actions\.
 .
 .IP
-\fBOPTIONS\fR \fI\-\-version VERSION\fR \- The version of the subcommand for which to show help\.
+\fBOPTIONS\fR \fI\-\-ronn\fR \- Whether to render the help text in ronn format\.
+.
+.IP
+\fI\-\-version VERSION\fR \- The version of the subcommand for which to show help\.
 .
 .IP
 \fBRETURNS\fR

data/man/man8/puppet-lookup.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-LOOKUP" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-LOOKUP" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-lookup\fR \- Interactive Hiera lookup
@@ -22,10 +22,7 @@ The most common version of this command is:
 puppet lookup [\-\-help] [\-\-type \fITYPESTRING\fR] [\-\-merge first|unique|hash|deep] [\-\-knock\-out\-prefix \fIPREFIX\-STRING\fR] [\-\-sort\-merged\-arrays] [\-\-merge\-hash\-arrays] [\-\-explain] [\-\-environment \fIENV\fR] [\-\-default \fIVALUE\fR] [\-\-node \fINODE\-NAME\fR] [\-\-facts \fIFILE\fR] [\-\-compile] [\-\-render\-as s|json|yaml|binary|msgpack] \fIkeys\fR
 .
 .SH "DESCRIPTION"
-The lookup command is a CLI for Puppet\'s \'lookup()\' function\. It searches your Hiera data and returns a value for the requested lookup key, so you can test and explore your data\. It is a modern replacement for the \'hiera\' command\.
-.
-.P
-Hiera usually relies on a node\'s facts to locate the relevant data sources\. By default, \'puppet lookup\' uses facts from the node you run the command on, but you can get data for any other node with the \'\-\-node \fINAME\fR\' option\. If possible, the lookup command will use the requested node\'s real stored facts from PuppetDB; if PuppetDB isn\'t configured or you want to provide arbitrary fact values, you can pass alternate facts as a JSON or YAML file with \'\-\-facts \fIFILE\fR\'\.
+The lookup command is a CLI for Puppet\'s \'lookup()\' function\. It searches your Hiera data and returns a value for the requested lookup key, so you can test and explore your data\. It is a modern replacement for the \'hiera\' command\. Lookup uses the setting for global hiera\.yaml from puppet\'s config, and the environment to find the environment level hiera\.yaml as well as the resulting modulepath for the environment (for hiera\.yaml files in modules)\. Hiera usually relies on a node\'s facts to locate the relevant data sources\. By default, \'puppet lookup\' uses facts from the node you run the command on, but you can get data for any other node with the \'\-\-node \fINAME\fR\' option\. If possible, the lookup command will use the requested node\'s real stored facts from PuppetDB; if PuppetDB isn\'t configured or you want to provide arbitrary fact values, you can pass alternate facts as a JSON or YAML file with \'\-\-facts \fIFILE\fR\'\.
 .
 .P
 If you\'re debugging your Hiera data and want to see where values are coming from, use the \'\-\-explain\' option\.
@@ -54,7 +51,7 @@ For more details about how Hiera works, see the Hiera documentation: https://pup
 \-\-facts \fIFILE\fR Specify a \.json or \.yaml file of key => value mappings to override the facts for this lookup\. Any facts not specified in this file maintain their original value\.
 .
 .IP "\(bu" 4
-\-\-environment \fIENV\fR Like with most Puppet commands, you can specify an environment on the command line\. This is important for lookup because different environments can have different Hiera data\.
+\-\-environment \fIENV\fR Like with most Puppet commands, you can specify an environment on the command line\. This is important for lookup because different environments can have different Hiera data\. This environment will be always be the one used regardless of any other factors\.
 .
 .IP "\(bu" 4
 \-\-merge first|unique|hash|deep: Specify the merge behavior, overriding any merge behavior from the data\'s lookup_options\. \'first\' returns the first value found\. \'unique\' appends everything to a merged, deduplicated array\. \'hash\' performs a simple hash merge by overwriting keys of lower lookup priority\. \'deep\' performs a deep merge on values of Array and Hash type\. There are additional options that can be used with \'deep\'\.
@@ -89,6 +86,12 @@ For more details about how Hiera works, see the Hiera documentation: https://pup
 To look up \'key_name\' using the Puppet Server node\'s facts: $ puppet lookup key_name
 .
 .P
+To look up \'key_name\' using the Puppet Server node\'s arbitrary variables from a manifest, and classify the node if applicable: $ puppet lookup key_name \-\-compile
+.
+.P
+To look up \'key_name\' using the Puppet Server node\'s facts, overridden by facts given in a file: $ puppet lookup key_name \-\-facts fact_file\.yaml
+.
+.P
 To look up \'key_name\' with agent\.local\'s facts: $ puppet lookup \-\-node agent\.local key_name
 .
 .P

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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-MODULE" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.
@@ -32,10 +32,10 @@ Whether to log debug information\.
 .
 .TP
 \-\-environment production
-The environment in which Puppet is running\. For clients, such as \fBpuppet agent\fR, this determines the environment itself, which Puppet uses to find modules and much more\. For servers, such as \fBpuppet master\fR, this provides the default environment for nodes that Puppet knows nothing about\.
+The environment in which Puppet is running\. For clients, such as \fBpuppet agent\fR, this determines the environment itself, which Puppet uses to find modules and much more\. For servers, such as \fBpuppet server\fR, this provides the default environment for nodes that Puppet knows nothing about\.
 .
 .IP
-When defining an environment in the \fB[agent]\fR section, this refers to the environment that the agent requests from the master\. The environment doesn\'t have to exist on the local filesystem because the agent fetches it from the master\. This definition is used when running \fBpuppet agent\fR\.
+When defining an environment in the \fB[agent]\fR section, this refers to the environment that the agent requests from the primary server\. The environment doesn\'t have to exist on the local filesystem because the agent fetches it from the primary server\. This definition is used when running \fBpuppet agent\fR\.
 .
 .IP
 When defined in the \fB[user]\fR section, the environment refers to the path that Puppet uses to search for code and modules related to its execution\. This requires the environment to exist locally on the filesystem where puppet is being executed\. Puppet subcommands, including \fBpuppet module\fR and \fBpuppet apply\fR, use this definition\.
@@ -53,19 +53,6 @@ Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but
 .SH "ACTIONS"
 .
 .TP
-\fBbuild\fR \- Build a module release package\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet module build
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-This action has been replaced by Puppet Development Kit\. For more information visit https://puppet\.com/docs/pdk/latest/pdk\.html\.
-.
-.TP
 \fBchanges\fR \- Show modified files of an installed module\.
 \fBSYNOPSIS\fR
 .
@@ -85,19 +72,6 @@ Shows any files in a module that have been modified since it was installed\. Thi
 Array of strings representing paths of modified files\.
 .
 .TP
-\fBgenerate\fR \- Generate boilerplate for a new module\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet module generate
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-This action has been replaced by Puppet Development Kit\. For more information visit https://puppet\.com/docs/pdk/latest/pdk\.html\.
-.
-.TP
 \fBinstall\fR \- Install a module from the Puppet Forge or a release archive\.
 \fBSYNOPSIS\fR
 .
@@ -160,25 +134,6 @@ The output of this action includes information from the module\'s metadata, incl
 hash of paths to module objects
 .
 .TP
-\fBsearch\fR \- Search the Puppet Forge for a module\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet module search \fIsearch_term\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Searches a repository for modules whose names, descriptions, or keywords match the provided search term\.
-.
-.IP
-\fBRETURNS\fR
-.
-.IP
-Array of module metadata hashes
-.
-.TP
 \fBuninstall\fR \- Uninstall a puppet module\.
 \fBSYNOPSIS\fR
 .
@@ -319,15 +274,6 @@ List installed modules from a specified modulepath:
 $ puppet module list \-\-modulepath /opt/puppetlabs/puppet/modules /opt/puppetlabs/puppet/modules (no modules installed)
 .
 .P
-\fBsearch\fR
-.
-.P
-Search the Puppet Forge for a module:
-.
-.P
-$ puppet module search puppetlabs NAME DESCRIPTION AUTHOR KEYWORDS bacula This is a generic Apache module @puppetlabs backups
-.
-.P
 \fBuninstall\fR
 .
 .P

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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-NODE" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-node\fR \- View and manage node definitions\.
 .
 .SH "SYNOPSIS"
-puppet node \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet node \fIaction\fR [\-\-terminus _TERMINUS]
 .
 .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\.
@@ -31,10 +31,6 @@ 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\.
 .
@@ -51,7 +47,7 @@ The terminus for an action is often determined by context, but occasionally need
 \fBSYNOPSIS\fR
 .
 .IP
-puppet node clean [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIhost1\fR [\fIhost2\fR \.\.\.]
+puppet node clean [\-\-terminus _TERMINUS] \fIhost1\fR [\fIhost2\fR \.\.\.]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -79,7 +75,7 @@ NOTE: this action now cleans up certs via Puppet Server\'s CA API\. A running se
 \fBSYNOPSIS\fR
 .
 .IP
-puppet node find [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIhost\fR
+puppet node find [\-\-terminus _TERMINUS] \fIhost\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -101,7 +97,7 @@ RENDERING ISSUES: Rendering as string and json are currently broken; node object
 \fBSYNOPSIS\fR
 .
 .IP
-puppet node info [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet node info [\-\-terminus _TERMINUS]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -119,13 +115,13 @@ Retrieve an "empty" (no classes, no ENC\-imposed parameters, and an environment
 $ puppet node find somenode\.puppetlabs\.lan \-\-terminus plain \-\-render\-as yaml
 .
 .P
-Retrieve a node using the puppet master\'s configured ENC:
+Retrieve a node using the Puppet Server\'s configured ENC:
 .
 .P
-$ puppet node find somenode\.puppetlabs\.lan \-\-terminus exec \-\-run_mode master \-\-render\-as yaml
+$ puppet node find somenode\.puppetlabs\.lan \-\-terminus exec \-\-run_mode server \-\-render\-as yaml
 .
 .P
-Retrieve the same node from the puppet master:
+Retrieve the same node from the Puppet Server:
 .
 .P
 $ puppet node find somenode\.puppetlabs\.lan \-\-terminus rest \-\-render\-as yaml
@@ -137,6 +133,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
 \fBexec\fR
 .
 .IP "\(bu" 4
+\fBjson\fR
+.
+.IP "\(bu" 4
 \fBmemory\fR
 .
 .IP "\(bu" 4

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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-PARSER" "8" "July 2024" "Puppet, Inc." "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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-PLUGIN" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-plugin\fR \- Interact with the Puppet plugin system\.

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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-REPORT" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-report\fR \- Create, display, and submit reports\.
 .
 .SH "SYNOPSIS"
-puppet report \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet report \fIaction\fR [\-\-terminus _TERMINUS]
 .
 .SH "OPTIONS"
 Note that any setting 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 settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
@@ -28,10 +28,6 @@ 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 +44,7 @@ The terminus for an action is often determined by context, but occasionally need
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report info [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet report info [\-\-terminus _TERMINUS]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -61,7 +57,7 @@ Prints the default terminus class for this subcommand\. Note that different run
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report save [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIreport\fR
+puppet report save [\-\-terminus _TERMINUS] \fIreport\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -80,7 +76,7 @@ Nothing\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet report submit [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIreport\fR
+puppet report submit [\-\-terminus _TERMINUS] \fIreport\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -107,6 +103,9 @@ API example:report = Puppet::Face[:catalog, \'0\.0\.1\']\.apply Puppet::Face[:re
 This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of Puppet\. Valid termini for this face include:
 .
 .IP "\(bu" 4
+\fBjson\fR
+.
+.IP "\(bu" 4
 \fBmsgpack\fR
 .
 .IP "\(bu" 4

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" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-RESOURCE" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-resource\fR \- The resource abstraction layer shell
@@ -55,6 +55,10 @@ Print extra information\.
 \-\-to_yaml
 Output found resources in yaml format, suitable to use with Hiera and create_resources\.
 .
+.TP
+\-\-fail
+Fails and returns an exit code of 1 if the resource could not be modified\.
+.
 .SH "EXAMPLE"
 This example uses \fBpuppet resource\fR to return a Puppet configuration for the user \fBluke\fR:
 .

data/man/man8/puppet-script.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-SCRIPT" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-SCRIPT" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-script\fR \- Run a puppet manifests as a script without compiling a catalog
@@ -34,11 +34,14 @@ Print this help message
 .
 .TP
 \-\-logdest
-Where to send log messages\. Choose between \'syslog\' (the POSIX syslog service), \'eventlog\' (the Windows Event Log), \'console\', or the path to a log file\. Defaults to \'console\'\.
+Where to send log messages\. Choose between \'syslog\' (the POSIX syslog service), \'eventlog\' (the Windows Event Log), \'console\', or the path to a log file\. Defaults to \'console\'\. Multiple destinations can be set using a comma separated list (eg: \fB/path/file1,console,/path/file2\fR)"
 .
 .IP
 A path ending with \'\.json\' will receive structured output in JSON format\. The log file will not have an ending \']\' automatically written to it due to the appending nature of logging\. It must be appended manually to make the content valid JSON\.
 .
+.IP
+A path ending with \'\.jsonl\' will receive structured output in JSON Lines format\.
+.
 .TP
 \-\-noop
 Use \'noop\' mode where Puppet runs in a no\-op or dry\-run mode\. This is useful for seeing what changes Puppet will make without actually executing the changes\. Applies to tasks only\.

data/man/man8/puppet-ssl.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-SSL" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-SSL" "8" "July 2024" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-ssl\fR \- Manage SSL keys and certificates for puppet SSL clients
@@ -15,7 +15,7 @@ puppet ssl \fIaction\fR [\-h|\-\-help] [\-v|\-\-verbose] [\-d|\-\-debug] [\-\-lo
 .SH "OPTIONS"
 .
 .IP "\(bu" 4
-\-\-help: Print this help messsge\.
+\-\-help: Print this help message\.
 .
 .IP "\(bu" 4
 \-\-verbose: Print extra information\.
@@ -34,10 +34,18 @@ puppet ssl \fIaction\fR [\-h|\-\-help] [\-v|\-\-verbose] [\-d|\-\-debug] [\-\-lo
 .SH "ACTIONS"
 .
 .TP
+bootstrap
+Perform all of the steps necessary to request and download a client certificate\. If autosigning is disabled, then puppet will wait every \fBwaitforcert\fR seconds for its certificate to be signed\. To only attempt once and never wait, specify a time of 0\. Since \fBwaitforcert\fR is a Puppet setting, it can be specified as a time interval, such as 30s, 5m, 1h\.
+.
+.TP
 submit_request
 Generate a certificate signing request (CSR) and submit it to the CA\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\. If a CSR has already been submitted with the given \fBcertname\fR, then the operation will fail\.
 .
 .TP
+generate_request
+Generate a certificate signing request (CSR)\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\.
+.
+.TP
 download_cert
 Download a certificate for this host\. If the current private key matches the downloaded certificate, then the certificate will be saved and used for subsequent requests\. If there is already an existing certificate, it will be overwritten\.
 .
@@ -48,4 +56,8 @@ Verify the private key and certificate are present and match, verify the certifi
 .TP
 clean
 Remove the private key and certificate related files for this host\. If \fB\-\-localca\fR is specified, then also remove this host\'s local copy of the CA certificate(s) and CRL bundle\. if \fB\-\-target CERTNAME\fR is specified, then remove the files for the specified device on this host instead of this host\.
+.
+.TP
+show
+Print the full\-text version of this host\'s certificate\.