mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
7d4a15e53a
This patch adds structures and functions to reroute error and warning
logs to log report, if it's set.
There are 5 new functions:
- log_set_report
Set log report where logging will be rerouted.
- log_set_report_context
Set context globally so any report_cmdlog call will use it.
- log_set_report_object_type
Set object type globally so any report_cmdlog call will use it.
- log_set_report_object_name_and_id
Set object ID and name globally so any report_cmdlog call will use it.
- log_set_report_object_group_and_group_id
Set object group ID and name globally so any report_cmdlog call will use it.
These functions will be called during LVM command processing so any logs
which are rerouted to log report contain proper information about current
processing state.
227 lines
9.1 KiB
C
227 lines
9.1 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 {
|
|
struct processing_handle *parent;
|
|
int internal_report_for_select;
|
|
int include_historical_lvs;
|
|
struct selection_handle *selection_handle;
|
|
dm_report_group_type_t report_group_type;
|
|
struct dm_report_group *report_group;
|
|
struct dm_report *log_rh;
|
|
log_report_t saved_log_report_state;
|
|
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,
|
|
struct dm_list *use_vgnames,
|
|
uint32_t flags,
|
|
int include_internal,
|
|
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,
|
|
const char *one_vgname, const char *one_lvname,
|
|
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, struct processing_handle *parent_handle);
|
|
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 select_match_lv(struct cmd_context *cmd, struct processing_handle *handle,
|
|
struct volume_group *vg, struct logical_volume *lv);
|
|
int select_match_pv(struct cmd_context *cmd, struct processing_handle *handle,
|
|
struct volume_group *vg, struct physical_volume *pv);
|
|
|
|
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,
|
|
cache_mode_t *cache_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
|