summaryrefslogtreecommitdiffstats
path: root/lib/puppet/reference/configuration.rb
diff options
context:
space:
mode:
authorluke <luke@980ebf18-57e1-0310-9a29-db15c13687c0>2007-06-20 00:16:41 +0000
committerluke <luke@980ebf18-57e1-0310-9a29-db15c13687c0>2007-06-20 00:16:41 +0000
commit3aafa84493dbc1f3764526a16fb1fdac6e1671e9 (patch)
tree5b053eaa0cbe90f238d2d83112fa1c12d6462643 /lib/puppet/reference/configuration.rb
parent55a512c21c8a58689c0651376a9e99980cf4791e (diff)
downloadpuppet-3aafa84493dbc1f3764526a16fb1fdac6e1671e9.tar.gz
puppet-3aafa84493dbc1f3764526a16fb1fdac6e1671e9.tar.xz
puppet-3aafa84493dbc1f3764526a16fb1fdac6e1671e9.zip
Updating reference docs
git-svn-id: https://reductivelabs.com/svn/puppet/trunk@2637 980ebf18-57e1-0310-9a29-db15c13687c0
Diffstat (limited to 'lib/puppet/reference/configuration.rb')
-rw-r--r--lib/puppet/reference/configuration.rb30
1 files changed, 14 insertions, 16 deletions
diff --git a/lib/puppet/reference/configuration.rb b/lib/puppet/reference/configuration.rb
index b7076a1e5..b83992290 100644
--- a/lib/puppet/reference/configuration.rb
+++ b/lib/puppet/reference/configuration.rb
@@ -46,25 +46,23 @@ Specifying Configuration Parameters
On The Command-Line
+++++++++++++++++++
Every Puppet executable (with the exception of ``puppetdoc``) accepts all of
-the arguments below, but not all of the arguments make sense for every executable.
-Each argument has a section listed with it in parentheses; often, that section
+the parameters below, but not all of the arguments make sense for every executable.
+Each parameter has a section listed with it in parentheses; often, that section
will map to an executable (e.g., ``puppetd``), in which case it probably only
-makes sense for that one executable. If ``puppet`` is listed as the section,
+makes sense for that one executable. If ``main`` is listed as the section,
it is most likely an option that is valid for everyone.
-This will not always be the case. I have tried to be as thorough as possible
-in the descriptions of the arguments, so it should be obvious whether an
-argument is appropriate or not.
+I have tried to be as thorough as possible in the descriptions of the
+arguments, so it should be obvious whether an argument is appropriate or not.
-These arguments can be supplied to the executables either as command-line
-arugments or in the configuration file for the appropriate executable. For
-instance, the command-line invocation below would set the configuration directory
-to ``/private/puppet``::
+These parameters can be supplied to the executables either as command-line
+options or in the configuration file. For instance, the command-line
+invocation below would set the configuration directory to ``/private/puppet``::
$ puppetd --confdir=/private/puppet
-Note that boolean options are turned on and off with a slightly different syntax
-on the command line::
+Note that boolean options are turned on and off with a slightly different
+syntax on the command line::
$ puppetd --storeconfigs
@@ -76,14 +74,14 @@ the client configuration.
Configuration Files
+++++++++++++++++++
As mentioned above, the configuration parameters can also be stored in a
-configuration file located in the configuration directory (`/etc/puppet`
-by default). All executables look for ``puppet.conf`` in their
-configuration directory (although they used to each look to separate files).
+configuration file, located in the configuration directory (`/etc/puppet`
+by default). As of 0.23.0, all executables look for ``puppet.conf`` in their
+configuration directory (although they previously looked for separate files).
All executables will set any parameters set within the ``main`` section,
while each executable will also look for a section named for the executable
and load those parameters. For example, ``puppetd`` will look for a
-section named ``puppetd`, and ``puppetmasterd`` looks for a section
+section named ``puppetd``, and ``puppetmasterd`` looks for a section
named ``puppetmasterd``. This allows you to use a single configuration file
to customize the settings for all of your executables.