1 #ifndef TARGET_CORE_ALUA_H 2 #define TARGET_CORE_ALUA_H 3 4 /* 5 * INQUIRY response data, TPGS Field 6 * 7 * from spc4r17 section 6.4.2 Table 135 8 */ 9 #define TPGS_NO_ALUA 0x00 10 #define TPGS_IMPLICT_ALUA 0x10 11 #define TPGS_EXPLICT_ALUA 0x20 12 13 /* 14 * ASYMMETRIC ACCESS STATE field 15 * 16 * from spc4r17 section 6.27 Table 245 17 */ 18 #define ALUA_ACCESS_STATE_ACTIVE_OPTMIZED 0x0 19 #define ALUA_ACCESS_STATE_ACTIVE_NON_OPTIMIZED 0x1 20 #define ALUA_ACCESS_STATE_STANDBY 0x2 21 #define ALUA_ACCESS_STATE_UNAVAILABLE 0x3 22 #define ALUA_ACCESS_STATE_OFFLINE 0xe 23 #define ALUA_ACCESS_STATE_TRANSITION 0xf 24 25 /* 26 * REPORT_TARGET_PORT_GROUP STATUS CODE 27 * 28 * from spc4r17 section 6.27 Table 246 29 */ 30 #define ALUA_STATUS_NONE 0x00 31 #define ALUA_STATUS_ALTERED_BY_EXPLICT_STPG 0x01 32 #define ALUA_STATUS_ALTERED_BY_IMPLICT_ALUA 0x02 33 34 /* 35 * From spc4r17, Table D.1: ASC and ASCQ Assignement 36 */ 37 #define ASCQ_04H_ALUA_STATE_TRANSITION 0x0a 38 #define ASCQ_04H_ALUA_TG_PT_STANDBY 0x0b 39 #define ASCQ_04H_ALUA_TG_PT_UNAVAILABLE 0x0c 40 #define ASCQ_04H_ALUA_OFFLINE 0x12 41 42 /* 43 * Used as the default for Active/NonOptimized delay (in milliseconds) 44 * This can also be changed via configfs on a per target port group basis.. 45 */ 46 #define ALUA_DEFAULT_NONOP_DELAY_MSECS 100 47 #define ALUA_MAX_NONOP_DELAY_MSECS 10000 /* 10 seconds */ 48 /* 49 * Used for implict and explict ALUA transitional delay, that is disabled 50 * by default, and is intended to be used for debugging client side ALUA code. 51 */ 52 #define ALUA_DEFAULT_TRANS_DELAY_MSECS 0 53 #define ALUA_MAX_TRANS_DELAY_MSECS 30000 /* 30 seconds */ 54 /* 55 * Used for the recommended application client implict transition timeout 56 * in seconds, returned by the REPORT_TARGET_PORT_GROUPS w/ extended header. 57 */ 58 #define ALUA_DEFAULT_IMPLICT_TRANS_SECS 0 59 #define ALUA_MAX_IMPLICT_TRANS_SECS 255 60 /* 61 * Used by core_alua_update_tpg_primary_metadata() and 62 * core_alua_update_tpg_secondary_metadata() 63 */ 64 #define ALUA_METADATA_PATH_LEN 512 65 /* 66 * Used by core_alua_update_tpg_secondary_metadata() 67 */ 68 #define ALUA_SECONDARY_METADATA_WWN_LEN 256 69 70 extern struct kmem_cache *t10_alua_lu_gp_cache; 71 extern struct kmem_cache *t10_alua_lu_gp_mem_cache; 72 extern struct kmem_cache *t10_alua_tg_pt_gp_cache; 73 extern struct kmem_cache *t10_alua_tg_pt_gp_mem_cache; 74 75 extern sense_reason_t target_emulate_report_target_port_groups(struct se_cmd *); 76 extern sense_reason_t target_emulate_set_target_port_groups(struct se_cmd *); 77 extern int core_alua_check_nonop_delay(struct se_cmd *); 78 extern int core_alua_do_port_transition(struct t10_alua_tg_pt_gp *, 79 struct se_device *, struct se_port *, 80 struct se_node_acl *, int, int); 81 extern char *core_alua_dump_status(int); 82 extern struct t10_alua_lu_gp *core_alua_allocate_lu_gp(const char *, int); 83 extern int core_alua_set_lu_gp_id(struct t10_alua_lu_gp *, u16); 84 extern void core_alua_free_lu_gp(struct t10_alua_lu_gp *); 85 extern void core_alua_free_lu_gp_mem(struct se_device *); 86 extern struct t10_alua_lu_gp *core_alua_get_lu_gp_by_name(const char *); 87 extern void core_alua_put_lu_gp_from_name(struct t10_alua_lu_gp *); 88 extern void __core_alua_attach_lu_gp_mem(struct t10_alua_lu_gp_member *, 89 struct t10_alua_lu_gp *); 90 extern void __core_alua_drop_lu_gp_mem(struct t10_alua_lu_gp_member *, 91 struct t10_alua_lu_gp *); 92 extern void core_alua_drop_lu_gp_dev(struct se_device *); 93 extern struct t10_alua_tg_pt_gp *core_alua_allocate_tg_pt_gp( 94 struct se_device *, const char *, int); 95 extern int core_alua_set_tg_pt_gp_id(struct t10_alua_tg_pt_gp *, u16); 96 extern struct t10_alua_tg_pt_gp_member *core_alua_allocate_tg_pt_gp_mem( 97 struct se_port *); 98 extern void core_alua_free_tg_pt_gp(struct t10_alua_tg_pt_gp *); 99 extern void core_alua_free_tg_pt_gp_mem(struct se_port *); 100 extern void __core_alua_attach_tg_pt_gp_mem(struct t10_alua_tg_pt_gp_member *, 101 struct t10_alua_tg_pt_gp *); 102 extern ssize_t core_alua_show_tg_pt_gp_info(struct se_port *, char *); 103 extern ssize_t core_alua_store_tg_pt_gp_info(struct se_port *, const char *, 104 size_t); 105 extern ssize_t core_alua_show_access_type(struct t10_alua_tg_pt_gp *, char *); 106 extern ssize_t core_alua_store_access_type(struct t10_alua_tg_pt_gp *, 107 const char *, size_t); 108 extern ssize_t core_alua_show_nonop_delay_msecs(struct t10_alua_tg_pt_gp *, 109 char *); 110 extern ssize_t core_alua_store_nonop_delay_msecs(struct t10_alua_tg_pt_gp *, 111 const char *, size_t); 112 extern ssize_t core_alua_show_trans_delay_msecs(struct t10_alua_tg_pt_gp *, 113 char *); 114 extern ssize_t core_alua_store_trans_delay_msecs(struct t10_alua_tg_pt_gp *, 115 const char *, size_t); 116 extern ssize_t core_alua_show_implict_trans_secs(struct t10_alua_tg_pt_gp *, 117 char *); 118 extern ssize_t core_alua_store_implict_trans_secs(struct t10_alua_tg_pt_gp *, 119 const char *, size_t); 120 extern ssize_t core_alua_show_preferred_bit(struct t10_alua_tg_pt_gp *, 121 char *); 122 extern ssize_t core_alua_store_preferred_bit(struct t10_alua_tg_pt_gp *, 123 const char *, size_t); 124 extern ssize_t core_alua_show_offline_bit(struct se_lun *, char *); 125 extern ssize_t core_alua_store_offline_bit(struct se_lun *, const char *, 126 size_t); 127 extern ssize_t core_alua_show_secondary_status(struct se_lun *, char *); 128 extern ssize_t core_alua_store_secondary_status(struct se_lun *, 129 const char *, size_t); 130 extern ssize_t core_alua_show_secondary_write_metadata(struct se_lun *, 131 char *); 132 extern ssize_t core_alua_store_secondary_write_metadata(struct se_lun *, 133 const char *, size_t); 134 extern int core_setup_alua(struct se_device *); 135 extern sense_reason_t target_alua_state_check(struct se_cmd *cmd); 136 137 #endif /* TARGET_CORE_ALUA_H */ 138