openvox 9.0.0.pre.alpha2 → 9.0.0.pre.beta2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (278) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +114 -1
  3. data/CODE_OF_CONDUCT.md +1 -1
  4. data/Gemfile +5 -5
  5. data/README.md +6 -6
  6. data/Rakefile +3 -3
  7. data/conf/environment.conf +2 -2
  8. data/conf/fileserver.conf +3 -3
  9. data/conf/puppet.conf +4 -4
  10. data/examples/enc/regexp_nodes/regexp_nodes.rb +2 -2
  11. data/examples/hiera/README.md +1 -1
  12. data/examples/nagios/check_puppet.rb +1 -1
  13. data/ext/README.md +3 -3
  14. data/ext/hiera/hiera.yaml +1 -1
  15. data/ext/project_data.yaml +1 -1
  16. data/ext/redhat/client.sysconfig +1 -0
  17. data/ext/solaris/smf/puppet.xml +2 -2
  18. data/ext/windows/puppet_interactive.bat +1 -1
  19. data/ext/windows/service/daemon.rb +5 -5
  20. data/lib/hiera/puppet_function.rb +1 -2
  21. data/lib/hiera_puppet.rb +1 -1
  22. data/lib/puppet/agent/disabler.rb +3 -3
  23. data/lib/puppet/agent/locker.rb +1 -1
  24. data/lib/puppet/agent.rb +2 -2
  25. data/lib/puppet/application/agent.rb +33 -35
  26. data/lib/puppet/application/apply.rb +7 -7
  27. data/lib/puppet/application/describe.rb +3 -3
  28. data/lib/puppet/application/device.rb +1 -1
  29. data/lib/puppet/application/doc.rb +5 -7
  30. data/lib/puppet/application/facts.rb +1 -1
  31. data/lib/puppet/application/filebucket.rb +5 -5
  32. data/lib/puppet/application/lookup.rb +8 -8
  33. data/lib/puppet/application/resource.rb +5 -5
  34. data/lib/puppet/application/script.rb +3 -3
  35. data/lib/puppet/application/ssl.rb +4 -4
  36. data/lib/puppet/application_support.rb +2 -2
  37. data/lib/puppet/configurer.rb +13 -7
  38. data/lib/puppet/confine/variable.rb +2 -2
  39. data/lib/puppet/context.rb +1 -1
  40. data/lib/puppet/data_binding.rb +1 -1
  41. data/lib/puppet/defaults.rb +157 -226
  42. data/lib/puppet/error.rb +1 -1
  43. data/lib/puppet/etc.rb +4 -4
  44. data/lib/puppet/face/catalog/select.rb +3 -3
  45. data/lib/puppet/face/catalog.rb +4 -4
  46. data/lib/puppet/face/config.rb +6 -6
  47. data/lib/puppet/face/facts.rb +6 -6
  48. data/lib/puppet/face/help/man.erb +3 -3
  49. data/lib/puppet/face/node/clean.rb +3 -3
  50. data/lib/puppet/face/node.rb +2 -2
  51. data/lib/puppet/face/plugin.rb +4 -4
  52. data/lib/puppet/functions/all.rb +4 -4
  53. data/lib/puppet/functions/any.rb +4 -4
  54. data/lib/puppet/functions/assert_type.rb +5 -5
  55. data/lib/puppet/functions/defined.rb +1 -1
  56. data/lib/puppet/functions/each.rb +11 -11
  57. data/lib/puppet/functions/epp.rb +5 -5
  58. data/lib/puppet/functions/eyaml_lookup_key.rb +1 -1
  59. data/lib/puppet/functions/filter.rb +5 -5
  60. data/lib/puppet/functions/find_file.rb +1 -1
  61. data/lib/puppet/functions/hiera.rb +4 -4
  62. data/lib/puppet/functions/hiera_array.rb +5 -5
  63. data/lib/puppet/functions/hiera_hash.rb +5 -5
  64. data/lib/puppet/functions/hiera_include.rb +6 -6
  65. data/lib/puppet/functions/hocon_data.rb +1 -1
  66. data/lib/puppet/functions/include.rb +1 -1
  67. data/lib/puppet/functions/index.rb +3 -3
  68. data/lib/puppet/functions/inline_epp.rb +6 -6
  69. data/lib/puppet/functions/json_data.rb +1 -1
  70. data/lib/puppet/functions/lest.rb +1 -1
  71. data/lib/puppet/functions/lookup.rb +14 -14
  72. data/lib/puppet/functions/map.rb +5 -5
  73. data/lib/puppet/functions/reduce.rb +6 -6
  74. data/lib/puppet/functions/regsubst.rb +1 -13
  75. data/lib/puppet/functions/reverse_each.rb +5 -5
  76. data/lib/puppet/functions/scanf.rb +1 -1
  77. data/lib/puppet/functions/step.rb +5 -5
  78. data/lib/puppet/functions/then.rb +1 -1
  79. data/lib/puppet/functions/tree_each.rb +3 -3
  80. data/lib/puppet/functions/versioncmp.rb +1 -1
  81. data/lib/puppet/functions/with.rb +2 -2
  82. data/lib/puppet/functions/yaml_data.rb +1 -1
  83. data/lib/puppet/generate/type.rb +5 -1
  84. data/lib/puppet/gettext/config.rb +5 -5
  85. data/lib/puppet/gettext/module_translations.rb +1 -1
  86. data/lib/puppet/graph/simple_graph.rb +0 -1
  87. data/lib/puppet/http/client.rb +5 -5
  88. data/lib/puppet/http/factory.rb +1 -1
  89. data/lib/puppet/http/resolver/server_list.rb +2 -2
  90. data/lib/puppet/http/service/compiler.rb +3 -3
  91. data/lib/puppet/http/service/file_server.rb +1 -1
  92. data/lib/puppet/http/service.rb +19 -1
  93. data/lib/puppet/http/session.rb +1 -1
  94. data/lib/puppet/http.rb +1 -1
  95. data/lib/puppet/indirector/catalog/compiler.rb +2 -2
  96. data/lib/puppet/indirector/data_binding/hiera.rb +93 -2
  97. data/lib/puppet/indirector/face.rb +4 -4
  98. data/lib/puppet/indirector/facts/facter.rb +7 -7
  99. data/lib/puppet/indirector/file_bucket_file/file.rb +2 -2
  100. data/lib/puppet/indirector/file_bucket_file/rest.rb +7 -3
  101. data/lib/puppet/indirector/file_content/file_server.rb +1 -1
  102. data/lib/puppet/indirector/file_metadata/file_server.rb +1 -1
  103. data/lib/puppet/indirector/node/exec.rb +1 -1
  104. data/lib/puppet/indirector/node/rest.rb +1 -1
  105. data/lib/puppet/indirector/report/processor.rb +1 -1
  106. data/lib/puppet/indirector.rb +1 -1
  107. data/lib/puppet/interface/documentation.rb +1 -1
  108. data/lib/puppet/interface/face_collection.rb +1 -1
  109. data/lib/puppet/interface/option.rb +2 -2
  110. data/lib/puppet/module/task.rb +1 -1
  111. data/lib/puppet/module_tool/applications/application.rb +1 -1
  112. data/lib/puppet/module_tool/metadata.rb +1 -2
  113. data/lib/puppet/module_tool.rb +1 -1
  114. data/lib/puppet/network/authorization.rb +1 -1
  115. data/lib/puppet/network/http/api.rb +2 -2
  116. data/lib/puppet/network/http/connection.rb +2 -2
  117. data/lib/puppet/node/environment.rb +6 -6
  118. data/lib/puppet/node.rb +2 -2
  119. data/lib/puppet/pal/catalog_compiler.rb +1 -1
  120. data/lib/puppet/pal/pal_impl.rb +1 -25
  121. data/lib/puppet/parser/compiler.rb +1 -1
  122. data/lib/puppet/parser/functions/assert_type.rb +5 -5
  123. data/lib/puppet/parser/functions/create_resources.rb +1 -1
  124. data/lib/puppet/parser/functions/defined.rb +1 -1
  125. data/lib/puppet/parser/functions/digest.rb +1 -1
  126. data/lib/puppet/parser/functions/each.rb +11 -11
  127. data/lib/puppet/parser/functions/epp.rb +5 -5
  128. data/lib/puppet/parser/functions/filter.rb +5 -5
  129. data/lib/puppet/parser/functions/generate.rb +1 -1
  130. data/lib/puppet/parser/functions/hiera.rb +3 -3
  131. data/lib/puppet/parser/functions/hiera_array.rb +4 -4
  132. data/lib/puppet/parser/functions/hiera_hash.rb +4 -4
  133. data/lib/puppet/parser/functions/hiera_include.rb +5 -5
  134. data/lib/puppet/parser/functions/include.rb +1 -1
  135. data/lib/puppet/parser/functions/inline_epp.rb +6 -6
  136. data/lib/puppet/parser/functions/inline_template.rb +1 -1
  137. data/lib/puppet/parser/functions/lest.rb +1 -1
  138. data/lib/puppet/parser/functions/lookup.rb +14 -14
  139. data/lib/puppet/parser/functions/map.rb +5 -5
  140. data/lib/puppet/parser/functions/reduce.rb +7 -7
  141. data/lib/puppet/parser/functions/reverse_each.rb +5 -5
  142. data/lib/puppet/parser/functions/scanf.rb +1 -1
  143. data/lib/puppet/parser/functions/step.rb +5 -5
  144. data/lib/puppet/parser/functions/then.rb +1 -1
  145. data/lib/puppet/parser/functions/versioncmp.rb +1 -1
  146. data/lib/puppet/parser/functions/with.rb +1 -1
  147. data/lib/puppet/parser/functions.rb +3 -3
  148. data/lib/puppet/parser/scope.rb +1 -1
  149. data/lib/puppet/plugins/syntax_checkers.rb +2 -2
  150. data/lib/puppet/plugins.rb +1 -1
  151. data/lib/puppet/pops/evaluator/collectors/exported_collector.rb +1 -1
  152. data/lib/puppet/pops/evaluator/deferred_resolver.rb +4 -1
  153. data/lib/puppet/pops/issues.rb +3 -3
  154. data/lib/puppet/pops/loader/module_loaders.rb +4 -4
  155. data/lib/puppet/pops/loader/ruby_legacy_function_instantiator.rb +1 -1
  156. data/lib/puppet/pops/loaders.rb +4 -4
  157. data/lib/puppet/pops/lookup/lookup_adapter.rb +7 -66
  158. data/lib/puppet/pops/model/factory.rb +5 -5
  159. data/lib/puppet/pops/resource/resource_type_impl.rb +1 -1
  160. data/lib/puppet/pops/serialization/to_data_converter.rb +1 -1
  161. data/lib/puppet/pops/types/iterable.rb +1 -1
  162. data/lib/puppet/property/keyvalue.rb +3 -3
  163. data/lib/puppet/provider/group/aix.rb +2 -2
  164. data/lib/puppet/provider/nameservice/directoryservice.rb +2 -2
  165. data/lib/puppet/provider/package/aix.rb +1 -1
  166. data/lib/puppet/provider/package/apt.rb +2 -2
  167. data/lib/puppet/provider/package/aptitude.rb +0 -1
  168. data/lib/puppet/provider/package/dnfmodule.rb +1 -1
  169. data/lib/puppet/provider/package/nim.rb +1 -1
  170. data/lib/puppet/provider/package/pacman.rb +1 -2
  171. data/lib/puppet/provider/package/pip.rb +1 -1
  172. data/lib/puppet/provider/package/pip2.rb +1 -1
  173. data/lib/puppet/provider/package/pip3.rb +1 -1
  174. data/lib/puppet/provider/package/pkgdmg.rb +2 -2
  175. data/lib/puppet/provider/package/puppet_gem.rb +2 -2
  176. data/lib/puppet/provider/package/puppetserver_gem.rb +1 -1
  177. data/lib/puppet/provider/package/windows.rb +1 -1
  178. data/lib/puppet/provider/service/freebsd.rb +1 -1
  179. data/lib/puppet/provider/service/init.rb +5 -5
  180. data/lib/puppet/provider/service/launchd.rb +2 -2
  181. data/lib/puppet/provider/service/smf.rb +1 -1
  182. data/lib/puppet/provider/service/upstart.rb +2 -2
  183. data/lib/puppet/provider/user/aix.rb +3 -3
  184. data/lib/puppet/provider/user/directoryservice.rb +9 -9
  185. data/lib/puppet/provider/user/pw.rb +3 -3
  186. data/lib/puppet/provider.rb +1 -1
  187. data/lib/puppet/reference/configuration.rb +6 -13
  188. data/lib/puppet/reference/function.rb +4 -4
  189. data/lib/puppet/reference/indirection.rb +2 -2
  190. data/lib/puppet/reference/metaparameter.rb +3 -3
  191. data/lib/puppet/reference/providers.rb +3 -3
  192. data/lib/puppet/reference/report.rb +4 -4
  193. data/lib/puppet/reference/type.rb +2 -2
  194. data/lib/puppet/relationship.rb +1 -1
  195. data/lib/puppet/reports/http.rb +4 -4
  196. data/lib/puppet/reports.rb +1 -1
  197. data/lib/puppet/resource/catalog.rb +4 -4
  198. data/lib/puppet/resource/type.rb +8 -8
  199. data/lib/puppet/settings/base_setting.rb +2 -3
  200. data/lib/puppet/settings/config_file.rb +3 -3
  201. data/lib/puppet/settings/environment_conf.rb +3 -11
  202. data/lib/puppet/settings.rb +11 -51
  203. data/lib/puppet/ssl/certificate.rb +4 -0
  204. data/lib/puppet/ssl/certificate_request.rb +1 -1
  205. data/lib/puppet/ssl/oids.rb +1 -1
  206. data/lib/puppet/ssl/openssl_loader.rb +1 -1
  207. data/lib/puppet/ssl/ssl_provider.rb +5 -5
  208. data/lib/puppet/ssl/state_machine.rb +9 -3
  209. data/lib/puppet/syntax_checkers.rb +1 -1
  210. data/lib/puppet/transaction/report.rb +3 -3
  211. data/lib/puppet/transaction.rb +0 -1
  212. data/lib/puppet/type/exec.rb +20 -20
  213. data/lib/puppet/type/file/content.rb +10 -37
  214. data/lib/puppet/type/file/ensure.rb +18 -9
  215. data/lib/puppet/type/file/mode.rb +4 -4
  216. data/lib/puppet/type/file/selcontext.rb +2 -2
  217. data/lib/puppet/type/file/source.rb +19 -25
  218. data/lib/puppet/type/file.rb +22 -15
  219. data/lib/puppet/type/filebucket.rb +22 -8
  220. data/lib/puppet/type/group.rb +5 -5
  221. data/lib/puppet/type/notify.rb +1 -1
  222. data/lib/puppet/type/package.rb +4 -4
  223. data/lib/puppet/type/schedule.rb +11 -11
  224. data/lib/puppet/type/service.rb +8 -8
  225. data/lib/puppet/type/stage.rb +1 -1
  226. data/lib/puppet/type/user.rb +19 -21
  227. data/lib/puppet/type/whit.rb +2 -2
  228. data/lib/puppet/type.rb +27 -27
  229. data/lib/puppet/util/character_encoding.rb +3 -3
  230. data/lib/puppet/util/command_line.rb +1 -1
  231. data/lib/puppet/util/execution.rb +1 -1
  232. data/lib/puppet/util/filetype.rb +6 -6
  233. data/lib/puppet/util/log.rb +2 -2
  234. data/lib/puppet/util/logging.rb +3 -3
  235. data/lib/puppet/util/plist.rb +1 -1
  236. data/lib/puppet/util/profiler/around_profiler.rb +1 -1
  237. data/lib/puppet/util/profiler.rb +1 -1
  238. data/lib/puppet/util/rdoc.rb +6 -3
  239. data/lib/puppet/util/selinux.rb +5 -5
  240. data/lib/puppet/util/tag_set.rb +0 -1
  241. data/lib/puppet/util/windows/adsi.rb +1 -1
  242. data/lib/puppet/util/windows/com.rb +2 -2
  243. data/lib/puppet/util/windows/eventlog.rb +6 -6
  244. data/lib/puppet/util/windows/file.rb +2 -2
  245. data/lib/puppet/util/windows/security.rb +3 -3
  246. data/lib/puppet/util.rb +8 -3
  247. data/lib/puppet/version.rb +8 -8
  248. data/lib/puppet/x509/cert_provider.rb +1 -1
  249. data/lib/puppet.rb +5 -5
  250. data/locales/config.yaml +3 -3
  251. data/locales/puppet.pot +462 -464
  252. data/man/man5/puppet.conf.5 +122 -146
  253. data/man/man8/puppet-agent.8 +25 -25
  254. data/man/man8/puppet-apply.8 +6 -6
  255. data/man/man8/puppet-catalog.8 +11 -11
  256. data/man/man8/puppet-config.8 +7 -7
  257. data/man/man8/puppet-describe.8 +3 -3
  258. data/man/man8/puppet-device.8 +2 -2
  259. data/man/man8/puppet-doc.8 +5 -5
  260. data/man/man8/puppet-epp.8 +3 -3
  261. data/man/man8/puppet-facts.8 +11 -11
  262. data/man/man8/puppet-filebucket.8 +5 -5
  263. data/man/man8/puppet-generate.8 +3 -3
  264. data/man/man8/puppet-help.8 +3 -3
  265. data/man/man8/puppet-lookup.8 +8 -8
  266. data/man/man8/puppet-module.8 +7 -7
  267. data/man/man8/puppet-node.8 +11 -45
  268. data/man/man8/puppet-parser.8 +3 -3
  269. data/man/man8/puppet-plugin.8 +7 -7
  270. data/man/man8/puppet-report.8 +6 -6
  271. data/man/man8/puppet-resource.8 +5 -5
  272. data/man/man8/puppet-script.8 +3 -3
  273. data/man/man8/puppet-ssl.8 +21 -23
  274. data/man/man8/puppet.8 +2 -2
  275. metadata +5 -8
  276. data/lib/puppet/indirector/hiera.rb +0 -101
  277. data/lib/puppet/util/rdoc/generators/puppet_generator.rb +0 -902
  278. data/lib/puppet/util/rdoc/generators/template/puppet/puppet.rb +0 -1068
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-LOOKUP" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-LOOKUP" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-lookup\fR \- Interactive Hiera lookup for OpenVox
6
6
  .SH "SYNOPSIS"
