puppet 8.8.1 → 8.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (64) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +2 -0
  3. data/Gemfile.lock +37 -29
  4. data/ext/project_data.yaml +12 -0
  5. data/install.rb +3 -74
  6. data/lib/puppet/application/apply.rb +1 -0
  7. data/lib/puppet/application/filebucket.rb +6 -4
  8. data/lib/puppet/application/ssl.rb +4 -4
  9. data/lib/puppet/defaults.rb +62 -52
  10. data/lib/puppet/face/catalog.rb +24 -8
  11. data/lib/puppet/face/help.rb +43 -23
  12. data/lib/puppet/functions/capitalize.rb +1 -1
  13. data/lib/puppet/functions/find_file.rb +4 -0
  14. data/lib/puppet/functions/hiera.rb +1 -0
  15. data/lib/puppet/functions/index.rb +2 -2
  16. data/lib/puppet/functions/lookup.rb +1 -1
  17. data/lib/puppet/functions/new.rb +1 -1
  18. data/lib/puppet/functions/regsubst.rb +1 -1
  19. data/lib/puppet/functions/unique.rb +3 -2
  20. data/lib/puppet/functions/yaml_data.rb +1 -0
  21. data/lib/puppet/interface/action_manager.rb +1 -1
  22. data/lib/puppet/provider/package/pacman.rb +9 -10
  23. data/lib/puppet/reference/configuration.rb +6 -1
  24. data/lib/puppet/resource/type.rb +15 -1
  25. data/lib/puppet/settings.rb +2 -2
  26. data/lib/puppet/transaction/resource_harness.rb +7 -3
  27. data/lib/puppet/type/exec.rb +3 -4
  28. data/lib/puppet/type/file/checksum.rb +4 -2
  29. data/lib/puppet/type/file/ctime.rb +2 -2
  30. data/lib/puppet/type/file/mtime.rb +2 -2
  31. data/lib/puppet/type/file/selcontext.rb +6 -6
  32. data/lib/puppet/type/package.rb +4 -3
  33. data/lib/puppet/type/user.rb +1 -1
  34. data/lib/puppet/util/checksums.rb +1 -0
  35. data/lib/puppet/util/profiler/aggregate.rb +2 -2
  36. data/lib/puppet/util/profiler/wall_clock.rb +2 -2
  37. data/lib/puppet/util/reference.rb +0 -1
  38. data/lib/puppet/util/selinux.rb +26 -14
  39. data/lib/puppet/version.rb +1 -1
  40. data/locales/puppet.pot +71 -71
  41. data/man/man5/puppet.conf.5 +18 -18
  42. data/man/man8/puppet-agent.8 +1 -1
  43. data/man/man8/puppet-apply.8 +2 -1
  44. data/man/man8/puppet-catalog.8 +5 -2
  45. data/man/man8/puppet-config.8 +1 -1
  46. data/man/man8/puppet-describe.8 +1 -1
  47. data/man/man8/puppet-device.8 +1 -1
  48. data/man/man8/puppet-doc.8 +1 -1
  49. data/man/man8/puppet-epp.8 +1 -1
  50. data/man/man8/puppet-facts.8 +1 -1
  51. data/man/man8/puppet-filebucket.8 +10 -1
  52. data/man/man8/puppet-generate.8 +1 -1
  53. data/man/man8/puppet-help.8 +1 -1
  54. data/man/man8/puppet-lookup.8 +1 -1
  55. data/man/man8/puppet-module.8 +1 -1
  56. data/man/man8/puppet-node.8 +1 -1
  57. data/man/man8/puppet-parser.8 +1 -1
  58. data/man/man8/puppet-plugin.8 +1 -1
  59. data/man/man8/puppet-report.8 +1 -1
  60. data/man/man8/puppet-resource.8 +1 -1
  61. data/man/man8/puppet-script.8 +1 -1
  62. data/man/man8/puppet-ssl.8 +3 -3
  63. data/man/man8/puppet.8 +128 -9
  64. metadata +1 -1
@@ -55,24 +55,16 @@ module Puppet::Util::SELinux
55
55
 
56
56
  # If the file exists we should pass the mode to matchpathcon for the most specific
57
57
  # matching. If not, we can pass a mode of 0.
58
- begin
59
- filestat = file_lstat(file)
60
- mode = filestat.mode
61
- rescue Errno::EACCES
62
- mode = 0
63
- rescue Errno::ENOENT
64
- if resource_ensure
65
- mode = get_create_mode(resource_ensure)
66
- else
67
- mode = 0
68
- end
69
- end
58
+ mode = file_mode(file, resource_ensure)
70
59
 
71
60
  retval = Selinux.matchpathcon(file, mode)
72
61
  retval == -1 ? nil : retval[1]
73
62
  end
74
63
 
75
- def get_selinux_default_context_with_handle(file, handle)
64
+ # Retrieve and return the default context of the file using an selinux handle.
65
+ # If we don't have SELinux support or if the SELinux call fails to file a
66
+ # default then return nil.
67
+ def get_selinux_default_context_with_handle(file, handle, resource_ensure = nil)
76
68
  return nil unless selinux_support?
