puppet 5.3.5 → 5.3.6

data/locales/puppet.pot

@@ -6,11 +6,11 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Puppet automation framework 5.3.3-362-gf61e966\n"
+"Project-Id-Version: Puppet automation framework 5.3.5-413-g6525ac3\n"
 "\n"
 "Report-Msgid-Bugs-To: https://tickets.puppetlabs.com\n"
-"POT-Creation-Date: 2018-01-26 22:31+0000\n"
-"PO-Revision-Date: 2018-01-26 22:31+0000\n"
+"POT-Creation-Date: 2018-04-03 18:07+0000\n"
+"PO-Revision-Date: 2018-04-03 18:07+0000\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "Language: \n"
@@ -217,7 +217,7 @@ msgstr ""
 msgid "Exiting"
 msgstr ""
 
-#: ../lib/puppet/application/apply.rb:348
+#: ../lib/puppet/application/apply.rb:346
 msgid "Could not deserialize catalog from %{format}: %{detail}"
 msgstr ""
 
@@ -225,7 +225,11 @@ msgstr ""
 msgid "Manage certificates and requests"
 msgstr ""
 
-#: ../lib/puppet/application/cert.rb:329
+#: ../lib/puppet/application/cert.rb:272
+msgid "Refusing to destroy all certs, provide an explicit list of certs to destroy"
+msgstr ""
+
+#: ../lib/puppet/application/cert.rb:334
 msgid "You must specify the hosts to apply to; valid values are an array or the symbol :all"
 msgstr ""
 
@@ -233,22 +237,46 @@ msgstr ""
 msgid "Display help about resource types"
 msgstr ""
 
-#: ../lib/puppet/application/device.rb:66
+#: ../lib/puppet/application/device.rb:75
 msgid "Manage remote network devices"
 msgstr ""
 
-#: ../lib/puppet/application/device.rb:203
+#: ../lib/puppet/application/device.rb:211
+msgid "resource command requires target"
+msgstr ""
+
+#: ../lib/puppet/application/device.rb:216
+msgid "missing argument: --target is required when using --apply"
+msgstr ""
+
+#: ../lib/puppet/application/device.rb:220
+msgid "%{file} does not exist, cannot apply"
+msgstr ""
+
+#: ../lib/puppet/application/device.rb:238
 msgid "Target device / certificate '%{target}' not found in %{config}"
 msgstr ""
 
-#: ../lib/puppet/application/device.rb:205
+#: ../lib/puppet/application/device.rb:240
 msgid "No device found in %{config}"
 msgstr ""
 
-#: ../lib/puppet/application/device.rb:215
+#: ../lib/puppet/application/device.rb:262
+msgid "retrieving resource: %{resource} from %{target} at %{scheme}%{url_host}%{port}%{url_path}"
+msgstr ""
+
+#: ../lib/puppet/application/device.rb:294
 msgid "starting applying configuration to %{target} at %{scheme}%{url_host}%{port}%{url_path}"
 msgstr ""
 
+#: ../lib/puppet/application/device.rb:331 ../lib/puppet/application/resource.rb:196
+msgid "You must specify the type to display"
+msgstr ""
+
+#: ../lib/puppet/application/device.rb:332 ../lib/puppet/application/resource.rb:197
+msgid "Could not find type %{type}"
+msgstr ""
+
 #: ../lib/puppet/application/doc.rb:28
 msgid "Invalid output format %{arg}"
 msgstr ""
@@ -369,7 +397,7 @@ msgstr ""
 msgid "Unknown rendering format '%{format}'"
 msgstr ""
 
-#: ../lib/puppet/application/lookup.rb:350 ../lib/puppet/face/epp.rb:493
+#: ../lib/puppet/application/lookup.rb:360 ../lib/puppet/face/epp.rb:493
 msgid "Incorrect formatted data in %{fact_file} given via the --facts flag"
 msgstr ""
 
