1c66ac9dbSNicholas Bellinger #ifndef TARGET_CORE_ALUA_H 2c66ac9dbSNicholas Bellinger #define TARGET_CORE_ALUA_H 3c66ac9dbSNicholas Bellinger 48dcf07beSBart Van Assche #include <target/target_core_base.h> 58dcf07beSBart Van Assche 6c66ac9dbSNicholas Bellinger /* 7c66ac9dbSNicholas Bellinger * INQUIRY response data, TPGS Field 8c66ac9dbSNicholas Bellinger * 9c66ac9dbSNicholas Bellinger * from spc4r17 section 6.4.2 Table 135 10c66ac9dbSNicholas Bellinger */ 11c66ac9dbSNicholas Bellinger #define TPGS_NO_ALUA 0x00 12125d0119SHannes Reinecke #define TPGS_IMPLICIT_ALUA 0x10 13125d0119SHannes Reinecke #define TPGS_EXPLICIT_ALUA 0x20 14c66ac9dbSNicholas Bellinger 15c66ac9dbSNicholas Bellinger /* 16c66ac9dbSNicholas Bellinger * ASYMMETRIC ACCESS STATE field 17c66ac9dbSNicholas Bellinger * 18c66094bfSHannes Reinecke * from spc4r36j section 6.37 Table 307 19c66ac9dbSNicholas Bellinger */ 2073f3bf51SHannes Reinecke #define ALUA_ACCESS_STATE_ACTIVE_OPTIMIZED 0x0 21c66ac9dbSNicholas Bellinger #define ALUA_ACCESS_STATE_ACTIVE_NON_OPTIMIZED 0x1 22c66ac9dbSNicholas Bellinger #define ALUA_ACCESS_STATE_STANDBY 0x2 23c66ac9dbSNicholas Bellinger #define ALUA_ACCESS_STATE_UNAVAILABLE 0x3 24c66094bfSHannes Reinecke #define ALUA_ACCESS_STATE_LBA_DEPENDENT 0x4 25c66ac9dbSNicholas Bellinger #define ALUA_ACCESS_STATE_OFFLINE 0xe 26c66ac9dbSNicholas Bellinger #define ALUA_ACCESS_STATE_TRANSITION 0xf 27c66ac9dbSNicholas Bellinger 28c66ac9dbSNicholas Bellinger /* 29c0dc941eSHannes Reinecke * from spc4r36j section 6.37 Table 306 30c0dc941eSHannes Reinecke */ 31c0dc941eSHannes Reinecke #define ALUA_T_SUP 0x80 32c0dc941eSHannes Reinecke #define ALUA_O_SUP 0x40 33c0dc941eSHannes Reinecke #define ALUA_LBD_SUP 0x10 34c0dc941eSHannes Reinecke #define ALUA_U_SUP 0x08 35c0dc941eSHannes Reinecke #define ALUA_S_SUP 0x04 36c0dc941eSHannes Reinecke #define ALUA_AN_SUP 0x02 37c0dc941eSHannes Reinecke #define ALUA_AO_SUP 0x01 38c0dc941eSHannes Reinecke 39c0dc941eSHannes Reinecke /* 40c66ac9dbSNicholas Bellinger * REPORT_TARGET_PORT_GROUP STATUS CODE 41c66ac9dbSNicholas Bellinger * 42c66ac9dbSNicholas Bellinger * from spc4r17 section 6.27 Table 246 43c66ac9dbSNicholas Bellinger */ 44c66ac9dbSNicholas Bellinger #define ALUA_STATUS_NONE 0x00 45125d0119SHannes Reinecke #define ALUA_STATUS_ALTERED_BY_EXPLICIT_STPG 0x01 46125d0119SHannes Reinecke #define ALUA_STATUS_ALTERED_BY_IMPLICIT_ALUA 0x02 47c66ac9dbSNicholas Bellinger 48c66ac9dbSNicholas Bellinger /* 49c66ac9dbSNicholas Bellinger * From spc4r17, Table D.1: ASC and ASCQ Assignement 50c66ac9dbSNicholas Bellinger */ 51c66ac9dbSNicholas Bellinger #define ASCQ_04H_ALUA_STATE_TRANSITION 0x0a 52c66ac9dbSNicholas Bellinger #define ASCQ_04H_ALUA_TG_PT_STANDBY 0x0b 53c66ac9dbSNicholas Bellinger #define ASCQ_04H_ALUA_TG_PT_UNAVAILABLE 0x0c 54c66ac9dbSNicholas Bellinger #define ASCQ_04H_ALUA_OFFLINE 0x12 55c66ac9dbSNicholas Bellinger 56c66ac9dbSNicholas Bellinger /* 57c66ac9dbSNicholas Bellinger * Used as the default for Active/NonOptimized delay (in milliseconds) 58c66ac9dbSNicholas Bellinger * This can also be changed via configfs on a per target port group basis.. 59c66ac9dbSNicholas Bellinger */ 60c66ac9dbSNicholas Bellinger #define ALUA_DEFAULT_NONOP_DELAY_MSECS 100 61c66ac9dbSNicholas Bellinger #define ALUA_MAX_NONOP_DELAY_MSECS 10000 /* 10 seconds */ 62c66ac9dbSNicholas Bellinger /* 63125d0119SHannes Reinecke * Used for implicit and explicit ALUA transitional delay, that is disabled 64c66ac9dbSNicholas Bellinger * by default, and is intended to be used for debugging client side ALUA code. 65c66ac9dbSNicholas Bellinger */ 66c66ac9dbSNicholas Bellinger #define ALUA_DEFAULT_TRANS_DELAY_MSECS 0 67c66ac9dbSNicholas Bellinger #define ALUA_MAX_TRANS_DELAY_MSECS 30000 /* 30 seconds */ 68c66ac9dbSNicholas Bellinger /* 69125d0119SHannes Reinecke * Used for the recommended application client implicit transition timeout 705b9a4d72SNicholas Bellinger * in seconds, returned by the REPORT_TARGET_PORT_GROUPS w/ extended header. 715b9a4d72SNicholas Bellinger */ 72125d0119SHannes Reinecke #define ALUA_DEFAULT_IMPLICIT_TRANS_SECS 0 73125d0119SHannes Reinecke #define ALUA_MAX_IMPLICIT_TRANS_SECS 255 745b9a4d72SNicholas Bellinger /* 75c66ac9dbSNicholas Bellinger * Used by core_alua_update_tpg_primary_metadata() and 76c66ac9dbSNicholas Bellinger * core_alua_update_tpg_secondary_metadata() 77c66ac9dbSNicholas Bellinger */ 78c66ac9dbSNicholas Bellinger #define ALUA_METADATA_PATH_LEN 512 79c66ac9dbSNicholas Bellinger /* 80c66ac9dbSNicholas Bellinger * Used by core_alua_update_tpg_secondary_metadata() 81c66ac9dbSNicholas Bellinger */ 82c66ac9dbSNicholas Bellinger #define ALUA_SECONDARY_METADATA_WWN_LEN 256 83c66ac9dbSNicholas Bellinger 841e0b9403SHannes Reinecke /* Used by core_alua_update_tpg_(primary,secondary)_metadata */ 851e0b9403SHannes Reinecke #define ALUA_MD_BUF_LEN 1024 861e0b9403SHannes Reinecke 87c66ac9dbSNicholas Bellinger extern struct kmem_cache *t10_alua_lu_gp_cache; 88c66ac9dbSNicholas Bellinger extern struct kmem_cache *t10_alua_lu_gp_mem_cache; 89c66ac9dbSNicholas Bellinger extern struct kmem_cache *t10_alua_tg_pt_gp_cache; 90229d4f11SHannes Reinecke extern struct kmem_cache *t10_alua_lba_map_cache; 91229d4f11SHannes Reinecke extern struct kmem_cache *t10_alua_lba_map_mem_cache; 92c66ac9dbSNicholas Bellinger 93de103c93SChristoph Hellwig extern sense_reason_t target_emulate_report_target_port_groups(struct se_cmd *); 94de103c93SChristoph Hellwig extern sense_reason_t target_emulate_set_target_port_groups(struct se_cmd *); 95c66094bfSHannes Reinecke extern sense_reason_t target_emulate_report_referrals(struct se_cmd *); 96c66ac9dbSNicholas Bellinger extern int core_alua_check_nonop_delay(struct se_cmd *); 97c66ac9dbSNicholas Bellinger extern int core_alua_do_port_transition(struct t10_alua_tg_pt_gp *, 98adf653f9SChristoph Hellwig struct se_device *, struct se_lun *, 99c66ac9dbSNicholas Bellinger struct se_node_acl *, int, int); 100c66ac9dbSNicholas Bellinger extern char *core_alua_dump_status(int); 101229d4f11SHannes Reinecke extern struct t10_alua_lba_map *core_alua_allocate_lba_map( 102229d4f11SHannes Reinecke struct list_head *, u64, u64); 103229d4f11SHannes Reinecke extern int core_alua_allocate_lba_map_mem(struct t10_alua_lba_map *, int, int); 104229d4f11SHannes Reinecke extern void core_alua_free_lba_map(struct list_head *); 105229d4f11SHannes Reinecke extern void core_alua_set_lba_map(struct se_device *, struct list_head *, 106229d4f11SHannes Reinecke int, int); 107c66ac9dbSNicholas Bellinger extern struct t10_alua_lu_gp *core_alua_allocate_lu_gp(const char *, int); 108c66ac9dbSNicholas Bellinger extern int core_alua_set_lu_gp_id(struct t10_alua_lu_gp *, u16); 109c66ac9dbSNicholas Bellinger extern void core_alua_free_lu_gp(struct t10_alua_lu_gp *); 110c66ac9dbSNicholas Bellinger extern void core_alua_free_lu_gp_mem(struct se_device *); 111c66ac9dbSNicholas Bellinger extern struct t10_alua_lu_gp *core_alua_get_lu_gp_by_name(const char *); 112c66ac9dbSNicholas Bellinger extern void core_alua_put_lu_gp_from_name(struct t10_alua_lu_gp *); 113c66ac9dbSNicholas Bellinger extern void __core_alua_attach_lu_gp_mem(struct t10_alua_lu_gp_member *, 114c66ac9dbSNicholas Bellinger struct t10_alua_lu_gp *); 115c66ac9dbSNicholas Bellinger extern void __core_alua_drop_lu_gp_mem(struct t10_alua_lu_gp_member *, 116c66ac9dbSNicholas Bellinger struct t10_alua_lu_gp *); 117c66ac9dbSNicholas Bellinger extern void core_alua_drop_lu_gp_dev(struct se_device *); 118c66ac9dbSNicholas Bellinger extern struct t10_alua_tg_pt_gp *core_alua_allocate_tg_pt_gp( 1190fd97ccfSChristoph Hellwig struct se_device *, const char *, int); 120c66ac9dbSNicholas Bellinger extern int core_alua_set_tg_pt_gp_id(struct t10_alua_tg_pt_gp *, u16); 121c66ac9dbSNicholas Bellinger extern void core_alua_free_tg_pt_gp(struct t10_alua_tg_pt_gp *); 122adf653f9SChristoph Hellwig extern void target_detach_tg_pt_gp(struct se_lun *); 123adf653f9SChristoph Hellwig extern void target_attach_tg_pt_gp(struct se_lun *, struct t10_alua_tg_pt_gp *); 124adf653f9SChristoph Hellwig extern ssize_t core_alua_show_tg_pt_gp_info(struct se_lun *, char *); 125adf653f9SChristoph Hellwig extern ssize_t core_alua_store_tg_pt_gp_info(struct se_lun *, const char *, 126c66ac9dbSNicholas Bellinger size_t); 127c66ac9dbSNicholas Bellinger extern ssize_t core_alua_show_access_type(struct t10_alua_tg_pt_gp *, char *); 128c66ac9dbSNicholas Bellinger extern ssize_t core_alua_store_access_type(struct t10_alua_tg_pt_gp *, 129c66ac9dbSNicholas Bellinger const char *, size_t); 130c66ac9dbSNicholas Bellinger extern ssize_t core_alua_show_nonop_delay_msecs(struct t10_alua_tg_pt_gp *, 131c66ac9dbSNicholas Bellinger char *); 132c66ac9dbSNicholas Bellinger extern ssize_t core_alua_store_nonop_delay_msecs(struct t10_alua_tg_pt_gp *, 133c66ac9dbSNicholas Bellinger const char *, size_t); 134c66ac9dbSNicholas Bellinger extern ssize_t core_alua_show_trans_delay_msecs(struct t10_alua_tg_pt_gp *, 135c66ac9dbSNicholas Bellinger char *); 136c66ac9dbSNicholas Bellinger extern ssize_t core_alua_store_trans_delay_msecs(struct t10_alua_tg_pt_gp *, 137c66ac9dbSNicholas Bellinger const char *, size_t); 138125d0119SHannes Reinecke extern ssize_t core_alua_show_implicit_trans_secs(struct t10_alua_tg_pt_gp *, 1395b9a4d72SNicholas Bellinger char *); 140125d0119SHannes Reinecke extern ssize_t core_alua_store_implicit_trans_secs(struct t10_alua_tg_pt_gp *, 1415b9a4d72SNicholas Bellinger const char *, size_t); 142c66ac9dbSNicholas Bellinger extern ssize_t core_alua_show_preferred_bit(struct t10_alua_tg_pt_gp *, 143c66ac9dbSNicholas Bellinger char *); 144c66ac9dbSNicholas Bellinger extern ssize_t core_alua_store_preferred_bit(struct t10_alua_tg_pt_gp *, 145c66ac9dbSNicholas Bellinger const char *, size_t); 146c66ac9dbSNicholas Bellinger extern ssize_t core_alua_show_offline_bit(struct se_lun *, char *); 147c66ac9dbSNicholas Bellinger extern ssize_t core_alua_store_offline_bit(struct se_lun *, const char *, 148c66ac9dbSNicholas Bellinger size_t); 149c66ac9dbSNicholas Bellinger extern ssize_t core_alua_show_secondary_status(struct se_lun *, char *); 150c66ac9dbSNicholas Bellinger extern ssize_t core_alua_store_secondary_status(struct se_lun *, 151c66ac9dbSNicholas Bellinger const char *, size_t); 152c66ac9dbSNicholas Bellinger extern ssize_t core_alua_show_secondary_write_metadata(struct se_lun *, 153c66ac9dbSNicholas Bellinger char *); 154c66ac9dbSNicholas Bellinger extern ssize_t core_alua_store_secondary_write_metadata(struct se_lun *, 155c66ac9dbSNicholas Bellinger const char *, size_t); 1560fd97ccfSChristoph Hellwig extern int core_setup_alua(struct se_device *); 157de103c93SChristoph Hellwig extern sense_reason_t target_alua_state_check(struct se_cmd *cmd); 158c66ac9dbSNicholas Bellinger 159c66ac9dbSNicholas Bellinger #endif /* TARGET_CORE_ALUA_H */ 160