77
69
  # If the filesystem has no support for SELinux labels, return a default of nil
78
70
  # instead of what selabel_lookup would return
@@ -81,7 +73,11 @@ module Puppet::Util::SELinux
81
73
  # Handle is needed for selabel_lookup
82
74
  raise ArgumentError, _("Cannot get default context with nil handle") unless handle
83
75
 
84
- retval = Selinux.selabel_lookup(handle, file, 0)
76
+ # If the file exists we should pass the mode to selabel_lookup for the most specific
77
+ # matching. If not, we can pass a mode of 0.
78
+ mode = file_mode(file, resource_ensure)
79
+
80
+ retval = Selinux.selabel_lookup(handle, file, mode)
85
81
  retval == -1 ? nil : retval[1]
86
82
  end
87
83
 
@@ -245,6 +241,22 @@ module Puppet::Util::SELinux
245
241
  mode
246
242
  end
247
243
 
244
+ # If the file/directory/symlink exists, return its mode. Otherwise, get the default mode
245
+ # that should be used to create the file/directory/symlink taking into account the desired
246
+ # file type specified in +resource_ensure+.
247
+ def file_mode(file, resource_ensure)
248
+ filestat = file_lstat(file)
249
+ filestat.mode
250
+ rescue Errno::EACCES
251
+ 0
252
+ rescue Errno::ENOENT
253
+ if resource_ensure
254
+ get_create_mode(resource_ensure)
255
+ else
256
+ 0
257
+ end
258
+ end
259
+
248
260
  # Internal helper function to read and parse /proc/mounts
249
261
  def read_mounts
250
262
  mounts = ''.dup
@@ -8,7 +8,7 @@
8
8
  # Raketasks and such to set the version based on the output of `git describe`
9
9
 
10
10
  module Puppet
11
- PUPPETVERSION = '8.8.1'
11
+ PUPPETVERSION = '8.9.0'
12
12
 
13
13
  ##
14
14
  # version is a public API method intended to always provide a fast and
data/locales/puppet.pot CHANGED
@@ -6,11 +6,11 @@
6
6
  #, fuzzy
7
7
  msgid ""
8
8
  msgstr ""
9
- "Project-Id-Version: Puppet automation framework 8.7.0-45-g36bdec037a\n"
9
+ "Project-Id-Version: Puppet automation framework 8.8.0-49-gd70f906d86\n"
10
10
  "\n"
11
11
  "Report-Msgid-Bugs-To: https://tickets.puppetlabs.com\n"
12
- "POT-Creation-Date: 2024-07-02 16:40+0000\n"
13
- "PO-Revision-Date: 2024-07-02 16:40+0000\n"
12
+ "POT-Creation-Date: 2024-08-29 16:36+0000\n"
13
+ "PO-Revision-Date: 2024-08-29 16:36+0000\n"
14
14
  "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
15
15
  "Language-Team: LANGUAGE <LL@li.org>\n"
16
16
  "Language: \n"
@@ -196,35 +196,35 @@ msgstr ""
196
196
 
197
197
  #. TRANSLATORS "puppet apply" is a program command and should not be translated
198
198
  #. TRANSLATORS "puppet apply" is a program command and should not be translated
199
- #: ../lib/puppet/application/apply.rb:216 ../lib/puppet/application/apply.rb:343
199
+ #: ../lib/puppet/application/apply.rb:217 ../lib/puppet/application/apply.rb:344
200
200
  msgid "For puppet apply"
201
201
  msgstr ""
202
202
 
203
- #: ../lib/puppet/application/apply.rb:224
203
+ #: ../lib/puppet/application/apply.rb:225
204
204
  msgid "%{file} is not readable"
205
205
  msgstr ""
206
206
 
207
- #: ../lib/puppet/application/apply.rb:310 ../lib/puppet/application/script.rb:241
207
+ #: ../lib/puppet/application/apply.rb:311 ../lib/puppet/application/script.rb:241
208
208
  msgid "Exiting"
209
209
  msgstr ""
210
210
 
211
- #: ../lib/puppet/application/apply.rb:353
211
+ #: ../lib/puppet/application/apply.rb:354
212
212
  msgid "Could not deserialize catalog from %{format}: %{detail}"
213
213
  msgstr ""
214
214
 
215
- #: ../lib/puppet/application/apply.rb:374 ../lib/puppet/application/script.rb:148
215
+ #: ../lib/puppet/application/apply.rb:375 ../lib/puppet/application/script.rb:148
216
216
  msgid "Could not find facts for %{node}"
217
217
  msgstr ""
218
218
 
219
- #: ../lib/puppet/application/apply.rb:386 ../lib/puppet/application/script.rb:156
219
+ #: ../lib/puppet/application/apply.rb:387 ../lib/puppet/application/script.rb:156
220
220
  msgid "Could not find node %{node}"
221
221
  msgstr ""
222
222
 
223
- #: ../lib/puppet/application/apply.rb:400 ../lib/puppet/application/script.rb:140
223
+ #: ../lib/puppet/application/apply.rb:401 ../lib/puppet/application/script.rb:140
224
224
  msgid "Could not find file %{manifest}"
