152 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2#ifndef TARGET_CORE_ALUA_H3#define TARGET_CORE_ALUA_H4 5#include <target/target_core_base.h>6 7/*8 * INQUIRY response data, TPGS Field9 *10 * from spc4r17 section 6.4.2 Table 13511 */12#define TPGS_NO_ALUA 0x0013#define TPGS_IMPLICIT_ALUA 0x1014#define TPGS_EXPLICIT_ALUA 0x2015 16/*17 * ASYMMETRIC ACCESS STATE field18 *19 * from spc4r36j section 6.37 Table 30720 */21#define ALUA_ACCESS_STATE_ACTIVE_OPTIMIZED 0x022#define ALUA_ACCESS_STATE_ACTIVE_NON_OPTIMIZED 0x123#define ALUA_ACCESS_STATE_STANDBY 0x224#define ALUA_ACCESS_STATE_UNAVAILABLE 0x325#define ALUA_ACCESS_STATE_LBA_DEPENDENT 0x426#define ALUA_ACCESS_STATE_OFFLINE 0xe27#define ALUA_ACCESS_STATE_TRANSITION 0xf28 29/*30 * from spc4r36j section 6.37 Table 30631 */32#define ALUA_T_SUP 0x8033#define ALUA_O_SUP 0x4034#define ALUA_LBD_SUP 0x1035#define ALUA_U_SUP 0x0836#define ALUA_S_SUP 0x0437#define ALUA_AN_SUP 0x0238#define ALUA_AO_SUP 0x0139 40/*41 * REPORT_TARGET_PORT_GROUP STATUS CODE42 *43 * from spc4r17 section 6.27 Table 24644 */45#define ALUA_STATUS_NONE 0x0046#define ALUA_STATUS_ALTERED_BY_EXPLICIT_STPG 0x0147#define ALUA_STATUS_ALTERED_BY_IMPLICIT_ALUA 0x0248 49/*50 * From spc4r17, Table D.1: ASC and ASCQ Assignement51 */52#define ASCQ_04H_ALUA_STATE_TRANSITION 0x0a53#define ASCQ_04H_ALUA_TG_PT_STANDBY 0x0b54#define ASCQ_04H_ALUA_TG_PT_UNAVAILABLE 0x0c55#define ASCQ_04H_ALUA_OFFLINE 0x1256 57/*58 * Used as the default for Active/NonOptimized delay (in milliseconds)59 * This can also be changed via configfs on a per target port group basis..60 */61#define ALUA_DEFAULT_NONOP_DELAY_MSECS 10062#define ALUA_MAX_NONOP_DELAY_MSECS 10000 /* 10 seconds */63/*64 * Used for implicit and explicit ALUA transitional delay, that is disabled65 * by default, and is intended to be used for debugging client side ALUA code.66 */67#define ALUA_DEFAULT_TRANS_DELAY_MSECS 068#define ALUA_MAX_TRANS_DELAY_MSECS 30000 /* 30 seconds */69/*70 * Used for the recommended application client implicit transition timeout71 * in seconds, returned by the REPORT_TARGET_PORT_GROUPS w/ extended header.72 */73#define ALUA_DEFAULT_IMPLICIT_TRANS_SECS 074#define ALUA_MAX_IMPLICIT_TRANS_SECS 25575 76/* Used by core_alua_update_tpg_(primary,secondary)_metadata */77#define ALUA_MD_BUF_LEN 102478 79extern struct kmem_cache *t10_alua_lu_gp_cache;80extern struct kmem_cache *t10_alua_lu_gp_mem_cache;81extern struct kmem_cache *t10_alua_tg_pt_gp_cache;82extern struct kmem_cache *t10_alua_lba_map_cache;83extern struct kmem_cache *t10_alua_lba_map_mem_cache;84 85extern sense_reason_t target_emulate_report_target_port_groups(struct se_cmd *);86extern sense_reason_t target_emulate_set_target_port_groups(struct se_cmd *);87extern sense_reason_t target_emulate_report_referrals(struct se_cmd *);88extern int core_alua_check_nonop_delay(struct se_cmd *);89extern int core_alua_do_port_transition(struct t10_alua_tg_pt_gp *,90 struct se_device *, struct se_lun *,91 struct se_node_acl *, int, int);92extern char *core_alua_dump_status(int);93extern struct t10_alua_lba_map *core_alua_allocate_lba_map(94 struct list_head *, u64, u64);95extern int core_alua_allocate_lba_map_mem(struct t10_alua_lba_map *, int, int);96extern void core_alua_free_lba_map(struct list_head *);97extern void core_alua_set_lba_map(struct se_device *, struct list_head *,98 int, int);99extern struct t10_alua_lu_gp *core_alua_allocate_lu_gp(const char *, int);100extern int core_alua_set_lu_gp_id(struct t10_alua_lu_gp *, u16);101extern void core_alua_free_lu_gp(struct t10_alua_lu_gp *);102extern void core_alua_free_lu_gp_mem(struct se_device *);103extern struct t10_alua_lu_gp *core_alua_get_lu_gp_by_name(const char *);104extern void core_alua_put_lu_gp_from_name(struct t10_alua_lu_gp *);105extern void __core_alua_attach_lu_gp_mem(struct t10_alua_lu_gp_member *,106 struct t10_alua_lu_gp *);107extern void __core_alua_drop_lu_gp_mem(struct t10_alua_lu_gp_member *,108 struct t10_alua_lu_gp *);109extern void core_alua_drop_lu_gp_dev(struct se_device *);110extern struct t10_alua_tg_pt_gp *core_alua_allocate_tg_pt_gp(111 struct se_device *, const char *, int);112extern int core_alua_set_tg_pt_gp_id(struct t10_alua_tg_pt_gp *, u16);113extern void core_alua_free_tg_pt_gp(struct t10_alua_tg_pt_gp *);114extern void target_detach_tg_pt_gp(struct se_lun *);115extern void target_attach_tg_pt_gp(struct se_lun *, struct t10_alua_tg_pt_gp *);116extern ssize_t core_alua_show_tg_pt_gp_info(struct se_lun *, char *);117extern ssize_t core_alua_store_tg_pt_gp_info(struct se_lun *, const char *,118 size_t);119extern ssize_t core_alua_show_access_type(struct t10_alua_tg_pt_gp *, char *);120extern ssize_t core_alua_store_access_type(struct t10_alua_tg_pt_gp *,121 const char *, size_t);122extern ssize_t core_alua_show_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,123 char *);124extern ssize_t core_alua_store_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,125 const char *, size_t);126extern ssize_t core_alua_show_trans_delay_msecs(struct t10_alua_tg_pt_gp *,127 char *);128extern ssize_t core_alua_store_trans_delay_msecs(struct t10_alua_tg_pt_gp *,129 const char *, size_t);130extern ssize_t core_alua_show_implicit_trans_secs(struct t10_alua_tg_pt_gp *,131 char *);132extern ssize_t core_alua_store_implicit_trans_secs(struct t10_alua_tg_pt_gp *,133 const char *, size_t);134extern ssize_t core_alua_show_preferred_bit(struct t10_alua_tg_pt_gp *,135 char *);136extern ssize_t core_alua_store_preferred_bit(struct t10_alua_tg_pt_gp *,137 const char *, size_t);138extern ssize_t core_alua_show_offline_bit(struct se_lun *, char *);139extern ssize_t core_alua_store_offline_bit(struct se_lun *, const char *,140 size_t);141extern ssize_t core_alua_show_secondary_status(struct se_lun *, char *);142extern ssize_t core_alua_store_secondary_status(struct se_lun *,143 const char *, size_t);144extern ssize_t core_alua_show_secondary_write_metadata(struct se_lun *,145 char *);146extern ssize_t core_alua_store_secondary_write_metadata(struct se_lun *,147 const char *, size_t);148extern int core_setup_alua(struct se_device *);149extern sense_reason_t target_alua_state_check(struct se_cmd *cmd);150 151#endif /* TARGET_CORE_ALUA_H */152