@@ -14,7 +14,7 @@ The most common version of this command is:
14
14
  .SH "USAGE"
15
15
  puppet lookup [\-\-help] [\-\-type \fITYPESTRING\fR] [\-\-merge first|unique|hash|deep] [\-\-knock\-out\-prefix \fIPREFIX\-STRING\fR] [\-\-sort\-merged\-arrays] [\-\-merge\-hash\-arrays] [\-\-explain] [\-\-environment \fIENV\fR] [\-\-default \fIVALUE\fR] [\-\-node \fINODE\-NAME\fR] [\-\-facts \fIFILE\fR] [\-\-compile] [\-\-render\-as s|json|yaml|binary|msgpack] \fIkeys\fR
16
16
  .SH "DESCRIPTION"
17
- The lookup command is a CLI for Puppet's 'lookup()' function\. It searches your Hiera data and returns a value for the requested lookup key, so you can test and explore your data\. It is a modern replacement for the 'hiera' command\. Lookup uses the setting for global hiera\.yaml from puppet's config, and the environment to find the environment level hiera\.yaml as well as the resulting modulepath for the environment (for hiera\.yaml files in modules)\. Hiera usually relies on a node's facts to locate the relevant data sources\. By default, 'puppet lookup' uses facts from the node you run the command on, but you can get data for any other node with the '\-\-node \fINAME\fR' option\. If possible, the lookup command will use the requested node's real stored facts from PuppetDB; if PuppetDB isn't configured or you want to provide arbitrary fact values, you can pass alternate facts as a JSON or YAML file with '\-\-facts \fIFILE\fR'\.
17
+ The lookup command is a CLI for OpenVox's 'lookup()' function\. It searches your Hiera data and returns a value for the requested lookup key, so you can test and explore your data\. It is a modern replacement for the 'hiera' command\. Lookup uses the setting for global hiera\.yaml from puppet's config, and the environment to find the environment level hiera\.yaml as well as the resulting modulepath for the environment (for hiera\.yaml files in modules)\. Hiera usually relies on a node's facts to locate the relevant data sources\. By default, 'puppet lookup' uses facts from the node you run the command on, but you can get data for any other node with the '\-\-node \fINAME\fR' option\. If possible, the lookup command will use the requested node's real stored facts from OpenVoxDB; if OpenVoxDB isn't configured or you want to provide arbitrary fact values, you can pass alternate facts as a JSON or YAML file with '\-\-facts \fIFILE\fR'\.
18
18
  .P