225
225
  msgstr ""
226
226
 
227
- #: ../lib/puppet/application/apply.rb:402
227
+ #: ../lib/puppet/application/apply.rb:403
228
228
  msgid "Only one file can be applied per run. Skipping %{files}"
229
229
  msgstr ""
230
230
 
@@ -342,27 +342,27 @@ msgstr ""
342
342
  msgid "Store and retrieve files in a filebucket"
343
343
  msgstr ""
344
344
 
345
- #: ../lib/puppet/application/filebucket.rb:228
345
+ #: ../lib/puppet/application/filebucket.rb:230
346
346
  msgid "You must specify a file to back up"
347
347
  msgstr ""
348
348
 
349
- #: ../lib/puppet/application/filebucket.rb:232
349
+ #: ../lib/puppet/application/filebucket.rb:234
350
350
  msgid "%{file}: no such file"
351
351
  msgstr ""
352
352
 
353
- #: ../lib/puppet/application/filebucket.rb:236
353
+ #: ../lib/puppet/application/filebucket.rb:238
354
354
  msgid "%{file}: cannot read file"
355
355
  msgstr ""
356
356
 
357
- #: ../lib/puppet/application/filebucket.rb:258 ../lib/puppet/application/filebucket.rb:282
357
+ #: ../lib/puppet/application/filebucket.rb:260 ../lib/puppet/application/filebucket.rb:284
358
358
  msgid "Need exactly two arguments: filebucket diff <file_a> <file_b>"
359
359
  msgstr ""
360
360
 
361
- #: ../lib/puppet/application/filebucket.rb:279
361
+ #: ../lib/puppet/application/filebucket.rb:281
362
362
  msgid "Comparing %{checksum_a} %{checksum_b} %{file_a} %{file_b}"
363
363
  msgstr ""
364
364
 
365
- #: ../lib/puppet/application/filebucket.rb:293
365
+ #: ../lib/puppet/application/filebucket.rb:295
366
366
  msgid "Cancelling"
367
367
  msgstr ""
368
368
 
@@ -744,39 +744,39 @@ msgstr ""
744
744
  msgid "a data type can only have one implementation"
745
745
  msgstr ""
746
746
 
747
- #: ../lib/puppet/defaults.rb:156
747
+ #: ../lib/puppet/defaults.rb:157
748
748
  msgid "Cannot disable unrecognized warning types '%{invalid}'."
749
749
  msgstr ""
750
750
 
751
- #: ../lib/puppet/defaults.rb:157
751
+ #: ../lib/puppet/defaults.rb:158
752
752
  msgid "Valid values are '%{values}'."
753
753
  msgstr ""
754
754
 
755
755
  #. TRANSLATORS 'data_binding_terminus' is a setting and should not be translated
756
- #: ../lib/puppet/defaults.rb:555
756
+ #: ../lib/puppet/defaults.rb:558
757
757
  msgid "Setting 'data_binding_terminus' is deprecated."
758
758
  msgstr ""
759
759
 
760
760
  #. TRANSLATORS 'hiera' should not be translated
761
- #: ../lib/puppet/defaults.rb:557
761
+ #: ../lib/puppet/defaults.rb:560
762
762
  msgid "Convert custom terminus to hiera 5 API."
763
763
  msgstr ""
764
764
 
765
765
  #. TRANSLATORS 'environment_data_provider' is a setting and should not be translated
766
- #: ../lib/puppet/defaults.rb:751
766
+ #: ../lib/puppet/defaults.rb:754
767
767
  msgid "Setting 'environment_data_provider' is deprecated."
768
768
  msgstr ""
769
769
 
770
- #: ../lib/puppet/defaults.rb:841
770
+ #: ../lib/puppet/defaults.rb:844
771
771
  msgid "Certificate names must be lower case"
772
772
  msgstr ""
773
773
 
774
- #: ../lib/puppet/defaults.rb:1100 ../lib/puppet/settings/enum_setting.rb:15 ../lib/puppet/settings/symbolic_enum_setting.rb:16
774
+ #: ../lib/puppet/defaults.rb:1103 ../lib/puppet/settings/enum_setting.rb:15 ../lib/puppet/settings/symbolic_enum_setting.rb:16
775
775
  msgid "Invalid value '%{value}' for parameter %{name}. Allowed values are '%{allowed_values}'"
776
776
  msgstr ""
777
777
 
778
778
  #. TRANSLATORS 'pluginsync' is a setting and should not be translated
779
- #: ../lib/puppet/defaults.rb:2034
779
+ #: ../lib/puppet/defaults.rb:2042
780
780
  msgid "Setting 'pluginsync' is deprecated."
781
781
  msgstr ""
782
782
 
@@ -792,7 +792,15 @@ msgstr ""
792
792
  msgid "Compile, save, view, and convert catalogs."
793
793
  msgstr ""
794
794
 
795
- #: ../lib/puppet/face/catalog.rb:89
795
+ #: ../lib/puppet/face/catalog.rb:29
796
+ msgid "Retrieve the catalog for the node from which the command is run."
797
+ msgstr ""
798
+
799
+ #: ../lib/puppet/face/catalog.rb:32
800
+ msgid "Not implemented for the CLI; facts are collected internally."
801
+ msgstr ""
802
+
803
+ #: ../lib/puppet/face/catalog.rb:103
796
804
  msgid "Compile a catalog."
