diff options
Diffstat (limited to 'lib/cache/lvmcache.h')
| -rw-r--r-- | lib/cache/lvmcache.h | 207 |
1 files changed, 143 insertions, 64 deletions
diff --git a/lib/cache/lvmcache.h b/lib/cache/lvmcache.h index 615f466..7dde3cd 100644 --- a/lib/cache/lvmcache.h +++ b/lib/cache/lvmcache.h @@ -10,16 +10,17 @@ * * 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 + * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #ifndef _LVM_CACHE_H #define _LVM_CACHE_H -#include "dev-cache.h" -#include "uuid.h" -#include "label.h" -#include "locking.h" +#include "lib/device/dev-cache.h" +#include "lib/device/dev-type.h" +#include "lib/uuid/uuid.h" +#include "lib/label/label.h" +#include "lib/locking/locking.h" #define ORPHAN_PREFIX VG_ORPHANS #define ORPHAN_VG_NAME(fmt) ORPHAN_PREFIX "_" fmt @@ -38,96 +39,108 @@ struct disk_locn; struct lvmcache_vginfo; -int lvmcache_init(void); -void lvmcache_allow_reads_with_lvmetad(void); - -void lvmcache_destroy(struct cmd_context *cmd, int retain_orphans); - -/* Set full_scan to 1 to reread every filtered device label or - * 2 to rescan /dev for new devices */ -int lvmcache_label_scan(struct cmd_context *cmd, int full_scan); +/* + * vgsummary represents a summary of the VG that is read + * without a lock during label scan. It's used to populate + * basic lvmcache vginfo/info during label scan prior to + * vg_read(). + */ +struct lvmcache_vgsummary { + const char *vgname; + char vgid[ID_LEN + 1]; + uint64_t vgstatus; + char *creation_host; + const char *system_id; + const char *lock_type; + uint32_t seqno; + uint32_t mda_checksum; + size_t mda_size; + int mda_num; /* 1 = summary from mda1, 2 = summary from mda2 */ + unsigned mda_ignored:1; + unsigned zero_offset:1; + unsigned mismatch:1; /* lvmcache sets if this summary differs from previous values */ + struct dm_list pvsummaries; +}; + +int lvmcache_init(struct cmd_context *cmd); + +void lvmcache_destroy(struct cmd_context *cmd, int retain_orphans, int reset); + +int lvmcache_label_scan(struct cmd_context *cmd); +int lvmcache_label_rescan_vg(struct cmd_context *cmd, const char *vgname, const char *vgid); +int lvmcache_label_rescan_vg_rw(struct cmd_context *cmd, const char *vgname, const char *vgid); +int lvmcache_label_reopen_vg_rw(struct cmd_context *cmd, const char *vgname, const char *vgid); /* Add/delete a device */ -struct lvmcache_info *lvmcache_add(struct labeller *labeller, const char *pvid, - struct device *dev, - const char *vgname, const char *vgid, - uint32_t vgstatus); -int lvmcache_add_orphan_vginfo(const char *vgname, struct format_type *fmt); +struct lvmcache_info *lvmcache_add(struct cmd_context *cmd, struct labeller *labeller, const char *pvid, + struct device *dev, uint64_t label_sector, + const char *vgname, const char *vgid, + uint32_t vgstatus, int *is_duplicate); +int lvmcache_add_orphan_vginfo(struct cmd_context *cmd, const char *vgname, struct format_type *fmt); void lvmcache_del(struct lvmcache_info *info); +void lvmcache_del_dev(struct device *dev); /* Update things */ -int lvmcache_update_vgname_and_id(struct lvmcache_info *info, - const char *vgname, const char *vgid, - uint32_t vgstatus, const char *hostname); -int lvmcache_update_vg(struct volume_group *vg, unsigned precommitted); +int lvmcache_update_vgname_and_id(struct cmd_context *cmd, struct lvmcache_info *info, + struct lvmcache_vgsummary *vgsummary); +int lvmcache_update_vg_from_read(struct volume_group *vg, unsigned precommitted); void lvmcache_lock_vgname(const char *vgname, int read_only); void lvmcache_unlock_vgname(const char *vgname); -int lvmcache_verify_lock_order(const char *vgname); /* Queries */ -const struct format_type *lvmcache_fmt_from_vgname(struct cmd_context *cmd, const char *vgname, const char *vgid, unsigned revalidate_labels); - -/* Decrement and test if there are still vg holders in vginfo. */ -int lvmcache_vginfo_holders_dec_and_test_for_zero(struct lvmcache_vginfo *vginfo); +int lvmcache_lookup_mda(struct lvmcache_vgsummary *vgsummary); struct lvmcache_vginfo *lvmcache_vginfo_from_vgname(const char *vgname, const char *vgid); struct lvmcache_vginfo *lvmcache_vginfo_from_vgid(const char *vgid); -struct lvmcache_info *lvmcache_info_from_pvid(const char *pvid, int valid_only); +struct lvmcache_info *lvmcache_info_from_pvid(const char *pvid, struct device *dev, int valid_only); +struct lvmcache_info *lvmcache_info_from_pv_id(const struct id *pv_id, struct device *dev, int valid_only); const char *lvmcache_vgname_from_vgid(struct dm_pool *mem, const char *vgid); -struct device *lvmcache_device_from_pvid(struct cmd_context *cmd, const struct id *pvid, - unsigned *scan_done_once, uint64_t *label_sector); -const char *lvmcache_pvid_from_devname(struct cmd_context *cmd, - const char *dev_name); -char *lvmcache_vgname_from_pvid(struct cmd_context *cmd, const char *pvid); +const char *lvmcache_vgid_from_vgname(struct cmd_context *cmd, const char *vgname); +struct device *lvmcache_device_from_pv_id(struct cmd_context *cmd, const struct id *pv_id, uint64_t *label_sector); const char *lvmcache_vgname_from_info(struct lvmcache_info *info); -int lvmcache_vgs_locked(void); -int lvmcache_vgname_is_locked(const char *vgname); +const struct format_type *lvmcache_fmt_from_info(struct lvmcache_info *info); -void lvmcache_seed_infos_from_lvmetad(struct cmd_context *cmd); +int lvmcache_get_vgnameids(struct cmd_context *cmd, + struct dm_list *vgnameids, + const char *only_this_vgname, + int include_internal); -/* Returns list of struct str_lists containing pool-allocated copy of vgnames */ -/* If include_internal is not set, return only proper vg names. */ -struct dm_list *lvmcache_get_vgnames(struct cmd_context *cmd, - int include_internal); - -/* Returns list of struct str_lists containing pool-allocated copy of vgids */ -/* If include_internal is not set, return only proper vg ids. */ -struct dm_list *lvmcache_get_vgids(struct cmd_context *cmd, - int include_internal); - -/* Returns list of struct str_lists containing pool-allocated copy of pvids */ -struct dm_list *lvmcache_get_pvids(struct cmd_context *cmd, const char *vgname, - const char *vgid); - -/* Returns cached volume group metadata. */ -struct volume_group *lvmcache_get_vg(struct cmd_context *cmd, const char *vgname, - const char *vgid, unsigned precommitted); void lvmcache_drop_metadata(const char *vgname, int drop_precommitted); void lvmcache_commit_metadata(const char *vgname); -int lvmcache_pvid_is_locked(const char *pvid); int lvmcache_fid_add_mdas(struct lvmcache_info *info, struct format_instance *fid, const char *id, int id_len); int lvmcache_fid_add_mdas_pv(struct lvmcache_info *info, struct format_instance *fid); int lvmcache_fid_add_mdas_vg(struct lvmcache_vginfo *vginfo, struct format_instance *fid); int lvmcache_populate_pv_fields(struct lvmcache_info *info, - struct physical_volume *pv, - int scan_label_only); + struct volume_group *vg, + struct physical_volume *pv); int lvmcache_check_format(struct lvmcache_info *info, const struct format_type *fmt); void lvmcache_del_mdas(struct lvmcache_info *info); void lvmcache_del_das(struct lvmcache_info *info); +void lvmcache_del_bas(struct lvmcache_info *info); int lvmcache_add_mda(struct lvmcache_info *info, struct device *dev, - uint64_t start, uint64_t size, unsigned ignored); + uint64_t start, uint64_t size, unsigned ignored, + struct metadata_area **mda_new); int lvmcache_add_da(struct lvmcache_info *info, uint64_t start, uint64_t size); +int lvmcache_add_ba(struct lvmcache_info *info, uint64_t start, uint64_t size); + +void lvmcache_set_ext_version(struct lvmcache_info *info, uint32_t version); +uint32_t lvmcache_ext_version(struct lvmcache_info *info); +void lvmcache_set_ext_flags(struct lvmcache_info *info, uint32_t flags); +uint32_t lvmcache_ext_flags(struct lvmcache_info *info); const struct format_type *lvmcache_fmt(struct lvmcache_info *info); struct label *lvmcache_get_label(struct lvmcache_info *info); +struct label *lvmcache_get_dev_label(struct device *dev); +int lvmcache_has_dev_info(struct device *dev); void lvmcache_update_pv(struct lvmcache_info *info, struct physical_volume *pv, const struct format_type *fmt); int lvmcache_update_das(struct lvmcache_info *info, struct physical_volume *pv); +int lvmcache_update_bas(struct lvmcache_info *info, struct physical_volume *pv); int lvmcache_foreach_mda(struct lvmcache_info *info, int (*fun)(struct metadata_area *, void *), void *baton); @@ -136,17 +149,83 @@ int lvmcache_foreach_da(struct lvmcache_info *info, int (*fun)(struct disk_locn *, void *), void *baton); -int lvmcache_foreach_pv(struct lvmcache_vginfo *vg, +int lvmcache_foreach_ba(struct lvmcache_info *info, + int (*fun)(struct disk_locn *, void *), + void *baton); + +int lvmcache_foreach_pv(struct lvmcache_vginfo *vginfo, int (*fun)(struct lvmcache_info *, void *), void * baton); uint64_t lvmcache_device_size(struct lvmcache_info *info); void lvmcache_set_device_size(struct lvmcache_info *info, uint64_t size); struct device *lvmcache_device(struct lvmcache_info *info); -void lvmcache_make_valid(struct lvmcache_info *info); -int lvmcache_is_orphan(struct lvmcache_info *info); -int lvmcache_uncertain_ownership(struct lvmcache_info *info); -int lvmcache_mda_count(struct lvmcache_info *info); -int lvmcache_vgid_is_cached(const char *vgid); -int lvmcache_smallest_mda_size(struct lvmcache_info *info); +unsigned lvmcache_mda_count(struct lvmcache_info *info); +uint64_t lvmcache_smallest_mda_size(struct lvmcache_info *info); + +bool lvmcache_has_duplicate_devs(void); +void lvmcache_del_dev_from_duplicates(struct device *dev); +bool lvmcache_dev_is_unused_duplicate(struct device *dev); +int lvmcache_pvid_in_unused_duplicates(const char *pvid); +int lvmcache_get_unused_duplicates(struct cmd_context *cmd, struct dm_list *head); +int vg_has_duplicate_pvs(struct volume_group *vg); + +int lvmcache_found_duplicate_vgnames(void); +bool lvmcache_has_duplicate_local_vgname(const char *vgid, const char *vgname); + +int lvmcache_contains_lock_type_sanlock(struct cmd_context *cmd); + +void lvmcache_get_max_name_lengths(struct cmd_context *cmd, + unsigned *pv_max_name_len, unsigned *vg_max_name_len); + +int lvmcache_vg_is_foreign(struct cmd_context *cmd, const char *vgname, const char *vgid); + +bool lvmcache_scan_mismatch(struct cmd_context *cmd, const char *vgname, const char *vgid); + +int lvmcache_vginfo_has_pvid(struct lvmcache_vginfo *vginfo, const char *pvid_arg); + +uint64_t lvmcache_max_metadata_size(void); +void lvmcache_save_metadata_size(uint64_t val); + +bool lvmcache_has_bad_metadata(struct device *dev); + +bool lvmcache_has_old_metadata(struct cmd_context *cmd, const char *vgname, const char *vgid, struct device *dev); + +void lvmcache_get_outdated_devs(struct cmd_context *cmd, + const char *vgname, const char *vgid, + struct dm_list *devs); +void lvmcache_get_outdated_mdas(struct cmd_context *cmd, + const char *vgname, const char *vgid, + struct device *dev, + struct dm_list **mdas); + +bool lvmcache_is_outdated_dev(struct cmd_context *cmd, + const char *vgname, const char *vgid, + struct device *dev); + +void lvmcache_del_outdated_devs(struct cmd_context *cmd, + const char *vgname, const char *vgid); + +void lvmcache_save_bad_mda(struct lvmcache_info *info, struct metadata_area *mda); + +void lvmcache_del_save_bad_mda(struct lvmcache_info *info, int mda_num, int bad_mda_flag); + +void lvmcache_get_bad_mdas(struct cmd_context *cmd, + const char *vgname, const char *vgid, + struct dm_list *bad_mda_list); + +void lvmcache_get_mdas(struct cmd_context *cmd, + const char *vgname, const char *vgid, + struct dm_list *mda_list); + +const char *dev_filtered_reason(struct device *dev); +const char *devname_error_reason(const char *devname); + +struct metadata_area *lvmcache_get_dev_mda(struct device *dev, int mda_num); + +void lvmcache_extra_md_component_checks(struct cmd_context *cmd); + +unsigned int lvmcache_vg_info_count(void); + +int lvmcache_pvsummary_count(const char *vgname); #endif |