19
19
  If you're debugging your Hiera data and want to see where values are coming from, use the '\-\-explain' option\.
20
20
  .P
@@ -22,18 +22,18 @@ If '\-\-explain' isn't specified, lookup exits with 0 if a value was found and 1
22
22
  .P
23
23
  You can provide multiple lookup keys to this command, but it only returns a value for the first found key, omitting the rest\.
24
24
  .P
25
- For more details about how Hiera works, see the Hiera documentation: https://puppet\.com/docs/puppet/latest/hiera_intro\.html
25
+ For more details about how Hiera works, see the Hiera documentation: https://docs\.openvoxproject\.org/openvox/latest/hiera_intro\.html
26
26
  .SH "OPTIONS"
27
27
  .IP "\(bu" 4
28
28
  \-\-help: Print this help message\.
29
29
  .IP "\(bu" 4
30
30
  \-\-explain Explain the details of how the lookup was performed and where the final value came from (or the reason no value was found)\.
31
31
  .IP "\(bu" 4
32
- \-\-node \fINODE\-NAME\fR Specify which node to look up data for; defaults to the node where the command is run\. Since Hiera's purpose is to provide different values for different nodes (usually based on their facts), you'll usually want to use some specific node's facts to explore your data\. If the node where you're running this command is configured to talk to PuppetDB, the command will use the requested node's most recent facts\. Otherwise, you can override facts with the '\-\-facts' option\.
32
+ \-\-node \fINODE\-NAME\fR Specify which node to look up data for; defaults to the node where the command is run\. Since Hiera's purpose is to provide different values for different nodes (usually based on their facts), you'll usually want to use some specific node's facts to explore your data\. If the node where you're running this command is configured to talk to OpenVoxDB, the command will use the requested node's most recent facts\. Otherwise, you can override facts with the '\-\-facts' option\.
33
33
  .IP "\(bu" 4