797
805
  msgstr ""
798
806
 
@@ -2049,11 +2057,11 @@ msgstr ""
2049
2057
  msgid "'eyaml_lookup_key': one of 'path', 'paths' 'glob', 'globs' or 'mapped_paths' must be declared in hiera.yaml when using this lookup_key function"
2050
2058
  msgstr ""
2051
2059
 
2052
- #: ../lib/puppet/functions/eyaml_lookup_key.rb:54 ../lib/puppet/functions/yaml_data.rb:29
2060
+ #: ../lib/puppet/functions/eyaml_lookup_key.rb:54 ../lib/puppet/functions/yaml_data.rb:30
2053
2061
  msgid "%{path}: file does not contain a valid yaml hash"
2054
2062
  msgstr ""
2055
2063
 
2056
- #: ../lib/puppet/functions/eyaml_lookup_key.rb:62 ../lib/puppet/functions/yaml_data.rb:37
2064
+ #: ../lib/puppet/functions/eyaml_lookup_key.rb:62 ../lib/puppet/functions/yaml_data.rb:38
2057
2065
  msgid "Unable to parse %{message}"
2058
2066
  msgstr ""
2059
2067
 
@@ -4591,7 +4599,7 @@ msgstr ""
4591
4599
  msgid "Can only delete from an Array or Hash."
4592
4600
  msgstr ""
4593
4601
 
4594
- #: ../lib/puppet/pops/evaluator/external_syntax_support.rb:24 ../lib/puppet/pops/evaluator/runtime3_support.rb:24 ../lib/puppet/pops/evaluator/runtime3_support.rb:525
4602
+ #: ../lib/puppet/pops/evaluator/external_syntax_support.rb:24 ../lib/puppet/pops/evaluator/runtime3_support.rb:24 ../lib/puppet/pops/evaluator/runtime3_support.rb:519
4595
4603
  msgid "Internal Error: Configuration of runtime error handling wrong: should have raised exception"
4596
4604
  msgstr ""
4597
4605
 
@@ -6438,7 +6446,7 @@ msgstr ""
6438
6446
  msgid "See /var/pkg-get/admin-fullauto"
6439
6447
  msgstr ""
6440
6448
 
6441
- #: ../lib/puppet/provider/package/blastwave.rb:81 ../lib/puppet/provider/package/pkgutil.rb:75 ../lib/puppet/provider/package/pkgutil.rb:147
6449
+ #: ../lib/puppet/provider/package/blastwave.rb:81 ../lib/puppet/provider/package/pkgutil.rb:75 ../lib/puppet/provider/package/pkgutil.rb:148
6442
6450
  msgid "Cannot match %{line}"
6443
6451
  msgstr ""
6444
6452
 
@@ -6588,7 +6596,7 @@ msgstr ""
6588
6596
  msgid "Source %{source} is not supported by pacman"
6589
6597
  msgstr ""
6590
6598
 
6591
- #: ../lib/puppet/provider/package/pacman.rb:259
6599
+ #: ../lib/puppet/provider/package/pacman.rb:258
6592
6600
  msgid "Refusing to install package group %{resource_name}, because allow_virtual is false."
6593
6601
  msgstr ""
6594
6602
 
@@ -7043,51 +7051,51 @@ msgstr ""
7043
7051
  msgid "Could not evaluate: %{detail}"
7044
7052
  msgstr ""
7045
7053
 
7046
- #: ../lib/puppet/resource/type.rb:88
7054
+ #: ../lib/puppet/resource/type.rb:98
7047
7055
  msgid "Invalid resource supertype '%{type}'"
7048
7056
  msgstr ""
7049
7057
 
7050
- #: ../lib/puppet/resource/type.rb:119
7058
+ #: ../lib/puppet/resource/type.rb:129
7051
7059
  msgid "%{name} is not a class; cannot add code to it"
7052
7060
  msgstr ""
7053
7061
 
7054
- #: ../lib/puppet/resource/type.rb:120
7062
+ #: ../lib/puppet/resource/type.rb:130
7055
7063
  msgid "%{name} is not a class; cannot add code from it"
7056
7064
  msgstr ""
7057
7065
 
7058
- #: ../lib/puppet/resource/type.rb:125
7066
+ #: ../lib/puppet/resource/type.rb:135
7059
7067
  msgid "Cannot have code outside of a class/node/define because 'freeze_main' is enabled"
7060
7068
  msgstr ""
7061
7069
 
7062
- #: ../lib/puppet/resource/type.rb:129
7070
+ #: ../lib/puppet/resource/type.rb:139
7063
7071
  msgid "Cannot merge classes with different parent classes (%{name} => %{parent} vs. %{other_name} => %{other_parent})"
7064
7072
  msgstr ""
7065
7073
 
7066
- #: ../lib/puppet/resource/type.rb:160
7074
+ #: ../lib/puppet/resource/type.rb:170
7067
7075
  msgid "Cannot create resources for defined resource types"
