puppet 6.20.0-x86-mingw32 → 7.4.0-x86-mingw32

data/man/man5/puppet.conf.5

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPETCONF" "5" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPETCONF" "5" "February 2021" "Puppet, Inc." "Puppet manual"
 \fBThis page is autogenerated; any changes will get overwritten\fR
 .
 .SH "Configuration settings"
@@ -189,7 +189,7 @@ The certificate revocation list (CRL) for the CA\.
 The root directory for the certificate authority\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: $ssldir/ca
+\fIDefault\fR: /etc/puppetlabs/puppetserver/ca
 .
 .IP "" 0
 .
@@ -264,7 +264,7 @@ When certificate_revocation is set to \'false\', Puppet disables all certificate
 The name to use when handling certificates\. When a node requests a certificate from the CA puppet master, it uses the value of the \fBcertname\fR setting as its requested Subject CN\.
 .
 .P
-This is the name used when managing a node\'s permissions in auth\.conf \fIhttps://puppet\.com/docs/puppet/latest/config_file_auth\.html\fR\. In most cases, it is also used as the node\'s name when matching node definitions \fIhttps://puppet\.com/docs/puppet/latest/lang_node_definitions\.html\fR and requesting data from an ENC\. (This can be changed with the \fBnode_name_value\fR and \fBnode_name_fact\fR settings, although you should only do so if you have a compelling reason\.)
+This is the name used when managing a node\'s permissions in Puppet Server\'s auth\.conf \fIhttps://puppet\.com/docs/puppetserver/latest/config_file_auth\.html\fR\. In most cases, it is also used as the node\'s name when matching node definitions \fIhttps://puppet\.com/docs/puppet/latest/lang_node_definitions\.html\fR and requesting data from an ENC\. (This can be changed with the \fBnode_name_value\fR and \fBnode_name_fact\fR settings, although you should only do so if you have a compelling reason\.)
 .
 .P
 A node\'s certname is available in Puppet manifests as \fB$trusted[\'certname\']\fR\. (See Facts and Built\-In Variables \fIhttps://puppet\.com/docs/puppet/latest/lang_facts_and_builtin_vars\.html\fR for more details\.)
@@ -276,7 +276,7 @@ For best compatibility, you should limit the value of \fBcertname\fR to only use
 The special value \fBca\fR is reserved, and can\'t be used as the certname for a normal node\.
 .
 .IP
-\fBNote:\fR You must set the certname in the main section of the puppet\.conf file\. Setting it in a different section causes errors\.
+\fBNote:\fR You must set the certname in the main section of the puppet\.conf file\. Setting it in a different section causes errors\.
 .
 .IP "" 0
 .
@@ -497,10 +497,10 @@ Which arguments to pass to the diff command when printing differences between fi
 .IP "" 0
 .
 .SS "digest_algorithm"
-Which digest algorithm to use for file resources and the filebucket\. Valid values are md5, sha256, sha384, sha512, sha224\. Default is md5\.
+Which digest algorithm to use for file resources and the filebucket\. Valid values are sha256, sha384, sha512, sha224, md5\. Default is sha256\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: md5
+\fIDefault\fR: sha256
 .
 .IP "" 0
 .
@@ -508,7 +508,7 @@ Which digest algorithm to use for file resources and the filebucket\. Valid valu
 If true, turns off all translations of Puppet and module log messages, which affects error, warning, and info log messages, as well as any translations in the report and CLI\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: false
+\fIDefault\fR: true
 .
 .IP "" 0
 .
@@ -594,7 +594,7 @@ The name of a registered environment data provider used when obtaining environme
 How long the Puppet server should cache data it loads from an environment\.
 .
 .P
