puppet 5.3.4 → 6.29.0

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" "June 2017" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-HELP" "8" "January 2023" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-help\fR \- Display Puppet help\.
@@ -13,7 +13,7 @@ puppet help \fIaction\fR
 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\.
 .
 .P
-See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
+See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/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
 \-\-render\-as FORMAT
@@ -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-key.8

@@ -1,22 +1,22 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-KEY" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-KEY" "8" "January 2023" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-key\fR \- Create, save, and remove certificate keys\.
 .
 .SH "SYNOPSIS"
-puppet key \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet key \fIaction\fR [\-\-terminus _TERMINUS]
 .
 .SH "DESCRIPTION"
-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\.
+This subcommand manages certificate private keys\. Keys are created automatically by puppet agent and when certificate requests are generated with \'puppet ssl submit_request\'; it should not be necessary to use this subcommand directly\.
 .
 .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\.
 .
 .P
-See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
+See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/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
 \-\-render\-as FORMAT
@@ -51,7 +51,7 @@ The terminus for an action is often determined by context, but occasionally need
 \fBSYNOPSIS\fR
 .
 .IP
-puppet key destroy [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIkey\fR
+puppet key destroy [\-\-terminus _TERMINUS] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -64,7 +64,7 @@ Delete an object\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet key find [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fIkey\fR]
+puppet key find [\-\-terminus _TERMINUS] [\fIkey\fR]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -77,7 +77,7 @@ Retrieve an object by name\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet key info [\-\-terminus _TERMINUS] [\-\-extra HASH]
+puppet key info [\-\-terminus _TERMINUS]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -90,7 +90,7 @@ Prints the default terminus class for this subcommand\. Note that different run
 \fBSYNOPSIS\fR
 .
 .IP
-puppet key save [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIkey\fR
+puppet key save [\-\-terminus _TERMINUS] \fIkey\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -103,7 +103,7 @@ API only: create or overwrite an object\. As the Faces framework does not curren
 \fBSYNOPSIS\fR
 .
 .IP
-puppet key search [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIquery\fR
+puppet key search [\-\-terminus _TERMINUS] \fIquery\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -115,12 +115,6 @@ Search for an object or retrieve multiple objects\.
 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
-\fBca\fR
-.
-.IP "\(bu" 4
-\fBdisabled_ca\fR
-.
-.IP "\(bu" 4
 \fBfile\fR
 .
 .IP "\(bu" 4

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" "June 2017" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-LOOKUP" "8" "January 2023" "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\.
@@ -37,7 +34,7 @@ If \'\-\-explain\' isn\'t specified, lookup exits with 0 if a value was found an
 You can provide multiple lookup keys to this command, but it only returns a value for the first found key, omitting the rest\.
 .
 .P
-For more details about how Hiera works, see the Hiera documentation: https://docs\.puppet\.com/puppet/latest/hiera_intro\.html
+For more details about how Hiera works, see the Hiera documentation: https://puppet\.com/docs/puppet/latest/hiera_intro\.html
 .
 .SH "OPTIONS"
 .
@@ -54,7 +51,7 @@ For more details about how Hiera works, see the Hiera documentation: https://doc
 \-\-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://doc
 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-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" "June 2017" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-MAN" "8" "January 2023" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-man\fR \- Display Puppet manual pages\.
@@ -10,13 +10,13 @@
 puppet man \fIaction\fR
 .
 .SH "DESCRIPTION"
-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\-formatted man pages\. If \fBronn\fR is not available, puppet man will display the raw (but human\-readable) source text in a pager\.
+Please use the command \'puppet help \fIsubcommand\fR\' or the system manpage system \'man puppet\-\fIsubcommand\fR\' to display information about Puppet subcommands\. The deprecated man 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\-formatted 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 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\.
 .
 .P
-See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
+See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/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
 \-\-render\-as FORMAT
@@ -58,10 +58,16 @@ RENDERING ISSUES: To skip fancy formatting and output the raw Markdown text (e\.
 \fBman\fR
 .
 .P
-View the manual page for a subcommand:
+View the installed manual page for the subcommand \'config\':
 .
 .P
-$ puppet man facts
+$ man puppet\-config
+.
+.P
+(Deprecated) View the manual page for the subcommand \'config\':
+.
+.P
+$ puppet man config
 .
 .SH "NOTES"
 The pager used for display will be the first found of \fB$MANPAGER\fR, \fB$PAGER\fR, \fBless\fR, \fBmost\fR, or \fBmore\fR\.

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" "June 2017" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-MODULE" "8" "January 2023" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.
@@ -16,7 +16,7 @@ This subcommand can find, install, and manage modules from the Puppet Forge, a r
 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\.
 .
 .P
-See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
+See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/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
 \-\-render\-as FORMAT
@@ -32,14 +32,23 @@ Whether to log debug information\.
 .
 .TP
 \-\-environment production
-The environment Puppet is running in\. For clients (e\.g\., \fBpuppet agent\fR) this determines the environment itself, which is used to find modules and much more\. For servers (i\.e\., \fBpuppet master\fR) this provides the default environment for nodes we know 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 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\.
+.
+.IP
+Given that the context and effects vary depending on the config section \fIhttps://puppet\.com/docs/puppet/latest/config_file_main\.html#config\-sections\fR in which the \fBenvironment\fR setting is defined, do not set it globally\.
 .
 .TP
 \-\-modulepath
 The search path for modules, as a list of directories separated by the system path separator character\. (The POSIX path separator is \':\', and the Windows path separator is \';\'\.)
 .
 .IP
-Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT\'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see \fIhttps://docs\.puppet\.com/puppet/latest/reference/environments\.html\fR
+Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT\'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see \fIhttps://puppet\.com/docs/puppet/latest/environments_about\.html\fR
 .
 .SH "ACTIONS"
 .
@@ -48,25 +57,13 @@ Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but
 \fBSYNOPSIS\fR
 .
 .IP
-puppet module build [\fIpath\fR]
+puppet module build
 .
 .IP
 \fBDESCRIPTION\fR
 .
 .IP
-Prepares a local module for release on the Puppet Forge by building a ready\-to\-upload archive file\.
-.
-.IP
-This action uses the metadata\.json file in the module directory to set metadata used by the Forge\. See \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/modules_publishing\.html\fR for more about writing metadata\.json files\.
-.
-.IP
-After being built, the release archive file can be found in the module\'s \fBpkg\fR directory\.
-.
-.IP
-\fBRETURNS\fR
-.
-.IP
-Pathname object representing the path to the release archive\.
+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\.
@@ -92,38 +89,26 @@ Array of strings representing paths of modified files\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet module generate [\-\-skip\-interview] \fIname\fR
+puppet module generate
 .
 .IP
 \fBDESCRIPTION\fR
 .
 .IP
-Generates boilerplate for a new module by creating the directory structure and files recommended for the Puppet community\'s best practices\.
-.
-.IP
-A module may need additional directories beyond this boilerplate if it provides plugins, files, or templates\.
-.
-.IP
-\fBOPTIONS\fR \fI\-\-skip\-interview\fR \- Do not attempt to perform a metadata interview\. Primarily useful for automatic execution of \fBpuppet module generate\fR\.
-.
-.IP
-\fBRETURNS\fR
-.
-.IP
-Array of Pathname objects representing paths of generated files\.
+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
 .
 .IP
-puppet module install [\-\-force | \-f] [\-\-target\-dir DIR | \-i DIR] [\-\-ignore\-dependencies] [\-\-version VER | \-v VER] [\-\-strict\-semver] \fIname\fR
+puppet module install [\-\-force | \-f] [\-\-target\-dir DIR | \-i DIR] [\-\-ignore\-dependencies] [\-\-version VER | \-v VER] \fIname\fR
 .
 .IP
 \fBDESCRIPTION\fR
 .
 .IP
-Installs a module from the Puppet Forge or from a release archive file\.
+Installs a module from the Puppet Forge or from a release archive file\. Note: Module install uses MD5 checksums, which are prohibited on FIPS enabled systems\.
 .
 .IP
 The specified module will be installed into the directory specified with the \fB\-\-target\-dir\fR option, which defaults to the first directory in the modulepath\.
@@ -135,9 +120,6 @@ The specified module will be installed into the directory specified with the \fB
 \fI\-\-ignore\-dependencies\fR \- Do not attempt to install dependencies\. Implied by \-\-force\.
 .
 .IP
-\fI\-\-strict\-semver\fR \- Whether version ranges should exclude pre\-release versions
-.
-.IP
 \fI\-\-target\-dir DIR\fR | \fI\-i DIR\fR \- The directory into which modules are installed; defaults to the first directory in the modulepath\.
 .
 .IP
@@ -157,7 +139,7 @@ Pathname object representing the path to the installed module\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet module list [\-\-tree] [\-\-strict\-semver]
+puppet module list [\-\-tree]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -169,10 +151,7 @@ Lists the installed puppet modules\. By default, this action scans the modulepat
 The output of this action includes information from the module\'s metadata, including version numbers and unmet module dependencies\.
 .
 .IP
-\fBOPTIONS\fR \fI\-\-strict\-semver\fR \- Whether version ranges should exclude pre\-release versions
-.
-.IP
-\fI\-\-tree\fR \- Whether to show dependencies as a tree view
+\fBOPTIONS\fR \fI\-\-tree\fR \- Whether to show dependencies as a tree view
 .
 .IP
 \fBRETURNS\fR
@@ -191,6 +170,9 @@ puppet module search \fIsearch_term\fR
 \fBDESCRIPTION\fR
 .
 .IP
+This action has been deprecated\. Please use the Puppet Forge to search for modules\.
+.
+.IP
 Searches a repository for modules whose names, descriptions, or keywords match the provided search term\.
 .
 .IP
@@ -204,13 +186,13 @@ Array of module metadata hashes
 \fBSYNOPSIS\fR
 .
 .IP
-puppet module uninstall [\-\-force | \-f] [\-\-ignore\-changes | \-c] [\-\-version=] [\-\-strict\-semver] \fIname\fR
+puppet module uninstall [\-\-force | \-f] [\-\-ignore\-changes | \-c] [\-\-version=] \fIname\fR
 .
 .IP
 \fBDESCRIPTION\fR
 .
 .IP
-Uninstalls a puppet module from the modulepath (or a specific target directory)\.
+Uninstalls a puppet module from the modulepath (or a specific target directory)\. Note: Module uninstall uses MD5 checksums, which are prohibited on FIPS enabled systems\.
 .
 .IP
 \fBOPTIONS\fR \fI\-\-force\fR | \fI\-f\fR \- Force the uninstall of an installed module even if there are local changes or the possibility of causing broken dependencies\.
@@ -219,9 +201,6 @@ Uninstalls a puppet module from the modulepath (or a specific target directory)\
 \fI\-\-ignore\-changes\fR | \fI\-c\fR \- Uninstall an installed module even if there are local changes to it\. (Implied by \-\-force\.)
 .
 .IP
-\fI\-\-strict\-semver\fR \- Whether version ranges should exclude pre\-release versions
-.
-.IP
 \fI\-\-version=\fR \- The version of the module to uninstall\. When using this option, a module matching the specified version must be installed or else an error is raised\.
 .
 .IP
@@ -235,13 +214,13 @@ Hash of module objects representing uninstalled modules and related errors\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet module upgrade [\-\-force | \-f] [\-\-ignore\-dependencies] [\-\-ignore\-changes | \-c] [\-\-version=] [\-\-strict\-semver] \fIname\fR
+puppet module upgrade [\-\-force | \-f] [\-\-ignore\-dependencies] [\-\-ignore\-changes | \-c] [\-\-version=] \fIname\fR
 .
 .IP
 \fBDESCRIPTION\fR
 .
 .IP
-Upgrades a puppet module\.
+Upgrades a puppet module\. Note: Module upgrade uses MD5 checksums, which are prohibited on FIPS enabled systems\.
 .
 .IP
 \fBOPTIONS\fR \fI\-\-force\fR | \fI\-f\fR \- Force the upgrade of an installed module even if there are local changes or the possibility of causing broken dependencies\. Implies \-\-ignore\-dependencies\.
@@ -253,9 +232,6 @@ Upgrades a puppet module\.
 \fI\-\-ignore\-dependencies\fR \- Do not attempt to install dependencies\. Implied by \-\-force\.
 .
 .IP
-\fI\-\-strict\-semver\fR \- Whether version ranges should exclude pre\-release versions
-.
-.IP
 \fI\-\-version=\fR \- The version of the module to upgrade to\.
 .
 .IP
@@ -265,21 +241,6 @@ Upgrades a puppet module\.
 Hash
 .
 .SH "EXAMPLES"
-\fBbuild\fR
-.
-.P
-Build a module release:
-.
-.P
-$ 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
 .
 .P
@@ -289,45 +250,6 @@ Show modified files of an installed module:
 $ puppet module changes /etc/puppetlabs/code/modules/vcsrepo/ warning: 1 files modified lib/puppet/provider/vcsrepo\.rb
 .
 .P
-\fBgenerate\fR
-.
-.P
-Generate a new module in the current directory:
-.
-.P
-$ puppet module generate puppetlabs\-ssh We need to create a metadata\.json file for this module\. Please answer the following questions; if the question is not applicable to this module, feel free to leave it blank\.
-.
-.P
-Puppet uses Semantic Versioning (semver\.org) to version modules\. What version is this module? [0\.1\.0] \-\->
-.
-.P
-Who wrote this module? [puppetlabs] \-\->
-.
-.P
-What license does this module code fall under? [Apache\-2\.0] \-\->
-.
-.P
-How would you describe this module in a single sentence? \-\->
-.
-.P
-Where is this module\'s source code repository? \-\->
-.
-.P
-Where can others go to learn more about this module? \-\->
-.
-.P
-Where can others go to file issues about this module? \-\->
-.
-.P
-{ "name": "puppetlabs\-ssh", "version": "0\.1\.0", "author": "puppetlabs", "summary": null, "license": "Apache\-2\.0", "source": "", "project_page": null, "issues_url": null, "dependencies": [ { "name": "puppetlabs\-stdlib", "version_requirement": ">= 1\.0\.0" } ]
-.
-.SH "}"
-About to generate this metadata; continue? [n/Y] \-\->
-.
-.P
-Notice: Generating module at /Users/username/Projects/puppet/puppetlabs\-ssh\.\.\. Notice: Populating ERB templates\.\.\. Finished; module generated in puppetlabs\-ssh\. puppetlabs\-ssh/manifests puppetlabs\-ssh/manifests/init\.pp puppetlabs\-ssh/metadata\.json puppetlabs\-ssh/README\.md puppetlabs\-ssh/spec puppetlabs\-ssh/spec/spec_helper\.rb puppetlabs\-ssh/tests puppetlabs\-ssh/tests/init\.pp
-.
-.P
 \fBinstall\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" "June 2017" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-NODE" "8" "January 2023" "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\.
@@ -16,7 +16,7 @@ This subcommand interacts with node objects, which are used by Puppet to build a
 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\.
 .
 .P
-See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
+See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/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
 \-\-render\-as FORMAT
@@ -51,7 +51,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
@@ -71,12 +71,15 @@ Cleans up the following information a puppet master knows about a node:
 .IP
 \fIReports\fR \- ($vardir/reports/node\.domain)
 .
+.IP
+NOTE: this action now cleans up certs via Puppet Server\'s CA API\. A running server is required for certs to be cleaned\.
+.
 .TP
 \fBfind\fR \- Retrieve a node object\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet node find [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIhost\fR
+puppet node find [\-\-terminus _TERMINUS] \fIhost\fR
 .
 .IP
 \fBDESCRIPTION\fR
@@ -98,7 +101,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
@@ -116,13 +119,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
@@ -134,7 +137,7 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
 \fBexec\fR
 .
 .IP "\(bu" 4
-\fBldap\fR
+\fBjson\fR
 .
 .IP "\(bu" 4
 \fBmemory\fR
@@ -152,9 +155,6 @@ 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