34
34
  \-\-facts \fIFILE\fR Specify a \.json or \.yaml file of key => value mappings to override the facts for this lookup\. Any facts not specified in this file maintain their original value\.
35
35
  .IP "\(bu" 4
36
- \-\-environment \fIENV\fR Like with most Puppet commands, you can specify an environment on the command line\. This is important for lookup because different environments can have different Hiera data\. This environment will be always be the one used regardless of any other factors\.
36
+ \-\-environment \fIENV\fR Like with most OpenVox commands, you can specify an environment on the command line\. This is important for lookup because different environments can have different Hiera data\. This environment will be always be the one used regardless of any other factors\.
37
37
  .IP "\(bu" 4
38
38
  \-\-merge first|unique|hash|deep: Specify the merge behavior, overriding any merge behavior from the data's lookup_options\. 'first' returns the first value found\. 'unique' appends everything to a merged, deduplicated array\. 'hash' performs a simple hash merge by overwriting keys of lower lookup priority\. 'deep' performs a deep merge on values of Array and Hash type\. There are additional options that can be used with 'deep'\.
39
39
  .IP "\(bu" 4
@@ -54,11 +54,11 @@ For more details about how Hiera works, see the Hiera documentation: https://pup
54
54
  \-\-render\-as s|json|yaml|binary|msgpack Specify the output format of the results; "s" means plain text\. The default when producing a value is yaml and the default when producing an explanation is s\.
55
55
  .IP "" 0
56
56
  .SH "EXAMPLE"
57
- To look up 'key_name' using the Puppet Server node's facts: $ puppet lookup key_name
57
+ To look up 'key_name' using the OpenVox Server node's facts: $ puppet lookup key_name
58
58
  .P
59
- To look up 'key_name' using the Puppet Server node's arbitrary variables from a manifest, and classify the node if applicable: $ puppet lookup key_name \-\-compile
59
+ To look up 'key_name' using the OpenVox Server node's arbitrary variables from a manifest, and classify the node if applicable: $ puppet lookup key_name \-\-compile
60
60
  .P
61
- To look up 'key_name' using the Puppet Server node's facts, overridden by facts given in a file: $ puppet lookup key_name \-\-facts fact_file\.yaml
61
+ To look up 'key_name' using the OpenVox Server node's facts, overridden by facts given in a file: $ puppet lookup key_name \-\-facts fact_file\.yaml
62
62
  .P
63
63
  To look up 'key_name' with agent\.local's facts: $ puppet lookup \-\-node agent\.local key_name
64
64
  .P
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-MODULE" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-MODULE" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.
6
6
  .SH "SYNOPSIS"
@@ -10,7 +10,7 @@ This subcommand can find, install, and manage modules from the Puppet Forge, a r
10
10
  .SH "OPTIONS"
11
11
  Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
12
12
  .P
13
- See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
13
+ See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
14
14
  .TP
15
15
  \-\-render\-as FORMAT
16
16
  The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
@@ -22,18 +22,18 @@ Whether to log verbosely\.
22
22
  Whether to log debug information\.
23
23
  .TP
24
24
  \-\-environment production