-A value of \fB0\fR will disable caching\. This setting can also be set to \fBunlimited\fR, which will cache environments until the server is restarted or told to refresh the cache\. All other values will result in Puppet server evicting expired environments\. The expiration time is computed based on either when the environment was created or last accessed, see \fBenvironment_timeout_mode\fR\.
+A value of \fB0\fR will disable caching\. This setting can also be set to \fBunlimited\fR, which will cache environments until the server is restarted or told to refresh the cache\. All other values will result in Puppet server evicting environments that haven\'t been used within the last \fBenvironment_timeout\fR seconds\.
 .
 .P
 You should change this setting once your Puppet deployment is doing non\-trivial work\. We chose the default value of \fB0\fR because it lets new users update their code without any extra steps, but it lowers the performance of your Puppet server\. We recommend either:
@@ -603,7 +603,7 @@ You should change this setting once your Puppet deployment is doing non\-trivial
 Setting this to \fBunlimited\fR and explicitly refreshing your Puppet server as part of your code deployment process\.
 .
 .IP "\(bu" 4
-Setting this to a number that will keep your most actively used environments cached, but allow testing environments to fall out of the cache and reduce memory usage\. A value of 3 minutes (3m) is a reasonable value\. This option requires setting \fBenvironment_timeout_mode\fR to \fBfrom_last_used\fR\.
+Setting this to a number that will keep your most actively used environments cached, but allow testing environments to fall out of the cache and reduce memory usage\. A value of 3 minutes (3m) is a reasonable value\.
 .
 .IP "" 0
 .
@@ -615,14 +615,6 @@ Once you set \fBenvironment_timeout\fR to a non\-zero value, you need to tell Pu
 .
 .IP "" 0
 .
