puppet 2.7.14 → 2.7.16

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 (111) hide show
  1. data/CHANGELOG +85 -0
  2. data/conf/redhat/puppet.spec +31 -4
  3. data/lib/puppet.rb +1 -1
  4. data/lib/puppet/defaults.rb +2 -3
  5. data/lib/puppet/face/module/install.rb +3 -3
  6. data/lib/puppet/face/module/search.rb +3 -3
  7. data/lib/puppet/indirector/face.rb +1 -1
  8. data/lib/puppet/network/http_pool.rb +17 -8
  9. data/lib/puppet/node/environment.rb +1 -3
  10. data/lib/puppet/parser/ast.rb +1 -1
  11. data/lib/puppet/parser/compiler.rb +2 -10
  12. data/lib/puppet/parser/functions/template.rb +2 -1
  13. data/lib/puppet/parser/lexer.rb +2 -2
  14. data/lib/puppet/parser/scope.rb +3 -2
  15. data/lib/puppet/provider/package/gem.rb +3 -1
  16. data/lib/puppet/provider/package/pkg.rb +18 -2
  17. data/lib/puppet/provider/service/gentoo.rb +5 -0
  18. data/lib/puppet/provider/service/init.rb +12 -14
  19. data/lib/puppet/provider/service/redhat.rb +1 -1
  20. data/lib/puppet/provider/service/upstart.rb +257 -7
  21. data/lib/puppet/provider/ssh_authorized_key/parsed.rb +6 -9
  22. data/lib/puppet/reports/http.rb +1 -1
  23. data/lib/puppet/reports/tagmail.rb +1 -1
  24. data/lib/puppet/type/cron.rb +5 -0
  25. data/lib/puppet/type/filebucket.rb +12 -0
  26. data/lib/puppet/util.rb +15 -9
  27. data/lib/puppet/util/colors.rb +94 -64
  28. data/lib/puppet/util/platform.rb +15 -0
  29. data/man/man5/puppet.conf.5 +73 -27
  30. data/man/man8/filebucket.8 +1 -1
  31. data/man/man8/pi.8 +1 -1
  32. data/man/man8/puppet-agent.8 +17 -17
  33. data/man/man8/puppet-apply.8 +8 -3
  34. data/man/man8/puppet-ca.8 +183 -0
  35. data/man/man8/puppet-catalog.8 +17 -10
  36. data/man/man8/puppet-cert.8 +1 -1
  37. data/man/man8/puppet-certificate.8 +27 -11
  38. data/man/man8/puppet-certificate_request.8 +12 -11
  39. data/man/man8/puppet-certificate_revocation_list.8 +11 -10
  40. data/man/man8/puppet-config.8 +1 -1
  41. data/man/man8/puppet-describe.8 +1 -1
  42. data/man/man8/puppet-device.8 +2 -2
  43. data/man/man8/puppet-doc.8 +15 -3
  44. data/man/man8/puppet-facts.8 +18 -8
  45. data/man/man8/puppet-file.8 +13 -22
  46. data/man/man8/puppet-filebucket.8 +1 -1
  47. data/man/man8/puppet-help.8 +1 -1
  48. data/man/man8/puppet-inspect.8 +10 -2
  49. data/man/man8/puppet-instrumentation_data.8 +145 -0
  50. data/man/man8/puppet-instrumentation_listener.8 +222 -0
  51. data/man/man8/puppet-instrumentation_probe.8 +207 -0
  52. data/man/man8/puppet-key.8 +11 -7
  53. data/man/man8/puppet-kick.8 +35 -3
  54. data/man/man8/puppet-man.8 +1 -1
  55. data/man/man8/puppet-master.8 +1 -1
  56. data/man/man8/puppet-module.8 +451 -0
  57. data/man/man8/puppet-node.8 +64 -22
  58. data/man/man8/puppet-parser.8 +1 -1
  59. data/man/man8/puppet-plugin.8 +1 -1
  60. data/man/man8/puppet-queue.8 +1 -1
  61. data/man/man8/puppet-report.8 +12 -8
  62. data/man/man8/puppet-resource.8 +1 -1
  63. data/man/man8/puppet-resource_type.8 +11 -7
  64. data/man/man8/puppet-secret_agent.8 +1 -1
  65. data/man/man8/puppet-status.8 +11 -7
  66. data/man/man8/puppet.8 +1 -1
  67. data/man/man8/puppetca.8 +1 -1
  68. data/man/man8/puppetd.8 +17 -17
  69. data/man/man8/puppetdoc.8 +15 -3
  70. data/man/man8/puppetmasterd.8 +1 -1
  71. data/man/man8/puppetqd.8 +1 -1
  72. data/man/man8/puppetrun.8 +35 -3
  73. data/man/man8/ralsh.8 +1 -1
  74. data/spec/fixtures/unit/provider/package/gem/line-with-1.8.5-warning +14 -0
  75. data/spec/fixtures/unit/provider/package/pkg/{dummy → dummy_solaris10} +0 -0
  76. data/spec/fixtures/unit/provider/package/pkg/dummy_solaris11 +1 -0
  77. data/spec/fixtures/unit/provider/package/pkg/solaris11 +12 -0
  78. data/spec/fixtures/unit/provider/package/pkg/unknown_status +12 -0
  79. data/spec/fixtures/unit/provider/service/gentoo/rc_update_show +30 -0
  80. data/spec/integration/defaults_spec.rb +2 -7
  81. data/spec/integration/network/server/mongrel_spec.rb +16 -10
  82. data/spec/integration/network/server/webrick_spec.rb +16 -9
  83. data/spec/integration/provider/service/init_spec.rb +20 -4
  84. data/spec/integration/provider/ssh_authorized_key_spec.rb +119 -107
  85. data/spec/unit/face/module/install_spec.rb +16 -4
  86. data/spec/unit/network/http/api/v1_spec.rb +8 -0
  87. data/spec/unit/network/http_pool_spec.rb +80 -74
  88. data/spec/unit/node/environment_spec.rb +9 -4
  89. data/spec/unit/parser/ast/leaf_spec.rb +2 -2
  90. data/spec/unit/parser/ast_spec.rb +3 -3
  91. data/spec/unit/parser/compiler_spec.rb +0 -17
  92. data/spec/unit/parser/lexer_spec.rb +45 -2
  93. data/spec/unit/parser/scope_spec.rb +181 -14
  94. data/spec/unit/provider/package/gem_spec.rb +17 -1
  95. data/spec/unit/provider/package/pkg_spec.rb +70 -22
  96. data/spec/unit/provider/service/gentoo_spec.rb +237 -0
  97. data/spec/unit/provider/service/init_spec.rb +2 -2
  98. data/spec/unit/provider/service/redhat_spec.rb +2 -2
  99. data/spec/unit/provider/service/upstart_spec.rb +414 -5
  100. data/spec/unit/provider/ssh_authorized_key/parsed_spec.rb +24 -0
  101. data/spec/unit/reports/tagmail_spec.rb +50 -0
  102. data/spec/unit/type/cron_spec.rb +21 -1
  103. data/spec/unit/type/filebucket_spec.rb +39 -9
  104. data/spec/unit/util/colors_spec.rb +69 -0
  105. data/spec/unit/util/log/destinations_spec.rb +17 -9
  106. data/spec/unit/util/log_spec.rb +2 -1
  107. data/spec/unit/util_spec.rb +11 -0
  108. data/tasks/rake/gem.rake +1 -1
  109. data/tasks/rake/manpages.rake +11 -3
  110. data/test/network/handler/fileserver.rb +7 -1
  111. metadata +22 -10
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-CERTIFICATE" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CERTIFICATE" "8" "June 2012" "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] [\-\-ca\-location LOCATION]
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\.
@@ -42,6 +42,10 @@ Whether to act on the local certificate authority or one provided by a remote pu
42
42
  This option is required\.
