puppet 5.0.0 → 5.0.1

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of puppet might be problematic. Click here for more details.

Files changed (101) hide show
  1. checksums.yaml +7 -0
  2. data/README.md +1 -1
  3. data/ext/puppet-test +1 -1
  4. data/lib/puppet.rb +3 -1
  5. data/lib/puppet/application/lookup.rb +2 -2
  6. data/lib/puppet/defaults.rb +1 -1
  7. data/lib/puppet/face/epp.rb +26 -24
  8. data/lib/puppet/face/module/search.rb +1 -1
  9. data/lib/puppet/forge.rb +3 -2
  10. data/lib/puppet/functions/each.rb +1 -1
  11. data/lib/puppet/functions/filter.rb +1 -1
  12. data/lib/puppet/module.rb +28 -1
  13. data/lib/puppet/module_tool.rb +2 -2
  14. data/lib/puppet/module_tool/applications/installer.rb +5 -5
  15. data/lib/puppet/module_tool/applications/uninstaller.rb +1 -1
  16. data/lib/puppet/module_tool/applications/upgrader.rb +5 -5
  17. data/lib/puppet/module_tool/shared_behaviors.rb +2 -2
  18. data/lib/puppet/parser/compiler.rb +4 -0
  19. data/lib/puppet/parser/functions/assert_type.rb +1 -1
  20. data/lib/puppet/parser/functions/binary_file.rb +1 -1
  21. data/lib/puppet/parser/functions/break.rb +1 -1
  22. data/lib/puppet/parser/functions/defined.rb +1 -1
  23. data/lib/puppet/parser/functions/dig.rb +1 -1
  24. data/lib/puppet/parser/functions/each.rb +2 -2
  25. data/lib/puppet/parser/functions/epp.rb +1 -1
  26. data/lib/puppet/parser/functions/filter.rb +2 -2
  27. data/lib/puppet/parser/functions/find_file.rb +1 -1
  28. data/lib/puppet/parser/functions/inline_epp.rb +1 -1
  29. data/lib/puppet/parser/functions/lest.rb +1 -1
  30. data/lib/puppet/parser/functions/map.rb +1 -1
  31. data/lib/puppet/parser/functions/match.rb +1 -1
  32. data/lib/puppet/parser/functions/new.rb +1 -1
  33. data/lib/puppet/parser/functions/next.rb +1 -1
  34. data/lib/puppet/parser/functions/reduce.rb +1 -1
  35. data/lib/puppet/parser/functions/return.rb +1 -1
  36. data/lib/puppet/parser/functions/reverse_each.rb +2 -2
  37. data/lib/puppet/parser/functions/slice.rb +1 -1
  38. data/lib/puppet/parser/functions/step.rb +2 -2
  39. data/lib/puppet/parser/functions/strftime.rb +1 -1
  40. data/lib/puppet/parser/functions/then.rb +1 -1
  41. data/lib/puppet/parser/functions/type.rb +1 -1
  42. data/lib/puppet/parser/functions/with.rb +1 -1
  43. data/lib/puppet/pops/merge_strategy.rb +1 -1
  44. data/lib/puppet/pops/time/timestamp.rb +2 -2
  45. data/lib/puppet/provider/nameservice.rb +4 -2
  46. data/lib/puppet/reference/configuration.rb +1 -1
  47. data/lib/puppet/reports/http.rb +4 -2
  48. data/lib/puppet/resource/capability_finder.rb +1 -1
  49. data/lib/puppet/util/execution.rb +1 -1
  50. data/lib/puppet/util/logging.rb +8 -4
  51. data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/gem_version.rb +1 -1
  52. data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/version.rb +1 -1
  53. data/lib/puppet/version.rb +1 -1
  54. data/locales/puppet.pot +66 -58
  55. data/man/man5/puppet.conf.5 +233 -63
  56. data/man/man8/puppet-agent.8 +31 -9
  57. data/man/man8/puppet-apply.8 +20 -5
  58. data/man/man8/puppet-ca.8 +48 -34
  59. data/man/man8/puppet-catalog.8 +12 -15
  60. data/man/man8/puppet-cert.8 +23 -6
  61. data/man/man8/puppet-certificate.8 +52 -36
  62. data/man/man8/puppet-certificate_request.8 +10 -10
  63. data/man/man8/puppet-certificate_revocation_list.8 +9 -9
  64. data/man/man8/puppet-config.8 +5 -5
  65. data/man/man8/puppet-describe.8 +3 -3
  66. data/man/man8/puppet-device.8 +13 -5
  67. data/man/man8/puppet-doc.8 +5 -5
  68. data/man/man8/puppet-epp.8 +16 -10
  69. data/man/man8/puppet-facts.8 +9 -9
  70. data/man/man8/puppet-filebucket.8 +44 -5
  71. data/man/man8/puppet-generate.8 +84 -0
  72. data/man/man8/puppet-help.8 +4 -4
  73. data/man/man8/puppet-key.8 +11 -11
  74. data/man/man8/puppet-lookup.8 +104 -0
  75. data/man/man8/puppet-man.8 +5 -5
  76. data/man/man8/puppet-master.8 +5 -5
  77. data/man/man8/puppet-module.8 +29 -17
  78. data/man/man8/puppet-node.8 +9 -9
  79. data/man/man8/puppet-parser.8 +4 -4
  80. data/man/man8/puppet-plugin.8 +4 -4
  81. data/man/man8/puppet-report.8 +9 -9
  82. data/man/man8/puppet-resource.8 +4 -8
  83. data/man/man8/puppet-status.8 +9 -9
  84. data/man/man8/puppet.8 +12 -3
  85. data/spec/integration/util/execution_spec.rb +8 -0
  86. data/spec/unit/application/lookup_spec.rb +1 -1
  87. data/spec/unit/face/epp_face_spec.rb +9 -0
  88. data/spec/unit/face/module/search_spec.rb +1 -1
  89. data/spec/unit/functions/lookup_spec.rb +26 -0
  90. data/spec/unit/indirector/file_bucket_file/file_spec.rb +3 -3
  91. data/spec/unit/module_spec.rb +64 -0
  92. data/spec/unit/module_tool_spec.rb +22 -0
  93. data/spec/unit/parser/scope_spec.rb +1 -1
  94. data/spec/unit/pops/types/p_timestamp_type_spec.rb +30 -1
  95. data/spec/unit/puppet_spec.rb +33 -0
  96. data/spec/unit/util/logging_spec.rb +18 -9
  97. data/tasks/generate_ast_model.rake +48 -44
  98. data/tasks/manpages.rake +9 -1
  99. data/tasks/parallel.rake +12 -7
  100. metadata +3513 -3522
  101. data/man/man8/puppet-inspect.8 +0 -36
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
- .\" https://github.com/rtomayko/ronn/tree/0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-CERTIFICATE" "8" "May 2015" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CERTIFICATE" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-certificate\fR \- Provide access to the CA for certificate management\.
8
8
  .
