Skip to content

Commit 3960fbe

Browse files
authored
Merge pull request #9 from OpenVoxProject/debrand_mans
update generated man pages for the debrand
2 parents fae3987 + 8ab2d6a commit 3960fbe

23 files changed

+545
-2363
lines changed

man/man5/puppet.conf.5

Lines changed: 171 additions & 990 deletions
Large diffs are not rendered by default.

man/man8/puppet-agent.8

Lines changed: 39 additions & 107 deletions
Large diffs are not rendered by default.

man/man8/puppet-apply.8

Lines changed: 18 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,101 +1,67 @@
1-
.\" generated with Ronn/v0.7.3
2-
.\" http://github.com/rtomayko/ronn/tree/0.7.3
3-
.
4-
.TH "PUPPET\-APPLY" "8" "October 2024" "Puppet, Inc." "Puppet manual"
5-
.
1+
.\" generated with Ronn-NG/v0.10.1
2+
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3+
.TH "PUPPET\-APPLY" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
64
.SH "NAME"
7-
\fBpuppet\-apply\fR \- Apply Puppet manifests locally
8-
.
5+
\fBpuppet\-apply\fR \- Apply Puppet manifests locally via OpenVox
96
.SH "SYNOPSIS"
107
Applies a standalone Puppet manifest to the local system\.
11-
.
128
.SH "USAGE"
139
puppet apply [\-h|\-\-help] [\-V|\-\-version] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-execute] [\-\-detailed\-exitcodes] [\-L|\-\-loadclasses] [\-l|\-\-logdest syslog|eventlog|\fIABS FILEPATH\fR|console] [\-\-noop] [\-\-catalog \fIcatalog\fR] [\-\-write\-catalog\-summary] \fIfile\fR
14-
.
1510
.SH "DESCRIPTION"
1611
This is the standalone puppet execution tool; use it to apply individual manifests\.
17-
.
1812
.P
19-
When provided with a modulepath, via command line or config file, puppet apply can effectively mimic the catalog that would be served by puppet master with access to the same modules, although there are some subtle differences\. When combined with scheduling and an automated system for pushing manifests, this can be used to implement a serverless Puppet site\.
20-
.
13+
When provided with a modulepath, via command line or config file, puppet apply can effectively mimic the catalog that would be served by OpenVox server with access to the same modules, although there are some subtle differences\. When combined with scheduling and an automated system for pushing manifests, this can be used to implement a serverless site\.
2114
.P
22-
Most users should use \'puppet agent\' and \'puppet master\' for site\-wide manifests\.
23-
.
15+
Most users should use 'puppet agent' and 'puppet master' for site\-wide manifests\.
2416
.SH "OPTIONS"
25-
Any setting that\'s valid in the configuration file is a valid long argument for puppet apply\. For example, \'tags\' is a valid setting, so you can specify \'\-\-tags \fIclass\fR,\fItag\fR\' as an argument\.
26-
.
17+
Any setting that's valid in the configuration file is a valid long argument for puppet apply\. For example, 'tags' is a valid setting, so you can specify '\-\-tags \fIclass\fR,\fItag\fR' as an argument\.
2718
.P
28-
See the configuration file documentation at https://puppet\.com/docs/puppet/latest/configuration\.html for the full list of acceptable parameters\. You can generate a commented list of all configuration options by running puppet with \'\-\-genconfig\'\.
29-
.
19+
See the configuration file documentation at https://puppet\.com/docs/puppet/latest/configuration\.html for the full list of acceptable parameters\. You can generate a commented list of all configuration options by running puppet with '\-\-genconfig'\.
3020
.IP "\(bu" 4
3121
\-\-debug: Enable full debugging\.
32-
.
3322
.IP "\(bu" 4
34-
\-\-detailed\-exitcodes: Provide extra information about the run via exit codes\. If enabled, \'puppet apply\' will use the following exit codes:
35-
.
23+
\-\-detailed\-exitcodes: Provide extra information about the run via exit codes\. If enabled, 'puppet apply' will use the following exit codes:
3624
.IP
3725
0: The run succeeded with no changes or failures; the system was already in the desired state\.
38-
.
3926
.IP
4027
1: The run failed\.
41-
.
4228
.IP
4329
2: The run succeeded, and some resources were changed\.
44-
.
4530
.IP
4631
4: The run succeeded, and some resources failed\.
47-
.
4832
.IP
4933
6: The run succeeded, and included both changes and failures\.
50-
.
5134
.IP "\(bu" 4
5235
\-\-help: Print this help message
53-
.
5436
.IP "\(bu" 4
55-
\-\-loadclasses: Load any stored classes\. \'puppet agent\' caches configured classes (usually at /etc/puppetlabs/puppet/classes\.txt), and setting this option causes all of those classes to be set in your puppet manifest\.
56-
.
37+
\-\-loadclasses: Load any stored classes\. 'puppet agent' caches configured classes (usually at /etc/puppetlabs/puppet/classes\.txt), and setting this option causes all of those classes to be set in your puppet manifest\.
5738
.IP "\(bu" 4
58-
\-\-logdest: Where to send log messages\. Choose between \'syslog\' (the POSIX syslog service), \'eventlog\' (the Windows Event Log), \'console\', or the path to a log file\. Defaults to \'console\'\. Multiple destinations can be set using a comma separated list (eg: \fB/path/file1,console,/path/file2\fR)"
59-
.
39+
\-\-logdest: Where to send log messages\. Choose between 'syslog' (the POSIX syslog service), 'eventlog' (the Windows Event Log), 'console', or the path to a log file\. Defaults to 'console'\. Multiple destinations can be set using a comma separated list (eg: \fB/path/file1,console,/path/file2\fR)"
6040
.IP
61-
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\.
62-
.
41+
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\.
6342
.IP
64-
A path ending with \'\.jsonl\' will receive structured output in JSON Lines format\.
65-
.
43+
A path ending with '\.jsonl' will receive structured output in JSON Lines format\.
6644
.IP "\(bu" 4
67-
\-\-noop: 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\.
68-
.
45+
\-\-noop: 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\.
6946
.IP "\(bu" 4
7047
\-\-execute: Execute a specific piece of Puppet code
71-
.
7248
.IP "\(bu" 4
73-
\-\-test: Enable the most common options used for testing\. These are \'verbose\', \'detailed\-exitcodes\' and \'show_diff\'\.
74-
.
49+
\-\-test: Enable the most common options used for testing\. These are 'verbose', 'detailed\-exitcodes' and 'show_diff'\.
7550
.IP "\(bu" 4
7651
\-\-verbose: Print extra information\.
77-
.
7852
.IP "\(bu" 4
79-
\-\-catalog: Apply a JSON catalog (such as one generated with \'puppet master \-\-compile\')\. You can either specify a JSON file or pipe in JSON from standard input\.
80-
.
53+
\-\-catalog: Apply a JSON catalog (such as one generated with 'puppet master \-\-compile')\. You can either specify a JSON file or pipe in JSON from standard input\.
8154
.IP "\(bu" 4
8255
\-\-write\-catalog\-summary After compiling the catalog saves the resource list and classes list to the node in the state directory named classes\.txt and resources\.txt
83-
.
8456
.IP "" 0
85-
.
8657
.SH "EXAMPLE"
87-
.
8858
.nf
89-
90-
$ puppet apply \-e \'notify { "hello world": }\'
59+
$ puppet apply \-e 'notify { "hello world": }'
9160
$ puppet apply \-l /tmp/manifest\.log manifest\.pp
9261
$ puppet apply \-\-modulepath=/root/dev/modules \-e "include ntpd::server"
9362
$ puppet apply \-\-catalog catalog\.json
94-
.
9563
.fi
96-
.
9764
.SH "AUTHOR"
9865
Luke Kanies
99-
.
10066
.SH "COPYRIGHT"
101-
Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
67+
Copyright (c) 2011 Puppet Inc\. Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2\.0 License

0 commit comments

Comments
 (0)