7068
7076
  msgstr ""
7069
7077
 
7070
- #: ../lib/puppet/resource/type.rb:213
7078
+ #: ../lib/puppet/resource/type.rb:227
7071
7079
  msgid "Could not find parent resource type '%{parent}' of type %{parent_type} in %{env}"
7072
7080
  msgstr ""
7073
7081
 
7074
- #: ../lib/puppet/resource/type.rb:344
7082
+ #: ../lib/puppet/resource/type.rb:358
7075
7083
  msgid "Parameter '%{name}' is given a type, but is not a valid parameter."
7076
7084
  msgstr ""
7077
7085
 
7078
- #: ../lib/puppet/resource/type.rb:347
7086
+ #: ../lib/puppet/resource/type.rb:361
7079
7087
  msgid "Parameter '%{name}' is given a type that is not a Puppet Type, got %{class_name}"
7080
7088
  msgstr ""
7081
7089
 
7082
- #: ../lib/puppet/resource/type.rb:383
7090
+ #: ../lib/puppet/resource/type.rb:397
7083
7091
  msgid "Could not find scope for %{class_name}"
7084
7092
  msgstr ""
7085
7093
 
7086
- #: ../lib/puppet/resource/type.rb:404
7094
+ #: ../lib/puppet/resource/type.rb:418
7087
7095
  msgid "%{param} is a metaparam; this value will inherit to all contained resources in the %{name} definition"
7088
7096
  msgstr ""
7089
7097
 
7090
- #: ../lib/puppet/resource/type.rb:406
7098
+ #: ../lib/puppet/resource/type.rb:420
7091
7099
  msgid "%{param} is a metaparameter; please choose another parameter name in the %{name} definition"
7092
7100
  msgstr ""
7093
7101
 
@@ -7922,15 +7930,15 @@ msgstr ""
7922
7930
  msgid " (previously recorded value was %s)"
7923
7931
  msgstr ""
7924
7932
 
7925
- #: ../lib/puppet/transaction/resource_harness.rb:238
7933
+ #: ../lib/puppet/transaction/resource_harness.rb:239
7926
7934
  msgid "current_value %s, should be %s (noop)"
7927
7935
  msgstr ""
7928
7936
 
7929
- #: ../lib/puppet/transaction/resource_harness.rb:247
7937
+ #: ../lib/puppet/transaction/resource_harness.rb:251
7930
7938
  msgid "changed %s to %s"
7931
7939
  msgstr ""
7932
7940
 
7933
- #: ../lib/puppet/transaction/resource_harness.rb:270
7941
+ #: ../lib/puppet/transaction/resource_harness.rb:274
7934
7942
  msgid "audit change: newly-recorded value %s"
7935
7943
  msgstr ""
7936
7944
 
@@ -8071,15 +8079,15 @@ msgid "try_sleep cannot be a negative number"
8071
8079
  msgstr ""
8072
8080
 
8073
8081
  #. TRANSLATORS 'creates' is a parameter name and should not be translated
8074
- #: ../lib/puppet/type/exec.rb:455
8082
+ #: ../lib/puppet/type/exec.rb:454
8075
8083
  msgid "Checking that 'creates' path '%{creates_path}' exists"
8076
8084
  msgstr ""
8077
8085
 
8078
- #: ../lib/puppet/type/exec.rb:507 ../lib/puppet/type/exec.rb:570
8086
+ #: ../lib/puppet/type/exec.rb:506 ../lib/puppet/type/exec.rb:569
8079
8087
  msgid "Check %{value} exceeded timeout"
8080
8088
  msgstr ""
8081
8089
 
8082
- #: ../lib/puppet/type/exec.rb:673
8090
+ #: ../lib/puppet/type/exec.rb:672
8083
8091
  msgid "'%{cmd}' won't be executed because of failed check '%{check}'"
8084
8092
  msgstr ""
8085
8093
 
@@ -8170,7 +8178,7 @@ msgstr ""
8170
8178
  msgid "File written to disk did not match desired checksum; discarding changes (%{content_checksum} vs %{desired_checksum})"
8171
8179
  msgstr ""
8172
8180
 
8173
- #: ../lib/puppet/type/file/checksum.rb:22
8181
+ #: ../lib/puppet/type/file/checksum.rb:24
8174
8182
  msgid "MD5 is not supported in FIPS mode"
8175
8183
  msgstr ""
8176
8184
 
@@ -8244,23 +8252,23 @@ msgstr ""
8244
8252
  msgid "Name must be a String not %{klass}"
8245
8253
  msgstr ""
8246
8254
 
8247
- #: ../lib/puppet/type/package.rb:420
8255
+ #: ../lib/puppet/type/package.rb:421
8248
8256
  msgid "Cannot have both `ensure => disabled` and `flavor`"
8249
8257
  msgstr ""
8250
8258
 
8251
- #: ../lib/puppet/type/package.rb:519
8259
+ #: ../lib/puppet/type/package.rb:520
8252
8260
  msgid "Cannot have both `enable_only => true` and `flavor`"
8253
8261
  msgstr ""
8254
8262
 