@@ -421,14 +449,6 @@ msgstr ""
 msgid "Editing with Yaml output is not supported"
 msgstr ""
 
-#: ../lib/puppet/application/resource.rb:196
-msgid "You must specify the type to display"
-msgstr ""
-
-#: ../lib/puppet/application/resource.rb:197
-msgid "Could not find type %{type}"
-msgstr ""
-
 #: ../lib/puppet/application/resource.rb:204
 msgid "Invalid parameter setting %{setting}"
 msgstr ""
@@ -526,11 +546,11 @@ msgstr ""
 msgid "Could not run command from %{setting}: %{detail}"
 msgstr ""
 
-#: ../lib/puppet/configurer.rb:433
+#: ../lib/puppet/configurer.rb:438
 msgid "Could not retrieve catalog from cache: %{detail}"
 msgstr ""
 
-#: ../lib/puppet/configurer.rb:445
+#: ../lib/puppet/configurer.rb:458
 msgid "Could not retrieve catalog from remote server: %{detail}"
 msgstr ""
 
@@ -551,7 +571,7 @@ msgid "Attempted to pop, but already at root of the context stack."
 msgstr ""
 
 #: ../lib/puppet/context.rb:55
-msgid "no '%{name}' in %{table} at top of %{stack}"
+msgid "Unable to lookup '%{name}'"
 msgstr ""
 
 #: ../lib/puppet/context.rb:80
@@ -2733,15 +2753,15 @@ msgstr ""
 msgid "Server version %{version} does not accept reports in '%{format}', use `preferred_serialization_format=pson`"
 msgstr ""
 
-#: ../lib/puppet/indirector/request.rb:96
+#: ../lib/puppet/indirector/request.rb:100
 msgid "Could not find indirection '%{indirection}'"
 msgstr ""
 
-#: ../lib/puppet/indirector/request.rb:135
+#: ../lib/puppet/indirector/request.rb:139
 msgid "HTTP REST queries cannot handle values of type '%{klass}'"
 msgstr ""
 
-#: ../lib/puppet/indirector/request.rb:190
+#: ../lib/puppet/indirector/request.rb:194
 msgid "Error connecting to %{srv_server}:%{srv_port}: %{message}"
 msgstr ""
 
@@ -2757,15 +2777,15 @@ msgstr ""
 msgid "Resource instance does not match request key"
 msgstr ""
 
-#: ../lib/puppet/indirector/rest.rb:187
+#: ../lib/puppet/indirector/rest.rb:185
 msgid "Find %{uri} resulted in 404 with the message: %{body}"
 msgstr ""
 
-#: ../lib/puppet/indirector/rest.rb:220
+#: ../lib/puppet/indirector/rest.rb:218
 msgid "DELETE does not accept options"
 msgstr ""
 
-#: ../lib/puppet/indirector/rest.rb:235
+#: ../lib/puppet/indirector/rest.rb:233
 msgid "PUT does not accept options"
 msgstr ""
 
@@ -3838,37 +3858,41 @@ msgstr ""
 msgid "Unknown content encoding - %{encoding}"
 msgstr ""
 
-#: ../lib/puppet/network/http/connection.rb:55
+#: ../lib/puppet/network/http/connection.rb:56
 msgid "Unrecognized option(s): %{opts}"
 msgstr ""
 
-#: ../lib/puppet/network/http/connection.rb:203
+#: ../lib/puppet/network/http/connection.rb:204
 msgid "Too many HTTP redirections for %{host}:%{port}"
 msgstr ""
 
 #. TRANSLATORS: Used in the phrase:
 #. "Received a response from the remote server."
-#: ../lib/puppet/network/http/connection.rb:234
+#: ../lib/puppet/network/http/connection.rb:235
 msgid "the remote server"
 msgstr ""
 
