5b9a4d7280
This patch adds support for ALUA MI_REPORT_TARGET_PGS extended header format defined within SPC-4. It changes target core ALUA emulation logic within target_emulate_report_target_port_groups() to support both the extended and original length only header formats. It includes adding a new 'implict_trans_secs' attribute for each ALUA target port group to control the value returned to the application client for an recommended implict translation timeout in seconds. By default this value is currently set to zero, and limited up to 255 by virtue of using a single byte in the extended header format. This value is used by target_emulate_report_target_port_groups() within the extended header logic to set IMPLICIT TRANSITION TIME as defined by spc4r30. Cc: Hannes Reinecke <hare@suse.de> Cc: Rob Evers <revers@redhat.com> Cc: Christoph Hellwig <hch@lst.de> Cc: Roland Dreier <roland@purestorage.com> Signed-off-by: Nicholas Bellinger <nab@linux-iscsi.org>
136 lines
5.4 KiB
C
136 lines
5.4 KiB
C
#ifndef TARGET_CORE_ALUA_H
|
|
#define TARGET_CORE_ALUA_H
|
|
|
|
/*
|
|
* INQUIRY response data, TPGS Field
|
|
*
|
|
* from spc4r17 section 6.4.2 Table 135
|
|
*/
|
|
#define TPGS_NO_ALUA 0x00
|
|
#define TPGS_IMPLICT_ALUA 0x10
|
|
#define TPGS_EXPLICT_ALUA 0x20
|
|
|
|
/*
|
|
* ASYMMETRIC ACCESS STATE field
|
|
*
|
|
* from spc4r17 section 6.27 Table 245
|
|
*/
|
|
#define ALUA_ACCESS_STATE_ACTIVE_OPTMIZED 0x0
|
|
#define ALUA_ACCESS_STATE_ACTIVE_NON_OPTIMIZED 0x1
|
|
#define ALUA_ACCESS_STATE_STANDBY 0x2
|
|
#define ALUA_ACCESS_STATE_UNAVAILABLE 0x3
|
|
#define ALUA_ACCESS_STATE_OFFLINE 0xe
|
|
#define ALUA_ACCESS_STATE_TRANSITION 0xf
|
|
|
|
/*
|
|
* REPORT_TARGET_PORT_GROUP STATUS CODE
|
|
*
|
|
* from spc4r17 section 6.27 Table 246
|
|
*/
|
|
#define ALUA_STATUS_NONE 0x00
|
|
#define ALUA_STATUS_ALTERED_BY_EXPLICT_STPG 0x01
|
|
#define ALUA_STATUS_ALTERED_BY_IMPLICT_ALUA 0x02
|
|
|
|
/*
|
|
* From spc4r17, Table D.1: ASC and ASCQ Assignement
|
|
*/
|
|
#define ASCQ_04H_ALUA_STATE_TRANSITION 0x0a
|
|
#define ASCQ_04H_ALUA_TG_PT_STANDBY 0x0b
|
|
#define ASCQ_04H_ALUA_TG_PT_UNAVAILABLE 0x0c
|
|
#define ASCQ_04H_ALUA_OFFLINE 0x12
|
|
|
|
/*
|
|
* Used as the default for Active/NonOptimized delay (in milliseconds)
|
|
* This can also be changed via configfs on a per target port group basis..
|
|
*/
|
|
#define ALUA_DEFAULT_NONOP_DELAY_MSECS 100
|
|
#define ALUA_MAX_NONOP_DELAY_MSECS 10000 /* 10 seconds */
|
|
/*
|
|
* Used for implict and explict ALUA transitional delay, that is disabled
|
|
* by default, and is intended to be used for debugging client side ALUA code.
|
|
*/
|
|
#define ALUA_DEFAULT_TRANS_DELAY_MSECS 0
|
|
#define ALUA_MAX_TRANS_DELAY_MSECS 30000 /* 30 seconds */
|
|
/*
|
|
* Used for the recommended application client implict transition timeout
|
|
* in seconds, returned by the REPORT_TARGET_PORT_GROUPS w/ extended header.
|
|
*/
|
|
#define ALUA_DEFAULT_IMPLICT_TRANS_SECS 0
|
|
#define ALUA_MAX_IMPLICT_TRANS_SECS 255
|
|
/*
|
|
* Used by core_alua_update_tpg_primary_metadata() and
|
|
* core_alua_update_tpg_secondary_metadata()
|
|
*/
|
|
#define ALUA_METADATA_PATH_LEN 512
|
|
/*
|
|
* Used by core_alua_update_tpg_secondary_metadata()
|
|
*/
|
|
#define ALUA_SECONDARY_METADATA_WWN_LEN 256
|
|
|
|
extern struct kmem_cache *t10_alua_lu_gp_cache;
|
|
extern struct kmem_cache *t10_alua_lu_gp_mem_cache;
|
|
extern struct kmem_cache *t10_alua_tg_pt_gp_cache;
|
|
extern struct kmem_cache *t10_alua_tg_pt_gp_mem_cache;
|
|
|
|
extern int target_emulate_report_target_port_groups(struct se_cmd *);
|
|
extern int target_emulate_set_target_port_groups(struct se_cmd *);
|
|
extern int core_alua_check_nonop_delay(struct se_cmd *);
|
|
extern int core_alua_do_port_transition(struct t10_alua_tg_pt_gp *,
|
|
struct se_device *, struct se_port *,
|
|
struct se_node_acl *, int, int);
|
|
extern char *core_alua_dump_status(int);
|
|
extern struct t10_alua_lu_gp *core_alua_allocate_lu_gp(const char *, int);
|
|
extern int core_alua_set_lu_gp_id(struct t10_alua_lu_gp *, u16);
|
|
extern void core_alua_free_lu_gp(struct t10_alua_lu_gp *);
|
|
extern void core_alua_free_lu_gp_mem(struct se_device *);
|
|
extern struct t10_alua_lu_gp *core_alua_get_lu_gp_by_name(const char *);
|
|
extern void core_alua_put_lu_gp_from_name(struct t10_alua_lu_gp *);
|
|
extern void __core_alua_attach_lu_gp_mem(struct t10_alua_lu_gp_member *,
|
|
struct t10_alua_lu_gp *);
|
|
extern void __core_alua_drop_lu_gp_mem(struct t10_alua_lu_gp_member *,
|
|
struct t10_alua_lu_gp *);
|
|
extern void core_alua_drop_lu_gp_dev(struct se_device *);
|
|
extern struct t10_alua_tg_pt_gp *core_alua_allocate_tg_pt_gp(
|
|
struct se_subsystem_dev *, const char *, int);
|
|
extern int core_alua_set_tg_pt_gp_id(struct t10_alua_tg_pt_gp *, u16);
|
|
extern struct t10_alua_tg_pt_gp_member *core_alua_allocate_tg_pt_gp_mem(
|
|
struct se_port *);
|
|
extern void core_alua_free_tg_pt_gp(struct t10_alua_tg_pt_gp *);
|
|
extern void core_alua_free_tg_pt_gp_mem(struct se_port *);
|
|
extern void __core_alua_attach_tg_pt_gp_mem(struct t10_alua_tg_pt_gp_member *,
|
|
struct t10_alua_tg_pt_gp *);
|
|
extern ssize_t core_alua_show_tg_pt_gp_info(struct se_port *, char *);
|
|
extern ssize_t core_alua_store_tg_pt_gp_info(struct se_port *, const char *,
|
|
size_t);
|
|
extern ssize_t core_alua_show_access_type(struct t10_alua_tg_pt_gp *, char *);
|
|
extern ssize_t core_alua_store_access_type(struct t10_alua_tg_pt_gp *,
|
|
const char *, size_t);
|
|
extern ssize_t core_alua_show_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
|
|
char *);
|
|
extern ssize_t core_alua_store_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
|
|
const char *, size_t);
|
|
extern ssize_t core_alua_show_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
|
|
char *);
|
|
extern ssize_t core_alua_store_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
|
|
const char *, size_t);
|
|
extern ssize_t core_alua_show_implict_trans_secs(struct t10_alua_tg_pt_gp *,
|
|
char *);
|
|
extern ssize_t core_alua_store_implict_trans_secs(struct t10_alua_tg_pt_gp *,
|
|
const char *, size_t);
|
|
extern ssize_t core_alua_show_preferred_bit(struct t10_alua_tg_pt_gp *,
|
|
char *);
|
|
extern ssize_t core_alua_store_preferred_bit(struct t10_alua_tg_pt_gp *,
|
|
const char *, size_t);
|
|
extern ssize_t core_alua_show_offline_bit(struct se_lun *, char *);
|
|
extern ssize_t core_alua_store_offline_bit(struct se_lun *, const char *,
|
|
size_t);
|
|
extern ssize_t core_alua_show_secondary_status(struct se_lun *, char *);
|
|
extern ssize_t core_alua_store_secondary_status(struct se_lun *,
|
|
const char *, size_t);
|
|
extern ssize_t core_alua_show_secondary_write_metadata(struct se_lun *,
|
|
char *);
|
|
extern ssize_t core_alua_store_secondary_write_metadata(struct se_lun *,
|
|
const char *, size_t);
|
|
extern int core_setup_alua(struct se_device *, int);
|
|
|
|
#endif /* TARGET_CORE_ALUA_H */
|