8255
- #: ../lib/puppet/type/package.rb:522
8263
+ #: ../lib/puppet/type/package.rb:523
8256
8264
  msgid "Cannot have both `ensure => disabled` and `enable_only => true`"
8257
8265
  msgstr ""
8258
8266
 
8259
- #: ../lib/puppet/type/package.rb:683
8267
+ #: ../lib/puppet/type/package.rb:684
8260
8268
  msgid "Invalid hold value %{value}. %{doc}"
8261
8269
  msgstr ""
8262
8270
 
8263
- #: ../lib/puppet/type/package.rb:710
8271
+ #: ../lib/puppet/type/package.rb:711
8264
8272
  msgid "You cannot use \"mark\" property while \"ensure\" is one of [\"absent\", \"purged\"]"
8265
8273
  msgstr ""
8266
8274
 
@@ -9117,14 +9125,6 @@ msgstr ""
9117
9125
  msgid "%{name} Reference"
9118
9126
  msgstr ""
9119
9127
 
9120
- #: ../lib/puppet/util/reference.rb:87
9121
- msgid ""
9122
- "\n"
9123
- "\n"
9124
- "**This page is autogenerated; any changes will get overwritten**\n"
9125
- "\n"
9126
- msgstr ""
9127
-
9128
9128
  #: ../lib/puppet/util/resource_template.rb:49
9129
9129
  msgid "Template %{file} does not exist"
9130
9130
  msgstr ""
@@ -9137,35 +9137,35 @@ msgstr ""
9137
9137
  msgid "Caught exception %{klass}:%{error} retrying"
9138
9138
  msgstr ""
9139
9139
 
9140
- #: ../lib/puppet/util/selinux.rb:82
9140
+ #: ../lib/puppet/util/selinux.rb:74
9141
9141
  msgid "Cannot get default context with nil handle"
9142
9142
  msgstr ""
9143
9143
 
9144
- #: ../lib/puppet/util/selinux.rb:98
9144
+ #: ../lib/puppet/util/selinux.rb:94
9145
9145
  msgid "Invalid context to parse: %{context}"
9146
9146
  msgstr ""
9147
9147
 
9148
- #: ../lib/puppet/util/selinux.rb:111
9148
+ #: ../lib/puppet/util/selinux.rb:107
9149
9149
  msgid "Invalid SELinux parameter type"
9150
9150
  msgstr ""
9151
9151
 
9152
- #: ../lib/puppet/util/selinux.rb:132
9152
+ #: ../lib/puppet/util/selinux.rb:128
9153
9153
  msgid "Can't set SELinux context on file unless the file already has some kind of context"
9154
9154
  msgstr ""
9155
9155
 
9156
- #: ../lib/puppet/util/selinux.rb:146
9156
+ #: ../lib/puppet/util/selinux.rb:142
9157
9157
  msgid "set_selinux_context component must be one of :seluser, :selrole, :seltype, or :selrange"
9158
9158
  msgstr ""
9159
9159
 
9160
- #: ../lib/puppet/util/selinux.rb:157
9160
+ #: ../lib/puppet/util/selinux.rb:153
9161
9161
  msgid "Failed to set SELinux context %{context} on %{file}"
9162
9162
  msgstr ""
9163
9163
 
9164
- #: ../lib/puppet/util/selinux.rb:210
9164
+ #: ../lib/puppet/util/selinux.rb:206
9165
9165
  msgid "Could not open SELinux category translation file %{path}."
9166
9166
  msgstr ""
9167
9167
 
9168
- #: ../lib/puppet/util/selinux.rb:298
9168
+ #: ../lib/puppet/util/selinux.rb:310
9169
9169
  msgid "got a relative path in SELinux find_fs: %{path}"
9170
9170
  msgstr ""
9171
9171
 
@@ -1,8 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPETCONF" "5" "July 2024" "Puppet, Inc." "Puppet manual"
5
- \fBThis page is autogenerated; any changes will get overwritten\fR
4
+ .TH "PUPPETCONF" "5" "September 2024" "Puppet, Inc." "Puppet manual"
6
5
  .
7
6
  .SH "Configuration settings"
8
7
  .
@@ -63,7 +62,7 @@ Whether to allow a new certificate request to overwrite an existing certificate
63
62
  .IP "" 0
64
63
  .
65
64
  .SS "allow_pson_serialization"
66
- Whether when unable to serialize to JSON or other formats, Puppet falls back to PSON\. This option affects both puppetserver\'s configuration management service responses and when the agent saves its cached catalog\. This option is useful in preventing the loss of data because rich data cannot be serialized via PSON\.
65
+ Whether to allow PSON serialization\. When unable to serialize to JSON or other formats, Puppet falls back to PSON\. This option affects the configuration management service responses of Puppet Server and the process by which the agent saves its cached catalog\. With a default value of \fBfalse\fR, this option is useful in preventing the loss of data because rich data cannot be serialized via PSON\.
67
66
  .
68
67
  .IP "\(bu" 4
69
68
  \fIDefault\fR: \fBfalse\fR
@@ -164,13 +163,13 @@ The port to use for the certificate authority\.
164
163
  .IP "" 0
165
164
  .
166
165
  .SS "ca_refresh_interval"