-#: ../lib/puppet/network/http/connection.rb:238
+#: ../lib/puppet/network/http/connection.rb:239
 msgid "Received a %{status_code} response from %{server_hostname}, but the Retry-After header value of \"%{retry_after}\" could not be converted to an integer or RFC 2822 date."
 msgstr ""
 
-#: ../lib/puppet/network/http/connection.rb:249
+#: ../lib/puppet/network/http/connection.rb:250
 msgid "Received a %{status_code} response from %{server_hostname}. Sleeping for %{retry_sleep} seconds before retrying the request."
 msgstr ""
 
-#: ../lib/puppet/network/http/connection.rb:320
+#: ../lib/puppet/network/http/connection.rb:306
+msgid "request %{uri} interrupted after %{elapsed} seconds"
+msgstr ""
+
+#: ../lib/puppet/network/http/connection.rb:328
 msgid "expected one of %{certnames}"
 msgstr ""
 
-#: ../lib/puppet/network/http/connection.rb:322
+#: ../lib/puppet/network/http/connection.rb:330
 msgid "expected %{certname}"
 msgstr ""
 
-#: ../lib/puppet/network/http/connection.rb:325
+#: ../lib/puppet/network/http/connection.rb:333
 msgid "Server hostname '%{host}' did not match server certificate; %{expected_certnames}"
 msgstr ""
 
@@ -4000,23 +4024,23 @@ msgstr ""
 msgid "No name provided in serialized data"
 msgstr ""
 
-#: ../lib/puppet/node.rb:100
+#: ../lib/puppet/node.rb:101
 msgid "Node names cannot be nil"
 msgstr ""
 
-#: ../lib/puppet/node.rb:136
+#: ../lib/puppet/node.rb:137
 msgid "Could not retrieve facts for %{name}: %{detail}"
 msgstr ""
 
-#: ../lib/puppet/node.rb:154
+#: ../lib/puppet/node.rb:155
 msgid "The node parameter '%{param_name}' for node '%{node_name}' was already set to '%{value}'. It could not be set to '%{desired_value}'"
 msgstr ""
 
-#: ../lib/puppet/node.rb:193
+#: ../lib/puppet/node.rb:194
 msgid "Host is missing hostname and/or domain: %{name}"
 msgstr ""
 
-#: ../lib/puppet/node.rb:225
+#: ../lib/puppet/node.rb:226
 msgid "Trusted node data modified for node %{name}"
 msgstr ""
 
@@ -8138,7 +8162,7 @@ msgid "Copying owner/mode/group from the source file on Windows is not supported
 msgstr ""
 
 #. TRANSLATORS "stat" is a program name and should not be translated
-#: ../lib/puppet/type/file.rb:837 ../lib/puppet/type/tidy.rb:332
+#: ../lib/puppet/type/file.rb:837 ../lib/puppet/type/tidy.rb:339
 msgid "Could not stat; permission denied"
 msgstr ""
 
@@ -8403,11 +8427,11 @@ msgid "Invalid tidy size %{age}"
 msgstr ""
 
 #. TRANSLATORS "Tidy" is a program name and should not be translated
-#: ../lib/puppet/type/tidy.rb:264
+#: ../lib/puppet/type/tidy.rb:271
 msgid "Tidying %{count} files"
 msgstr ""
 
-#: ../lib/puppet/type/tidy.rb:328
+#: ../lib/puppet/type/tidy.rb:335
 msgid "File does not exist"
 msgstr ""
 
@@ -9025,7 +9049,7 @@ msgstr ""
 msgid "Could not write crontab for %{path}: %{detail}"
 msgstr ""
 
-#: ../lib/puppet/util/http_proxy.rb:203
+#: ../lib/puppet/util/http_proxy.rb:205
 msgid "Too many HTTP redirections for %{uri}"
 msgstr ""
 
@@ -9291,37 +9315,31 @@ msgstr ""
 msgid "RDOC SUPPORT FOR MANIFEST HAS BEEN REMOVED - See PUP-3638"
 msgstr ""
 
