mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
f7e0a4cc18
This patch adds "include_historical_lvs" field to struct cmd_context to make it possible for the command to switch between original funcionality where no historical LVs are processed and functionality where historical LVs are taken into account (and reported or processed further). The switch between these modes is done using the '-H|--history' switch on command line. The include_historical_lvs state is then passed to process_each_* fns using the "include_historical_lvs" field within struct processing_handle.
217 lines
8.8 KiB
C
217 lines
8.8 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_TOOLLIB_H
|
|
#define _LVM_TOOLLIB_H
|
|
|
|
#include "metadata-exported.h"
|
|
#include "report.h"
|
|
|
|
int become_daemon(struct cmd_context *cmd, int skip_lvm);
|
|
|
|
/*
|
|
* The "struct processing_handle" is used as a handle for processing
|
|
* functions (process_each_* and related).
|
|
*
|
|
* The "custom_handle" is any handle used to pass custom data into
|
|
* process_each_* and related functions.
|
|
*
|
|
* The "internal_report_for_select=0" makes processing function to
|
|
* skip checking the report/selection criteria (if given on cmd line)
|
|
* before executing the action on the item.
|
|
*
|
|
* The "selection_handle" is only used if "internal_report_for_select=1".
|
|
*
|
|
* Some important notes about selection:
|
|
* =====================================
|
|
* In case we're processing for display, the selection is directly
|
|
* a part of reporting for the display on output so we don't need to
|
|
* report the item in memory to get the selection result, then dropping
|
|
* the report and then reporting the same thing again for it to be
|
|
* displayed on output.
|
|
* For example, compare these code paths:
|
|
*
|
|
* - when reporting for display on output:
|
|
* _report -> process_each_* -> ... -> dm_report_object
|
|
* (Here the dm_report_object does both selection and
|
|
* reporting for display on output.)
|
|
*
|
|
* - for any other processing and reporting for selection:
|
|
* process_each_* -> _select_match_* -> ... -> dm_report_object_is_selected
|
|
* |
|
|
* --> (selection result) --> ...
|
|
* (Here the dm_report_object_is_selected just gets
|
|
* the selection result and it drops reporting buffer
|
|
* immediately. Then based on the selection result,
|
|
* the process_each_* action on the item is executed
|
|
* or not...)
|
|
*
|
|
* Simply, we want to avoid this double reporting when reporting
|
|
* for display on output:
|
|
* _report -> process_each_* -> _select_match_* -> ... -> dm_report_object_is_selected
|
|
* |
|
|
* --> (selection result) -> dm_report_object
|
|
*
|
|
* So whenever the processing action is "to display item on output", use
|
|
* "internal_report_for_select=0" as report/selection is already
|
|
* a part of that reporting for display (dm_report_object).
|
|
*/
|
|
struct processing_handle {
|
|
int internal_report_for_select;
|
|
int include_historical_lvs;
|
|
struct selection_handle *selection_handle;
|
|
void *custom_handle;
|
|
};
|
|
|
|
typedef int (*process_single_vg_fn_t) (struct cmd_context * cmd,
|
|
const char *vg_name,
|
|
struct volume_group * vg,
|
|
struct processing_handle *handle);
|
|
typedef int (*process_single_pv_fn_t) (struct cmd_context *cmd,
|
|
struct volume_group *vg,
|
|
struct physical_volume *pv,
|
|
struct processing_handle *handle);
|
|
typedef int (*process_single_label_fn_t) (struct cmd_context *cmd,
|
|
struct label *label,
|
|
struct processing_handle *handle);
|
|
typedef int (*process_single_lv_fn_t) (struct cmd_context *cmd,
|
|
struct logical_volume *lv,
|
|
struct processing_handle *handle);
|
|
typedef int (*process_single_seg_fn_t) (struct cmd_context * cmd,
|
|
struct lv_segment * seg,
|
|
struct processing_handle *handle);
|
|
typedef int (*process_single_pvseg_fn_t) (struct cmd_context * cmd,
|
|
struct volume_group * vg,
|
|
struct pv_segment * pvseg,
|
|
struct processing_handle *handle);
|
|
|
|
int process_each_vg(struct cmd_context *cmd, int argc, char **argv,
|
|
const char *one_vgname, uint32_t flags,
|
|
struct processing_handle *handle,
|
|
process_single_vg_fn_t process_single_vg);
|
|
|
|
int process_each_pv(struct cmd_context *cmd, int argc, char **argv, const char *vg_name,
|
|
int all_is_set, uint32_t read_flags,
|
|
struct processing_handle *handle,
|
|
process_single_pv_fn_t process_single_pv);
|
|
|
|
int process_each_label(struct cmd_context *cmd, int argc, char **argv,
|
|
struct processing_handle *handle,
|
|
process_single_label_fn_t process_single_label);
|
|
|
|
int process_each_segment_in_pv(struct cmd_context *cmd,
|
|
struct volume_group *vg,
|
|
struct physical_volume *pv,
|
|
struct processing_handle *handle,
|
|
process_single_pvseg_fn_t process_single_pvseg);
|
|
|
|
int process_each_lv(struct cmd_context *cmd, int argc, char **argv,
|
|
uint32_t flags, struct processing_handle *handle,
|
|
process_single_lv_fn_t process_single_lv);
|
|
|
|
|
|
int process_each_segment_in_lv(struct cmd_context *cmd,
|
|
struct logical_volume *lv,
|
|
struct processing_handle *handle,
|
|
process_single_seg_fn_t process_single_seg);
|
|
|
|
int process_each_pv_in_vg(struct cmd_context *cmd, struct volume_group *vg,
|
|
struct processing_handle *handle,
|
|
process_single_pv_fn_t process_single_pv);
|
|
|
|
|
|
int process_each_lv_in_vg(struct cmd_context *cmd, struct volume_group *vg,
|
|
struct dm_list *arg_lvnames, const struct dm_list *tagsl,
|
|
int stop_on_error, struct processing_handle *handle,
|
|
process_single_lv_fn_t process_single_lv);
|
|
|
|
struct processing_handle *init_processing_handle(struct cmd_context *cmd);
|
|
int init_selection_handle(struct cmd_context *cmd, struct processing_handle *handle,
|
|
report_type_t initial_report_type);
|
|
void destroy_processing_handle(struct cmd_context *cmd, struct processing_handle *handle);
|
|
|
|
int select_match_vg(struct cmd_context *cmd, struct processing_handle *handle,
|
|
struct volume_group *vg, int *selected);
|
|
int select_match_lv(struct cmd_context *cmd, struct processing_handle *handle,
|
|
struct volume_group *vg, struct logical_volume *lv, int *selected);
|
|
int select_match_pv(struct cmd_context *cmd, struct processing_handle *handle,
|
|
struct volume_group *vg, struct physical_volume *pv, int *selected);
|
|
|
|
const char *extract_vgname(struct cmd_context *cmd, const char *lv_name);
|
|
const char *skip_dev_dir(struct cmd_context *cmd, const char *vg_name,
|
|
unsigned *dev_dir_found);
|
|
|
|
int pvcreate_params_from_args(struct cmd_context *cmd, struct pvcreate_params *pp);
|
|
int pvcreate_each_device(struct cmd_context *cmd, struct processing_handle *handle, struct pvcreate_params *pp);
|
|
|
|
/*
|
|
* Builds a list of pv's from the names in argv. Used in
|
|
* lvcreate/extend.
|
|
*/
|
|
struct dm_list *create_pv_list(struct dm_pool *mem, struct volume_group *vg, int argc,
|
|
char **argv, int allocatable_only);
|
|
|
|
struct dm_list *clone_pv_list(struct dm_pool *mem, struct dm_list *pvs);
|
|
|
|
int vgcreate_params_set_defaults(struct cmd_context *cmd,
|
|
struct vgcreate_params *vp_def,
|
|
struct volume_group *vg);
|
|
int vgcreate_params_set_from_args(struct cmd_context *cmd,
|
|
struct vgcreate_params *vp_new,
|
|
struct vgcreate_params *vp_def);
|
|
int lv_change_activate(struct cmd_context *cmd, struct logical_volume *lv,
|
|
activation_change_t activate);
|
|
int lv_refresh(struct cmd_context *cmd, struct logical_volume *lv);
|
|
int vg_refresh_visible(struct cmd_context *cmd, struct volume_group *vg);
|
|
void lv_spawn_background_polling(struct cmd_context *cmd,
|
|
struct logical_volume *lv);
|
|
|
|
int get_activation_monitoring_mode(struct cmd_context *cmd,
|
|
int *monitoring_mode);
|
|
|
|
int get_pool_params(struct cmd_context *cmd,
|
|
const struct segment_type *segtype,
|
|
int *passed_args,
|
|
uint64_t *pool_metadata_size,
|
|
int *pool_metadata_spare,
|
|
uint32_t *chunk_size,
|
|
thin_discards_t *discards,
|
|
int *zero);
|
|
|
|
int get_stripe_params(struct cmd_context *cmd, uint32_t *stripes,
|
|
uint32_t *stripe_size);
|
|
|
|
int get_cache_params(struct cmd_context *cmd,
|
|
const char **mode,
|
|
const char **name,
|
|
struct dm_config_tree **settings);
|
|
|
|
int change_tag(struct cmd_context *cmd, struct volume_group *vg,
|
|
struct logical_volume *lv, struct physical_volume *pv, int arg);
|
|
|
|
int get_and_validate_major_minor(const struct cmd_context *cmd,
|
|
const struct format_type *fmt,
|
|
int32_t *major, int32_t *minor);
|
|
|
|
int validate_lvname_param(struct cmd_context *cmd, const char **vg_name,
|
|
const char **lv_name);
|
|
int validate_restricted_lvname_param(struct cmd_context *cmd, const char **vg_name,
|
|
const char **lv_name);
|
|
|
|
int lvremove_single(struct cmd_context *cmd, struct logical_volume *lv,
|
|
struct processing_handle *handle __attribute__((unused)));
|
|
|
|
#endif
|