mirror of
git://sourceware.org/git/lvm2.git
synced 2025-10-11 03:33:14 +03:00
c44f1bd669
devices_file, e.g. /etc/lvm/lvm_devices.dat, is a list of devices that lvm can use. Option --devicesfile can sepecify a different file with a separate set of devices for lvm to use. This option allows different applications to use lvm on different sets of devices. In most cases (with limited exceptions), lvm will not read or use a device not listed in devices_file. When the devices_file is used, the filter-regex is not used and the filter settings in lvm.conf are ignored. lvm uses the devices_file to control access to devices using the new filter-deviceid. Setting --devicesfile to "" on the command line, or devicesfile to "" in lvm.conf will disable the use of the devices_file and filter-deviceid. This allows lvm to see and use any device on the system. In this case lvm will fall back to using filter-regex and the filter config settings in lvm.conf. device_id, e.g. wwid or serial number from sysfs, is a unique ID that identifies a device without reading it, and which will change if the device is copied to another. The device_id is used in the devices_file and is included in VG metadata sections. Each device_id has a device_id_type which indicates where the device_id comes from, e.g. "sys_wwid" means the device_id comes from the sysfs wwid file. Others are sys_serial, mpath_uuid, loop_file, devname. (devname is the device path which is a fallback when no other proper device_id_type is available.) filter-deviceid permits lvm to use only devices on the system that have a device_id matching a devices_file entry. Using the device_id, lvm can determine the set of devices to use without reading any devices, so devices_file will constrain lvm in two ways: 1. it limits the devices that lvm will read. 2. it limits the devices that lvm will use. In some uncommon cases, e.g. when devices have no unique ID and device_id has to fall back to using the devname, lvm may need to read all devices on the system to determine which ones correspond to the devices_file entries. In this case, the devices_file does not limit the devices that lvm reads, but it does limit the devices that lvm uses. pvcreate/vgcreate/vgextend are not constrained by the devices_file, and will look outside it to find the new PV. They assign the new PV a device_id and add it to the devices_file. It is also possible to explicitly add new PVs to devices_file before using them in pvcreate/etc, in which case these commands would not need to access devices outside devices_file. (A config setting may be added to control the ability of these commands to search outside devices_file.) vgimportdevices VG looks at all devices on the system to find an existing VG and add its devices to the devices_file. The command is not limited by an existing devices_file. The command will also add device_ids to the VG metadata if the VG does not yet include device_ids. vgimportdevices -a imports devices for all accessible VGs. Since vgimportdevices does not limit itself to devices in an existing devices_file, the lvm.conf regex filter applies. Adding --foreign will import devices for foreign VGs, but device_ids are not added to foreign VGs. Incomplete VGs are not imported. The lvmdevices command manages the devices file. The primary purpose is to edit the devices file, but it will read PV headers to find/check PVIDs. (It does not read, process or modify VG metadata.) lvmdevices . Displays devices_file entries. lvmdevices --check . Checks devices_file entries. lvmdevices --update . Updates devices_file entries. lvmdevices --adddev <devname> . Adds devices_file entry (reads pv header). lvmdevices --deldev <devname> . Removes devices_file entry. lvmdevices --addpvid <pvid> . Reads pv header of all devices to find <pvid>, and if found adds devices_file entry. lvmdevices --delpvid <pvid> . Removes devices_file entry. TODO: pvchange --deviceidupdate PV vgchange --deviceidupdate VG pvs -o deviceidtype,deviceid duplicate PV resolution using device_id vgimportclone needs to update device_file pvchange --uuid needs to update device_file config setting device_id_types to control idtypes used search for pvid when no wwid is available and PV is missing md device_id_type config setting pvcreate_extends_devices_file=0|1 shortsystemid crc of systemid and written in pv header use shortsystemid for new filter and orphan PV ownership
283 lines
8.5 KiB
C
283 lines
8.5 KiB
C
/*
|
|
* Copyright (C) 2001-2004 Sistina Software, Inc. All rights reserved.
|
|
* Copyright (C) 2004-2009 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef _LVM_TOOLCONTEXT_H
|
|
#define _LVM_TOOLCONTEXT_H
|
|
|
|
#include "lib/device/dev-cache.h"
|
|
#include "lib/device/dev-type.h"
|
|
|
|
#include <limits.h>
|
|
|
|
/*
|
|
* Config options that can be changed while commands are processed
|
|
*/
|
|
struct config_info {
|
|
int debug;
|
|
int debug_classes;
|
|
int verbose;
|
|
int silent;
|
|
int test;
|
|
int syslog;
|
|
int activation;
|
|
int suffix;
|
|
int archive; /* should we archive ? */
|
|
int backup; /* should we backup ? */
|
|
int read_ahead; /* DM_READ_AHEAD_NONE or _AUTO */
|
|
int udev_rules;
|
|
int udev_sync;
|
|
int udev_fallback;
|
|
int cache_vgmetadata;
|
|
const char *msg_prefix;
|
|
const char *fmt_name;
|
|
const char *dmeventd_executable;
|
|
uint64_t unit_factor;
|
|
mode_t umask;
|
|
char unit_type;
|
|
char _padding[1];
|
|
};
|
|
|
|
struct dm_config_tree;
|
|
struct profile_params;
|
|
struct archive_params;
|
|
struct backup_params;
|
|
struct arg_values;
|
|
|
|
struct config_tree_list {
|
|
struct dm_list list;
|
|
struct dm_config_tree *cft;
|
|
};
|
|
|
|
struct cmd_context_initialized_parts {
|
|
unsigned config:1; /* used to reinitialize config if previous init was not successful */
|
|
unsigned filters:1;
|
|
unsigned connections:1;
|
|
};
|
|
|
|
struct cmd_report {
|
|
int log_only;
|
|
dm_report_group_type_t report_group_type;
|
|
struct dm_report_group *report_group;
|
|
struct dm_report *log_rh;
|
|
const char *log_name;
|
|
log_report_t saved_log_report_state;
|
|
};
|
|
|
|
/* FIXME Split into tool & library contexts */
|
|
/* command-instance-related variables needed by library */
|
|
struct cmd_context {
|
|
/*
|
|
* Memory handlers.
|
|
*/
|
|
struct dm_pool *libmem; /* for permanent config data */
|
|
struct dm_pool *mem; /* transient: cleared between each command */
|
|
|
|
/*
|
|
* Command line and arguments.
|
|
*/
|
|
const char *cmd_line;
|
|
const char *name; /* needed before cmd->command is set */
|
|
struct command_name *cname;
|
|
struct command *command;
|
|
char **argv;
|
|
struct arg_values *opt_arg_values;
|
|
struct dm_list arg_value_groups;
|
|
int opt_count; /* total number of options (beginning with - or --) */
|
|
|
|
/*
|
|
* Position args remaining after command name
|
|
* and --options are removed from original argc/argv.
|
|
*/
|
|
int position_argc;
|
|
char **position_argv;
|
|
|
|
/*
|
|
* Format handlers.
|
|
*/
|
|
const struct format_type *fmt; /* current format to use by default */
|
|
struct format_type *fmt_backup; /* format to use for backups */
|
|
struct dm_list formats; /* available formats */
|
|
struct dm_list segtypes; /* available segment types */
|
|
|
|
/*
|
|
* Machine and system identification.
|
|
*/
|
|
const char *system_id;
|
|
const char *hostname;
|
|
const char *kernel_vsn;
|
|
|
|
/*
|
|
* Device identification.
|
|
*/
|
|
struct dev_types *dev_types; /* recognized extra device types. */
|
|
|
|
/*
|
|
* Initialization state.
|
|
*/
|
|
struct cmd_context_initialized_parts initialized;
|
|
|
|
/*
|
|
* Switches.
|
|
*/
|
|
unsigned is_long_lived:1; /* optimises persistent_filter handling */
|
|
unsigned is_interactive:1;
|
|
unsigned check_pv_dev_sizes:1;
|
|
unsigned handles_missing_pvs:1;
|
|
unsigned handles_unknown_segments:1;
|
|
unsigned use_linear_target:1;
|
|
unsigned partial_activation:1;
|
|
unsigned degraded_activation:1;
|
|
unsigned auto_set_activation_skip:1;
|
|
unsigned si_unit_consistency:1;
|
|
unsigned report_binary_values_as_numeric:1;
|
|
unsigned report_mark_hidden_devices:1;
|
|
unsigned metadata_read_only:1;
|
|
unsigned threaded:1; /* set if running within a thread e.g. clvmd */
|
|
unsigned unknown_system_id:1;
|
|
unsigned include_historical_lvs:1; /* also process/report/display historical LVs */
|
|
unsigned record_historical_lvs:1; /* record historical LVs */
|
|
unsigned include_exported_vgs:1;
|
|
unsigned include_foreign_vgs:1; /* report/display cmds can reveal foreign VGs */
|
|
unsigned include_shared_vgs:1; /* report/display cmds can reveal lockd VGs */
|
|
unsigned include_active_foreign_vgs:1; /* cmd should process foreign VGs with active LVs */
|
|
unsigned vg_read_print_access_error:1; /* print access errors from vg_read */
|
|
unsigned allow_mixed_block_sizes:1;
|
|
unsigned force_access_clustered:1;
|
|
unsigned lockd_gl_disable:1;
|
|
unsigned lockd_vg_disable:1;
|
|
unsigned lockd_lv_disable:1;
|
|
unsigned lockd_gl_removed:1;
|
|
unsigned lockd_vg_default_sh:1;
|
|
unsigned lockd_vg_enforce_sh:1;
|
|
unsigned lockd_lv_sh_for_ex:1;
|
|
unsigned lockd_global_ex:1; /* set while global lock held ex (lockd) */
|
|
unsigned lockf_global_ex:1; /* set while global lock held ex (flock) */
|
|
unsigned nolocking:1;
|
|
unsigned vg_notify:1;
|
|
unsigned lv_notify:1;
|
|
unsigned pv_notify:1;
|
|
unsigned activate_component:1; /* command activates component LV */
|
|
unsigned process_component_lvs:1; /* command processes also component LVs */
|
|
unsigned mirror_warn_printed:1; /* command already printed warning about non-monitored mirrors */
|
|
unsigned pvscan_cache_single:1;
|
|
unsigned can_use_one_scan:1;
|
|
unsigned is_clvmd:1;
|
|
unsigned md_component_detection:1;
|
|
unsigned use_full_md_check:1;
|
|
unsigned is_activating:1;
|
|
unsigned enable_hints:1; /* hints are enabled for cmds in general */
|
|
unsigned use_hints:1; /* if hints are enabled this cmd can use them */
|
|
unsigned pvscan_recreate_hints:1; /* enable special case hint handling for pvscan --cache */
|
|
unsigned scan_lvs:1;
|
|
unsigned wipe_outdated_pvs:1;
|
|
unsigned enable_device_ids:1;
|
|
unsigned skip_filter_deviceid:1;
|
|
|
|
/*
|
|
* Devices and filtering.
|
|
*/
|
|
struct dev_filter *filter;
|
|
struct dm_list hints;
|
|
struct dm_list use_device_ids;
|
|
const char *md_component_checks;
|
|
const char *devices_file;
|
|
|
|
/*
|
|
* Configuration.
|
|
*/
|
|
struct dm_list config_files; /* master lvm config + any existing tag configs */
|
|
struct profile_params *profile_params; /* profile handling params including loaded profile configs */
|
|
struct dm_config_tree *cft; /* the whole cascade: CONFIG_STRING -> CONFIG_PROFILE -> CONFIG_FILE/CONFIG_MERGED_FILES */
|
|
struct dm_hash_table *cft_def_hash; /* config definition hash used for validity check (item type + item recognized) */
|
|
struct config_info default_settings; /* selected settings with original default/configured value which can be changed during cmd processing */
|
|
struct config_info current_settings; /* may contain changed values compared to default_settings */
|
|
|
|
/*
|
|
* Archives and backups.
|
|
*/
|
|
struct archive_params *archive_params;
|
|
struct backup_params *backup_params;
|
|
const char *stripe_filler;
|
|
|
|
/*
|
|
* Host tags.
|
|
*/
|
|
struct dm_list tags; /* list of defined tags */
|
|
int hosttags;
|
|
|
|
/*
|
|
* Paths.
|
|
*/
|
|
const char *lib_dir; /* cache value global/library_dir */
|
|
char system_dir[PATH_MAX];
|
|
char dev_dir[PATH_MAX];
|
|
char proc_dir[PATH_MAX];
|
|
|
|
/*
|
|
* Reporting.
|
|
*/
|
|
struct cmd_report cmd_report;
|
|
|
|
/*
|
|
* Buffers.
|
|
*/
|
|
char display_buffer[NAME_LEN * 10]; /* ring buffer for upto 10 longest vg/lv names */
|
|
unsigned display_lvname_idx; /* index to ring buffer */
|
|
char *linebuffer;
|
|
|
|
/*
|
|
* Others - unsorted.
|
|
*/
|
|
const char *report_list_item_separator;
|
|
const char *time_format;
|
|
unsigned rand_seed;
|
|
struct dm_list pending_delete; /* list of LVs for removal */
|
|
struct dm_pool *pending_delete_mem; /* memory pool for pending deletes */
|
|
};
|
|
|
|
/*
|
|
* system_dir may be NULL to use the default value.
|
|
* The environment variable LVM_SYSTEM_DIR always takes precedence.
|
|
*/
|
|
struct cmd_context *create_toolcontext(unsigned is_clvmd,
|
|
const char *system_dir,
|
|
unsigned set_buffering,
|
|
unsigned threaded,
|
|
unsigned set_connections,
|
|
unsigned set_filters);
|
|
void destroy_toolcontext(struct cmd_context *cmd);
|
|
int refresh_toolcontext(struct cmd_context *cmd);
|
|
int refresh_filters(struct cmd_context *cmd);
|
|
int process_profilable_config(struct cmd_context *cmd);
|
|
int config_files_changed(struct cmd_context *cmd);
|
|
int init_lvmcache_orphans(struct cmd_context *cmd);
|
|
int init_filters(struct cmd_context *cmd, unsigned load_persistent_cache);
|
|
int init_connections(struct cmd_context *cmd);
|
|
int init_run_by_dmeventd(struct cmd_context *cmd);
|
|
|
|
/*
|
|
* A config context is a very light weight cmd struct that
|
|
* is only used for reading config settings from lvm.conf,
|
|
* which are at cmd->cft.
|
|
*/
|
|
struct cmd_context *create_config_context(void);
|
|
void destroy_config_context(struct cmd_context *cmd);
|
|
|
|
struct format_type *get_format_by_name(struct cmd_context *cmd, const char *format);
|
|
|
|
const char *system_id_from_string(struct cmd_context *cmd, const char *str);
|
|
|
|
#endif
|