-#: ../lib/puppet/util/reference.rb:16
-msgid ""
-"*This page autogenerated on %{current_time}*\n"
-msgstr ""
-
-#: ../lib/puppet/util/reference.rb:34
+#: ../lib/puppet/util/reference.rb:30
 msgid "Could not find section %{name}"
 msgstr ""
 
-#: ../lib/puppet/util/reference.rb:40
+#: ../lib/puppet/util/reference.rb:36
 msgid "creating pdf"
 msgstr ""
 
-#: ../lib/puppet/util/reference.rb:42
+#: ../lib/puppet/util/reference.rb:38
 msgid "Could not find rst2latex"
 msgstr ""
 
-#: ../lib/puppet/util/reference.rb:52
+#: ../lib/puppet/util/reference.rb:48
 msgid "rst2latex failed"
 msgstr ""
 
-#: ../lib/puppet/util/reference.rb:92
+#: ../lib/puppet/util/reference.rb:88
 msgid "%{name} Reference"
 msgstr ""
 
-#. TRANSLATORS message accompanied by date of generation
-#: ../lib/puppet/util/reference.rb:115
+#: ../lib/puppet/util/reference.rb:110
 msgid ""
 "\n"
 "\n"
-"**This page is autogenerated; any changes will get overwritten** *(last generated on %{current_time})*\n"
+"**This page is autogenerated; any changes will get overwritten**\n"
 "\n"
 msgstr ""
 
@@ -9461,39 +9479,39 @@ msgstr ""
 msgid "Value must be in DOMAIN\\user style syntax"
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:156
+#: ../lib/puppet/util/windows/adsi.rb:158
 msgid "Could not resolve name: %{name}"
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:214
+#: ../lib/puppet/util/windows/adsi.rb:216
 msgid "Puppet is not able to create/delete domain users with the user resource."
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:219
+#: ../lib/puppet/util/windows/adsi.rb:221
 msgid "User update failed: %{e}"
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:314
+#: ../lib/puppet/util/windows/adsi.rb:316
 msgid "Cannot create user if group '%{name}' exists."
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:328
+#: ../lib/puppet/util/windows/adsi.rb:330
 msgid "Failed to get user name"
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:406
+#: ../lib/puppet/util/windows/adsi.rb:408
 msgid "Cannot delete user profile for '%{sid}' prior to Vista SP1"
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:444
+#: ../lib/puppet/util/windows/adsi.rb:446
 msgid "Puppet is not able to create/delete domain groups with the group resource."
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:449
+#: ../lib/puppet/util/windows/adsi.rb:451
 msgid "Group update failed: %{error}"
 msgstr ""
 
-#: ../lib/puppet/util/windows/adsi.rb:505
+#: ../lib/puppet/util/windows/adsi.rb:502
 msgid "Cannot create group if user '%{name}' exists."
 msgstr ""
 
@@ -9556,17 +9574,17 @@ msgstr ""
 msgid "Failed to call GetLongPathName"
 msgstr ""
 
-#: ../lib/puppet/util/windows/principal.rb:67 ../lib/puppet/util/windows/principal.rb:74
-msgid "Failed to call LookupAccountNameW"
+#: ../lib/puppet/util/windows/principal.rb:68 ../lib/puppet/util/windows/principal.rb:75
+msgid "Failed to call LookupAccountNameW with account: %{account_name}"
 msgstr ""
 
 #. TRANSLATORS `lookup_account_sid` is a variable name and should not be translated
-#: ../lib/puppet/util/windows/principal.rb:97
+#: ../lib/puppet/util/windows/principal.rb:98
 msgid "Byte array for lookup_account_sid must not be nil and must be at least 1 byte long"
 msgstr ""
 