167
- How often the Puppet agent refreshes its local CA certs\. By default the CA certs are refreshed once every 24 hours\. If a different duration is specified, then the agent will refresh its CA certs whenever it next runs and the elapsed time since the certs were last refreshed exceeds the duration\.
166
+ How often the Puppet agent refreshes its local CA certificates\. By default, CA certificates are refreshed every 24 hours\. If a different interval is specified, the agent refreshes its CA certificates during the next agent run if the elapsed time since the certificates were last refreshed exceeds the specified duration\.
168
167
  .
169
168
  .P
170
- In general, the duration should be greater than the \fBruninterval\fR\. Setting it to 0 or an equal or lesser value than \fBruninterval\fR, will cause the CA certs to be refreshed on every run\.
169
+ In general, the interval should be greater than the \fBruninterval\fR value\. Setting the \fBca_refresh_interval\fR value to 0 or an equal or lesser value than \fBruninterval\fR causes the CA certificates to be refreshed on every run\.
171
170
  .
172
171
  .P
173
- If the agent downloads new CA certs, the agent will use it for subsequent network requests\. If the refresh request fails or if the CA certs are unchanged on the server, then the agent run will continue using the local CA certs it already has\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
172
+ If the agent downloads new CA certs, the agent uses those for subsequent network requests\. If the refresh request fails or if the CA certs are unchanged on the server, then the agent run will continue using the local CA certs it already has\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
174
173
  .
175
174
  .IP "\(bu" 4
176
175
  \fIDefault\fR: \fB1d\fR
@@ -406,10 +405,10 @@ Setting a global value for config_version in puppet\.conf is not allowed (but it
406
405
  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\.
407
406
  .
408
407
  .SS "crl_refresh_interval"
409
- How often the Puppet agent refreshes its local CRL\. By default the CRL is refreshed once every 24 hours\. If a different 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\.
408
+ How often the Puppet agent refreshes its local Certificate Revocation List (CRL)\. By default, the CRL is refreshed every 24 hours\. If a different interval is specified, the agent refreshes its CRL on the next Puppet agent run if the elapsed time since the CRL was last refreshed exceeds the specified interval\.
410
409
  .
411
410
  .P
412
- In general, the duration should be greater than the \fBruninterval\fR\. Setting it to 0 or an equal or lesser value than \fBruninterval\fR, will cause the CRL to be refreshed on every run\.
411
+ In general, the interval should be greater than the \fBruninterval\fR value\. Setting the \fBcrl_refresh_interval\fR value to 0 or an equal or lesser value than \fBruninterval\fR causes the CRL to be refreshed on every run\.
413
412
  .
414
413
  .P
415
414
  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)\.
@@ -670,7 +669,7 @@ Whether each resource should log when it is being evaluated\. This allows you to
670
669
  .IP "" 0
671
670
  .
672
671
  .SS "exclude_unchanged_resources"
673
- When set to true, resources that have had no changes after catalog application will not have corresponding unchanged resource status updates listed in the report\.
672
+ Specifies how unchanged resources are listed in reports\. When set to \fBtrue\fR, resources that have had no changes after catalog application will not have corresponding unchanged resource status updates listed in a report\.
674
673
  .
675
674
  .IP "\(bu" 4
676
675
  \fIDefault\fR: \fBtrue\fR
@@ -690,6 +689,7 @@ This setting\'s value must be the path to an executable command that can produce
690
689
  Take the name of a node as a command\-line argument\.
691
690
  .
692
691
  .IP "\(bu" 4
692
+ Return a YAML hash with up to three keys:
693
693
  .
694
694
  .IP "\(bu" 4
695
695
  \fBclasses\fR \-\-\- A list of classes, as an array or hash\.
@@ -849,13 +849,13 @@ Where individual hosts store and look for their certificates\.
849
849
  .IP "" 0
850
850
  .
851
851
  .SS "hostcert_renewal_interval"
852
- When the Puppet agent refreshes its client certificate\. By default the client certificate will refresh 30 days before the certificate expires\. If a different duration is specified, then the agent will refresh its client certificate whenever it next runs and if the client certificate expires within the duration specified\.
852
+ How often the Puppet agent renews its client certificate\. By default, the client certificate is renewed 30 days before the certificate expires\. If a different interval is specified, the agent renews its client certificate during the next agent run, assuming that the client certificate has expired within the specified duration\.
853
853
  .
854
854
  .P
855
- In general, the duration should be greater than the \fBruninterval\fR\. Setting it to 0 will disable automatic renewal\.
855
+ In general, the \fBhostcert_renewal_interval\fR value should be greater than the \fBruninterval\fR value\. Setting the \fBhostcert_renewal_interval\fR value to 0 disables automatic renewal\.
856
856
  .
857
857
  .P
858
- If the agent downloads a new certificate, the agent will use it for subsequent network requests\. If the refresh request fails, then the agent run will continue using the certificate it already has\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
858
+ If the agent downloads a new certificate, the agent will use it for subsequent network requests\. If the refresh request fails, the agent run continues to use its existing certificate\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
859
859
  .
860
860
  .IP "\(bu" 4
