shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-21 13:34:40 +03:00
Code Releases Activity

cleanup: config_settings.h: comments

Browse Source
This commit is contained in:
Peter Rajnoha 2015-04-30 14:43:08 +02:00
parent 25e7178e59
commit 9c39d635b6
1 changed files with 54 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

94
lib/config/config_settings.h
View File

@ -23,10 +23,7 @@
* - define a configuration array of one or more types: * - define a configuration array of one or more types:
* cfg_array(id, name, parent, flags, types, default_value, since_version, unconfigured_default_value, comment) * cfg_array(id, name, parent, flags, types, default_value, since_version, unconfigured_default_value, comment)
* *
* The unconfigured_default_value is used as a default value which is *
* in "@...@" form and which is then substitued with concrete value while
* running configure (see also 'lvmconfig --type default --unconfigured').
*
* If default value can't be assigned statically because it depends on some * If default value can't be assigned statically because it depends on some
* run-time checks or if it depends on other settings already defined, * run-time checks or if it depends on other settings already defined,
* the configuration setting or array can be defined with the * the configuration setting or array can be defined with the
@ -36,42 +33,59 @@
* *
* *
* VARIABLES: * VARIABLES:
* id: unique identifier *
* name: configuration node name * id: Unique identifier.
* parent: id of parent configuration node *
* flags: configuration item flags: * name: Configuration node name.
* CFG_NAME_VARIABLE - configuration node name is variable *
* CFG_ALLOW_EMPTY - node value can be emtpy * parent: Id of parent configuration node.
* CFG_ADVANCED - this node belongs to advanced config set *
* CFG_UNSUPPORTED - this node is not officially supported and it's used primarily by developers * flags: Configuration item flags:
* CFG_PROFILABLE - this node is customizable by a profile * CFG_NAME_VARIABLE - configuration node name is variable
* CFG_PROFILABLE_METADATA - profilable and attachable to VG/LV metadata * CFG_ALLOW_EMPTY - node value can be emtpy
* CFG_DEFAULT_UNDEFINED - node's default value is undefined * CFG_ADVANCED - this node belongs to advanced config set
* CFG_DISABLED - configuration is disabled (defaults always used) * CFG_UNSUPPORTED - this node is not officially supported and it's used primarily by developers
* type: allowed type for the value of simple configuation setting, one of: * CFG_PROFILABLE - this node is customizable by a profile
* CFG_TYPE_BOOL * CFG_PROFILABLE_METADATA - profilable and attachable to VG/LV metadata
* CFG_TYPE_INT * CFG_DEFAULT_UNDEFINED - node's default value is undefined
* CFG_TYPE_FLOAT * CFG_DISABLED - configuration is disabled (defaults always used)
* CFG_TYPE_STRING *
* types: allowed types for the values of array configuration setting * type: Allowed type for the value of simple configuation setting, one of:
* (use logical "OR" to define more than one allowed type, * CFG_TYPE_BOOL
* e.g. CFG_TYPE_STRING | CFG_TYPE_INT) * CFG_TYPE_INT
* default_value: default value of type 'type' for the configuration node, * CFG_TYPE_FLOAT
* if this is an array with several 'types' defined then * CFG_TYPE_STRING
* default value is a string where each string representation *
* of each value is prefixed by '#X' where X is one of: * types: Allowed types for the values of array configuration setting
* 'B' for boolean value * (use logical "OR" to define more than one allowed type,
* 'I' for integer value * e.g. CFG_TYPE_STRING | CFG_TYPE_INT).
* 'F' for float value *
* 'S' for string value * default_value: Default value of type 'type' for the configuration node,
* '#' for the '#' character itself * if this is an array with several 'types' defined then
* For example, "#Sfd#I16" means default value [ "fd", 16 ]. * default value is a string where each string representation
* comment: brief comment used in configuration dumps * of each value is prefixed by '#X' where X is one of:
* since_version: the version this configuration node first appeared in (be sure * 'B' for boolean value
* that parent nodes are consistent with versioning, no check done * 'I' for integer value
* if parent node is older or the same age as any child node!) * 'F' for float value
* Use "vsn" macro to translate the "major.minor.release" version * 'S' for string value
* into a single number that is being stored internally in memory. * '#' for the '#' character itself
* For example, "#Sfd#I16" means default value [ "fd", 16 ].
*
* since_version: The version this configuration node first appeared in (be sure
* that parent nodes are consistent with versioning, no check done
* if parent node is older or the same age as any child node!)
* Use "vsn" macro to translate the "major.minor.release" version
* into a single number that is being stored internally in memory.
* (see also lvmconfig ... --withversions)
*
* unconfigured_default_value: Unconfigured default value used as a default value which is
* in "@...@" form and which is then substitued with concrete value
* while running configure.
* (see also 'lvmconfig --type default --unconfigured')
*
* comment: Comment used in configuration dumps. The very first line is the
* summarizing comment.
* (see also lvmconfig ... --withcomments and --withsummary)
*/ */
#include "defaults.h" #include "defaults.h"