-#: ../lib/puppet/util/windows/principal.rb:119 ../lib/puppet/util/windows/principal.rb:126
-msgid "Failed to call LookupAccountSidW"
+#: ../lib/puppet/util/windows/principal.rb:120 ../lib/puppet/util/windows/principal.rb:127
+msgid "Failed to call LookupAccountSidW with bytes: %{sid_bytes}"
 msgstr ""
 
 #: ../lib/puppet/util/windows/process.rb:24
@@ -9645,7 +9663,7 @@ msgstr ""
 msgid "Failed to get volume information"
 msgstr ""
 
-#: ../lib/puppet/util/windows/security.rb:383 ../lib/puppet/util/windows/security.rb:400 ../lib/puppet/util/windows/sid.rb:127 ../lib/puppet/util/windows/sid.rb:189 ../lib/puppet/util/windows/user.rb:45
+#: ../lib/puppet/util/windows/security.rb:383 ../lib/puppet/util/windows/security.rb:400 ../lib/puppet/util/windows/sid.rb:156 ../lib/puppet/util/windows/sid.rb:218 ../lib/puppet/util/windows/user.rb:45
 msgid "Invalid SID"
 msgstr ""
 
@@ -9685,19 +9703,19 @@ msgstr ""
 msgid "Failed to set security information"
 msgstr ""
 
-#: ../lib/puppet/util/windows/sid.rb:93
+#: ../lib/puppet/util/windows/sid.rb:94
 msgid "Octet string must be an array of bytes"
 msgstr ""
 
-#: ../lib/puppet/util/windows/sid.rb:133
+#: ../lib/puppet/util/windows/sid.rb:162
 msgid "Failed to convert binary SID"
 msgstr ""
 
-#: ../lib/puppet/util/windows/sid.rb:138
+#: ../lib/puppet/util/windows/sid.rb:167
 msgid "ConvertSidToStringSidW failed to allocate buffer for sid"
 msgstr ""
 
-#: ../lib/puppet/util/windows/sid.rb:158
+#: ../lib/puppet/util/windows/sid.rb:187
 msgid "Failed to convert string SID: %{string_sid}"
 msgstr ""
 

data/man/man5/puppet.conf.5

@@ -1,10 +1,10 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPETCONF" "5" "June 2017" "Puppet Labs, LLC" "Puppet manual"
-\fBThis page is autogenerated; any changes will get overwritten\fR \fI(last generated on 2017\-06\-29 14:42:23 \-0700)\fR
+.TH "PUPPETCONF" "5" "April 2018" "Puppet, Inc." "Puppet manual"
+\fBThis page is autogenerated; any changes will get overwritten\fR
 .
-.SH "Configuration Settings"
+.SH "Configuration settings"
 .
 .IP "\(bu" 4
 Each of these settings can be specified in \fBpuppet\.conf\fR or on the command line\.
@@ -22,6 +22,9 @@ Multiple values should be specified as comma\-separated lists; multiple director
 Settings that represent time intervals should be specified in duration format: an integer immediately followed by one of the units \'y\' (years of 365 days), \'d\' (days), \'h\' (hours), \'m\' (minutes), or \'s\' (seconds)\. The unit cannot be combined with other units, and defaults to seconds when omitted\. Examples are \'3600\' which is equivalent to \'1h\' (one hour), and \'1825d\' which is equivalent to \'5y\' (5 years)\.
 .
 .IP "\(bu" 4
+If you use the \fBsplay\fR setting, note that the period that it waits changes each time the Puppet agent is restarted\.
+.
+.IP "\(bu" 4
 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
@@ -30,7 +33,7 @@ The Puppet executables will ignore any setting that isn\'t relevant to their fun
 .IP "" 0
 .
 .P
-See the configuration guide \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/config_about_settings\.html\fR for more details\.
+See the configuration guide \fIhttps://puppet\.com/docs/puppet/latest/config_about_settings\.html\fR for more details\.
 .
 .SS "agent_catalog_run_lockfile"
 A lock file to indicate that a puppet agent catalog run is currently in progress\. The file contains the pid of the process that holds the lock on the catalog run\.