43
43
  .
44
44
  .TP
45
+ \-\-extra HASH
46
+ 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\.
47
+ .
48
+ .TP
45
49
  \-\-terminus TERMINUS
46
50
  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
51
  .
@@ -58,7 +62,7 @@ The terminus for an action is often determined by context, but occasionally need
58
62
  \fBSYNOPSIS\fR
59
63
  .
60
64
  .IP
61
- puppet certificate destroy [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION] \fIhost\fR
65
+ puppet certificate destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
62
66
  .
63
67
  .IP
64
68
  \fBDESCRIPTION\fR
@@ -77,7 +81,7 @@ Nothing\.
77
81
  \fBSYNOPSIS\fR
78
82
  .
79
83
  .IP
80
- puppet certificate find [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION] \fIhost\fR
84
+ puppet certificate find [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
81
85
  .
82
86
  .IP
83
87
  \fBDESCRIPTION\fR
@@ -89,7 +93,7 @@ Retrieve a certificate\.
89
93
  \fBRETURNS\fR
90
94
  .
91
95
  .IP
92
- An x509 SSL certificate\. You will usually want to render this as a string (\-\-render\-as s)\.
96
+ An x509 SSL certificate\.
93
97
  .
94
98
  .IP
95
99
  Note that this action has a side effect of caching a copy of the certificate in Puppet\'s \fBssldir\fR\.
@@ -99,7 +103,7 @@ Note that this action has a side effect of caching a copy of the certificate in
99
103
  \fBSYNOPSIS\fR
100
104
  .
101
105
  .IP
102
- puppet certificate generate [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION] \fIhost\fR
106
+ puppet certificate generate [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-dns\-alt\-names NAMES] \fIhost\fR
103
107
  .
104
108
  .IP
105
109
  \fBDESCRIPTION\fR
@@ -111,6 +115,12 @@ Generates and submits a certificate signing request (CSR) for the specified host
111
115
  Puppet agent usually handles CSR submission automatically\. This action is primarily useful for requesting certificates for individual users and external applications\.
112
116
  .
113
117
  .IP
118
+ \fBOPTIONS\fR
119
+ .
120
+ .IP
121
+ \fI\-\-dns\-alt\-names NAMES\fR \- The comma\-separated list of alternative DNS names to use for the local host\. 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\. 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\. This is unnecessary for agents, unless you intend to use them as a server for \fBpuppet kick\fR or remote \fBpuppet resource\fR management\. 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\.
122
+ .
123
+ .IP
114
124
  \fBRETURNS\fR
115
125
  .
116
126
  .IP
@@ -121,7 +131,7 @@ Nothing\.
121
131
  \fBSYNOPSIS\fR
122
132
  .
123
133
  .IP
124
- puppet certificate info [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION]
134
+ puppet certificate info [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
125
135
  .
126
136
  .IP
127
137
  \fBDESCRIPTION\fR
@@ -134,7 +144,7 @@ Prints the default terminus class for this subcommand\. Note that different run
134
144
  \fBSYNOPSIS\fR
135
145
  .
136
146
  .IP
137
- puppet certificate list [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION]
147
+ puppet certificate list [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
138
148
  .
139
149
  .IP
140
150
  \fBDESCRIPTION\fR
@@ -153,7 +163,7 @@ An array of #inspect output from CSR objects\. This output is currently messy, b
153
163
  \fBSYNOPSIS\fR
154
164
  .
155
165
  .IP
156
- puppet certificate save [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION]
166
+ puppet certificate save [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIkey\fR
157
167
  .
158
168
  .IP
159
169
  \fBDESCRIPTION\fR
@@ -166,7 +176,7 @@ Invalid for this subcommand\.
166
176
  \fBSYNOPSIS\fR
167
177
  .
168
178
  .IP
169
- puppet certificate search [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION] \fIquery\fR
179
+ puppet certificate search [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIquery\fR
170
180
  .
171
181
  .IP
172
182
  \fBDESCRIPTION\fR
@@ -179,7 +189,7 @@ Invalid for this subcommand\.
179
189
  \fBSYNOPSIS\fR
180
190
  .
181
191
  .IP
182
- puppet certificate sign [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION] \fIhost\fR
192
+ puppet certificate sign [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-[no\-]allow\-dns\-alt\-names] \fIhost\fR
183
193
  .
184
194
  .IP
185
195
  \fBDESCRIPTION\fR
@@ -188,6 +198,12 @@ puppet certificate sign [\-\-terminus TERMINUS] [\-\-ca\-location LOCATION] \fIh
188
198
  Sign a certificate signing request for HOST\.
189
199
  .
190
200
  .IP
201
+ \fBOPTIONS\fR
202
+ .
203
+ .IP
204
+ \fI\-\-[no\-]allow\-dns\-alt\-names\fR \- Whether or not to accept DNS alt names in the certificate request
205
+ .
206
+ .IP
191
207
  \fBRETURNS\fR
192
208
  .
193
209
  .IP
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-CERTIFICATE_REQUEST" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CERTIFICATE_REQUEST" "8" "June 2012" "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]
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)\.
@@ -35,6 +35,10 @@ Whether to log verbosely\.
35
35
  Whether to log debug information\.
36
36
  .
37
37
  .TP
38
+ \-\-extra HASH
39
+ 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\.
40
+ .
41
+ .TP
38
42
  \-\-terminus TERMINUS
39
43
  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
44
  .
@@ -51,7 +55,7 @@ The terminus for an action is often determined by context, but occasionally need
51
55
  \fBSYNOPSIS\fR
52
56
  .
53
57
  .IP
54
- puppet certificate_request destroy [\-\-terminus TERMINUS] \fIkey\fR
58
+ puppet certificate_request destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
55
59
  .
56
60
  .IP
57
61
  \fBDESCRIPTION\fR
@@ -64,7 +68,7 @@ Invalid for this subcommand\.
64
68
  \fBSYNOPSIS\fR
65
69
  .
66
70
  .IP
67
- puppet certificate_request find [\-\-terminus TERMINUS] \fIhost\fR
71
+ puppet certificate_request find [\-\-terminus TERMINUS] [\-\-extra HASH] \fIhost\fR
68
72
  .
69
73
  .IP
70
74
  \fBDESCRIPTION\fR
@@ -78,15 +82,12 @@ Retrieve a single CSR\.
78
82
  .IP
79
83
  A single certificate request\. When used from the Ruby API, returns a Puppet::SSL::CertificateRequest object\.
80
84
  .
81
- .IP
82
- RENDERING ISSUES: In most cases, you will want to render this as a string (\'\-\-render\-as s\')\.
83
- .
84
85
  .TP
85
86
  \fBinfo\fR \- Print the default terminus class for this face\.
86
87
  \fBSYNOPSIS\fR
87
88
  .
88
89
  .IP
89
- puppet certificate_request info [\-\-terminus TERMINUS]
90
+ puppet certificate_request info [\-\-terminus TERMINUS] [\-\-extra HASH]
90
91
  .
91
92
  .IP
92
93
  \fBDESCRIPTION\fR
@@ -99,7 +100,7 @@ Prints the default terminus class for this subcommand\. Note that different run
99
100
  \fBSYNOPSIS\fR
100
101
  .
101
102
  .IP
102
- puppet certificate_request save [\-\-terminus TERMINUS] \fIx509_CSR\fR
103
+ puppet certificate_request save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIx509_CSR\fR
103
104
  .
104
105
  .IP
105
106
  \fBDESCRIPTION\fR
@@ -112,7 +113,7 @@ API only: create or overwrite an object\. As the Faces framework does not curren
112
113
  \fBSYNOPSIS\fR
113
114
  .
114
115
  .IP
115
- puppet certificate_request search [\-\-terminus TERMINUS] \fIdummy_text\fR
116
+ puppet certificate_request search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
116
117
  .
117
118
  .IP
118
119
  \fBDESCRIPTION\fR
@@ -124,7 +125,7 @@ Retrieve all outstanding CSRs\.
124
125
  \fBRETURNS\fR
125
126
  .
126
127
  .IP
127
- A list of certificate requests; be sure to to render this as a string (\'\-\-render\-as s\')\. When used from the Ruby API, returns an array of Puppet::SSL::CertificateRequest objects\.
128
+ A list of certificate requests\. When used from the Ruby API, returns an array of Puppet::SSL::CertificateRequest objects\.
128
129
  .
129
130
  .IP
130
131
  \fBNOTES\fR
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-CERTIFICATE_REVOCATION_LIST" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CERTIFICATE_REVOCATION_LIST" "8" "June 2012" "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]
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\.
@@ -35,6 +35,10 @@ Whether to log verbosely\.
35
35
  Whether to log debug information\.
36
36
  .
37
37
  .TP
38
+ \-\-extra HASH
39
+ 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\.
40
+ .
41
+ .TP
38
42
  \-\-terminus TERMINUS
39
43
  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
44
  .
@@ -51,7 +55,7 @@ The terminus for an action is often determined by context, but occasionally need
51
55
  \fBSYNOPSIS\fR
52
56
  .
53
57
  .IP
54
- puppet certificate_revocation_list destroy [\-\-terminus TERMINUS] \fIdummy_text\fR
58
+ puppet certificate_revocation_list destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
55
59
  .
56
60
  .IP
57
61
  \fBDESCRIPTION\fR
@@ -76,7 +80,7 @@ Although this action always deletes the CRL from the specified terminus, it requ
76
80
  \fBSYNOPSIS\fR
77
81
  .
78
82
  .IP
79
- puppet certificate_revocation_list find [\-\-terminus TERMINUS] \fIdummy_text\fR
83
+ puppet certificate_revocation_list find [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
80
84
  .
81
85
  .IP
82
86
  \fBDESCRIPTION\fR
@@ -91,9 +95,6 @@ Retrieve the certificate revocation list\.
91
95
  The certificate revocation list\. When used from the Ruby API: returns an OpenSSL::X509::CRL object\.
92
96
  .
93
97
  .IP
94
- RENDERING ISSUES: this should usually be rendered as a string (\'\-\-render\-as s\')\.
95
- .
96
- .IP
97
98
  \fBNOTES\fR
98
99
  .
99
100
  .IP
@@ -104,7 +105,7 @@ Although this action always returns the CRL from the specified terminus, it requ
104
105
  \fBSYNOPSIS\fR
105
106
  .
106
107
  .IP
107
- puppet certificate_revocation_list info [\-\-terminus TERMINUS]
108
+ puppet certificate_revocation_list info [\-\-terminus TERMINUS] [\-\-extra HASH]
108
109
  .
109
110
  .IP
110
111
  \fBDESCRIPTION\fR
@@ -117,7 +118,7 @@ Prints the default terminus class for this subcommand\. Note that different run
117
118
  \fBSYNOPSIS\fR
118
119
  .
119
120
  .IP
120
- puppet certificate_revocation_list save [\-\-terminus TERMINUS]
121
+ puppet certificate_revocation_list save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
121
122
  .
122
123
  .IP
123
124
  \fBDESCRIPTION\fR
@@ -130,7 +131,7 @@ Invalid for this subcommand\.
130
131
  \fBSYNOPSIS\fR
131
132
  .
132
133
  .IP
133
- puppet certificate_revocation_list search [\-\-terminus TERMINUS] \fIquery\fR
134
+ puppet certificate_revocation_list search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
134
135
  .
135
136
  .IP
136
137
  \fBDESCRIPTION\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\-CONFIG" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-CONFIG" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-config\fR \- Interact with Puppet\'s configuration options\.
@@ -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\-DESCRIBE" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-DESCRIBE" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-describe\fR \- Display help about resource types
@@ -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\-DEVICE" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-DEVICE" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-device\fR \- Manage remote network devices
@@ -53,7 +53,7 @@ Enable full debugging\.
53
53
  .
54
54
  .TP
55
55
  \-\-detailed\-exitcodes
56
- Provide transaction information via exit codes\. If this is enabled, an exit code of \'2\' means there were changes, and an exit code of \'4\' means that there were failures during the transaction\. This option only makes sense in conjunction with \-\-onetime\.
56
+ Provide transaction information via exit codes\. If this is enabled, an exit code of \'2\' means there were changes, an exit code of \'4\' means there were failures during the transaction, and an exit code of \'6\' means there were both changes and failures\.
57
57
  .
58
58
  .TP
59
59
  \-\-help
@@ -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\-DOC" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-DOC" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-doc\fR \- Generate Puppet documentation and references
@@ -25,7 +25,7 @@ If the command is run with the name of a manifest file as an argument, puppet do
25
25
  .
26
26
  .TP
27
27
  \-\-all
28
- Output the docs for all of the reference types\. In \'rdoc\' modes, this also outputs documentation for all resources
28
+ Output the docs for all of the reference types\. In \'rdoc\' mode, this also outputs documentation for all resources\.
29
29
  .
30
30
  .TP
31
31
  \-\-help
@@ -33,7 +33,7 @@ Print this help message
33
33
  .
34
34
  .TP
35
35
  \-\-outputdir
36
- Specifies the directory where to output the rdoc documentation in \'rdoc\' mode\.
36
+ Used only in \'rdoc\' mode\. The directory to which the rdoc output should be written\.
37
37
  .
38
38
  .TP
39
39
  \-\-mode
@@ -47,6 +47,18 @@ Build a particular reference\. Get a list of references by running \'puppet doc
47
47
  \-\-charset
48
48
  Used only in \'rdoc\' mode\. It sets the charset used in the html files produced\.
49
49
  .
50
+ .TP
51
+ \-\-manifestdir
52
+ Used only in \'rdoc\' mode\. The directory to scan for stand\-alone manifests\. If not supplied, puppet doc will use the manifestdir from puppet\.conf\.
53
+ .
54
+ .TP
55
+ \-\-modulepath
56
+ Used only in \'rdoc\' mode\. The directory or directories to scan for modules\. If not supplied, puppet doc will use the modulepath from puppet\.conf\.
57
+ .
58
+ .TP
59
+ \-\-environment
60
+ Used only in \'rdoc\' mode\. The configuration environment from which to read the modulepath and manifestdir settings, when reading said settings from puppet\.conf\. Due to a known bug, this option is not currently effective\.
61
+ .
50
62
  .SH "EXAMPLE"
51
63
  .
52
64
  .nf
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET\-FACTS" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
4
+ .TH "PUPPET\-FACTS" "8" "June 2012" "Puppet Labs, LLC" "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-facts\fR \- Retrieve and store facts\.
8
8
  .
9
9
  .SH "SYNOPSIS"
10
- puppet facts \fIaction\fR [\-\-terminus TERMINUS]
10
+ puppet facts \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
11
11
  .
12
12
  .SH "DESCRIPTION"
13
13
  This subcommand manages facts, which are collections of normalized system information used by Puppet\. It can read facts directly from the local system (with the default \fBfacter\fR terminus), look up facts reported by other systems, and submit facts to the puppet master\.
@@ -38,6 +38,10 @@ Whether to log verbosely\.
38
38
  Whether to log debug information\.
39
39
  .
40
40
  .TP
41
+ \-\-extra HASH
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
+ .
44
+ .TP
41
45
  \-\-terminus TERMINUS
42
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\.
43
47
  .
@@ -54,7 +58,7 @@ The terminus for an action is often determined by context, but occasionally need
54
58
  \fBSYNOPSIS\fR
55
59
  .
56
60
  .IP
57
- puppet facts destroy [\-\-terminus TERMINUS] \fIkey\fR
61
+ puppet facts destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
58
62
  .
59
63
  .IP
60
64
  \fBDESCRIPTION\fR
@@ -67,7 +71,7 @@ Invalid for this subcommand\.
67
71
  \fBSYNOPSIS\fR
68
72
  .
69
73
  .IP
70
- puppet facts find [\-\-terminus TERMINUS] \fInode_certname\fR
74
+ puppet facts find [\-\-terminus TERMINUS] [\-\-extra HASH] \fInode_certname\fR
71
75
  .
72
76
  .IP
73
77
  \fBDESCRIPTION\fR
@@ -95,7 +99,7 @@ When using the \fBfacter\fR terminus, the host argument is ignored\.
95
99
  \fBSYNOPSIS\fR
96
100
  .
97
101
  .IP
98
- puppet facts info [\-\-terminus TERMINUS]
102
+ puppet facts info [\-\-terminus TERMINUS] [\-\-extra HASH]
99
103
  .
100
104
  .IP
101
105
  \fBDESCRIPTION\fR
@@ -108,7 +112,7 @@ Prints the default terminus class for this subcommand\. Note that different run
108
112
  \fBSYNOPSIS\fR
109
113
  .
110
114
  .IP
111
- puppet facts save [\-\-terminus TERMINUS]
115
+ puppet facts save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
112
116
  .
113
117
  .IP
114
118
  \fBDESCRIPTION\fR
@@ -121,7 +125,7 @@ API only: create or overwrite an object\. As the Faces framework does not curren
121
125
  \fBSYNOPSIS\fR
122
126
  .
123
127
  .IP
124
- puppet facts search [\-\-terminus TERMINUS] \fIquery\fR
128
+ puppet facts search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
125
129
  .
126
130
  .IP
127
131
  \fBDESCRIPTION\fR
@@ -134,7 +138,7 @@ Invalid for this subcommand\.
134
138
  \fBSYNOPSIS\fR
135
139
  .
136
140
  .IP
137
- puppet facts upload [\-\-terminus TERMINUS]
141
+ puppet facts upload [\-\-terminus TERMINUS] [\-\-extra HASH]
138
142
  .
139
143
  .IP
140
144
  \fBDESCRIPTION\fR
@@ -200,6 +204,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
200
204
  \fBinventory_active_record\fR
201
205
  .
202
206
  .IP "\(bu" 4
207
+ \fBinventory_service\fR
208
+ .
209
+ .IP "\(bu" 4
203
210
  \fBmemory\fR
204
211
  .
205
212
  .IP "\(bu" 4
@@ -209,6 +216,9 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
209
216
  \fBrest\fR
210
217
  .
211
218
  .IP "\(bu" 4
219
+ \fBstore_configs\fR
220
+ .
221
+ .IP "\(bu" 4
212
222
  \fByaml\fR
213
223
  .
214
224
  .IP "" 0