From 17c74a7ecb2d241f6f0aa01b97b552c2855847e4 Mon Sep 17 00:00:00 2001 From: Michal Minar Date: Fri, 11 Oct 2013 10:12:51 +0200 Subject: documentation: extended configuration section --- tools/gendoc/doc/config.rst | 85 +++++++++++++++++++++++++++++++++++---------- 1 file changed, 66 insertions(+), 19 deletions(-) (limited to 'tools') diff --git a/tools/gendoc/doc/config.rst b/tools/gendoc/doc/config.rst index 0c28609..398df3d 100644 --- a/tools/gendoc/doc/config.rst +++ b/tools/gendoc/doc/config.rst @@ -30,25 +30,62 @@ Default configuration:: Level=ERROR Stderr=false -======= =================== ==================== =========== -Section Option name Default value Desciption -======= =================== ==================== =========== -``CIM`` ``Namespace`` root/cimv2 Namespace where OpenLMI providers are registered. -``CIM`` ``SystemClassName`` PG_ComputerSystem Name of CIM_ComputerSystem class, which is used to represent the computer system. It will be used as ``SystemClassName`` property value of various classes. -``Log`` ``Level`` ERROR Chooses which messages are logged, either to CIMOM and (if configured) to standard error output. Available levels (sorted by severity) are: - - * CRITICAL - * ERROR - * WARNING - * INFO - * DEBUG - * TRACE_WARNING - * TRACE_INFO - * TRACE_VERBOSE - - Levels below INFO (= TRACE_WARNING, TRACE_INFO and DEBUG) are useful mainly for debugging and bug reporting. -``Log`` ``Stderr`` false Toggles sending of log messages to standard error output of the CIMOM. -======= =================== ==================== =========== ++---------+---------------------+-----------------------+-------------------------------------------------------------------+ +| Section | Option name | Default value | Description | ++=========+=====================+=======================+===================================================================+ +| ``CIM`` | ``Namespace`` | ``root/cimv2`` | Namespace where OpenLMI providers are registered. | ++---------+---------------------+-----------------------+-------------------------------------------------------------------+ +| ``CIM`` | ``SystemClassName`` | ``PG_ComputerSystem`` | Name of ``CIM_ComputerSystem`` class, which is used to represent | +| | | | the computer system. It will be used as ``SystemClassName`` | +| | | | property value of various classes. Different cimmoms can | +| | | | instrument variously named computer systems and some may not | +| | | | instrument any at all. `Sfcb`_ is an example of the later, it | +| | | | needs the ``sblim-cmpi-base`` package installed providing the | +| | | | basic set of providers containing ``Linux_ComputerSystem``. So in | +| | | | case you run a ``Sfcb`` or you preferr to use providers from | +| | | | ``sblim-cmpi-base`` package, you need to change this to | +| | | | ``Linux_ComputerSystem``. | ++---------+---------------------+-----------------------+-------------------------------------------------------------------+ +| ``Log`` | ``Level`` | ``ERROR`` | Chooses which messages are logged, either to CIMOM and (if | +| | | | configured) to standard error output. Available levels | +| | | | (sorted by severity) are: | +| | | | | +| | | | * ``CRITICAL`` | +| | | | * ``ERROR`` | +| | | | * ``WARNING`` | +| | | | * ``INFO`` | +| | | | * ``DEBUG`` | +| | | | * ``TRACE_WARNING`` | +| | | | * ``TRACE_INFO`` | +| | | | * ``TRACE_VERBOSE`` | +| | | | | +| | | | Levels below ``INFO`` (= ``TRACE_WARNING``, ``TRACE_INFO`` | +| | | | and ``DEBUG``) are useful mainly for debugging and bug | +| | | | reporting. | ++---------+---------------------+-----------------------+-------------------------------------------------------------------+ +| ``Log`` | ``Stderr`` | ``False`` | Toggles sending of log messages to standard error output of the | +| | | | CIMOM. Accepts boolean value (see the next section). | ++---------+---------------------+-----------------------+-------------------------------------------------------------------+ + +Treating boolean values +----------------------- +Options expecting boolean values treat following strings as valid ``True`` +values: + + * ``true`` + * ``1`` + * ``yes`` + * ``on`` + +While the following are considered ``False``: + + * ``false`` + * ``0`` + * ``no`` + * ``off`` + +These words are checked in a case-insensitive way. Any other value isn't +considered valid [1]_. Logging ======= @@ -63,3 +100,13 @@ documentation how to enable tracing logs. With ``Stderr`` configuration option enabled, all logs are sent both to CIMOM and to the standard error output of the CIMOM. + +------------------------------------------------------------------------------- + +.. [1] Default value will be used as a fallback. This applies also to other + non-boolean options in case of invalid value. + +.. **************************************************************************** + +.. _Sfcb: http://sourceforge.net/apps/mediawiki/sblim/index.php?title=Sfcb + -- cgit