@@ -268,10 +271,22 @@ The certificate directory\.
 .IP "" 0
 .
 .SS "certificate_revocation"
-Whether certificate revocation should be supported by downloading a Certificate Revocation List (CRL) to all clients\. If enabled, CA chaining will almost definitely not work\.
+Whether certificate revocation checking should be enabled, and what level of checking should be performed\.
+.
+.P
+When certificate_revocation is set to \'true\' or \'chain\', Puppet will download the CA CRL and will perform revocation checking against each certificate in the chain\.
+.
+.P
+Puppet is unable to load multiple CRLs, so if certificate_revocation is set to \'chain\' and Puppet attempts to verify a certificate signed by a root CA the behavior is equivalent to the \'leaf\' setting, and if Puppet attempts to verify a certificate signed by an intermediate CA then verification will fail as Puppet will be unable to load the multiple CRLs required for full chain checking\. As such the \'chain\' setting is limited in functionality and is meant as a stand in pending the implementation of full chain checking\.
+.
+.P
+When certificate_revocation is set to \'leaf\', Puppet will download the CA CRL and will verify the leaf certificate against that CRL\. CRLs will not be fetched or checked for the rest of the certificates in the chain\. If you are using an intermediate CA certificate and want to enable certificate revocation checking, this setting must be set to \'leaf\'\.
+.
+.P
+When certificate_revocation is set to \'false\', Puppet will disable all certificate revocation checking and will not attempt to download the CRL\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: true
+\fIDefault\fR: chain
 .
 .IP "" 0
 .
@@ -296,7 +311,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: rll\.corp\.puppetlabs\.net
+\fIDefault\fR: the Host\'s fully qualified domain name, as determined by facter
 .
 .IP "" 0
 .
@@ -503,6 +518,14 @@ Which digest algorithm to use for file resources and the filebucket\. Valid valu
 .
 .IP "" 0
 .
+.SS "disable_i18n"
+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
+.
+.IP "" 0
+.
 .SS "disable_per_environment_manifest"
 Whether to disallow an environment\-specific main manifest\. When set to \fBtrue\fR, Puppet will use the manifest specified in the \fBdefault_manifest\fR setting for all environments\. If an environment specifies a different main manifest in its \fBenvironment\.conf\fR file, catalog requests for that environment will fail with an error\.
 .
@@ -581,7 +604,16 @@ Whether to document all resources when using \fBpuppet doc\fR to generate manife
 .IP "" 0
 .
 .SS "environment"
-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 master\fR, this provides the default environment for nodes that Puppet knows nothing about\.
+.
+.P
+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\.
+.
+.P
+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\.
+.
+.P
+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\.
 .
 .IP "\(bu" 4
 \fIDefault\fR: production
@@ -728,6 +760,14 @@ Freezes the \'main\' class, disallowing any code to be added to it\. This essent
 .
 .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\.
 .
@@ -895,7 +935,7 @@ The time to wait for one block to be read from an HTTP connection\. If nothing i
 The HTTP User\-Agent string to send when making network requests\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: Puppet/5\.0\.0 Ruby/2\.4\.1\-p111 (x86_64\-darwin15)
+\fIDefault\fR: Puppet/5\.3\.6 Ruby/2\.3\.1\-p112 (x86_64\-linux)
 .
 .IP "" 0
 .
@@ -1044,6 +1084,22 @@ Where each client stores the CA certificate\.
 .
 .IP "" 0
 .
+.SS "localedest"
+Where Puppet should store translation files that it pulls down from the central server\.
+.
+.IP "\(bu" 4
+\fIDefault\fR: $vardir/locales
+.
+.IP "" 0
+.
+.SS "localesource"
+From where to retrieve translation files\. The standard Puppet \fBfile\fR type is used for retrieval, so anything that is a valid file source can be used here\.
+.
+.IP "\(bu" 4
+\fIDefault\fR: puppet:///locales
+.
+.IP "" 0
+.
 .SS "log_level"
 Default logging level for messages from Puppet\. Allowed values are:
 .