9
9
  .SH "SYNOPSIS"
10
- puppet certificate \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
10
+ puppet certificate \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
11
11
  .
12
12
  .SH "DESCRIPTION"
13
13
  This subcommand interacts with a local or remote Puppet certificate authority\. Currently, its behavior is not a full superset of \fBpuppet cert\fR; specifically, it is unable to mimic puppet cert\'s "clean" option, and its "generate" action submits a CSR rather than creating a signed certificate\.
@@ -16,7 +16,7 @@ This subcommand interacts with a local or remote Puppet certificate authority\.
16
16
  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\.
17
17
  .
18
18
  .P
19
- See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/references/stable/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\.
19
+ See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
20
20
  .
21
21
  .TP
22
22
  \-\-render\-as FORMAT
@@ -42,7 +42,7 @@ This option is required\.
42
42
  A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
43
43
  .
44
44
  .TP
45
- \-\-terminus TERMINUS
45
+ \-\-terminus _TERMINUS
46
46
  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\.
47
47
  .
48
48
  .IP
@@ -53,12 +53,11 @@ The terminus for an action is often determined by context, but occasionally need
53
53
  .
54
54
  .SH "ACTIONS"
55
55
  .
56
- .TP
57
- \fBdestroy\fR \- Delete a certificate\.
58
- \fBSYNOPSIS\fR
56
+ .IP "\(bu" 4
57
+ \fBdestroy\fR \- Delete a certificate\.: \fBSYNOPSIS\fR
59
58
  .