-.SS "environment_timeout_mode"
-How Puppet interprets the \fBenvironment_timeout\fR setting when \fBenvironment_timeout\fR is neither \fB0\fR nor \fBunlimited\fR\. If set to \fBfrom_created\fR, then the environment will be evicted \fBenvironment_timeout\fR seconds from when it was created\. If set to \fBfrom_last_used\fR then the environment will be evicted \fBenvironment_timeout\fR seconds from when it was last used\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: from_created
-.
-.IP "" 0
-.
 .SS "environmentpath"
 A search path for directory environments, as a list of directories separated by the system path separator character\. (The POSIX path separator is \':\', and the Windows path separator is \';\'\.)
 .
@@ -684,14 +676,6 @@ For more info, see the ENC documentation \fIhttps://puppet\.com/docs/puppet/late
 .
 .IP "" 0
 .
-.SS "facterng"
-Whether to enable a pre\-Facter 4\.0 release of Facter (distributed as the "facter\-ng" gem)\. This is not necessary if Facter 3\.x or later is installed\. This setting is still experimental\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: false
-.
-.IP "" 0
-.
 .SS "factpath"
 Where Puppet should look for facts\. Multiple directories should be separated by the system path separator character\. (The POSIX path separator is \':\', and the Windows path separator is \';\'\.)
 .
@@ -739,22 +723,6 @@ Freezes the \'main\' class, disallowing any code to be added to it\. This essent
 .
 .IP "" 0
 .
-.SS "func3x_check"
-Causes validation of loaded legacy Ruby functions (3x API) to raise errors about illegal constructs that could cause harm or that simply does not work\. This flag is on by default\. This flag is made available so that the validation can be turned off in case the method of validation is faulty \- if encountered, please file a bug report\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: true
-.
-.IP "" 0
-.
-.SS "future_features"
-Whether or not to enable all features currently being developed for future major releases of Puppet\. Should be used with caution, as in development features are experimental and can have unexpected effects\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: false
-.
-.IP "" 0
-.
 .SS "genconfig"
 When true, causes Puppet applications to print an example config file to stdout and exit\. The example will include descriptions of each setting, and the current (or default) value of each setting, incorporating any settings overridden on the CLI (with the exception of \fBgenconfig\fR itself)\. This setting only makes sense when specified on the command line as \fB\-\-genconfig\fR\.
 .
@@ -829,10 +797,10 @@ Where the host\'s certificate revocation list can be found\. This is distinct fr
 .IP "" 0
 .
 .SS "hostcsr"
-This setting is deprecated\.
+Where individual hosts store their certificate request (CSR) while waiting for the CA to issue their certificate\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: $ssldir/csr_$certname\.pem
+\fIDefault\fR: $requestdir/$certname\.pem
 .
 .IP "" 0
 .
@@ -931,7 +899,7 @@ The time to wait for data to be read from an HTTP connection\. If nothing is rea
 The HTTP User\-Agent string to send when making network requests\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: Puppet/6\.20\.0 Ruby/2\.5\.1\-p57 (x86_64\-linux)
+\fIDefault\fR: Puppet/7\.4\.0 Ruby/2\.5\.1\-p57 (x86_64\-linux)
 .
 .IP "" 0
 .
@@ -939,7 +907,7 @@ The HTTP User\-Agent string to send when making network requests\.
 Whether the puppet run should ignore errors during pluginsync\. If the setting is false and there are errors during pluginsync, then the agent will abort the run and submit a report containing information about the failed run\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: true
+\fIDefault\fR: false
 .
 .IP "" 0
 .
@@ -979,7 +947,7 @@ The bit length of keys\.
 Where puppet agent stores the last run report summary in yaml format\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: $statedir/last_run_summary\.yaml
+\fIDefault\fR: $publicdir/last_run_summary\.yaml
 .
 .IP "" 0
 .
@@ -1305,23 +1273,12 @@ How to store cached nodes\. Valid values are (none), \'json\', \'msgpack\', or \
 .TP
 \fIDefault\fR:
 
-.
-.SS "node_name"
-How the puppet master determines the client\'s identity and sets the \'hostname\', \'fqdn\' and \'domain\' facts for use in the manifest, in particular for determining which \'node\' statement applies to the client\. Possible values are \'cert\' (use the subject\'s CN in the client\'s certificate) and \'facter\' (use the hostname that the client reported in its facts)\.
-.
-.P
-This setting is deprecated, please use explicit fact matching for classification\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: cert
-.
-.IP "" 0
 .
 .SS "node_name_fact"
-The fact name used to determine the node name used for all requests the agent makes to the master\. WARNING: This setting is mutually exclusive with node_name_value\. Changing this setting also requires changes to the default auth\.conf configuration on the Puppet Master\. Please see http://links\.puppet\.com/node_name_fact for more information\.
+The fact name used to determine the node name used for all requests the agent makes to the master\. WARNING: This setting is mutually exclusive with node_name_value\. Changing this setting also requires changes to Puppet Server\'s default auth\.conf \fIhttps://puppet\.com/docs/puppetserver/latest/config_file_auth\.html\fR\.
 .
 .SS "node_name_value"
-The explicit value used for the node name for all requests the agent makes to the master\. WARNING: This setting is mutually exclusive with node_name_fact\. Changing this setting also requires changes to the default auth\.conf configuration on the Puppet Master\. Please see http://links\.puppet\.com/node_name_value for more information\.
+The explicit value used for the node name for all requests the agent makes to the master\. WARNING: This setting is mutually exclusive with node_name_fact\. Changing this setting also requires changes to Puppet Server\'s default auth\.conf \fIhttps://puppet\.com/docs/puppetserver/latest/config_file_auth\.html\fR\.
 .
 .IP "\(bu" 4
 \fIDefault\fR: $certname
@@ -1512,6 +1469,14 @@ Whether to enable experimental performance profiling
 .
 .IP "" 0
 .
+.SS "publicdir"
+Where Puppet stores public files\.
+.
+.IP "\(bu" 4
+\fIDefault\fR: Unix/Linux: /opt/puppetlabs/puppet/public \-\- Windows: C:\eProgramData\ePuppetLabs\epuppet\epublic \-\- Non\-root user: ~/\.puppetlabs/opt/puppet/public
+.
+.IP "" 0
+.
 .SS "publickeydir"
 The public key directory\.
 .
@@ -1620,14 +1585,6 @@ The file in which puppet agent stores a list of the resources associated with th
 .
 .IP "" 0
 .
-.SS "rest_authconfig"
-The configuration file that defines the rights to the different rest indirections\. This can be used as a fine\-grained authorization system for \fBpuppet master\fR\. The \fBpuppet master\fR command is deprecated and Puppet Server uses its own auth\.conf that must be placed within its configuration directory\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: $confdir/auth\.conf
-.
-.IP "" 0
-.
 .SS "resubmit_facts"
 Whether to send updated facts after every transaction\. By default puppet only submits facts at the beginning of the transaction before applying a catalog\. Since puppet can modify the state of the system, the value of the facts may change after puppet finishes\. Therefore, any facts stored in puppetdb may not be consistent until the agent next runs, typically in 30 minutes\. If this feature is enabled, puppet will resubmit facts after applying its catalog, ensuring facts for the node stored in puppetdb are current\. However, this will double the fact submission load on puppetdb, so it is disabled by default\.
 .
@@ -1701,7 +1658,7 @@ The directory in which serialized data is stored, usually in a subdirectory\.
 .IP "" 0
 .
 .SS "server_list"
-The list of puppet master servers to which the puppet agent should connect, in the order that they will be tried\.
+The list of Puppet master servers to which the Puppet agent should connect, in the order that they will be tried\. Each value should be a fully qualified domain name, followed by an optional \':\' and port number\. If a port is omitted, Puppet uses masterport for that host\.
 .
 .IP "\(bu" 4
 \fIDefault\fR: []
@@ -1716,6 +1673,14 @@ The default port puppet subcommands use to communicate with Puppet Server\. (eg
 .
 .IP "" 0
 .
+.SS "settings_catalog"
+Whether to compile and apply the settings catalog
+.
+.IP "\(bu" 4
+\fIDefault\fR: true
+.
+.IP "" 0
+.
 .SS "show_diff"
 Whether to log and report a contextual diff when files are being replaced\. This causes partial file contents to pass through Puppet\'s normal logging and reporting system, so this setting should be used with caution if you are sending Puppet\'s reports to an insecure destination\. This feature currently requires the \fBdiff/lcs\fR Ruby library\.
 .
@@ -1774,13 +1739,6 @@ The domain which will be queried to find the SRV records of servers to use\.
 \fIDefault\fR: ci\-jenkins\-setup\-platform\.svc\.cluster\.local
 .
 .IP "" 0
-.
-.SS "ssl_client_ca_auth"
-Certificate authorities who issue server certificates\. SSL servers will not be considered authentic unless they possess a certificate issued by an authority listed in this file\. If this setting has no value then the Puppet master\'s CA certificate (localcacert) will be used\.
-.
-.TP
-\fIDefault\fR:
-
 .
 .SS "ssl_client_header"
 The header containing an authenticated client\'s SSL DN\. This header must be set by the proxy to the authenticated client\'s SSL DN (e\.g\., \fB/CN=puppet\.puppetlabs\.com\fR)\. Puppet will parse out the Common Name (CN) from the Distinguished Name (DN) and use the value of the CN field for authorization\.
@@ -1811,13 +1769,6 @@ A lock file to indicate that the ssl bootstrap process is currently in progress\
 \fIDefault\fR: $ssldir/ssl\.lock
 .
 .IP "" 0
-.
-.SS "ssl_server_ca_auth"
-The setting is deprecated and has no effect\. Ensure all root and intermediate certificate authorities used to issue client certificates are contained in the server\'s \fBcacert\fR file on the server\.
-.
-.TP
-\fIDefault\fR:
-
 .
 .SS "ssl_trust_store"
 A file containing CA certificates in PEM format that puppet should trust when making HTTPS requests\. This \fBonly\fR applies to https requests to non\-puppet infrastructure, such as retrieving file metadata and content from https file sources, puppet module tool and the \'http\' report processor\. This setting is ignored when making requests to puppet:// URLs such as catalog and report requests\.
@@ -1924,17 +1875,6 @@ Whether the agent specified environment should be considered authoritative, caus
 .
 .IP "" 0
 .
-.SS "strict_hostname_checking"
-Whether to only search for the complete hostname as it is in the certificate when searching for node information in the catalogs or to match dot delimited segments of the cert\'s certname and the hostname, fqdn, and/or domain facts\.
-.
-.P
-This setting is deprecated and will be removed in a future release\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: true
-.
-.IP "" 0
-.
 .SS "strict_variables"
 Causes an evaluation error when referencing unknown variables\. (This does not affect referencing variables that are explicitly set to undef)\.
 .
@@ -1952,10 +1892,10 @@ Whether to print a transaction summary\.
 .IP "" 0
 .
 .SS "supported_checksum_types"
-Checksum types supported by this agent for use in file resources of a static catalog\. Values must be comma\-separated\. Valid types are md5, md5lite, sha256, sha256lite, sha384, sha512, sha224, sha1, sha1lite, mtime, ctime\. Default is md5, sha256, sha384, sha512, sha224\.
+Checksum types supported by this agent for use in file resources of a static catalog\. Values must be comma\-separated\. Valid types are sha256, sha256lite, sha384, sha512, sha224, sha1, sha1lite, md5, md5lite, mtime, ctime\. Default is sha256, sha384, sha512, sha224, md5\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: ["md5", "sha256", "sha384", "sha512", "sha224"]
+\fIDefault\fR: ["sha256", "sha384", "sha512", "sha224", "md5"]
 .
 .IP "" 0
 .

data/man/man8/puppet-agent.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-AGENT" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-AGENT" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-agent\fR \- The puppet agent daemon

data/man/man8/puppet-apply.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-APPLY" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-APPLY" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-apply\fR \- Apply Puppet manifests locally

data/man/man8/puppet-catalog.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-CATALOG" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-CATALOG" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-catalog\fR \- Compile, save, view, and convert catalogs\.

data/man/man8/puppet-config.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-CONFIG" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-CONFIG" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-config\fR \- Interact with Puppet\'s settings\.

data/man/man8/puppet-describe.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-DESCRIBE" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DESCRIBE" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-describe\fR \- Display help about resource types

data/man/man8/puppet-device.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-DEVICE" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DEVICE" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-device\fR \- Manage remote network devices

data/man/man8/puppet-doc.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-DOC" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DOC" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-doc\fR \- Generate Puppet references

data/man/man8/puppet-epp.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-EPP" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-EPP" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-epp\fR \- Interact directly with the EPP template parser/renderer\.

data/man/man8/puppet-facts.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-FACTS" "8" "January 2021" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-FACTS" "8" "February 2021" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-facts\fR \- Retrieve and store facts\.
@@ -47,33 +47,11 @@ The terminus for an action is often determined by context, but occasionally need
 .SH "ACTIONS"
 .
 .TP
-\fBdiff\fR \- Compare Facter 3 output with Facter 4 output
-\fBSYNOPSIS\fR
-.
-.IP
-puppet facts diff [\-\-terminus _TERMINUS] [\-\-extra HASH]
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Compares output from facter 3 with Facter 4 and prints the differences
-.
-.IP
-\fBRETURNS\fR
-.
-.IP
-Differences between Facter 3 and Facter 4 output as an array\.
-.
-.IP
-\fBNOTES\fR
-.
-.TP
 \fBfind\fR \- Retrieve a node\'s facts\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet facts [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fInode_certname\fR]
+puppet facts find [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fInode_certname\fR]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -123,6 +101,52 @@ 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] [\-\-extra HASH] [\-\-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
 .
@@ -145,7 +169,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:
@@ -153,26 +177,23 @@ 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"
-\fBdiff\fR
+\fBfind\fR
 .
 .P
-get differences between facter versions: $ puppet facts diff
+Get facts from the local system:
 .
 .P
-\fBfind\fR
+$ puppet facts find
 .
 .P
-Get facts from the local system:
+\fBshow\fR
 .
 .P
-$ puppet facts find
+retrieve facts:
+.
+.P
+$ puppet facts show os
 .
 .P
 \fBupload\fR