puppet 6.4.5-universal-darwin → 6.5.0-universal-darwin

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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPETCONF" "5" "June 2019" "Puppet, Inc." "Puppet manual"
 \fBThis page is autogenerated; any changes will get overwritten\fR
 .
 .SH "Configuration settings"
@@ -31,7 +31,7 @@ If you use the \fBsplay\fR setting, note that the period that it waits changes e
 Settings that take a single file or directory can optionally set the owner, group, and mode for their value: \fBrundir = $vardir/run { owner = puppet, group = puppet, mode = 644 }\fR
 .
 .IP "\(bu" 4
-The Puppet executables will ignore any setting that isn\'t relevant to their function\.
+The Puppet executables ignores any setting that isn\'t relevant to their function\.
 .
 .IP "" 0
 .
@@ -274,7 +274,7 @@ The special value \fBca\fR is reserved, and can\'t be used as the certname for a
 Defaults to the node\'s fully qualified domain name\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: the Host\'s fully qualified domain name, as determined by facter
+\fIDefault\fR: the Host\'s fully qualified domain name, as determined by Facter
 .
 .IP "" 0
 .
@@ -361,6 +361,19 @@ Setting a global value for config_version in puppet\.conf is not allowed (but it
 .
 .SS "configprint"
 Prints the value of a specific configuration setting\. If the name of a setting is provided for this, then the value is printed and puppet exits\. Comma\-separate multiple values\. For a list of all values, specify \'all\'\. This setting is deprecated, the \'puppet config\' command replaces this functionality\.
+.
+.SS "crl_refresh_interval"
+How often the Puppet agent refreshes its local CRL\. By default the CRL is only downloaded once, and never refreshed\. If a duration is specified, then the agent will refresh its CRL whenever it next runs and the elapsed time since the CRL was last refreshed exceeds the duration\.
+.
+.P
+In general, the duration should be greater than the \fBruninterval\fR\. Setting it to an equal or lesser value will cause the CRL to be refreshed on every run\.
+.
+.P
+If the agent downloads a new CRL, the agent will use it for subsequent network requests\. If the refresh request fails or if the CRL is unchanged on the server, then the agent run will continue using the local CRL it already has\.This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
+.
+.TP
+\fIDefault\fR:
+
 .
 .SS "csr_attributes"
 An optional file containing custom attributes to add to certificate signing requests (CSRs)\. You should ensure that this file does not exist on your CA puppet master; if it does, unwanted certificate extensions may leak into certificates created with the \fBpuppetserver ca generate\fR command\.
@@ -433,14 +446,6 @@ Boolean; whether to generate the default schedule resources\. Setting this to fa
 .
 .IP "" 0
 .
-.SS "deviceconfdir"
-The root directory of devices\' $confdir\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: $confdir/devices
-.
-.IP "" 0
-.
 .SS "deviceconfig"
 Path to the device config file for puppet device\.
 .
@@ -769,7 +774,7 @@ The group Puppet Server will run as\. Used to ensure the agent side processes (a
 The hiera configuration file\. Puppet only reads this file on startup, so you must restart the puppet master every time you edit it\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: $confdir/hiera\.yaml\. However, if a file exists at $codedir/hiera\.yaml, Puppet uses that instead\.
+\fIDefault\fR: $confdir/hiera\.yaml\. However, for backwards compatibility, if a file exists at $codedir/hiera\.yaml, Puppet uses that instead\.
 .
 .IP "" 0
 .
@@ -838,7 +843,7 @@ The maximum amount of time a persistent HTTP connection can remain idle in the c
 .IP "" 0
 .
 .SS "http_proxy_host"
-The HTTP proxy host to use for outgoing connections\. The proxy will be bypassed if the server\'s hostname matches the NO_PROXY environment variable or \fBno_proxy\fR setting\. Note: You may need to use a FQDN for the server hostname when using a proxy\. Environment variable http_proxy or HTTP_PROXY will override this value\.
+The HTTP proxy host to use for outgoing connections\. Note: You may need to use a FQDN for the server hostname when using a proxy\. Environment variable http_proxy or HTTP_PROXY will override this value
 .
 .IP "\(bu" 4
 \fIDefault\fR: none
@@ -884,7 +889,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\.4\.5 Ruby/2\.4\.1\-p111 (x86_64\-linux)
+\fIDefault\fR: Puppet/6\.5\.0 Ruby/2\.4\.1\-p111 (x86_64\-linux)
 .
 .IP "" 0
 .
@@ -904,6 +909,14 @@ Boolean; whether puppet agent should ignore schedules\. This is useful for initi
 .
 .IP "" 0
 .
+.SS "key_type"
+The type of private key\. Valid values are \fBrsa\fR and \fBec\fR\. Default is \fBrsa\fR\.
+.
+.IP "\(bu" 4
+\fIDefault\fR: rsa
+.
+.IP "" 0
+.
 .SS "keylength"
 The bit length of keys\.
 .
@@ -1149,17 +1162,11 @@ The maximum allowed UID\. Some platforms use negative UIDs but then ship with to
 .
 .IP "" 0
 .
-.SS "merge_dependency_warnings"
-Whether to merge class\-level dependency failure warnings\.
-.
-.P
-When a class has a failed dependency, every resource in the class generates a notice level message about the dependency failure, and a warning level message about skipping the resource\.
-.
-.P
-If true, all messages caused by a class dependency failure are merged into one message associated with the class\.
+.SS "maxwaitforcert"
+The maximum amount of time the Puppet agent should wait for its certificate request to be signed\. A value of \fBunlimited\fR will cause puppet agent to ask for a signed certificate indefinitely\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: false
+\fIDefault\fR: unlimited
 .
 .IP "" 0
 .
@@ -1207,11 +1214,11 @@ The name of the application, if we are running as one\. The default is essential
 \fIDefault\fR:
 
 .
-.SS "no_proxy"
-List of host or domain names that should not go through \fBhttp_proxy_host\fR\. Environment variable no_proxy or NO_PROXY will override this value\. Names can be specified as an FQDN \fBhost\.example\.com\fR, wildcard \fB*\.example\.com\fR, dotted domain \fB\.example\.com\fR, or suffix \fBexample\.com\fR\.
+.SS "named_curve"
+The short name for the EC curve used to generate the EC private key\. Valid values must be one of the curves in \fBOpenSSL::PKey::EC\.builtin_curves\fR\. Default is \fBprime256v1\fR\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: localhost, 127\.0\.0\.1
+\fIDefault\fR: prime256v1
 .
 .IP "" 0
 .
@@ -1425,14 +1432,6 @@ The public key directory\.
 .
 .IP "" 0
 .
-.SS "puppet_trace"
-Whether to print the Puppet stack trace on some errors\. This is a noop if \fBtrace\fR is also set\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: false
-.
-.IP "" 0
-.
 .SS "puppetdlog"
 The fallback log file\. This is only used when the \fB\-\-logdest\fR option is not specified AND Puppet is running on an operating system where both the POSIX syslog service and the Windows Event Log are unavailable\. (Currently, no supported operating systems match that description\.)
 .
@@ -1525,14 +1524,6 @@ The configuration file that defines the rights to the different rest indirection
 .
 .IP "" 0
 .
-.SS "resubmit_facts"
-Whether to send updated facts after every transaction\.
-.
-.IP "\(bu" 4
-\fIDefault\fR: false
-.
-.IP "" 0
-.
 .SS "rich_data"
 Enables having extended data in the catalog by storing them as a hash with the special key \fB__ptype\fR\. When enabled, resource containing values of the data types \fBBinary\fR, \fBRegexp\fR, \fBSemVer\fR, \fBSemVerRange\fR, \fBTimespan\fR and \fBTimestamp\fR, as well as instances of types derived from \fBObject\fR retain their data type\.
 .
@@ -1693,6 +1684,14 @@ Note that the name of the HTTP header gets munged by the web server common gatew
 .
 .IP "" 0
 .
+.SS "ssl_lockfile"
+A lock file to indicate that the ssl bootstrap process is currently in progress\.
+.
+.IP "\(bu" 4
+\fIDefault\fR: $ssldir/ssl\.lock
+.
+.IP "" 0
+.
 .SS "ssl_server_ca_auth"
 Certificate authorities who issue client certificates\. SSL clients 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\.
 .
@@ -1850,7 +1849,7 @@ Turns on experimental support for tasks and plans in the puppet language\. This
 .IP "" 0
 .
 .SS "trace"
-Whether to print stack traces on some errors\. Will print internal Ruby stack trace interleaved with Puppet function frames\.
+Whether to print stack traces on some errors
 .
 .IP "\(bu" 4
 \fIDefault\fR: false
@@ -1928,7 +1927,7 @@ How frequently puppet agent should ask for a signed certificate\.
 When starting for the first time, puppet agent will submit a certificate signing request (CSR) to the server named in the \fBca_server\fR setting (usually the puppet master); this may be autosigned, or may need to be approved by a human, depending on the CA server\'s configuration\.
 .
 .P
-Puppet agent cannot apply configurations until its approved certificate is available\. Since the certificate may or may not be available immediately, puppet agent will repeatedly try to fetch it at this interval\. You can turn off waiting for certificates by specifying a time of 0, in which case puppet agent will exit if it cannot get a cert\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
+Puppet agent cannot apply configurations until its approved certificate is available\. Since the certificate may or may not be available immediately, puppet agent will repeatedly try to fetch it at this interval\. You can turn off waiting for certificates by specifying a time of 0, or a maximum amount of time to wait in the \fBmaxwaitforcert\fR setting, in which case puppet agent will exit if it cannot get a cert\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
 .
 .IP "\(bu" 4
 \fIDefault\fR: 2m

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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-AGENT" "8" "June 2019" "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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-APPLY" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-apply\fR \- Apply Puppet manifests locally
@@ -22,10 +22,10 @@ When provided with a modulepath, via command line or config file, puppet apply c
 Most users should use \'puppet agent\' and \'puppet master\' for site\-wide manifests\.
 .
 .SH "OPTIONS"
-Note that any setting that\'s valid in the configuration file is also a valid long argument\. For example, \'tags\' is a valid setting, so you can specify \'\-\-tags \fIclass\fR,\fItag\fR\' as an argument\.
+Any setting that\'s valid in the configuration file is a valid long argument for puppet apply\. For example, \'tags\' is a valid setting, so you can specify \'\-\-tags \fIclass\fR,\fItag\fR\' as an argument\.
 .
 .P
-See the configuration file documentation at https://puppet\.com/docs/puppet/latest/configuration\.html for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \'\-\-genconfig\'\.
+See the configuration file documentation at https://puppet\.com/docs/puppet/latest/configuration\.html for the full list of acceptable parameters\. You can generate a commented list of all configuration options by running puppet with \'\-\-genconfig\'\.
 .
 .IP "\(bu" 4
 \-\-debug: Enable full debugging\.

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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-CATALOG" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-catalog\fR \- Compile, save, view, and convert catalogs\.
@@ -66,6 +66,25 @@ Finds and applies a catalog\. This action takes no arguments, but the source of
 Nothing\. When used from the Ruby API, returns a Puppet::Transaction::Report object\.
 .
 .TP
+\fBcompile\fR \- Compile a catalog\.
+\fBSYNOPSIS\fR
+.
+.IP
+puppet catalog compile [\-\-terminus _TERMINUS] [\-\-extra HASH]
+.
+.IP
+\fBDESCRIPTION\fR
+.
+.IP
+Compiles a catalog locally for a node, requiring access to modules, node classifier, etc\.
+.
+.IP
+\fBRETURNS\fR
+.
+.IP
+A serialized catalog\.
+.
+.TP
 \fBdownload\fR \- Download this node\'s catalog from the puppet master server\.
 \fBSYNOPSIS\fR
 .
@@ -94,7 +113,7 @@ Nothing\.
 When used from the Ruby API, this action has a side effect of leaving Puppet::Resource::Catalog\.indirection\.terminus_class set to yaml\. The terminus must be explicitly re\-set for subsequent catalog actions\.
 .
 .TP
-\fBfind\fR \- Retrieve the catalog for a node\.
+\fBfind\fR \- Retrieve the catalog for the node from which the command is run\.
 \fBSYNOPSIS\fR
 .
 .IP
@@ -104,7 +123,7 @@ puppet catalog find [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIcertname\fR
 \fBDESCRIPTION\fR
 .
 .IP
-Retrieve the catalog for a node\.
+Retrieve the catalog for the node from which the command is run\.
 .
 .IP
 \fBRETURNS\fR
@@ -200,6 +219,15 @@ report  = Puppet::Face[:catalog, \'0\.0\.1\']\.apply
 .IP "" 0
 .
 .P
+\fBcompile\fR
+.
+.P
+Compile catalog for node \'mynode\':
+.
+.P
+$ puppet catalog compile mynode \-\-codedir \.\.\.
+.
+.P
 \fBdownload\fR
 .
 .P

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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-CONFIG" "8" "June 2019" "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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DESCRIBE" "8" "June 2019" "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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DEVICE" "8" "June 2019" "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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DOC" "8" "June 2019" "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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-EPP" "8" "June 2019" "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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-FACTS" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-facts\fR \- Retrieve and store facts\.

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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-FILEBUCKET" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-filebucket\fR \- Store and retrieve files in a filebucket

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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-GENERATE" "8" "June 2019" "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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-HELP" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-help\fR \- Display Puppet help\.

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" "January 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-KEY" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-key\fR \- Create, save, and remove certificate keys\.

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 "LOOKUP" "8" "January 2020" "Puppet, Inc." "Puppet manual"
+.TH "LOOKUP" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBlookup\fR \- Interactive Hiera lookup

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" "January 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-MAN" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-man\fR \- Display Puppet manual pages\.

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 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-MODULE" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.

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" "January 2020" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-NODE" "8" "June 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-node\fR \- View and manage node definitions\.

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