Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

puppetdoc(8) [debian man page]

PUPPET-DOC(8)							   Puppet manual						     PUPPET-DOC(8)

NAME

       puppet-doc - Generate Puppet documentation and references

SYNOPSIS

       Generates a reference for all Puppet types. Largely meant for internal Puppet Labs use.

USAGE

       puppet  doc  [-a|--all]	[-h|--help]  [-o|--outputdir  rdoc-outputdir] [-m|--mode text|pdf|rdoc] [-r|--reference reference-name] [--charset
       charset] [manifest-file]

DESCRIPTION

       If mode is not 'rdoc', then this command generates a Markdown document 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.

       In 'rdoc' mode, this command generates an html RDoc hierarchy describing the manifests that are in 'manifestdir' and 'modulepath'  configu-
       ration directives. The generated documentation directory is doc by default but can be changed with the 'outputdir' option.

       If the command is run with the name of a manifest file as an argument, puppet doc will output a single manifest's documentation on stdout.

OPTIONS

       --all  Output the docs for all of the reference types. In 'rdoc' mode, this also outputs documentation for all resources.

       --help Print this help message

       --outputdir
	      Used only in 'rdoc' mode. The directory to which the rdoc output should be written.

       --mode Determine  the  output mode. Valid modes are 'text', 'pdf' and 'rdoc'. The 'pdf' mode creates PDF formatted files in the /tmp direc-
	      tory. The default mode is 'text'. In 'rdoc' mode you must provide 'manifests-path'

       --reference
	      Build a particular reference. Get a list of references by running 'puppet doc --list'.

       --charset
	      Used only in 'rdoc' mode. It sets the charset used in the html files produced.

       --manifestdir
	      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.

       --modulepath
	      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.

       --environment
	      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.

EXAMPLE

       $ puppet doc -r type > /tmp/type_reference.markdown

       or

	   $ puppet doc --outputdir /tmp/rdoc --mode rdoc /path/to/manifests

       or

	   $ puppet doc /etc/puppet/manifests/site.pp

       or

	   $ puppet doc -m pdf -r configuration

AUTHOR

       Luke Kanies

COPYRIGHT

       Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2.0 License

Puppet Labs, LLC						     June 2012							     PUPPET-DOC(8)

Check Out this Related Man Page

PUPPET-CONFIG(8)						   Puppet manual						  PUPPET-CONFIG(8)

NAME

       puppet-config - Interact with Puppet's configuration options.

SYNOPSIS

       puppet config action

OPTIONS

       Note  that  any configuration parameter 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, server is a valid configuration parameter, so you can  specify  --server  <servername>  as	an
       argument.

       See the configuration file documentation at http://docs.puppetlabs.com/references/stable/configuration.html for the full list of acceptable
       parameters. A commented list of all configuration options can also be generated by running puppet with --genconfig.

       --mode MODE
	      The run mode to use for the current action. Valid modes are user, agent, and master.

       --render-as FORMAT
	      The format in which to render output. The most common formats are json, s (string), yaml, and console, but other options such as dot
	      are sometimes available.

       --verbose
	      Whether to log verbosely.

       --debug
	      Whether to log debug information.

ACTIONS

       print - Examine Puppet's current configuration settings.
	      SYNOPSIS

	      puppet config print (all | setting [setting ...]

	      DESCRIPTION

	      Prints the value of a single configuration option or a list of configuration options.

	      This action is an alternate interface to the information available with puppet <subcommand> --configprint.

	      RETURNS

	      A single value when called with one config setting, and a list of settings and values when called with multiple options or "all."

	      NOTES

	      By  default, this action reads the configuration in agent mode. Use the '--mode' and '--environment' flags to examine other configu-
	      ration domains.

EXAMPLES

       print

       Get puppet's runfile directory:

       $ puppet config print rundir

       Get a list of important directories from the master's config:

       $ puppet config print all --mode master | grep -E "(path|dir)"

COPYRIGHT AND LICENSE

       Copyright 2011 by Puppet Labs Apache 2 license; see COPYING

Puppet Labs, LLC						     June 2012							  PUPPET-CONFIG(8)
Man Page