@@ -1566,6 +1622,14 @@ How often puppet agent applies the catalog\. Note that a runinterval of 0 means
 .
 .IP "" 0
 .
+.SS "runtimeout"
+The maximum amount of time an agent run is allowed to take\. A Puppet agent run that exceeds this timeout will be aborted\. Defaults to 0, which is unlimited\. 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: 0
+.
+.IP "" 0
+.
 .SS "serial"
 Where the serial number for certificates is stored\.
 .
@@ -1616,12 +1680,25 @@ Where the CA stores signed certificates\.
 .
 .SS "skip_tags"
 Tags to use to filter resources\. If this is set, then only resources not tagged with the specified tags will be applied\. Values must be comma\-separated\.
+.
+.SS "sourceaddress"
+The address the agent should use to initiate requests\.
+.
+.TP
+\fIDefault\fR:
+
 .
 .SS "splay"
-Whether to sleep for a pseudo\-random (but consistent) amount of time before a run\.
+Whether to sleep for a random amount of time, ranging from immediately up to its \fB$splaylimit\fR, before performing its first agent run after a service restart\. After this period, the agent runs periodically on its \fB$runinterval\fR\.
 .
 .P
-For example, without \fBsplay\fR enabled, your agent checks in every 30 minutes at :01 and :31 past the hour\. After enabling \fBsplay\fR, the agent will wait the pseudorandom sleep time, say eight minutes, and then check in every 30 minutes, at :09 and :39 after the hour\. If you restart the same agent at 12:45 PM, it will wait its eight minutes, and check in at 12:52 PM, and every 30 minutes after that, at 1:22 PM, 1:52 PM, and so on\. Other agents will have different sleep times, and so will check in at different times even if they are all restarted at the same time\.
+For example, assume a default 30\-minute \fB$runinterval\fR, \fBsplay\fR set to its default of \fBfalse\fR, and an agent starting at :00 past the hour\. The agent would check in every 30 minutes at :01 and :31 past the hour\.
+.
+.P
+With \fBsplay\fR enabled, it waits any amount of time up to its \fB$splaylimit\fR before its first run\. For example, it might randomly wait 8 minutes, then start its first run at :08 past the hour\. With the \fB$runinterval\fR at its default 30 minutes, its next run will be at :38 past the hour\.
+.
+.P
+If you restart an agent\'s puppet service with \fBsplay\fR enabled, it recalculates its splay period and delays its first agent run after restarting for this new period\. If you simultaneously restart a group of puppet agents with \fBsplay\fR enabled, their checkins to your puppet masters can be distributed more evenly\.
 .
 .IP "\(bu" 4
 \fIDefault\fR: false
@@ -1629,7 +1706,7 @@ For example, without \fBsplay\fR enabled, your agent checks in every 30 minutes
 .IP "" 0
 .
 .SS "splaylimit"
-The maximum time to delay before runs\. Defaults to being the same as the run interval\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
+The maximum time to delay before an agent\'s first run when \fBsplay\fR is enabled\. Defaults to the agent\'s \fB$runinterval\fR\. The \fBsplay\fR interval is random and recalculated each time the agent is started or restarted\. 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: $runinterval
@@ -1640,7 +1717,7 @@ The maximum time to delay before runs\. Defaults to being the same as the run in
 The domain which will be queried to find the SRV records of servers to use\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: corp\.puppetlabs\.net
+\fIDefault\fR: delivery\.puppetlabs\.net
 .
 .IP "" 0
 .
@@ -1903,6 +1980,4 @@ The directory in which YAML data is stored, usually in a subdirectory\.
 \fIDefault\fR: $vardir/yaml
 .
 .IP "" 0
-.
-.P
-\fIThis page autogenerated on 2017\-06\-29 14:42:23 \-0700\fR
+