25
- The environment in which Puppet is running\. For clients, such as \fBpuppet agent\fR, this determines the environment itself, which Puppet uses to find modules and much more\. For servers, such as \fBpuppet server\fR, this provides the default environment for nodes that Puppet knows nothing about\.
25
+ The environment in which OpenVox is running\. For clients, such as \fBpuppet agent\fR, this determines the environment itself, which OpenVox uses to find modules and much more\. For servers, such as OpenVox Server, this provides the default environment for nodes that OpenVox knows nothing about\.
26
26
  .IP
27
27
  When defining an environment in the \fB[agent]\fR section, this refers to the environment that the agent requests from the primary server\. The environment doesn't have to exist on the local filesystem because the agent fetches it from the primary server\. This definition is used when running \fBpuppet agent\fR\.
28
28
  .IP
29
- 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\.
29
+ When defined in the \fB[user]\fR section, the environment refers to the path that OpenVox 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\. OpenVox subcommands, including \fBpuppet module\fR and \fBpuppet apply\fR, use this definition\.
30
30
  .IP
31
- 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\.
31
+ Given that the context and effects vary depending on the config section \fIhttps://docs\.openvoxproject\.org/openvox/latest/config_file_main\.html#config\-sections\fR in which the \fBenvironment\fR setting is defined, do not set it globally\.
32
32
  .TP
33
33
  \-\-modulepath
34
34
  The search path for modules, as a list of directories separated by the system path separator character\. (The POSIX path separator is ':', and the Windows path separator is ';'\.)
35
35
  .IP
36
- Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see \fIhttps://puppet\.com/docs/puppet/latest/environments_about\.html\fR
36
+ Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see \fIhttps://docs\.openvoxproject\.org/openvox/latest/environments_about\.html\fR
37
37
  .SH "ACTIONS"
38
38
  .TP
39
39
  \fBchanges\fR \- Show modified files of an installed module\.
@@ -217,4 +217,4 @@ upgrade an installed module for a specific environment
217
217
  .P
218
218
  $ puppet module upgrade puppetlabs\-apache \-\-environment test /etc/puppetlabs/code/environments/test/modules └── puppetlabs\-apache (v1\.0\.0 \-> v2\.4\.0)
219
219
  .SH "COPYRIGHT AND LICENSE"
220
- Copyright 2012 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
220
+ Copyright 2012 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-NODE" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-NODE" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-node\fR \- View and manage node definitions\.
6
6
  .SH "SYNOPSIS"
@@ -10,7 +10,7 @@ This subcommand interacts with node objects, which are used by OpenVox to build
10
10
  .SH "OPTIONS"
11
11
  Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
12
12
  .P
13
- See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
13
+ See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
14
14
  .TP
15
15
  \-\-render\-as FORMAT
16
16
  The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
@@ -22,21 +22,21 @@ Whether to log verbosely\.
22
22
  Whether to log debug information\.
23
23
  .TP
24
24
  \-\-terminus _TERMINUS
25
- Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
25
+ Indirector faces expose indirected subsystems of OpenVox\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In OpenVox parlance, these backends are called terminuses\.
26
26
  .IP
27
- Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the puppet master's data\. Most of them have additional terminuses for various local data models, which are in turn used by the indirected subsystem on the puppet master whenever it receives a remote request\.
27
+ Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the OpenVox server's data\. Most of them have additional terminuses for various local data models, which are in turn used by the indirected subsystem on the OpenVox server whenever it receives a remote request\.
28
28
  .IP
29
29
  The terminus for an action is often determined by context, but occasionally needs to be set explicitly\. See the "Notes" section of this face's manpage for more details\.
30
30
  .SH "ACTIONS"
31
31
  .TP
32
- \fBclean\fR \- Clean up signed certs, cached facts, node objects, and reports for a node stored by the puppetmaster
32
+ \fBclean\fR \- Clean up signed certs, cached facts, node objects, and reports for a node stored by the OpenVox server
33
33
  \fBSYNOPSIS\fR
34
34
  .IP
35
35
  puppet node clean [\-\-terminus _TERMINUS] \fIhost1\fR [\fIhost2\fR \|\.\|\.\|\.]
36
36
  .IP
37
37
  \fBDESCRIPTION\fR
38
38
  .IP
39
- Cleans up the following information a puppet master knows about a node:
39
+ Cleans up the following information an OpenVox server knows about a node:
40
40
  .IP
41
41
  \fISigned certificates\fR \- ($vardir/ssl/ca/signed/node\.domain\.pem)
42
42
  .IP
@@ -46,33 +46,7 @@ Cleans up the following information a puppet master knows about a node:
46
46
  .IP
47
47
  \fIReports\fR \- ($vardir/reports/node\.domain)
48
48
  .IP
49
- NOTE: this action now cleans up certs via Puppet Server's CA API\. A running server is required for certs to be cleaned\.
50
- .TP
51
- \fBdecrypt\fR \- Decrypt a value using the agent's own certificate
52
- \fBSYNOPSIS\fR
53
- .IP
54
- puppet node decrypt [\-\-terminus _TERMINUS] [\-d DATA | \-\-data DATA] [\-e VARIABLE | \-\-env VARIABLE]
55
- .IP
56
- \fBDESCRIPTION\fR
57
- .IP
58
- Decrypt a value using the agent's own certificate\. You have three ways to pass data for decryption\. You can pass it directly on the command line (if your kernel allows command strings that long), you can set it in an environment variable and pass the name of the variable, or you can pipe it using STDIN\.
59
- .IP
60
- \fBOPTIONS\fR \fI\-d DATA\fR | \fI\-\-data DATA\fR \- An string of data to decrypt
61
- .IP
62
- \fI\-e VARIABLE\fR | \fI\-\-env VARIABLE\fR \- An environment variable containing data to decrypt
63
- .TP
64
- \fBencrypt\fR \- Encrypt a value using a specified agent's certificate
65
- \fBSYNOPSIS\fR
66
- .IP
67
- puppet node encrypt [\-\-terminus _TERMINUS] [\-t CERTNAME | \-\-target CERTNAME] \fIstring\fR
68
- .IP
69
- \fBDESCRIPTION\fR
70
- .IP
71
- Encrypt a value using a specified agent's certificate useful for pasting into a manifest for a node_encrypted_file resource type, or for a data value for a datacat fragment\.
72
- .IP
73
- This will only run properly on a CA node with access to each node's signed public certificate\.
74
- .IP
75
- \fBOPTIONS\fR \fI\-t CERTNAME\fR | \fI\-\-target CERTNAME\fR \- Which agent to encrypt for
49
+ NOTE: this action now cleans up certs via OpenVox Server's CA API\. A running server is required for certs to be cleaned\.
76
50
  .TP
