puppet 0.25.4 → 0.25.5

data/man/man8/puppetqd.8

@@ -1,60 +1,55 @@
-.TH Synopsis  "" "" ""
+.TH SYNOPSIS  "" "" ""
 .SH NAME
 Synopsis \- 
 .\" Man page generated from reStructeredText.
+.
+.sp
 Retrieve serialized records from a queue and process them in order.
-
-
 .SH USAGE
 .INDENT 0.0
 .INDENT 3.5
+.sp
 puppetqd  [\-d|\-\-debug] [\-v|\-\-verbose]
-
 .UNINDENT
 .UNINDENT
-
 .SH DESCRIPTION
+.sp
 This is a simple application that just processes entities in a queue as
 they are recieved.
-
-
 .SH OPTIONS
-Note that any configuration parameter that\'s valid in the configuration
-file is also a valid long argument. For example, \'server\' is a valid
-configuration parameter, so you can specify \'\-\-server <servername>\' as
+.sp
+Note that any configuration parameter that\(aqs valid in the configuration
+file is also a valid long argument. For example, \(aqserver\(aq is a valid
+configuration parameter, so you can specify \(aq\-\-server <servername>\(aq as
 an argument.
-
+.sp
 See the configuration file documentation at
-\fI\%http://reductivelabs.com/trac/puppet/wiki/ConfigurationReference\fP for the
+\fI\%http://puppetlabs.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\'.
-
+\(aq\-\-genconfig\(aq.
+.sp
 debug:   Enable full debugging.
-
+.sp
 help:    Print this help message
-
+.sp
 verbose: Turn on verbose reporting.
-
+.sp
 version: Print the puppet version number and exit.
-
-
 .SH EXAMPLE
 .INDENT 0.0
 .INDENT 3.5
+.sp
 puppetqd
-
 .UNINDENT
 .UNINDENT
-
 .SH AUTHOR
+.sp
 Luke Kanies
-
-
 .SH COPYRIGHT
-Copyright (c) 2009 Reductive Labs, LLC Licensed under the GNU Public
+.sp
+Copyright (c) 2009 Puppet Labs, LLC Licensed under the GNU Public
 License
-
-
-.\" Generated by docutils manpage writer on 2009-12-30 19:32.
+.\" Generated by docutils manpage writer.
 .\" 
+.

data/man/man8/puppetrun.8

@@ -2,58 +2,55 @@
 .SH NAME
  \- 
 .\" Man page generated from reStructeredText.
-
+.
 .SH SYNOPSIS
+.sp
 Trigger a puppetd run on a set of hosts.
-
-
 .SH USAGE
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
-
 .TP
 .B puppetrun [\-a|\-\-all] [\-c|\-\-class <class>] [\-d|\-\-debug] [\-f|\-\-foreground]
+.
 [\-h|\-\-help] [\-\-host <host>] [\-\-no\-fqdn] [\-\-ignoreschedules]
 [\-t|\-\-tag <tag>] [\-\-test] [\-p|\-\-ping]
-
 .UNINDENT
 .UNINDENT
 .UNINDENT
-
 .SH DESCRIPTION
+.sp
 This script can be used to connect to a set of machines running
 +puppetd+ and trigger them to run their configurations. The most common
 usage would be to specify a class of hosts and a set of tags, and
 +puppetrun+ would look up in LDAP all of the hosts matching that class,
 then connect to each host and trigger a run of all of the objects with
 the specified tags.
-
+.sp
 If you are not storing your host configurations in LDAP, you can specify
 hosts manually.
-
+.sp
 You will most likely have to run +puppetrun+ as root to get access to
 the SSL certificates.
-
-+puppetrun+ reads +puppetmaster+\'s configuration file, so that it can
+.sp
++puppetrun+ reads +puppetmaster+\(aqs configuration file, so that it can
 copy things like LDAP settings.
-
-
 .SH USAGE NOTES
+.sp
 +puppetrun+ is useless unless +puppetd+ is listening. See its
 documentation for more information, but the gist is that you must enable
 +listen+ on the +puppetd+ daemon, either using +\-\-listen+ on the command
-line or adding \'listen: true\' in its config file. In addition, you need
+line or adding \(aqlisten: true\(aq in its config file. In addition, you need
 to set the daemons up to specifically allow connections by creating the
-+namespaceauth+ file, normally at \'/etc/puppet/namespaceauth.conf\'. This
++namespaceauth+ file, normally at \(aq/etc/puppet/namespaceauth.conf\(aq. This
 file specifies who has access to each namespace; if you create the file
 you must add every namespace you want any Puppet daemon to allow \-\- it
 is currently global to all Puppet daemons.
-
+.sp
 An example file looks like this:
-
-
+.sp
 .nf
+.ft C
 [fileserver]
     allow *.madstop.com
 
@@ -62,103 +59,94 @@ An example file looks like this:
 
 [puppetrunner]
     allow culain.madstop.com
+.ft P
 .fi
+.sp
 This is what you would install on your Puppet master; non\-master hosts
-could leave off the \'fileserver\' and \'puppetmaster\' namespaces.
-
+could leave off the \(aqfileserver\(aq and \(aqpuppetmaster\(aq namespaces.
+.sp
 Expect more documentation on this eventually.
-
-
 .SH OPTIONS
-Note that any configuration parameter that\'s valid in the configuration
-file is also a valid long argument. For example, \'ssldir\' is a valid
-configuration parameter, so you can specify \'\-\-ssldir <directory>\' as an
+.sp
+Note that any configuration parameter that\(aqs valid in the configuration
+file is also a valid long argument. For example, \(aqssldir\(aq is a valid
+configuration parameter, so you can specify \(aq\-\-ssldir <directory>\(aq as an
 argument.
-
+.sp
 See the configuration file documentation at
-\fI\%http://reductivelabs.com/projects/puppet/reference/configref.html\fP for
+\fI\%http://puppetlabs.com/projects/puppet/reference/configref.html\fP for
 the full list of acceptable parameters. A commented list of all
 configuration options can also be generated by running puppetmasterdd
-with \'\-\-genconfig\'.
-
+with \(aq\-\-genconfig\(aq.
 .INDENT 0.0
-
 .TP
 .B all:             Connect to all available hosts. Requires LDAP support
+.
 at this point.
-
-
 .TP
 .B class:           Specify a class of machines to which to connect. This
+.
 only works if you have LDAP configured, at the moment.
-
 .UNINDENT
+.sp
 debug:           Enable full debugging.
-
 .INDENT 0.0
-
 .TP
 .B foreground:      Run each configuration in the foreground; that is, when
+.
 connecting to a host, do not return until the host has
 finished its run. The default is false.
-
 .UNINDENT
+.sp
 help:            Print this help message
-
 .INDENT 0.0
-
 .TP
 .B host:            A specific host to which to connect. This flag can be
+.
 specified more than once.
-
-
 .TP
 .B ignoreschedules: Whether the client should ignore schedules when running
+.
 its configuration. This can be used to force the client
 to perform work it would not normally perform so soon.
 The default is false.
-
-
 .TP
 .B parallel:        How parallel to make the connections. Parallelization
+.
 is provided by forking for each client to which to
 connect. The default is 1, meaning serial execution.
-
-
 .TP
 .B tag:             Specify a tag for selecting the objects to apply. Does
+.
 not work with the \-\-test option.
-
-
 .TP
 .B test:            Print the hosts you would connect to but do not
+.
 actually connect. This option requires LDAP support at
 this point.
-
 .UNINDENT
+.sp
 ping:
-
-
+.sp
 .nf
-Do a ICMP echo against the target host. Skip hosts that don\'t respond to ping.
+.ft C
+Do a ICMP echo against the target host. Skip hosts that don\(aqt respond to ping.
+.ft P
 .fi
-
 .SH EXAMPLE
 .INDENT 0.0
 .INDENT 3.5
+.sp
 sudo puppetrun \-p 10 \-\-host host1 \-\-host host2 \-t remotefile \-t webserver
-
 .UNINDENT
 .UNINDENT
-
 .SH AUTHOR
+.sp
 Luke Kanies
-
-
 .SH COPYRIGHT
-Copyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public
+.sp
+Copyright (c) 2005 Puppet Labs, LLC Licensed under the GNU Public
 License
-
-
-.\" Generated by docutils manpage writer on 2009-12-30 19:31.
+.\" Generated by docutils manpage writer.
 .\" 
+.

data/man/man8/ralsh.8

@@ -2,127 +2,122 @@
 .SH NAME
  \- 
 .\" Man page generated from reStructeredText.
+.
+.sp
 vim: softtabstop=4 shiftwidth=4 expandtab
-
-
 .SH SYNOPSIS
+.sp
 Use the Puppet RAL to directly interact with the system.
-
-
 .SH USAGE
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
-
 .TP
 .B ralsh [\-h|\-\-help] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-edit] [\-H|\-\-host <host>]
+.
 [\-p|\-\-param <param>] [\-t|\-\-types] type <name>
-
 .UNINDENT
 .UNINDENT
 .UNINDENT
-
 .SH DESCRIPTION
+.sp
 This command provides simple facilities for converting current system
 state into Puppet code, along with some ability to use Puppet to affect
 the current state.
-
+.sp
 By default, you must at least provide a type to list, which case ralsh
 will tell you everything it knows about all instances of that type. You
 can optionally specify an instance name, and ralsh will only describe
 that single instance.
-
+.sp
 You can also add +\-\-edit+ as an argument, and ralsh will write its
 output to a file, open that file in an editor, and then apply the file
 as a Puppet transaction. You can easily use this to use Puppet to make
 simple changes to a system.
-
-
 .SH OPTIONS
-Note that any configuration parameter that\'s valid in the configuration
-file is also a valid long argument. For example, \'ssldir\' is a valid
-configuration parameter, so you can specify \'\-\-ssldir <directory>\' as an
+.sp
+Note that any configuration parameter that\(aqs valid in the configuration
+file is also a valid long argument. For example, \(aqssldir\(aq is a valid
+configuration parameter, so you can specify \(aq\-\-ssldir <directory>\(aq as an
 argument.
-
+.sp
 See the configuration file documentation at
-\fI\%http://reductivelabs.com/trac/puppet/wiki/ConfigurationReference\fP for the
+\fI\%http://puppetlabs.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 puppet with
-\'\-\-genconfig\'.
-
+\(aq\-\-genconfig\(aq.
+.sp
 debug: Enable full debugging.
-
+.sp
 edit:
-
 .INDENT 0.0
 .INDENT 3.5
+.sp
 Write the results of the query to a file, open the file in an editor,
 and read the file back in as an executable Puppet manifest.
-
 .UNINDENT
 .UNINDENT
+.sp
 host:
-
 .INDENT 0.0
 .INDENT 3.5
+.sp
 When specified, connect to the resource server on the named host
 and retrieve the list of resouces of the type specified.
-
 .UNINDENT
 .UNINDENT
+.sp
 help:
-
 .INDENT 0.0
 .INDENT 3.5
+.sp
 Print this help message.
-
 .UNINDENT
 .UNINDENT
+.sp
 param:
-
 .INDENT 0.0
 .INDENT 3.5
+.sp
 Add more parameters to be outputted from queries.
-
 .UNINDENT
 .UNINDENT
+.sp
 types:
-
 .INDENT 0.0
 .INDENT 3.5
+.sp
 List all available types.
-
 .UNINDENT
 .UNINDENT
+.sp
 verbose: Print extra information.
-
-
 .SH EXAMPLE
+.sp
 This example uses \fBralsh\fP to return Puppet configuration for the user
 \fBluke\fP:
-
-
+.sp
 .nf
+.ft C
 $ ralsh user luke
-user { \'luke\':
-  home => \'/home/luke\',
-  uid => \'100\',
-  ensure => \'present\',
-  comment => \'Luke Kanies,,,\',
-  gid => \'1000\',
-  shell => \'/bin/bash\',
-  groups => [\'sysadmin\',\'audio\',\'video\',\'puppet\']
+user { \(aqluke\(aq:
+  home => \(aq/home/luke\(aq,
+  uid => \(aq100\(aq,
+  ensure => \(aqpresent\(aq,
+  comment => \(aqLuke Kanies,,,\(aq,
+  gid => \(aq1000\(aq,
+  shell => \(aq/bin/bash\(aq,
+  groups => [\(aqsysadmin\(aq,\(aqaudio\(aq,\(aqvideo\(aq,\(aqpuppet\(aq]
 }
+.ft P
 .fi
-
 .SH AUTHOR
+.sp
 Luke Kanies
-
-
 .SH COPYRIGHT
-Copyright (c) 2005\-2007 Reductive Labs, LLC Licensed under the GNU
+.sp
+Copyright (c) 2005\-2007 Puppet Labs, LLC Licensed under the GNU
 Public License
-
-
-.\" Generated by docutils manpage writer on 2009-12-30 19:24.
+.\" Generated by docutils manpage writer.
 .\" 
+.