diff options
Diffstat (limited to 'man/man8/puppetd.8')
-rw-r--r-- | man/man8/puppetd.8 | 49 |
1 files changed, 33 insertions, 16 deletions
diff --git a/man/man8/puppetd.8 b/man/man8/puppetd.8 index c448e89f6..fc151be93 100644 --- a/man/man8/puppetd.8 +++ b/man/man8/puppetd.8 @@ -1,7 +1,6 @@ .TH Synopsis "" "" "" .SH NAME -Synopsis \- - +Synopsis \- .\" Man page generated from reStructeredText. Retrieve the client configuration from the central puppet server and apply it to the local host. @@ -10,17 +9,19 @@ Currently must be run out periodically, using cron or something similar. .SH USAGE - -.\" visit_block_quote +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 .TP .B puppetd [\-D|\-\-daemonize|\-\-no\-daemonize] [\-d|\-\-debug] [\-\-disable] [\-\-enable] [\-h|\-\-help] [\-\-fqdn <host name>] [\-l|\-\-logdest syslog|<file>|console] -[\-o|\-\-onetime] [\-\-serve <handler>] [\-t|\-\-test] +[\-o|\-\-onetime] [\-\-serve <handler>] [\-t|\-\-test] [\-\-noop] [\-V|\-\-version] [\-v|\-\-verbose] [\-w|\-\-waitforcert <seconds>] - -.\" depart_block_quote +.UNINDENT +.UNINDENT +.UNINDENT .SH DESCRIPTION This is the main puppet client. Its job is to retrieve the local @@ -68,8 +69,8 @@ configuration parameter, so you can specify \'\-\-server <servername>\' as an argument. See the configuration file documentation at -http://reductivelabs.com/projects/puppet/reference/configref.html for -the full list of acceptable parameters. A commented list of all +\fI\%http://reductivelabs.com/trac/puppet/wiki/ConfigurationReference\fP for the +full list of acceptable parameters. A commented list of all configuration options can also be generated by running puppetd with \'\-\-genconfig\'. @@ -79,6 +80,7 @@ no\-daemonize: Do not send the process into the background. debug: Enable full debugging. +.INDENT 0.0 .TP .B disable: Disable working on the local system. This puts a lock file @@ -88,11 +90,13 @@ testing a configuration and do not want the central configuration to override the local state until everything is tested and committed. +.UNINDENT +puppetd+ uses the same lock file while it is running, so no more than one +puppetd+ process is working at a time. +puppetd+ exits after executing this. +.INDENT 0.0 .TP .B enable: Enable working on the local system. This removes any lock @@ -100,8 +104,10 @@ file, causing +puppetd+ to start managing the local system again (although it will continue to use its normal scheduling, so it might not start for another half hour). +.UNINDENT +puppetd+ exits after executing this. +.INDENT 0.0 .TP .B fqdn: Set the fully\-qualified domain name of the client. This is @@ -109,8 +115,10 @@ only used for certificate purposes, but can be used to override the discovered hostname. If you need to use this flag, it is generally an indication of a setup problem. +.UNINDENT help: Print this help message +.INDENT 0.0 .TP .B logdest: Where to send messages. Choose between syslog, the @@ -145,13 +153,21 @@ exactly, both in the call to +serve+ and in .TP .B test: Enable the most common options used for testing. These are -+onetime+, +verbose+, +ignorecache, and ++onetime+, +verbose+, +ignorecache, +no\-daemonize+, and +no\-usecacheonfailure+. + +.TP +.B noop: Use +noop+ mode where the daemon runs in a no\-op or +dry\-run mode. This is useful for seeing what changes +Puppet will make without actually executing the changes. + +.UNINDENT verbose: Turn on verbose reporting. version: Print the puppet version number and exit. +.INDENT 0.0 .TP .B waitforcert: This option only matters for daemons that do not yet have @@ -162,14 +178,15 @@ request. This is useful for the initial setup of a puppet client. You can turn off waiting for certificates by specifying a time of 0. +.UNINDENT .SH EXAMPLE - -.\" visit_block_quote +.INDENT 0.0 +.INDENT 3.5 puppetd \-\-server puppet.domain.com - -.\" depart_block_quote +.UNINDENT +.UNINDENT .SH AUTHOR Luke Kanies @@ -180,5 +197,5 @@ Copyright (c) 2005, 2006 Reductive Labs, LLC Licensed under the GNU Public License -.\" Generated by docutils manpage writer on 2008-05-05 09:33. -.\" +.\" Generated by docutils manpage writer on 2009-12-30 19:31. +.\" |