2001-10-09 20:05:34 +04:00
/*
2004-03-30 23:35:44 +04:00
* Copyright ( C ) 2001 - 2004 Sistina Software , Inc . All rights reserved .
2012-01-12 05:51:56 +04:00
* Copyright ( C ) 2004 - 2012 Red Hat , Inc . All rights reserved .
2001-10-09 20:05:34 +04:00
*
2004-03-30 23:35:44 +04:00
* 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
2007-08-21 00:55:30 +04:00
* of the GNU Lesser General Public License v .2 .1 .
2004-03-30 23:35:44 +04:00
*
2007-08-21 00:55:30 +04:00
* You should have received a copy of the GNU Lesser General Public License
2004-03-30 23:35:44 +04:00
* along with this program ; if not , write to the Free Software Foundation ,
* Inc . , 59 Temple Place , Suite 330 , Boston , MA 02111 - 1307 USA
2001-10-09 20:05:34 +04:00
*/
2001-10-16 20:25:28 +04:00
# ifndef LVM_ACTIVATE_H
# define LVM_ACTIVATE_H
2001-10-09 20:05:34 +04:00
2007-07-18 19:38:58 +04:00
# include "metadata-exported.h"
2003-01-09 01:44:07 +03:00
struct lvinfo {
int exists ;
int suspended ;
unsigned int open_count ;
int major ;
int minor ;
int read_only ;
2005-11-09 01:52:26 +03:00
int live_table ;
int inactive_table ;
2007-11-12 23:51:54 +03:00
uint32_t read_ahead ;
2003-01-09 01:44:07 +03:00
} ;
2001-11-21 22:32:35 +03:00
2011-06-17 18:14:19 +04:00
struct lv_activate_opts {
int exclusive ;
int origin_only ;
int no_merging ;
2013-01-17 13:35:27 +04:00
int send_messages ;
2012-03-23 13:58:04 +04:00
int skip_in_use ;
2011-09-28 02:43:40 +04:00
unsigned revert ;
2012-01-12 05:51:56 +04:00
unsigned read_only ;
activation: flag temporary LVs internally
Add LV_TEMPORARY flag for LVs with limited existence during command
execution. Such LVs are temporary in way that they need to be activated,
some action done and then removed immediately. Such LVs are just like
any normal LV - the only difference is that they are removed during
LVM command execution. This is also the case for LVs representing
future pool metadata spare LVs which we need to initialize by using
the usual LV before they are declared as pool metadata spare.
We can optimize some other parts like udev to do a better job if
it knows that the LV is temporary and any processing on it is just
useless.
This flag is orthogonal to LV_NOSCAN flag introduced recently
as LV_NOSCAN flag is primarily used to mark an LV for the scanning
to be avoided before the zeroing of the device happens. The LV_TEMPORARY
flag makes a difference between a full-fledged LV visible in the system
and the LV just used as a temporary overlay for some action that needs to
be done on underlying PVs.
For example: lvcreate --thinpool POOL --zero n -L 1G vg
- first, the usual LV is created to do a clean up for pool metadata
spare. The LV is activated, zeroed, deactivated.
- between "activated" and "zeroed" stage, the LV_NOSCAN flag is used
to avoid any scanning in udev
- betwen "zeroed" and "deactivated" stage, we need to avoid the WATCH
udev rule, but since the LV is just a usual LV, we can't make a
difference. The LV_TEMPORARY internal LV flag helps here. If we
create the LV with this flag, the DM_UDEV_DISABLE_DISK_RULES
and DM_UDEV_DISABLE_OTHER_RULES flag are set (just like as it is
with "invisible" and non-top-level LVs) - udev is directed to
skip WATCH rule use.
- if the LV_TEMPORARY flag was not used, there would normally be
a WATCH event generated once the LV is closed after "zeroed"
stage. This will make problems with immediated deactivation that
follows.
2013-10-23 16:06:39 +04:00
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 . */
2011-06-17 18:14:19 +04:00
} ;
2008-04-07 14:23:47 +04:00
/* target attribute flags */
# define MIRROR_LOG_CLUSTERED 0x00000001U
2012-05-25 15:38:03 +04:00
/* thin target attribute flags */
enum {
/* bitfields - new features from 1.1 version */
2012-08-08 00:24:41 +04:00
THIN_FEATURE_DISCARDS = ( 1 < < 0 ) ,
2012-05-25 15:38:03 +04:00
THIN_FEATURE_EXTERNAL_ORIGIN = ( 1 < < 1 ) ,
THIN_FEATURE_HELD_ROOT = ( 1 < < 2 ) ,
THIN_FEATURE_BLOCK_SIZE = ( 1 < < 3 ) ,
2012-11-26 14:04:00 +04:00
THIN_FEATURE_DISCARDS_NON_POWER_2 = ( 1 < < 4 ) ,
2013-06-11 14:31:01 +04:00
THIN_FEATURE_METADATA_RESIZE = ( 1 < < 5 ) ,
2012-05-25 15:38:03 +04:00
} ;
2002-11-18 17:01:16 +03:00
void set_activation ( int activation ) ;
2002-12-20 02:25:55 +03:00
int activation ( void ) ;
2002-11-18 17:01:16 +03:00
2002-01-17 19:39:24 +03:00
int driver_version ( char * version , size_t size ) ;
int library_version ( char * version , size_t size ) ;
2004-04-08 19:23:23 +04:00
int lvm1_present ( struct cmd_context * cmd ) ;
2002-01-17 19:39:24 +03:00
2009-02-28 03:54:06 +03:00
int module_present ( struct cmd_context * cmd , const char * target_name ) ;
int target_present ( struct cmd_context * cmd , const char * target_name ,
int use_modprobe ) ;
2005-12-20 00:01:39 +03:00
int target_version ( const char * target_name , uint32_t * maj ,
2010-08-17 02:54:35 +04:00
uint32_t * min , uint32_t * patchlevel ) ;
2011-11-11 20:41:37 +04:00
int lvm_dm_prefix_check ( int major , int minor , const char * prefix ) ;
2006-10-03 21:55:20 +04:00
int list_segment_modules ( struct dm_pool * mem , const struct lv_segment * seg ,
2008-11-04 01:14:30 +03:00
struct dm_list * modules ) ;
2006-10-03 21:55:20 +04:00
int list_lv_modules ( struct dm_pool * mem , const struct logical_volume * lv ,
2008-11-04 01:14:30 +03:00
struct dm_list * modules ) ;
2004-03-26 22:52:09 +03:00
2006-05-16 20:48:31 +04:00
void activation_release ( void ) ;
2003-07-05 02:34:56 +04:00
void activation_exit ( void ) ;
2010-08-17 20:25:32 +04:00
/* int lv_suspend(struct cmd_context *cmd, const char *lvid_s); */
2013-03-20 03:00:11 +04:00
int lv_suspend_if_active ( struct cmd_context * cmd , const char * lvid_s , unsigned origin_only , unsigned exclusive , struct logical_volume * lv_ondisk , struct logical_volume * lv_incore ) ;
2013-03-18 00:29:58 +04:00
int lv_resume ( struct cmd_context * cmd , const char * lvid_s , unsigned origin_only , struct logical_volume * lv ) ;
2011-02-18 03:36:04 +03:00
int lv_resume_if_active ( struct cmd_context * cmd , const char * lvid_s ,
2013-03-18 00:29:58 +04:00
unsigned origin_only , unsigned exclusive , unsigned revert , struct logical_volume * lv ) ;
activation: flag temporary LVs internally
Add LV_TEMPORARY flag for LVs with limited existence during command
execution. Such LVs are temporary in way that they need to be activated,
some action done and then removed immediately. Such LVs are just like
any normal LV - the only difference is that they are removed during
LVM command execution. This is also the case for LVs representing
future pool metadata spare LVs which we need to initialize by using
the usual LV before they are declared as pool metadata spare.
We can optimize some other parts like udev to do a better job if
it knows that the LV is temporary and any processing on it is just
useless.
This flag is orthogonal to LV_NOSCAN flag introduced recently
as LV_NOSCAN flag is primarily used to mark an LV for the scanning
to be avoided before the zeroing of the device happens. The LV_TEMPORARY
flag makes a difference between a full-fledged LV visible in the system
and the LV just used as a temporary overlay for some action that needs to
be done on underlying PVs.
For example: lvcreate --thinpool POOL --zero n -L 1G vg
- first, the usual LV is created to do a clean up for pool metadata
spare. The LV is activated, zeroed, deactivated.
- between "activated" and "zeroed" stage, the LV_NOSCAN flag is used
to avoid any scanning in udev
- betwen "zeroed" and "deactivated" stage, we need to avoid the WATCH
udev rule, but since the LV is just a usual LV, we can't make a
difference. The LV_TEMPORARY internal LV flag helps here. If we
create the LV with this flag, the DM_UDEV_DISABLE_DISK_RULES
and DM_UDEV_DISABLE_OTHER_RULES flag are set (just like as it is
with "invisible" and non-top-level LVs) - udev is directed to
skip WATCH rule use.
- if the LV_TEMPORARY flag was not used, there would normally be
a WATCH event generated once the LV is closed after "zeroed"
stage. This will make problems with immediated deactivation that
follows.
2013-10-23 16:06:39 +04:00
int lv_activate ( struct cmd_context * cmd , const char * lvid_s , int exclusive ,
int noscan , int temporary , struct logical_volume * lv ) ;
int lv_activate_with_filter ( struct cmd_context * cmd , const char * lvid_s , int exclusive ,
int noscan , int temporary , struct logical_volume * lv ) ;
2013-03-18 00:29:58 +04:00
int lv_deactivate ( struct cmd_context * cmd , const char * lvid_s , struct logical_volume * lv ) ;
2003-04-25 02:09:13 +04:00
2003-11-12 22:16:48 +03:00
int lv_mknodes ( struct cmd_context * cmd , const struct logical_volume * lv ) ;
2002-02-11 20:42:02 +03:00
/*
* Returns 1 if info structure has been populated , else 0.
*/
2012-01-25 17:10:26 +04:00
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_by_lvid ( struct cmd_context * cmd , const char * lvid_s , int use_layer ,
2007-11-12 23:51:54 +03:00
struct lvinfo * info , int with_open_count , int with_read_ahead ) ;
2004-03-08 21:54:13 +03:00
2011-09-22 21:33:50 +04:00
int lv_check_not_in_use ( struct cmd_context * cmd , struct logical_volume * lv ,
struct lvinfo * info ) ;
2004-03-08 21:54:13 +03:00
/*
* Returns 1 if activate_lv has been set : 1 = activate ; 0 = don ' t .
*/
int lv_activation_filter ( struct cmd_context * cmd , const char * lvid_s ,
2013-03-18 00:29:58 +04:00
int * activate_lv , struct logical_volume * lv ) ;
2012-06-27 16:59:34 +04:00
/*
* 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 ) ;
2004-03-08 21:54:13 +03:00
2010-05-24 19:32:20 +04:00
int lv_check_transient ( struct logical_volume * lv ) ;
2002-05-10 01:17:57 +04:00
/*
* Returns 1 if percent has been set , else 0.
*/
2010-11-30 14:53:31 +03:00
int lv_snapshot_percent ( const struct logical_volume * lv , percent_t * percent ) ;
2011-02-18 17:47:28 +03:00
int lv_mirror_percent ( struct cmd_context * cmd , const struct logical_volume * lv ,
2010-11-30 14:53:31 +03:00
int wait , percent_t * percent , uint32_t * event_nr ) ;
2011-08-11 22:24:40 +04:00
int lv_raid_percent ( const struct logical_volume * lv , percent_t * percent ) ;
2013-02-01 21:31:47 +04:00
int lv_raid_dev_health ( const struct logical_volume * lv , char * * dev_health ) ;
2013-04-12 00:33:59 +04:00
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 ) ;
2012-01-19 19:25:37 +04:00
int lv_thin_pool_percent ( const struct logical_volume * lv , int metadata ,
percent_t * percent ) ;
2012-01-19 19:27:54 +04:00
int lv_thin_percent ( const struct logical_volume * lv , int mapped ,
percent_t * percent ) ;
2012-01-25 12:48:42 +04:00
int lv_thin_pool_transaction_id ( const struct logical_volume * lv ,
uint64_t * transaction_id ) ;
2001-11-07 18:02:07 +03:00
2001-11-07 14:51:42 +03:00
/*
2002-02-11 18:48:34 +03:00
* Return number of LVs in the VG that are active .
2001-11-07 14:51:42 +03:00
*/
2012-02-24 02:41:57 +04:00
int lvs_in_vg_activated ( const struct volume_group * vg ) ;
2007-08-07 13:06:05 +04:00
int lvs_in_vg_opened ( const struct volume_group * vg ) ;
2001-10-16 20:25:28 +04:00
2012-02-24 02:41:57 +04:00
int lv_is_active ( const struct logical_volume * lv ) ;
2013-05-15 05:13:31 +04:00
int lv_is_active_locally ( const struct logical_volume * lv ) ;
2012-02-24 02:41:57 +04:00
int lv_is_active_but_not_locally ( const struct logical_volume * lv ) ;
int lv_is_active_exclusive ( const struct logical_volume * lv ) ;
int lv_is_active_exclusive_locally ( const struct logical_volume * lv ) ;
int lv_is_active_exclusive_remotely ( const struct logical_volume * lv ) ;
2006-05-12 23:16:48 +04:00
2010-04-23 06:57:39 +04:00
int lv_has_target_type ( struct dm_pool * mem , struct logical_volume * lv ,
const char * layer , const char * target_type ) ;
2010-08-17 20:25:32 +04:00
int monitor_dev_for_events ( struct cmd_context * cmd , struct logical_volume * lv ,
2011-06-17 18:14:19 +04:00
const struct lv_activate_opts * laopts , int do_reg ) ;
2006-05-12 23:16:48 +04:00
2010-08-17 02:54:35 +04:00
# ifdef DMEVENTD
# include "libdevmapper-event.h"
char * get_monitor_dso_path ( struct cmd_context * cmd , const char * libpath ) ;
2010-08-17 05:16:41 +04:00
int target_registered_with_dmeventd ( struct cmd_context * cmd , const char * libpath ,
struct logical_volume * lv , int * pending ) ;
int target_register_events ( struct cmd_context * cmd , const char * dso , struct logical_volume * lv ,
2010-08-17 02:54:35 +04:00
int evmask __attribute__ ( ( unused ) ) , int set , int timeout ) ;
# endif
2011-11-29 00:37:51 +04:00
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 ) ;
2005-10-25 23:08:21 +04:00
/*
* Returns 1 if PV has a dependency tree that uses anything in VG .
*/
2006-05-11 21:58:58 +04:00
int pv_uses_vg ( struct physical_volume * pv ,
2005-10-25 23:08:21 +04:00
struct volume_group * vg ) ;
2007-01-26 00:22:30 +03:00
/*
2013-08-08 02:42:26 +04:00
* Returns 1 if mapped device is not suspended , blocked or
* is using a reserved name .
2007-01-26 00:22:30 +03:00
*/
2010-05-13 22:38:38 +04:00
int device_is_usable ( struct device * dev ) ;
2007-01-26 00:22:30 +03:00
2013-08-08 02:42:26 +04:00
/*
* Returns 1 if the device is suspended or blocking .
* ( Does not perform check on the LV name of the device . )
* N . B . This is ! device_is_usable ( ) without the name check .
*/
int device_is_suspended_or_blocking ( struct device * dev ) ;
2011-01-10 17:02:30 +03:00
/*
* Declaration moved here from fs . h to keep header fs . h hidden
*/
void fs_unlock ( void ) ;
2001-10-09 20:05:34 +04:00
# endif