mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
241 lines
11 KiB
C
241 lines
11 KiB
C
/*
|
|
* Copyright (C) 2001-2004 Sistina Software, Inc. All rights reserved.
|
|
* Copyright (C) 2004-2007 Red Hat, Inc. All rights reserved.
|
|
*
|
|
* This file is part of LVM2.
|
|
*
|
|
* This copyrighted material is made available to anyone wishing to use,
|
|
* modify, copy, or redistribute it subject to the terms and conditions
|
|
* of the GNU Lesser General Public License v.2.1.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*/
|
|
|
|
#ifndef _LVM_CONFIG_H
|
|
#define _LVM_CONFIG_H
|
|
|
|
#include "lvm-types.h"
|
|
#include "defaults.h"
|
|
|
|
/* 16 bits: 3 bits for major, 4 bits for minor, 9 bits for patchlevel */
|
|
/* FIXME Max LVM version supported: 7.15.511. Extend bits when needed. */
|
|
#define vsn(major, minor, patchlevel) (major << 13 | minor << 9 | patchlevel)
|
|
|
|
struct device;
|
|
struct cmd_context;
|
|
|
|
typedef enum {
|
|
CONFIG_UNDEFINED, /* undefined/uninitialized config */
|
|
CONFIG_FILE, /* one file config */
|
|
CONFIG_MERGED_FILES, /* config that is a result of merging more config files */
|
|
CONFIG_STRING, /* config string typed on cmdline using '--config' arg */
|
|
CONFIG_PROFILE /* profile config */
|
|
} config_source_t;
|
|
|
|
struct profile {
|
|
struct dm_list list;
|
|
const char *name;
|
|
struct dm_config_tree *cft;
|
|
};
|
|
|
|
struct profile_params {
|
|
const char *dir; /* subdir in LVM_SYSTEM_DIR where LVM looks for profiles */
|
|
struct profile *global_profile; /* profile that overrides any other VG/LV-based profile ('--profile' cmd line arg) */
|
|
struct dm_list profiles_to_load;/* list of profiles which are only added, but still need to be loaded for any use */
|
|
struct dm_list profiles; /* list of profiles which are loaded already and which are ready for use */
|
|
};
|
|
|
|
#define CFG_PATH_MAX_LEN 64
|
|
|
|
/*
|
|
* Structures used for definition of a configuration tree.
|
|
*/
|
|
|
|
/* configuration definition item type (for item's accepted types) */
|
|
typedef enum {
|
|
CFG_TYPE_SECTION = 1 << 0, /* section */
|
|
CFG_TYPE_ARRAY = 1 << 1, /* setting */
|
|
CFG_TYPE_BOOL = 1 << 2, /* setting */
|
|
CFG_TYPE_INT = 1 << 3, /* setting */
|
|
CFG_TYPE_FLOAT = 1 << 4, /* setting */
|
|
CFG_TYPE_STRING = 1 << 5, /* setting */
|
|
} cfg_def_type_t;
|
|
|
|
/* function types to evaluate default value at runtime */
|
|
typedef int (*t_fn_CFG_TYPE_BOOL) (struct cmd_context *cmd, struct profile *profile);
|
|
typedef int (*t_fn_CFG_TYPE_INT) (struct cmd_context *cmd, struct profile *profile);
|
|
typedef float (*t_fn_CFG_TYPE_FLOAT) (struct cmd_context *cmd, struct profile *profile);
|
|
typedef const char* (*t_fn_CFG_TYPE_STRING) (struct cmd_context *cmd, struct profile *profile);
|
|
typedef const char* (*t_fn_CFG_TYPE_ARRAY) (struct cmd_context *cmd, struct profile *profile);
|
|
|
|
/* configuration definition item value (for item's default value) */
|
|
typedef union {
|
|
/* static value - returns a variable */
|
|
const int v_CFG_TYPE_BOOL, v_CFG_TYPE_INT;
|
|
const float v_CFG_TYPE_FLOAT;
|
|
const char *v_CFG_TYPE_STRING, *v_CFG_TYPE_ARRAY;
|
|
|
|
/* run-time value - evaluates a function */
|
|
t_fn_CFG_TYPE_BOOL fn_CFG_TYPE_BOOL;
|
|
t_fn_CFG_TYPE_INT fn_CFG_TYPE_INT;
|
|
t_fn_CFG_TYPE_FLOAT fn_CFG_TYPE_FLOAT;
|
|
t_fn_CFG_TYPE_STRING fn_CFG_TYPE_STRING;
|
|
t_fn_CFG_TYPE_ARRAY fn_CFG_TYPE_ARRAY;
|
|
} cfg_def_value_t;
|
|
|
|
/* configuration definition item flags: */
|
|
|
|
/* whether the configuration item name is variable */
|
|
#define CFG_NAME_VARIABLE 0x01
|
|
/* whether empty value is allowed */
|
|
#define CFG_ALLOW_EMPTY 0x02
|
|
/* whether the configuration item is for advanced use only */
|
|
#define CFG_ADVANCED 0x04
|
|
/* whether the configuration item is not officially supported */
|
|
#define CFG_UNSUPPORTED 0x08
|
|
/* whether the configuration item is customizable by a profile */
|
|
#define CFG_PROFILABLE 0x10
|
|
/* whether the default value is undefned */
|
|
#define CFG_DEFAULT_UNDEFINED 0x20
|
|
/* whether the defualt value is calculated during run time */
|
|
#define CFG_DEFAULT_RUN_TIME 0x40
|
|
|
|
/* configuration definition item structure */
|
|
typedef struct cfg_def_item {
|
|
int id; /* ID of this item */
|
|
int parent; /* ID of parent item */
|
|
const char *name; /* name of the item in configuration tree */
|
|
int type; /* configuration item type (bits of cfg_def_type_t) */
|
|
cfg_def_value_t default_value; /* default value (only for settings) */
|
|
uint16_t flags; /* configuration item definition flags */
|
|
uint16_t since_version; /* version this item appeared in */
|
|
const char *comment; /* brief comment */
|
|
} cfg_def_item_t;
|
|
|
|
/* configuration definition tree types */
|
|
typedef enum {
|
|
CFG_DEF_TREE_CURRENT, /* tree of nodes with values currently set in the config */
|
|
CFG_DEF_TREE_MISSING, /* tree of nodes missing in current config using default values */
|
|
CFG_DEF_TREE_COMPLETE, /* CURRENT + MISSING, the tree actually used within execution, not implemented yet */
|
|
CFG_DEF_TREE_DEFAULT, /* tree of all possible config nodes with default values */
|
|
CFG_DEF_TREE_NEW, /* tree of all new nodes that appeared in given version */
|
|
CFG_DEF_TREE_PROFILABLE /* tree of all nodes that are customizable by profiles */
|
|
} cfg_def_tree_t;
|
|
|
|
/* configuration definition tree specification */
|
|
struct config_def_tree_spec {
|
|
struct cmd_context *cmd; /* command context (for run-time defaults */
|
|
cfg_def_tree_t type; /* tree type */
|
|
uint16_t version; /* tree at this LVM2 version */
|
|
int ignoreadvanced:1; /* do not include advanced configs */
|
|
int ignoreunsupported:1; /* do not include unsupported configs */
|
|
int withcomments:1; /* include comments */
|
|
int withversions:1; /* include versions */
|
|
uint8_t *check_status; /* status of last tree check (currently needed for CFG_DEF_TREE_MISSING only) */
|
|
};
|
|
|
|
|
|
/* flag to mark the item as used in a config tree instance during validation */
|
|
#define CFG_USED 0x01
|
|
/* flag to mark the item as valid in a config tree instance during validation */
|
|
#define CFG_VALID 0x02
|
|
|
|
/*
|
|
* Register ID for each possible item in the configuration tree.
|
|
*/
|
|
enum {
|
|
#define cfg_section(id, name, parent, flags, since_version, comment) id,
|
|
#define cfg(id, name, parent, flags, type, default_value, since_version, comment) id,
|
|
#define cfg_runtime(id, name, parent, flags, type, since_version, comment) id,
|
|
#define cfg_array(id, name, parent, flags, types, default_value, since_version, comment) id,
|
|
#define cfg_array_runtime(id, name, parent, flags, types, since_version, comment) id,
|
|
#include "config_settings.h"
|
|
#undef cfg_section
|
|
#undef cfg
|
|
#undef cfg_runtime
|
|
#undef cfg_array
|
|
#undef cfg_array_runtime
|
|
};
|
|
|
|
struct profile *add_profile(struct cmd_context *cmd, const char *profile_name);
|
|
int load_profile(struct cmd_context *cmd, struct profile *profile);
|
|
int load_pending_profiles(struct cmd_context *cmd);
|
|
|
|
/* configuration check handle for each instance of the validation check */
|
|
struct cft_check_handle {
|
|
struct dm_config_tree *cft; /* the tree for which the check is done */
|
|
config_source_t source; /* configuration source */
|
|
unsigned force_check:1; /* force check even if disabled by config/checks setting */
|
|
unsigned skip_if_checked:1; /* skip the check if already done before - return last state */
|
|
unsigned suppress_messages:1; /* suppress messages during the check if config item is found invalid */
|
|
uint8_t status[CFG_COUNT]; /* flags for each configuration item - the result of the check */
|
|
};
|
|
|
|
int config_def_get_path(char *buf, size_t buf_size, int id);
|
|
int config_def_check(struct cmd_context *cmd, struct cft_check_handle *handle);
|
|
|
|
int override_config_tree_from_string(struct cmd_context *cmd, const char *config_settings);
|
|
int override_config_tree_from_profile(struct cmd_context *cmd, struct profile *profile);
|
|
struct dm_config_tree *remove_config_tree_by_source(struct cmd_context *cmd, config_source_t source);
|
|
config_source_t config_get_source_type(struct dm_config_tree *cft);
|
|
|
|
typedef uint32_t (*checksum_fn_t) (uint32_t initial, const uint8_t *buf, uint32_t size);
|
|
|
|
struct dm_config_tree *config_open(config_source_t source, const char *filename, int keep_open);
|
|
int config_file_read_fd(struct dm_config_tree *cft, struct device *dev,
|
|
off_t offset, size_t size, off_t offset2, size_t size2,
|
|
checksum_fn_t checksum_fn, uint32_t checksum);
|
|
int config_file_read(struct dm_config_tree *cft);
|
|
struct dm_config_tree *config_file_open_and_read(const char *config_file, config_source_t source);
|
|
int config_write(struct dm_config_tree *cft, struct config_def_tree_spec *tree_spec,
|
|
const char *file, int argc, char **argv);
|
|
struct dm_config_tree *config_def_create_tree(struct config_def_tree_spec *spec);
|
|
void config_destroy(struct dm_config_tree *cft);
|
|
|
|
time_t config_file_timestamp(struct dm_config_tree *cft);
|
|
int config_file_changed(struct dm_config_tree *cft);
|
|
int config_file_check(struct dm_config_tree *cft, const char **filename, struct stat *info);
|
|
|
|
|
|
typedef enum {
|
|
CONFIG_MERGE_TYPE_RAW, /* always replace old config values with new config values when merging */
|
|
CONFIG_MERGE_TYPE_TAGS /* apply some exceptions when merging tag configs:
|
|
- skip tags section
|
|
- do not replace, but merge values of these settings:
|
|
activation/volume_list
|
|
devices/filter
|
|
devices/types
|
|
*/
|
|
} config_merge_t;
|
|
|
|
int merge_config_tree(struct cmd_context *cmd, struct dm_config_tree *cft,
|
|
struct dm_config_tree *newdata, config_merge_t);
|
|
|
|
/*
|
|
* These versions check an override tree, if present, first.
|
|
*/
|
|
const struct dm_config_node *find_config_tree_node(struct cmd_context *cmd, int id, struct profile *profile);
|
|
const char *find_config_tree_str(struct cmd_context *cmd, int id, struct profile *profile);
|
|
const char *find_config_tree_str_allow_empty(struct cmd_context *cmd, int id, struct profile *profile);
|
|
int find_config_tree_int(struct cmd_context *cmd, int id, struct profile *profile);
|
|
int64_t find_config_tree_int64(struct cmd_context *cmd, int id, struct profile *profile);
|
|
float find_config_tree_float(struct cmd_context *cmd, int id, struct profile *profile);
|
|
int find_config_tree_bool(struct cmd_context *cmd, int id, struct profile *profile);
|
|
|
|
/*
|
|
* Functions for configuration settings for which the default
|
|
* value is evaluated at runtime based on command context.
|
|
*/
|
|
const char *get_default_devices_cache_dir_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
const char *get_default_devices_cache_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
const char *get_default_backup_backup_dir_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
const char *get_default_backup_archive_dir_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
const char *get_default_config_profile_dir_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
const char *get_default_activation_mirror_image_fault_policy_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
int get_default_allocation_thin_pool_chunk_size_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
int get_default_allocation_cache_pool_chunk_size_CFG(struct cmd_context *cmd, struct profile *profile);
|
|
|
|
#endif
|