77
51
  \fBfind\fR \- Retrieve a node object\.
78
52
  \fBSYNOPSIS\fR
@@ -98,29 +72,21 @@ puppet node info [\-\-terminus _TERMINUS]
98
72
  .IP
99
73
  Prints the default terminus class for this subcommand\. Note that different run modes may have different default termini; when in doubt, specify the run mode with the '\-\-run_mode' option\.
100
74
  .SH "EXAMPLES"
101
- \fBdecrypt\fR
102
- .P
103
- $ puppet node decrypt \-\-data \fIencrypted blob of data\fR $ puppet node decrypt \-\-env \fIenvironment variable containing blob of encrypted data\fR $ echo \fIencrypted blob of data\fR | puppet node decrypt $ cat /file/with/encrypted/blob\.txt | puppet node decrypt
104
- .P
105
- \fBencrypt\fR
106
- .P
107
- $ puppet node encrypt \-\-certname testhost\.example\.com "some text to encrypt"
108
- .P
109
75
  \fBfind\fR
110
76
  .P
111
77
  Retrieve an "empty" (no classes, no ENC\-imposed parameters, and an environment of "production") node:
112
78
  .P
113
79
  $ puppet node find somenode\.puppetlabs\.lan \-\-terminus plain \-\-render\-as yaml
114
80
  .P
115
- Retrieve a node using the Puppet Server's configured ENC:
81
+ Retrieve a node using the OpenVox Server's configured ENC:
116
82
  .P
117
83
  $ puppet node find somenode\.puppetlabs\.lan \-\-terminus exec \-\-run_mode server \-\-render\-as yaml
118
84
  .P
119
- Retrieve the same node from the Puppet Server:
85
+ Retrieve the same node from the OpenVox Server:
120
86
  .P
121
87
  $ puppet node find somenode\.puppetlabs\.lan \-\-terminus rest \-\-render\-as yaml
122
88
  .SH "NOTES"
123
- This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of Puppet\. Valid termini for this face include:
89
+ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of OpenVox\. Valid termini for this face include:
124
90
  .IP "\(bu" 4
125
91
  \fBexec\fR
126
92
  .IP "\(bu" 4
@@ -139,4 +105,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
139
105
  \fByaml\fR
140
106
  .IP "" 0
141
107
  .SH "COPYRIGHT AND LICENSE"
142
- Copyright 2011 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
108
+ Copyright 2011 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-PARSER" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-PARSER" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-parser\fR \- Interact directly with the parser\.
6
6
  .SH "SYNOPSIS"
@@ -8,7 +8,7 @@ puppet parser \fIaction\fR
8
8
  .SH "OPTIONS"
9
9
  Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
10
10
  .P
11
- See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
11
+ See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
12
12
  .TP
13
13
  \-\-render\-as FORMAT
14
14
  The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
@@ -84,4 +84,4 @@ Validate from STDIN:
84
84
  .P
85
85
  $ cat init\.pp | puppet parser validate
86
86
  .SH "COPYRIGHT AND LICENSE"
87
- Copyright 2014 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
87
+ Copyright 2014 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-PLUGIN" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-PLUGIN" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-plugin\fR \- Interact with the OpenVox plugin system\.
6
6
  .SH "SYNOPSIS"
@@ -8,11 +8,11 @@ puppet plugin \fIaction\fR
8
8
  .SH "DESCRIPTION"
9
9
  This subcommand provides network access to the OpenVox server's store of plugins\.
10
10
  .P
11
- The OpenVox server serves Ruby code collected from the \fBlib\fR directories of its modules\. These plugins can be used on agent nodes to extend Facter and implement custom types and providers\. Plugins are normally downloaded by the OpenVox agent during the course of a run\.
11
+ The OpenVox server serves Ruby code collected from the \fBlib\fR directories of its modules\. These plugins can be used on agent nodes to extend OpenFact and implement custom types and providers\. Plugins are normally downloaded by the OpenVox agent during the course of a run\.
12
12
  .SH "OPTIONS"
13
13
  Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
14
14
  .P
15
- See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
15
+ See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
16
16
  .TP
17
17
  \-\-render\-as FORMAT
18
18
  The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
@@ -24,7 +24,7 @@ Whether to log verbosely\.
24
24
  Whether to log debug information\.
25
25
  .SH "ACTIONS"
26
26
  .TP
27
- \fBdownload\fR \- Download plugins from the puppet master\.
27
+ \fBdownload\fR \- Download plugins from the OpenVox server\.
28
28
  \fBSYNOPSIS\fR
29
29
  .IP
30
30
  puppet plugin download
@@ -39,12 +39,12 @@ A list of the files downloaded, or a confirmation that no files were downloaded\
39
39
  .SH "EXAMPLES"
40
40
  \fBdownload\fR
41
41
  .P
42
- Retrieve plugins from the puppet master:
42
+ Retrieve plugins from the OpenVox server:
43
43
  .P
44
44
  $ puppet plugin download
45
45
  .P
46
- Retrieve plugins from the puppet master (API example):
46
+ Retrieve plugins from the OpenVox server (API example):
47
47
  .P
48
48
  $ Puppet::Face[:plugin, '0\.0\.1']\.download
49
49
  .SH "COPYRIGHT AND LICENSE"
50
- Copyright 2011 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
50
+ Copyright 2011 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-REPORT" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-REPORT" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-report\fR \- Create, display, and submit reports\.
6
6
  .SH "SYNOPSIS"
@@ -8,7 +8,7 @@ puppet report \fIaction\fR [\-\-terminus _TERMINUS]
8
8
  .SH "OPTIONS"
9
9
  Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
10
10
  .P
11
- See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
11
+ See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
12
12
  .TP
13
13
  \-\-render\-as FORMAT
14
14
  The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
@@ -20,9 +20,9 @@ Whether to log verbosely\.
20
20
  Whether to log debug information\.
21
21
  .TP
22
22
  \-\-terminus _TERMINUS
23
- Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
23
+ Indirector faces expose indirected subsystems of OpenVox\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In OpenVox parlance, these backends are called terminuses\.
24
24
  .IP
25
- Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the puppet master's data\. Most of them have additional terminuses for various local data models, which are in turn used by the indirected subsystem on the puppet master whenever it receives a remote request\.
25
+ Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the OpenVox server's data\. Most of them have additional terminuses for various local data models, which are in turn used by the indirected subsystem on the OpenVox server whenever it receives a remote request\.
26
26
  .IP
