mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
51c83f1483
Check if created LV is going to be activated read-only because such LV cannot be zeroed (equals to use option '-pr').
294 lines
11 KiB
C
294 lines
11 KiB
C
/*
|
|
* Copyright (C) 2001-2004 Sistina Software, Inc. All rights reserved.
|
|
* Copyright (C) 2004-2018 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_ACTIVATE_H
|
|
#define LVM_ACTIVATE_H
|
|
|
|
#include "lib/metadata/metadata-exported.h"
|
|
|
|
struct lvinfo {
|
|
int exists;
|
|
int suspended;
|
|
unsigned int open_count;
|
|
int major;
|
|
int minor;
|
|
int read_only;
|
|
int live_table;
|
|
int inactive_table;
|
|
uint32_t read_ahead;
|
|
};
|
|
|
|
typedef enum {
|
|
SEG_STATUS_NONE,
|
|
SEG_STATUS_CACHE,
|
|
SEG_STATUS_RAID,
|
|
SEG_STATUS_SNAPSHOT,
|
|
SEG_STATUS_THIN,
|
|
SEG_STATUS_THIN_POOL,
|
|
SEG_STATUS_VDO_POOL,
|
|
SEG_STATUS_WRITECACHE,
|
|
SEG_STATUS_INTEGRITY,
|
|
SEG_STATUS_UNKNOWN
|
|
} lv_seg_status_type_t;
|
|
|
|
struct lv_seg_status {
|
|
struct dm_pool *mem; /* input */
|
|
const struct lv_segment *seg; /* input */
|
|
lv_seg_status_type_t type; /* output */
|
|
union {
|
|
struct dm_status_cache *cache;
|
|
struct dm_status_raid *raid;
|
|
struct dm_status_snapshot *snapshot;
|
|
struct dm_status_thin *thin;
|
|
struct dm_status_thin_pool *thin_pool;
|
|
struct dm_status_writecache *writecache;
|
|
struct dm_status_integrity *integrity;
|
|
struct lv_status_vdo vdo_pool;
|
|
};
|
|
};
|
|
|
|
struct lv_with_info_and_seg_status {
|
|
int info_ok;
|
|
const struct logical_volume *lv; /* output */
|
|
struct lvinfo info; /* output */
|
|
int seg_part_of_lv; /* output */
|
|
struct lv_seg_status seg_status; /* output, see lv_seg_status */
|
|
/* TODO: add extra status for snapshot origin */
|
|
};
|
|
|
|
struct lv_activate_opts {
|
|
int exclusive;
|
|
int origin_only;
|
|
int no_merging;
|
|
int send_messages;
|
|
int skip_in_use;
|
|
unsigned revert;
|
|
unsigned read_only;
|
|
unsigned noscan; /* Mark this LV to avoid its scanning. This also
|
|
directs udev to use proper udev flag to avoid
|
|
any scanning in udev. This udev flag is automatically
|
|
dropped in udev db on any spurious event that follows. */
|
|
unsigned temporary; /* Mark this LV as temporary. It means, the LV
|
|
* is created, used and deactivated within single
|
|
* LVM command execution. Such LVs are mostly helper
|
|
* LVs to do some action or cleanup before the proper
|
|
* LV is created. This also directs udev to use proper
|
|
* set of flags to avoid any scanning in udev. These udev
|
|
* flags are persistent in udev db for any spurious event
|
|
* that follows. */
|
|
unsigned resuming; /* Set when resuming after a suspend. */
|
|
const struct logical_volume *component_lv;
|
|
};
|
|
|
|
void set_activation(int activation, int silent);
|
|
int activation(void);
|
|
|
|
int driver_version(char *version, size_t size);
|
|
int library_version(char *version, size_t size);
|
|
|
|
int module_present(struct cmd_context *cmd, const char *target_name);
|
|
int target_present_version(struct cmd_context *cmd, const char *target_name,
|
|
int use_modprobe, uint32_t *maj,
|
|
uint32_t *min, uint32_t *patchlevel);
|
|
int target_present(struct cmd_context *cmd, const char *target_name,
|
|
int use_modprobe);
|
|
int target_version(const char *target_name, uint32_t *maj,
|
|
uint32_t *min, uint32_t *patchlevel);
|
|
int raid4_is_supported(struct cmd_context *cmd, const struct segment_type *segtype);
|
|
int lvm_dm_prefix_check(int major, int minor, const char *prefix);
|
|
int list_segment_modules(struct dm_pool *mem, const struct lv_segment *seg,
|
|
struct dm_list *modules);
|
|
int list_lv_modules(struct dm_pool *mem, const struct logical_volume *lv,
|
|
struct dm_list *modules);
|
|
|
|
void activation_release(void);
|
|
void activation_exit(void);
|
|
|
|
/* int lv_suspend(struct cmd_context *cmd, const char *lvid_s); */
|
|
int lv_suspend_if_active(struct cmd_context *cmd, const char *lvid_s, unsigned origin_only, unsigned exclusive,
|
|
const struct logical_volume *lv, const struct logical_volume *lv_pre);
|
|
int lv_resume(struct cmd_context *cmd, const char *lvid_s, unsigned origin_only, const struct logical_volume *lv);
|
|
int lv_resume_if_active(struct cmd_context *cmd, const char *lvid_s,
|
|
unsigned origin_only, unsigned exclusive, unsigned revert, const struct logical_volume *lv);
|
|
int lv_activate(struct cmd_context *cmd, const char *lvid_s, int exclusive,
|
|
int noscan, int temporary, const struct logical_volume *lv);
|
|
int lv_activate_with_filter(struct cmd_context *cmd, const char *lvid_s, int exclusive,
|
|
int noscan, int temporary, const struct logical_volume *lv);
|
|
int lv_deactivate(struct cmd_context *cmd, const char *lvid_s, const struct logical_volume *lv);
|
|
|
|
int lv_mknodes(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
|
|
int lv_deactivate_any_missing_subdevs(const struct logical_volume *lv);
|
|
|
|
int activate_lv(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
int deactivate_lv(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
int suspend_lv(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
int suspend_lv_origin(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
int resume_lv(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
int resume_lv_origin(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
int revert_lv(struct cmd_context *cmd, const struct logical_volume *lv);
|
|
|
|
/*
|
|
* Returns 1 if info structure has been populated, else 0 on failure.
|
|
* When lvinfo* is NULL, it returns 1 if the device is locally active, 0 otherwise.
|
|
*/
|
|
int lv_info(struct cmd_context *cmd, const struct logical_volume *lv, int use_layer,
|
|
struct lvinfo *info, int with_open_count, int with_read_ahead);
|
|
int lv_info_with_name_check(struct cmd_context *cmd, const struct logical_volume *lv,
|
|
int use_layer, struct lvinfo *info);
|
|
|
|
/*
|
|
* Returns 1 if lv_info_and_seg_status structure has been populated,
|
|
* else 0 on failure or if device not active locally.
|
|
*
|
|
* lv_info_with_seg_status is the same as calling lv_info and then lv_status,
|
|
* but this fn tries to do that with one ioctl if possible.
|
|
*/
|
|
int lv_info_with_seg_status(struct cmd_context *cmd,
|
|
const struct lv_segment *lv_seg,
|
|
struct lv_with_info_and_seg_status *status,
|
|
int with_open_count, int with_read_ahead);
|
|
|
|
int lv_check_not_in_use(const struct logical_volume *lv, int error_if_used);
|
|
|
|
/*
|
|
* Returns 1 if activate has been set: 1 = activate; 0 = don't.
|
|
*/
|
|
int lv_activation_filter(struct cmd_context *cmd, const char *lvid_s,
|
|
int *activate, const struct logical_volume *lv);
|
|
/*
|
|
* Checks against the auto_activation_volume_list and
|
|
* returns 1 if the LV should be activated, 0 otherwise.
|
|
*/
|
|
int lv_passes_auto_activation_filter(struct cmd_context *cmd, struct logical_volume *lv);
|
|
|
|
int lv_check_transient(struct logical_volume *lv);
|
|
/*
|
|
* Returns 1 if percent has been set, else 0.
|
|
*/
|
|
int lv_snapshot_percent(const struct logical_volume *lv, dm_percent_t *percent);
|
|
int lv_mirror_percent(struct cmd_context *cmd, const struct logical_volume *lv,
|
|
int wait, dm_percent_t *percent, uint32_t *event_nr);
|
|
int lv_raid_percent(const struct logical_volume *lv, dm_percent_t *percent);
|
|
int lv_raid_dev_count(const struct logical_volume *lv, uint32_t *dev_cnt);
|
|
int lv_raid_data_offset(const struct logical_volume *lv, uint64_t *data_offset);
|
|
int lv_raid_dev_health(const struct logical_volume *lv, char **dev_health);
|
|
int lv_raid_mismatch_count(const struct logical_volume *lv, uint64_t *cnt);
|
|
int lv_raid_sync_action(const struct logical_volume *lv, char **sync_action);
|
|
int lv_raid_message(const struct logical_volume *lv, const char *msg);
|
|
int lv_writecache_message(const struct logical_volume *lv, const char *msg);
|
|
int lv_cache_status(const struct logical_volume *cache_lv,
|
|
struct lv_status_cache **status);
|
|
int lv_thin_device_id(const struct logical_volume *lv, uint32_t *device_id);
|
|
int lv_thin_status(const struct logical_volume *lv, int flush,
|
|
struct lv_status_thin **status);
|
|
int lv_thin_pool_status(const struct logical_volume *lv, int flush,
|
|
struct lv_status_thin_pool **status);
|
|
int lv_vdo_pool_status(const struct logical_volume *lv, int flush,
|
|
struct lv_status_vdo **status);
|
|
int lv_vdo_pool_percent(const struct logical_volume *lv, dm_percent_t *percent);
|
|
|
|
/*
|
|
* Return number of LVs in the VG that are active.
|
|
*/
|
|
int lvs_in_vg_activated(const struct volume_group *vg);
|
|
int lvs_in_vg_opened(const struct volume_group *vg);
|
|
|
|
int lv_is_active(const struct logical_volume *lv);
|
|
|
|
int lv_passes_readonly_filter(const struct logical_volume *lv);
|
|
|
|
/* Check is any component LV is active */
|
|
const struct logical_volume *lv_component_is_active(const struct logical_volume *lv);
|
|
const struct logical_volume *lv_holder_is_active(const struct logical_volume *lv);
|
|
int deactivate_lv_with_sub_lv(const struct logical_volume *lv);
|
|
|
|
int lv_has_target_type(struct dm_pool *mem, const struct logical_volume *lv,
|
|
const char *layer, const char *target_type);
|
|
|
|
int monitor_dev_for_events(struct cmd_context *cmd, const struct logical_volume *lv,
|
|
const struct lv_activate_opts *laopts, int monitor);
|
|
|
|
#ifdef DMEVENTD
|
|
# include "daemons/dmeventd/libdevmapper-event.h"
|
|
char *get_monitor_dso_path(struct cmd_context *cmd, int id);
|
|
int target_registered_with_dmeventd(struct cmd_context *cmd, const char *dso,
|
|
const struct logical_volume *lv, int *pending, int *monitored);
|
|
int target_register_events(struct cmd_context *cmd, const char *dso, const struct logical_volume *lv,
|
|
int evmask __attribute__((unused)), int set, int timeout);
|
|
#endif
|
|
|
|
int add_linear_area_to_dtree(struct dm_tree_node *node, uint64_t size,
|
|
uint32_t extent_size, int use_linear_target,
|
|
const char *vgname, const char *lvname);
|
|
|
|
/*
|
|
* Returns 1 if PV has a dependency tree that uses anything in VG.
|
|
*/
|
|
int pv_uses_vg(struct physical_volume *pv,
|
|
struct volume_group *vg);
|
|
|
|
struct dev_usable_check_params {
|
|
unsigned int check_empty:1;
|
|
unsigned int check_blocked:1;
|
|
unsigned int check_suspended:1;
|
|
unsigned int check_error_target:1;
|
|
unsigned int check_reserved:1;
|
|
unsigned int check_lv:1;
|
|
};
|
|
|
|
/*
|
|
* Returns 1 if mapped device is not suspended, blocked or
|
|
* is using a reserved name.
|
|
*/
|
|
int device_is_usable(struct device *dev, struct dev_usable_check_params check);
|
|
|
|
/*
|
|
* Declaration moved here from fs.h to keep header fs.h hidden
|
|
*/
|
|
void fs_unlock(void);
|
|
|
|
#define TARGET_NAME_CACHE "cache"
|
|
#define TARGET_NAME_WRITECACHE "writecache"
|
|
#define TARGET_NAME_INTEGRITY "integrity"
|
|
#define TARGET_NAME_ERROR "error"
|
|
#define TARGET_NAME_ERROR_OLD "erro" /* Truncated in older kernels */
|
|
#define TARGET_NAME_LINEAR "linear"
|
|
#define TARGET_NAME_MIRROR "mirror"
|
|
#define TARGET_NAME_RAID "raid"
|
|
#define TARGET_NAME_SNAPSHOT "snapshot"
|
|
#define TARGET_NAME_SNAPSHOT_MERGE "snapshot-merge"
|
|
#define TARGET_NAME_SNAPSHOT_ORIGIN "snapshot-origin"
|
|
#define TARGET_NAME_STRIPED "striped"
|
|
#define TARGET_NAME_THIN "thin"
|
|
#define TARGET_NAME_THIN_POOL "thin-pool"
|
|
#define TARGET_NAME_VDO "vdo"
|
|
#define TARGET_NAME_ZERO "zero"
|
|
|
|
#define MODULE_NAME_CLUSTERED_MIRROR "clog"
|
|
#define MODULE_NAME_CACHE TARGET_NAME_CACHE
|
|
#define MODULE_NAME_WRITECACHE TARGET_NAME_WRITECACHE
|
|
#define MODULE_NAME_INTEGRITY TARGET_NAME_INTEGRITY
|
|
#define MODULE_NAME_ERROR TARGET_NAME_ERROR
|
|
#define MODULE_NAME_LOG_CLUSTERED "log-clustered"
|
|
#define MODULE_NAME_LOG_USERSPACE "log-userspace"
|
|
#define MODULE_NAME_MIRROR TARGET_NAME_MIRROR
|
|
#define MODULE_NAME_SNAPSHOT TARGET_NAME_SNAPSHOT
|
|
#define MODULE_NAME_RAID TARGET_NAME_RAID
|
|
#define MODULE_NAME_VDO "kvdo" /* does NOT use dm- prefix */
|
|
#define MODULE_NAME_ZERO TARGET_NAME_ZERO
|
|
|
|
#endif
|