60
59
  .IP
61
- puppet certificate destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
60
+ puppet certificate destroy [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
62
61
  .
63
62
  .IP
64
63
  \fBDESCRIPTION\fR
@@ -72,12 +71,11 @@ Deletes a certificate\. This action currently only works on the local CA\.
72
71
  .IP
73
72
  Nothing\.
74
73
  .
75
- .TP
76
- \fBfind\fR \- Retrieve a certificate\.
77
- \fBSYNOPSIS\fR
74
+ .IP "\(bu" 4
75
+ \fBfind\fR \- Retrieve a certificate\.: \fBSYNOPSIS\fR
78
76
  .
79
77
  .IP
80
- puppet certificate find [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
78
+ puppet certificate find [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
81
79
  .
82
80
  .IP
83
81
  \fBDESCRIPTION\fR
@@ -94,12 +92,11 @@ An x509 SSL certificate\.
94
92
  .IP
95
93
  Note that this action has a side effect of caching a copy of the certificate in Puppet\'s \fBssldir\fR\.
96
94
  .
97
- .TP
98
- \fBgenerate\fR \- Generate a new certificate signing request\.
99
- \fBSYNOPSIS\fR
95
+ .IP "\(bu" 4
96
+ \fBgenerate\fR \- Generate a new certificate signing request\.: \fBSYNOPSIS\fR
100
97
  .
101
98
  .IP
102
- puppet certificate generate [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-dns\-alt\-names NAMES] \fIhost\fR
99
+ puppet certificate generate [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-dns\-alt\-names NAMES] \fIhost\fR
103
100
  .
104
101
  .IP
105
102
  \fBDESCRIPTION\fR
@@ -111,19 +108,39 @@ Generates and submits a certificate signing request (CSR) for the specified host
111
108
  Puppet agent usually handles CSR submission automatically\. This action is primarily useful for requesting certificates for individual users and external applications\.
112
109
  .
113
110
  .IP
114
- \fBOPTIONS\fR \fI\-\-dns\-alt\-names NAMES\fR \- The comma\-separated list of alternative DNS names to use for the local host\.
111
+ \fBOPTIONS\fR \fI\-\-dns\-alt\-names NAMES\fR \- A comma\-separated list of alternate DNS names for Puppet Server\. These are extra hostnames (in addition to its \fBcertname\fR) that the server is allowed to use when serving agents\. Puppet checks this setting when automatically requesting a certificate for Puppet agent or Puppet Server, and when manually generating a certificate with \fBpuppet cert generate\fR\.
115
112
  .
116
113
  .IP
117
- When the node generates a CSR for itself, these are added to the request as the desired \fBsubjectAltName\fR in the certificate: additional DNS labels that the certificate is also valid answering as\.
114
+ In order to handle agent requests at a given hostname (like "puppet\.example\.com"), Puppet Server needs a certificate that proves it\'s allowed to use that name; if a server shows a certificate that doesn\'t include its hostname, Puppet agents will refuse to trust it\. If you use a single hostname for Puppet traffic but load\-balance it to multiple Puppet Servers, each of those servers needs to include the official hostname in its list of extra names\.
118
115
  .
119
116
  .IP
120
- This is generally required if you use a non\-hostname \fBcertname\fR, or if you want to use \fBpuppet kick\fR or \fBpuppet resource \-H\fR and the primary certname does not match the DNS name you use to communicate with the host\.
117
+ \fBNote:\fR The list of alternate names is locked in when the server\'s certificate is signed\. If you need to change the list later, you can\'t just change this setting; you also need to:
121
118
  .
122
- .IP
123
- This is unnecessary for agents, unless you intend to use them as a server for \fBpuppet kick\fR or remote \fBpuppet resource\fR management\.
119
+ .IP "\(bu" 4
120
+ On the server: Stop Puppet Server\.
121
+ .
122
+ .IP "\(bu" 4
123
+ On the CA server: Revoke and clean the server\'s old certificate\. (\fBpuppet cert clean <NAME>\fR)
124
+ .
125
+ .IP "\(bu" 4
126
+ On the server: Delete the old certificate (and any old certificate signing requests) from the ssldir \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/dirs_ssldir\.html\fR\.
127
+ .
128
+ .IP "\(bu" 4
129
+ On the server: Run \fBpuppet agent \-t \-\-ca_server <CA HOSTNAME>\fR to request a new certificate
130
+ .
131
+ .IP "\(bu" 4
132
+ On the CA server: Sign the certificate request, explicitly allowing alternate names (\fBpuppet cert sign \-\-allow\-dns\-alt\-names <NAME>\fR)\.
133
+ .
134
+ .IP "\(bu" 4
135
+ On the server: Run \fBpuppet agent \-t \-\-ca_server <CA HOSTNAME>\fR to retrieve the cert\.
136
+ .
137
+ .IP "\(bu" 4
138
+ On the server: Start Puppet Server again\.
139
+ .
140
+ .IP "" 0
124
141
  .
125
142
  .IP
126
- It is rarely necessary for servers; it is usually helpful only if you need to have a pool of multiple load balanced masters, or for the same master to respond on two physically separate networks under different names\.
143
+ To see all the alternate names your servers are using, log into your CA server and run \fBpuppet cert list \-a\fR, then check the output for \fB(alt names: \.\.\.)\fR\. Most agent nodes should NOT have alternate names; the only certs that should have them are Puppet Server nodes that you want other agents to trust\.
127
144
  .
128
145
  .IP
129
146
  \fBRETURNS\fR
@@ -131,12 +148,11 @@ It is rarely necessary for servers; it is usually helpful only if you need to ha
131
148
  .IP
132
149
  Nothing\.
133
150
  .
134
- .TP
135
- \fBinfo\fR \- Print the default terminus class for this face\.
136
- \fBSYNOPSIS\fR
151
+ .IP "\(bu" 4
152
+ \fBinfo\fR \- Print the default terminus class for this face\.: \fBSYNOPSIS\fR
137
153
  .
138
154
  .IP
139
- puppet certificate info [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
155
+ puppet certificate info [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
140
156
  .
141
157
  .IP
142
158
  \fBDESCRIPTION\fR
@@ -144,12 +160,11 @@ puppet certificate info [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-loca
144
160
  .IP
145
161
  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\.
146
162
  .
147
- .TP
148
- \fBlist\fR \- List all certificate signing requests\.
149
- \fBSYNOPSIS\fR
163
+ .IP "\(bu" 4
164
+ \fBlist\fR \- List all certificate signing requests\.: \fBSYNOPSIS\fR
150
165
  .
151
166
  .IP
152
- puppet certificate list [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
167
+ puppet certificate list [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
153
168
  .
154
169
  .IP
155
170
  \fBDESCRIPTION\fR
@@ -163,12 +178,11 @@ List all certificate signing requests\.
163
178
  .IP
164
179
  An array of #inspect output from CSR objects\. This output is currently messy, but does contain the names of nodes requesting certificates\. This action returns #inspect strings even when used from the Ruby API\.
165
180
  .
166
- .TP
167
- \fBsign\fR \- Sign a certificate signing request for HOST\.
168
- \fBSYNOPSIS\fR
181
+ .IP "\(bu" 4
182
+ \fBsign\fR \- Sign a certificate signing request for HOST\.: \fBSYNOPSIS\fR
169
183
  .
170
184
  .IP
171
- puppet certificate sign [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-[no\-]allow\-dns\-alt\-names] \fIhost\fR
185
+ puppet certificate sign [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-[no\-]allow\-dns\-alt\-names] \fIhost\fR
172
186
  .
173
187
  .IP
174
188
  \fBDESCRIPTION\fR
@@ -185,6 +199,8 @@ Sign a certificate signing request for HOST\.
185
199
  .IP
186
200
  A string that appears to be (but isn\'t) an x509 certificate\.
187
201
  .
202
+ .IP "" 0
203
+ .
188
204
  .SH "EXAMPLES"
189
205
  \fBgenerate\fR
190
206
  .
@@ -221,4 +237,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
221
237
  .IP "" 0
222
238
  .
223
239
  .SH "COPYRIGHT AND LICENSE"
224
- Copyright 2011 by Puppet Labs Apache 2 license; see COPYING
240
+ Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
- .\" https://github.com/rtomayko/ronn/tree/0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-CERTIFICATE_REQUEST" "8" "May 2015" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CERTIFICATE_REQUEST" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-certificate_request\fR \- Manage certificate requests\.
8
8
  .
9
9
  .SH "SYNOPSIS"
10
- puppet certificate_request \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
10
+ puppet certificate_request \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
11
11
  .
12
12
  .SH "DESCRIPTION"
13
13
  This subcommand retrieves and submits certificate signing requests (CSRs)\.
@@ -16,7 +16,7 @@ This subcommand retrieves and submits certificate signing requests (CSRs)\.
16
16
  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\.
17
17
  .
18
18
  .P
19
- See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/references/stable/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\.
19
+ See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
20
20
  .
21
21
  .TP
22
22
  \-\-render\-as FORMAT
@@ -35,7 +35,7 @@ Whether to log debug information\.
35
35
  A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
36
36
  .
37
37
  .TP
38
- \-\-terminus TERMINUS
38
+ \-\-terminus _TERMINUS
39
39
  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\.
40
40
  .
41
41
  .IP
@@ -51,7 +51,7 @@ The terminus for an action is often determined by context, but occasionally need
51
51
  \fBSYNOPSIS\fR
52
52
  .
53
53
  .IP
54
- puppet certificate_request find [\-\-terminus TERMINUS] [\-\-extra HASH] [\fIhost\fR]
54
+ puppet certificate_request find [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fIhost\fR]
55
55
  .
56
56
  .IP
57
57
  \fBDESCRIPTION\fR
@@ -73,7 +73,7 @@ Defaults to the current nodes certname\.
73
73
  \fBSYNOPSIS\fR
74
74
  .
75
75
  .IP
76
- puppet certificate_request info [\-\-terminus TERMINUS] [\-\-extra HASH]
76
+ puppet certificate_request info [\-\-terminus _TERMINUS] [\-\-extra HASH]
77
77
  .
78
78
  .IP
79
79
  \fBDESCRIPTION\fR
@@ -86,7 +86,7 @@ Prints the default terminus class for this subcommand\. Note that different run
86
86
  \fBSYNOPSIS\fR
87
87
  .
88
88
  .IP
89
- puppet certificate_request save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIx509_CSR\fR
89
+ puppet certificate_request save [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIx509_CSR\fR
90
90
  .
91
91
  .IP
92
92
  \fBDESCRIPTION\fR
@@ -99,7 +99,7 @@ API only: create or overwrite an object\. As the Faces framework does not curren
99
99
  \fBSYNOPSIS\fR
100
100
  .
101
101
  .IP
102
- puppet certificate_request search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
102
+ puppet certificate_request search [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
103
103
  .
104
104
  .IP
105
105
  \fBDESCRIPTION\fR
@@ -158,4 +158,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
158
158
  .IP "" 0
159
159
  .
160
160
  .SH "COPYRIGHT AND LICENSE"
161
- Copyright 2011 by Puppet Labs Apache 2 license; see COPYING
161
+ Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
- .\" https://github.com/rtomayko/ronn/tree/0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-CERTIFICATE_REVOCATION_LIST" "8" "May 2015" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CERTIFICATE_REVOCATION_LIST" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-certificate_revocation_list\fR \- Manage the list of revoked certificates\.
8
8
  .
9
9
  .SH "SYNOPSIS"
10
- puppet certificate_revocation_list \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
10
+ puppet certificate_revocation_list \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
11
11
  .
12
12
  .SH "DESCRIPTION"
13
13
  This subcommand is primarily for retrieving the certificate revocation list from the CA\.
@@ -16,7 +16,7 @@ This subcommand is primarily for retrieving the certificate revocation list from
16
16
  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\.
17
17
  .
18
18
  .P
19
- See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/references/stable/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\.
19
+ See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
20
20
  .
21
21
  .TP
22
22
  \-\-render\-as FORMAT
@@ -35,7 +35,7 @@ Whether to log debug information\.
35
35
  A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
36
36
  .
37
37
  .TP
38
- \-\-terminus TERMINUS
38
+ \-\-terminus _TERMINUS
39
39
  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\.
40
40
  .
41
41
  .IP
@@ -51,7 +51,7 @@ The terminus for an action is often determined by context, but occasionally need
51
51
  \fBSYNOPSIS\fR
52
52
  .
53
53
  .IP
54
- puppet certificate_revocation_list destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
54
+ puppet certificate_revocation_list destroy [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
55
55
  .
56
56
  .IP
57
57
  \fBDESCRIPTION\fR
@@ -76,7 +76,7 @@ Although this action always deletes the CRL from the specified terminus, it requ
76
76
  \fBSYNOPSIS\fR
77
77
  .
78
78
  .IP
79
- puppet certificate_revocation_list find [\-\-terminus TERMINUS] [\-\-extra HASH] [\fIkey\fR]
79
+ puppet certificate_revocation_list find [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fIkey\fR]
80
80
  .
81
81
  .IP
82
82
  \fBDESCRIPTION\fR
@@ -101,7 +101,7 @@ Although this action always returns the CRL from the specified terminus\.
101
101
  \fBSYNOPSIS\fR
102
102
  .
103
103
  .IP
104
- puppet certificate_revocation_list info [\-\-terminus TERMINUS] [\-\-extra HASH]
104
+ puppet certificate_revocation_list info [\-\-terminus _TERMINUS] [\-\-extra HASH]
105
105
  .
106
106
  .IP
107
107
  \fBDESCRIPTION\fR
@@ -136,4 +136,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
136
136
  .IP "" 0
137
137
  .
138
138
  .SH "COPYRIGHT AND LICENSE"
139
- Copyright 2011 by Puppet Labs Apache 2 license; see COPYING
139
+ Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
- .\" https://github.com/rtomayko/ronn/tree/0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-CONFIG" "8" "May 2015" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CONFIG" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-config\fR \- Interact with Puppet\'s settings\.
@@ -10,13 +10,13 @@
10
10
  puppet config \fIaction\fR [\-\-section SECTION_NAME]
11
11
  .
12
12
  .SH "DESCRIPTION"
13
- This subcommand can inspect and modify settings from Puppet\'s \'puppet\.conf\' configuration file\. For documentation about individual settings, see https://docs\.puppetlabs\.com/references/latest/configuration\.html\.
13
+ This subcommand can inspect and modify settings from Puppet\'s \'puppet\.conf\' configuration file\. For documentation about individual settings, see https://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html\.
14
14
  .
15
15
  .SH "OPTIONS"
16
16
  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\.
17
17
  .
18
18
  .P
19
- See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/references/stable/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\.
19
+ See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/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\.
20
20
  .
21
21
  .TP
22
22
  \-\-render\-as FORMAT
@@ -114,4 +114,4 @@ Set the vardir for only the agent:
114
114
  $ puppet config set vardir /opt/puppetlabs/puppet/cache \-\-section agent
115
115
  .
116
116
  .SH "COPYRIGHT AND LICENSE"
117
- Copyright 2011 by Puppet Labs Apache 2 license; see COPYING
117
+ Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
- .\" https://github.com/rtomayko/ronn/tree/0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-DESCRIBE" "8" "May 2015" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-DESCRIBE" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-describe\fR \- Display help about resource types
@@ -48,4 +48,4 @@ $ puppet describe user \-s \-m
48
48
  David Lutterkort
49
49
  .
50
50
  .SH "COPYRIGHT"
51
- Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2\.0 License
51
+ Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
- .\" https://github.com/rtomayko/ronn/tree/0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-DEVICE" "8" "May 2015" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-DEVICE" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-device\fR \- Manage remote network devices
@@ -13,7 +13,7 @@ Retrieves all configurations from the puppet master and apply them to the remote
13
13
  Currently must be run out periodically, using cron or something similar\.
14
14
  .
15
15
  .SH "USAGE"
16
- puppet device [\-d|\-\-debug] [\-\-detailed\-exitcodes] [\-V|\-\-version] [\-h|\-\-help] [\-l|\-\-logdest syslog|\fIfile\fR|console] [\-v|\-\-verbose] [\-w|\-\-waitforcert \fIseconds\fR]
16
+ puppet device [\-d|\-\-debug] [\-\-detailed\-exitcodes] [\-\-deviceconfig \fIfile\fR] [\-h|\-\-help] [\-l|\-\-logdest syslog|\fIfile\fR|console] [\-v|\-\-verbose] [\-w|\-\-waitforcert \fIseconds\fR] [\-t|\-\-target \fIdevice\fR] [\-V|\-\-version]
17
17
  .
18
18
  .SH "DESCRIPTION"
19
19
  Once the client has a signed certificate for a given remote device, it will retrieve its configuration and apply it\.
@@ -42,7 +42,11 @@ Enable full debugging\.
42
42
  .
43
43
  .TP
44
44
  \-\-detailed\-exitcodes
45
- Provide transaction information via exit codes\. If this is enabled, an exit code of \'1\' means at least one device had a compile failure, an exit code of \'2\' means at least one device had resource changes, and an exit code of \'4\' means at least one device had resource failures\. Exit codes of \'3\', \'5\', \'6\', or \'7\' means that a bitwise combination of the preceeding exit codes happened\.
45
+ Provide transaction information via exit codes\. If this is enabled, an exit code of \'1\' means at least one device had a compile failure, an exit code of \'2\' means at least one device had resource changes, and an exit code of \'4\' means at least one device had resource failures\. Exit codes of \'3\', \'5\', \'6\', or \'7\' means that a bitwise combination of the preceding exit codes happened\.
46
+ .
47
+ .TP
48
+ \-\-deviceconfig
49
+ Path to the device config file for puppet device\. Default: $confdir/device\.conf
46
50
  .
47
51
  .TP
48
52
  \-\-help
@@ -56,6 +60,10 @@ Where to send log messages\. Choose between \'syslog\' (the POSIX syslog service
56
60
  A path ending with \'\.json\' will receive structured output in JSON format\. The log file will not have an ending \']\' automatically written to it due to the appending nature of logging\. It must be appended manually to make the content valid JSON\.
57
61
  .
58
62
  .TP
63
+ \-\-target
64
+ Target a specific device/certificate in the device\.conf\. Doing so will perform a device run against only that device/certificate\.
65
+ .
66
+ .TP
59
67
  \-\-verbose
60
68
  Turn on verbose reporting\.
61
69
  .
@@ -75,4 +83,4 @@ This option only matters for daemons that do not yet have certificates and it is
75
83
  Brice Figureau
76
84
  .
77
85
  .SH "COPYRIGHT"
78
- Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2\.0 License
86
+ Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
@@ -1,19 +1,19 @@
1
1
  .\" generated with Ronn/v0.7.3
2
- .\" https://github.com/rtomayko/ronn/tree/0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-DOC" "8" "May 2015" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-DOC" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-doc\fR \- Generate Puppet references
8
8
  .
9
9
  .SH "SYNOPSIS"
10
- Generates a reference for all Puppet types\. Largely meant for internal Puppet Labs use\. (Deprecated)
10
+ Generates a reference for all Puppet types\. Largely meant for internal Puppet Inc\. use\. (Deprecated)
11
11
  .
12
12
  .SH "USAGE"
13
13
  puppet doc [\-h|\-\-help] [\-l|\-\-list] [\-r|\-\-reference \fIreference\-name\fR]
14
14
  .
15
15
  .SH "DESCRIPTION"
16
- This deprecated command generates a Markdown document to stdout describing all installed Puppet types or all allowable arguments to puppet executables\. It is largely meant for internal use and is used to generate the reference document available on the Puppet Labs web site\.
16
+ This deprecated command generates a Markdown document to stdout describing all installed Puppet types or all allowable arguments to puppet executables\. It is largely meant for internal use and is used to generate the reference document available on the Puppet Inc\. web site\.
17
17
  .
18
18
  .P
19
19
  For Puppet module documentation (and all other use cases) this command has been superseded by the "puppet\-strings" module \- see https://github\.com/puppetlabs/puppetlabs\-strings for more information\.
@@ -43,4 +43,4 @@ $ puppet doc \-r type > /tmp/type_reference\.markdown
43
43
  Luke Kanies
44
44
  .
45
45
  .SH "COPYRIGHT"
46
- Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2\.0 License
46
+ Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License