27
27
  The terminus for an action is often determined by context, but occasionally needs to be set explicitly\. See the "Notes" section of this face's manpage for more details\.
28
28
  .SH "ACTIONS"
@@ -68,7 +68,7 @@ begin Puppet::Transaction::Report\.indirection\.terminus_class = :rest Puppet::F
68
68
  .P
69
69
  API example:report = Puppet::Face[:catalog, '0\.0\.1']\.apply Puppet::Face[:report, '0\.0\.1']\.submit(report) return report
70
70
  .SH "NOTES"
71
- This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of Puppet\. Valid termini for this face include:
71
+ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of OpenVox\. Valid termini for this face include:
72
72
  .IP "\(bu" 4
73
73
  \fBjson\fR
74
74
  .IP "\(bu" 4
@@ -81,4 +81,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
81
81
  \fByaml\fR
82
82
  .IP "" 0
83
83
  .SH "COPYRIGHT AND LICENSE"
84
- Copyright 2011 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
84
+ Copyright 2011 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-RESOURCE" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-RESOURCE" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-resource\fR \- The OpenVox resource abstraction layer shell
6
6
  .SH "SYNOPSIS"
@@ -8,15 +8,15 @@ Uses the OpenVox RAL to directly interact with the system\.
8
8
  .SH "USAGE"
9
9
  puppet resource [\-h|\-\-help] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-edit] [\-p|\-\-param \fIparameter\fR] [\-t|\-\-types] [\-y|\-\-to_yaml] \fItype\fR [\fIname\fR] [\fIattribute\fR=\fIvalue\fR \|\.\|\.\|\.]
10
10
  .SH "DESCRIPTION"
11
- This command provides simple facilities for converting current system state into Puppet code, along with some ability to modify the current state using Puppet's RAL\.
11
+ This command provides simple facilities for converting current system state into Puppet code, along with some ability to modify the current state using the OpenVox RAL\.
12
12
  .P
13
13
  By default, you must at least provide a type to list, in which case puppet resource will tell you everything it knows about all resources of that type\. You can optionally specify an instance name, and puppet resource will only describe that single instance\.
14
14
  .P
15
- If given a type, a name, and a series of \fIattribute\fR=\fIvalue\fR pairs, puppet resource will modify the state of the specified resource\. Alternately, if given a type, a name, and the '\-\-edit' flag, puppet resource will write its output to a file, open that file in an editor, and then apply the saved file as a Puppet transaction\.
15
+ If given a type, a name, and a series of \fIattribute\fR=\fIvalue\fR pairs, puppet resource will modify the state of the specified resource\. Alternately, if given a type, a name, and the '\-\-edit' flag, puppet resource will write its output to a file, open that file in an editor, and then apply the saved file as an OpenVox transaction\.
16
16
  .SH "OPTIONS"
17
17
  Note that any setting that's valid in the configuration file is also a valid long argument\. For example, 'ssldir' is a valid setting, so you can specify '\-\-ssldir \fIdirectory\fR' as an argument\.
18
18
  .P
19
- 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'\.
19
+ See the configuration file documentation at https://docs\.openvoxproject\.org/openvox/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'\.
20
20
  .TP
21
21
  \-\-debug
22
22
  Enable full debugging\.