861
861
  \fIDefault\fR: \fB30d\fR
@@ -973,7 +973,7 @@ The time to wait for data to be read from an HTTP connection\. If nothing is rea
973
973
  The HTTP User\-Agent string to send when making network requests\.
974
974
  .
975
975
  .IP "\(bu" 4
976
- \fIDefault\fR: \fBPuppet/8\.8\.0 Ruby/3\.1\.1\-p18 (x86_64\-linux)\fR
976
+ \fIDefault\fR: \fBPuppet/<version> Ruby/<version> (<architecture>)\fR
977
977
  .
978
978
  .IP "" 0
979
979
  .
@@ -1002,7 +1002,7 @@ Boolean; whether puppet agent should ignore schedules\. This is useful for initi
1002
1002
  .IP "" 0
1003
1003
  .
1004
1004
  .SS "include_legacy_facts"
1005
- Whether to include legacy facts when requesting a catalog\. This option can be set to false provided all puppet manifests, hiera\.yaml and hiera configuration layers no longer access legacy facts, such as \fB$osfamily\fR, and instead access structured facts, such as \fB$facts[\'os\'][\'family\']\fR\.
1005
+ Whether to include legacy facts when requesting a catalog\. This option can be set to \fBfalse\fR if all puppet manifests, hiera\.yaml, and hiera configuration layers no longer access legacy facts, such as \fB$osfamily\fR, and instead access structured facts, such as \fB$facts[\'os\'][\'family\']\fR\.
1006
1006
  .
1007
1007
  .IP "\(bu" 4
1008
1008
  \fIDefault\fR: \fBfalse\fR
@@ -1539,7 +1539,7 @@ The preferred means of serializing ruby instances for passing over the wire\. Th
1539
1539
  .IP "" 0
1540
1540
  .
1541
1541
  .SS "preprocess_deferred"
1542
- Whether puppet should call deferred functions before applying the catalog\. If set to \fBtrue\fR, then all prerequisites needed for the deferred function must be satisfied prior to puppet running\. If set to \fBfalse\fR, then deferred functions will follow puppet relationships and ordering\. This allows puppet to install prerequisites needed for a deferred function and call the deferred function in the same run\.
1542
+ Whether Puppet should call deferred functions before applying the catalog\. If set to \fBtrue\fR, all prerequisites required for the deferred function must be satisfied before the Puppet run\. If set to \fBfalse\fR, deferred functions follow Puppet relationships and ordering\. In this way, Puppet can install the prerequisites required for a deferred function and call the deferred function in the same run\.
1543
1543
  .
1544
1544
  .IP "\(bu" 4
1545
1545
  \fIDefault\fR: \fBfalse\fR
@@ -1636,10 +1636,10 @@ Whether to send reports after every transaction\.
1636
1636
  .IP "" 0
1637
1637
  .
1638
1638
  .SS "report_configured_environmentpath"
1639
- When versioned_environment_dirs is \fBtrue\fR Puppet will readlink the environmentpath when constructing the environment\'s modulepath\. The full readlinked path is referred to as the "resolved path" and the configured path potentially containing symlinks is the "configured path"\. When reporting where resources come from users may choose between the configured or resolved path\.
1639
+ Specifies how environment paths are reported\. When the value of \fBversioned_environment_dirs\fR is \fBtrue\fR, Puppet applies the readlink function to the \fBenvironmentpath\fR setting when constructing the environment\'s modulepath\. The full readlinked path is referred to as the "resolved path," and the configured path potentially containing symlinks is the "configured path\." When reporting where resources come from, users may choose between the configured and resolved path\.
1640
1640
  .
1641
1641
  .P
1642
- When set to false, the resolved paths are reported instead of the configured paths\.
1642
+ When set to \fBfalse\fR, the resolved paths are reported instead of the configured paths\.
1643
1643
  .
1644
1644
  .IP "\(bu" 4
1645
1645
  \fIDefault\fR: \fBtrue\fR
@@ -1832,7 +1832,7 @@ Where the CA stores signed certificates\.
1832
1832
  .IP "" 0
1833
1833
  .
1834
1834
  .SS "skip_logging_catalog_request_destination"
1835
- If you wish to suppress the notice of which compiler supplied the catalog
1835
+ Specifies whether to suppress the notice of which compiler supplied the catalog\. A value of \fBtrue\fR suppresses the notice\.
1836
1836
  .
1837
1837
  .IP "\(bu" 4
1838
1838
  \fIDefault\fR: \fBfalse\fR
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-AGENT" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-AGENT" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-agent\fR \- The puppet agent daemon
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-APPLY" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-APPLY" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-apply\fR \- Apply Puppet manifests locally
@@ -87,6 +87,7 @@ A path ending with \'\.jsonl\' will receive structured output in JSON Lines form
87
87
  .
88
88
  .nf
89
89
 
90
+ $ puppet apply \-e \'notify { "hello world": }\'
90
91
  $ puppet apply \-l /tmp/manifest\.log manifest\.pp
91
92
  $ puppet apply \-\-modulepath=/root/dev/modules \-e "include ntpd::server"
92
93
  $ puppet apply \-\-catalog catalog\.json