1
0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-22 17:35:59 +03:00
lvm2/doc
Peter Rajnoha 245b85692e config: use config checks and add support for creating trees from config definition (config_def_create_tree fn)
Configuration checking is initiated during config load/processing
(_process_config fn) which is part of the command context
creation/refresh.

This patch also defines 5 types of trees that could be created from
the configuration definition (config_settings.h), the cfg_def_tree_t:

  - CFG_DEF_TREE_CURRENT that denotes a tree of all the configuration
    nodes that are explicitly defined in lvm.conf/--config

  - CFG_DEF_TREE_MISSING that denotes a tree of all missing
    configuration nodes for which default valus are used since they're
    not explicitly used in lvm.conf/--config

  - CFG_DEF_TREE_DEFAULT that denotes a tree of all possible
    configuration nodes with default values assigned, no matter what
    the actual lvm.conf/--config is

  - CFG_DEF_TREE_NEW that denotes a tree of all new configuration nodes
    that appeared in given version

  - CFG_DEF_TREE_COMPLETE that denotes a tree of the whole configuration
    tree that is used in LVM2 (a combination of CFG_DEF_TREE_CURRENT +
    CFG_DEF_TREE_MISSING). This is not implemented yet, it will be added
    later...

The function that creates the definition tree of given type:

  struct dm_config_tree *config_def_create_tree(struct config_def_tree_spec *spec);

Where the "spec" specifies the tree type to be created:

  struct config_def_tree_spec {
    cfg_def_tree_t type;	/* tree type */
    uint16_t version;		/* tree at this LVM2 version */
    int ignoreadvanced;		/* do not include advanced configs */
    int ignoreunsupported;	/* do not include unsupported configs */
  };

This tree can be passed to already existing functions that write
the tree on output (like we already do with cmd->cft).

There is a new lvm.conf section called "config" with two new options:

  - config/checks which enables/disables checking (enabled by default)

  - config/abort_on_errors which enables/disables aborts on any type of
    mismatch found in the config (disabled by default)
2013-03-06 10:46:35 +01:00
..
kernel kernel docs: Refresh kernel target documentation 2012-06-21 23:48:40 +01:00
.gitignore More .gitignore files for an in-source-tree build. 2012-06-08 16:34:43 +01:00
example_cmdlib.c Fix lvm2cmd example in documentation. 2010-06-16 13:03:48 +00:00
example.conf.in config: use config checks and add support for creating trees from config definition (config_def_create_tree fn) 2013-03-06 10:46:35 +01:00
lvm2-raid.txt Add policy based automated repair of RAID logical volumes 2011-12-06 19:30:15 +00:00
lvm_fault_handling.txt Add policy based automated repair of RAID logical volumes 2011-12-06 19:30:15 +00:00
lvmetad_design.txt Change pvscan --lvmetad to pvscan --cache. 2012-03-02 18:09:46 +00:00
Makefile.in Clean generated files .exported_symbols_generated, example.conf for distclean. 2010-08-03 13:00:45 +00:00
pvmove_outline.txt o typo 2002-01-24 09:54:09 +00:00
tagging.txt There is no hotsname_tags but only hosttags... sigh, even docs is wrong :-) 2012-03-27 13:39:08 +00:00
testing.txt doc/testing.txt: Fix typo: s/this/thing/. 2007-09-25 08:28:57 +00:00
udev_assembly.txt Change pvscan --lvmetad to pvscan --cache. 2012-03-02 18:09:46 +00:00