@@ -60,4 +60,4 @@ user { 'luke':
60
60
  .SH "AUTHOR"
61
61
  Luke Kanies
62
62
  .SH "COPYRIGHT"
63
- Copyright (c) 2011 Puppet Inc\. Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2\.0 License
63
+ Copyright (c) 2011 Puppet Inc\.; Copyright (c) 2024 Vox Pupuli\. Licensed under the Apache 2\.0 License
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-SCRIPT" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-SCRIPT" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-script\fR \- Run a puppet manifests as a script without compiling a catalog
6
6
  .SH "SYNOPSIS"
@@ -14,7 +14,7 @@ When provided with a modulepath, via command line or config file, puppet script
14
14
  .SH "OPTIONS"
15
15
  Note that any setting that's valid in the configuration file is also a valid long argument\. For example, 'environment' is a valid setting, so you can specify '\-\-environment mytest' as an argument\.
16
16
  .P
17
- 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'\.
17
+ See the configuration file documentation at https://docs\.openvoxproject\.org/openvox/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'\.
18
18
  .TP
19
19
  \-\-debug
20
20
  Enable full debugging\.
@@ -30,7 +30,7 @@ A path ending with '\.json' will receive structured output in JSON format\. The
30
30
  A path ending with '\.jsonl' will receive structured output in JSON Lines format\.
31
31
  .TP
32
32
  \-\-noop
33
- Use 'noop' mode where Puppet runs in a no\-op or dry\-run mode\. This is useful for seeing what changes Puppet will make without actually executing the changes\. Applies to tasks only\.
33
+ Use 'noop' mode where OpenVox runs in a no\-op or dry\-run mode\. This is useful for seeing what changes OpenVox will make without actually executing the changes\. Applies to tasks only\.
34
34
  .TP
35
35
  \-\-execute
36
36
  Execute a specific piece of Puppet code
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET\-SSL" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET\-SSL" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\-ssl\fR \- Manage SSL keys and certificates for OpenVox SSL clients
6
6
  .SH "SYNOPSIS"
@@ -18,28 +18,26 @@ puppet ssl \fIaction\fR [\-h|\-\-help] [\-v|\-\-verbose] [\-d|\-\-debug] [\-\-lo
18
18
  \-\-localca Also clean the local CA certificate and CRL\.
19
19
  .IP "\(bu" 4
20
20
  \-\-target CERTNAME Clean the specified device certificate instead of this host's certificate\.
21
+ .IP "\(bu" 4
22
+ \-\-if\-expiring\-in DURATION When renewing a certificate only renew if the certificate is valid for less than this amount of time\. Duration can be specified as a time interval, such as 30s, 5m, 1h\.
21
23
  .IP "" 0
22
24
  .SH "ACTIONS"
23
- .TP
24
- bootstrap
25
- Perform all of the steps necessary to request and download a client certificate\. If autosigning is disabled, then puppet will wait every \fBwaitforcert\fR seconds for its certificate to be signed\. To only attempt once and never wait, specify a time of 0\. Since \fBwaitforcert\fR is a Puppet setting, it can be specified as a time interval, such as 30s, 5m, 1h\.
26
- .TP
27
- submit_request
28
- Generate a certificate signing request (CSR) and submit it to the CA\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise, a new key pair will be generated\. If a CSR has already been submitted with the given \fBcertname\fR, then the operation will fail\.
29
- .TP
30
- generate_request
31
- Generate a certificate signing request (CSR)\. If a private and public key pair exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\.
32
- .TP
33
- download_cert
34
- Download a certificate for this host\. If the current private key matches the downloaded certificate, then the certificate will be saved and used for subsequent requests\. If there is already an existing certificate, it will be overwritten\.
35
- .TP
36
- verify
37
- Verify the private key and certificate are present and match, verify the certificate is issued by a trusted CA, and check revocation status\.
38
- .TP
39
- clean
40
- Remove the private key and certificate related files for this host\. If \fB\-\-localca\fR is specified, then also remove this host's local copy of the CA certificate(s) and CRL bundle\. if \fB\-\-target CERTNAME\fR is specified, then remove the files for the specified device on this host instead of this host\.
41
- .TP
42
- show
43
- Print the full\-text version of this host's certificate\.
25
+ .IP "\(bu" 4
26
+ bootstrap: Perform all of the steps necessary to request and download a client certificate\. If autosigning is disabled, then puppet will wait every \fBwaitforcert\fR seconds for its certificate to be signed\. To only attempt once and never wait, specify a time of 0\. Since \fBwaitforcert\fR is an OpenVox setting, it can be specified as a time interval, such as 30s, 5m, 1h\.
27
+ .IP "\(bu" 4
28
+ submit_request: Generate a certificate signing request (CSR) and submit it to the CA\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise, a new key pair will be generated\. If a CSR has already been submitted with the given \fBcertname\fR, then the operation will fail\.
29
+ .IP "\(bu" 4
30
+ generate_request: Generate a certificate signing request (CSR)\. If a private and public key pair exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\.
31
+ .IP "\(bu" 4
32
+ download_cert: Download a certificate for this host\. If the current private key matches the downloaded certificate, then the certificate will be saved and used for subsequent requests\. If there is already an existing certificate, it will be overwritten\.
33
+ .IP "\(bu" 4
34
+ renew_cert Renew an existing and non\-expired client certificate\. When \fB\-\-if\-expiring\-in\fR option is specified, then renew the certificate only if it's going to expire in the amount of time given\.
35
+ .IP "\(bu" 4
36
+ verify: Verify the private key and certificate are present and match, verify the certificate is issued by a trusted CA, and check revocation status\.
37
+ .IP "\(bu" 4
38
+ clean: Remove the private key and certificate related files for this host\. If \fB\-\-localca\fR is specified, then also remove this host's local copy of the CA certificate(s) and CRL bundle\. if \fB\-\-target CERTNAME\fR is specified, then remove the files for the specified device on this host instead of this host\.
39
+ .IP "\(bu" 4
40
+ show: Print the full\-text version of this host's certificate\.
41
+ .IP "" 0
44
42
  .P
45
- COPYRIGHT \-\-\-\-\-\- Copyright (c) 2011 Puppet Inc\. Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2\.0 License
43
+ COPYRIGHT \-\-\-\-\-\- Copyright (c) 2011 Puppet Inc\.; Copyright (c) 2024 Vox Pupuli\. Licensed under the Apache 2\.0 License
data/man/man8/puppet.8 CHANGED
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "PUPPET" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
3
+ .TH "PUPPET" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
4
4
  .SH "NAME"
5
5
  \fBpuppet\fR \- OpenVox is an automated configuration management tool
6
6
  .SH "SYNOPSIS"
@@ -39,7 +39,7 @@ OpenVox is a community implementation of Puppet, an automated administrative eng
39
39
  .SS "Specialized"
40
40
  \fBstrings\fR
41
41
  .br
42
- \~\~\~\~Generate Puppet documentation with YARD\.
42
+ \~\~\~\~Generate Puppet module documentation with YARD\.
43
43
  .P
44
44
  \fBcatalog\fR
45
45
  .br
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: openvox
3
3
  version: !ruby/object:Gem::Version
4
- version: 9.0.0.pre.alpha2
4
+ version: 9.0.0.pre.beta2
5
5
  platform: ruby
6
6
  authors:
7
7
  - OpenVox Project
@@ -145,14 +145,14 @@ dependencies:
145
145
  requirements:
146
146
  - - "~>"
147
147
  - !ruby/object:Gem::Version
148
- version: '5.0'
148
+ version: '6.0'
149
149
  type: :runtime
150
150
  prerelease: false
151
151
  version_requirements: !ruby/object:Gem::Requirement
152
152
  requirements:
153
153
  - - "~>"
154
154
  - !ruby/object:Gem::Version
155
- version: '5.0'
155
+ version: '6.0'
156
156
  - !ruby/object:Gem::Dependency
157
157
  name: ostruct
158
158
  requirement: !ruby/object:Gem::Requirement
@@ -602,7 +602,6 @@ files:
602
602
  - lib/puppet/indirector/file_metadata/selector.rb
603
603
  - lib/puppet/indirector/file_server.rb
604
604
  - lib/puppet/indirector/generic_http.rb
605
- - lib/puppet/indirector/hiera.rb
606
605
  - lib/puppet/indirector/indirection.rb
607
606
  - lib/puppet/indirector/json.rb
608
607
  - lib/puppet/indirector/memory.rb
@@ -1257,8 +1256,6 @@ files:
1257
1256
  - lib/puppet/util/psych_support.rb
1258
1257
  - lib/puppet/util/rdoc.rb
1259
1258
  - lib/puppet/util/rdoc/code_objects.rb
1260
- - lib/puppet/util/rdoc/generators/puppet_generator.rb
1261
- - lib/puppet/util/rdoc/generators/template/puppet/puppet.rb
1262
1259
  - lib/puppet/util/rdoc/parser.rb
1263
1260
  - lib/puppet/util/rdoc/parser/puppet_parser_core.rb
1264
1261
  - lib/puppet/util/rdoc/parser/puppet_parser_rdoc2.rb
@@ -1359,14 +1356,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
1359
1356
  requirements:
1360
1357
  - - ">="
1361
1358
  - !ruby/object:Gem::Version
1362
- version: 3.1.0
1359
+ version: 3.2.0
1363
1360
  required_rubygems_version: !ruby/object:Gem::Requirement
1364
1361
  requirements:
1365
1362
  - - ">"
1366
1363
  - !ruby/object:Gem::Version
1367
1364
  version: 1.3.1
1368
1365
  requirements: []
1369
- rubygems_version: 4.0.10
1366
+ rubygems_version: 4.0.16
1370
1367
  specification_version: 4
1371
1368
  summary: OpenVox, a community implementation of Puppet -- an automated configuration
1372
1369
  management tool