LXR linux/drivers/target/target_core

   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_IMPLICIT_ALUA                      0x10
  11#define TPGS_EXPLICIT_ALUA                      0x20
  12
  13/*
  14 * ASYMMETRIC ACCESS STATE field
  15 *
  16 * from spc4r36j section 6.37 Table 307
  17 */
  18#define ALUA_ACCESS_STATE_ACTIVE_OPTIMIZED      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_LBA_DEPENDENT         0x4
  23#define ALUA_ACCESS_STATE_OFFLINE               0xe
  24#define ALUA_ACCESS_STATE_TRANSITION            0xf
  25
  26/*
  27 * from spc4r36j section 6.37 Table 306
  28 */
  29#define ALUA_T_SUP              0x80
  30#define ALUA_O_SUP              0x40
  31#define ALUA_LBD_SUP            0x10
  32#define ALUA_U_SUP              0x08
  33#define ALUA_S_SUP              0x04
  34#define ALUA_AN_SUP             0x02
  35#define ALUA_AO_SUP             0x01
  36
  37/*
  38 * REPORT_TARGET_PORT_GROUP STATUS CODE
  39 *
  40 * from spc4r17 section 6.27 Table 246
  41 */
  42#define ALUA_STATUS_NONE                                0x00
  43#define ALUA_STATUS_ALTERED_BY_EXPLICIT_STPG            0x01
  44#define ALUA_STATUS_ALTERED_BY_IMPLICIT_ALUA            0x02
  45
  46/*
  47 * From spc4r17, Table D.1: ASC and ASCQ Assignement
  48 */
  49#define ASCQ_04H_ALUA_STATE_TRANSITION                  0x0a
  50#define ASCQ_04H_ALUA_TG_PT_STANDBY                     0x0b
  51#define ASCQ_04H_ALUA_TG_PT_UNAVAILABLE                 0x0c
  52#define ASCQ_04H_ALUA_OFFLINE                           0x12
  53
  54/*
  55 * Used as the default for Active/NonOptimized delay (in milliseconds)
  56 * This can also be changed via configfs on a per target port group basis..
  57 */
  58#define ALUA_DEFAULT_NONOP_DELAY_MSECS                  100
  59#define ALUA_MAX_NONOP_DELAY_MSECS                      10000 /* 10 seconds */
  60/*
  61 * Used for implicit and explicit ALUA transitional delay, that is disabled
  62 * by default, and is intended to be used for debugging client side ALUA code.
  63 */
  64#define ALUA_DEFAULT_TRANS_DELAY_MSECS                  0
  65#define ALUA_MAX_TRANS_DELAY_MSECS                      30000 /* 30 seconds */
  66/*
  67 * Used for the recommended application client implicit transition timeout
  68 * in seconds, returned by the REPORT_TARGET_PORT_GROUPS w/ extended header.
  69 */
  70#define ALUA_DEFAULT_IMPLICIT_TRANS_SECS                        0
  71#define ALUA_MAX_IMPLICIT_TRANS_SECS                    255
  72/*
  73 * Used by core_alua_update_tpg_primary_metadata() and
  74 * core_alua_update_tpg_secondary_metadata()
  75 */
  76#define ALUA_METADATA_PATH_LEN                          512
  77/*
  78 * Used by core_alua_update_tpg_secondary_metadata()
  79 */
  80#define ALUA_SECONDARY_METADATA_WWN_LEN                 256
  81
  82/* Used by core_alua_update_tpg_(primary,secondary)_metadata */
  83#define ALUA_MD_BUF_LEN                                 1024
  84
  85extern struct kmem_cache *t10_alua_lu_gp_cache;
  86extern struct kmem_cache *t10_alua_lu_gp_mem_cache;
  87extern struct kmem_cache *t10_alua_tg_pt_gp_cache;
  88extern struct kmem_cache *t10_alua_lba_map_cache;
  89extern struct kmem_cache *t10_alua_lba_map_mem_cache;
  90
  91extern sense_reason_t target_emulate_report_target_port_groups(struct se_cmd *);
  92extern sense_reason_t target_emulate_set_target_port_groups(struct se_cmd *);
  93extern sense_reason_t target_emulate_report_referrals(struct se_cmd *);
  94extern int core_alua_check_nonop_delay(struct se_cmd *);
  95extern int core_alua_do_port_transition(struct t10_alua_tg_pt_gp *,
  96                                struct se_device *, struct se_lun *,
  97                                struct se_node_acl *, int, int);
  98extern char *core_alua_dump_status(int);
  99extern struct t10_alua_lba_map *core_alua_allocate_lba_map(
 100                                struct list_head *, u64, u64);
 101extern int core_alua_allocate_lba_map_mem(struct t10_alua_lba_map *, int, int);
 102extern void core_alua_free_lba_map(struct list_head *);
 103extern void core_alua_set_lba_map(struct se_device *, struct list_head *,
 104                                int, int);
 105extern struct t10_alua_lu_gp *core_alua_allocate_lu_gp(const char *, int);
 106extern int core_alua_set_lu_gp_id(struct t10_alua_lu_gp *, u16);
 107extern void core_alua_free_lu_gp(struct t10_alua_lu_gp *);
 108extern void core_alua_free_lu_gp_mem(struct se_device *);
 109extern struct t10_alua_lu_gp *core_alua_get_lu_gp_by_name(const char *);
 110extern void core_alua_put_lu_gp_from_name(struct t10_alua_lu_gp *);
 111extern void __core_alua_attach_lu_gp_mem(struct t10_alua_lu_gp_member *,
 112                                        struct t10_alua_lu_gp *);
 113extern void __core_alua_drop_lu_gp_mem(struct t10_alua_lu_gp_member *,
 114                                        struct t10_alua_lu_gp *);
 115extern void core_alua_drop_lu_gp_dev(struct se_device *);
 116extern struct t10_alua_tg_pt_gp *core_alua_allocate_tg_pt_gp(
 117                        struct se_device *, const char *, int);
 118extern int core_alua_set_tg_pt_gp_id(struct t10_alua_tg_pt_gp *, u16);
 119extern void core_alua_free_tg_pt_gp(struct t10_alua_tg_pt_gp *);
 120extern void target_detach_tg_pt_gp(struct se_lun *);
 121extern void target_attach_tg_pt_gp(struct se_lun *, struct t10_alua_tg_pt_gp *);
 122extern ssize_t core_alua_show_tg_pt_gp_info(struct se_lun *, char *);
 123extern ssize_t core_alua_store_tg_pt_gp_info(struct se_lun *, const char *,
 124                                                size_t);
 125extern ssize_t core_alua_show_access_type(struct t10_alua_tg_pt_gp *, char *);
 126extern ssize_t core_alua_store_access_type(struct t10_alua_tg_pt_gp *,
 127                                        const char *, size_t);
 128extern ssize_t core_alua_show_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
 129                                                char *);
 130extern ssize_t core_alua_store_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
 131                                        const char *, size_t);
 132extern ssize_t core_alua_show_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
 133                                        char *);
 134extern ssize_t core_alua_store_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
 135                                        const char *, size_t);
 136extern ssize_t core_alua_show_implicit_trans_secs(struct t10_alua_tg_pt_gp *,
 137                                        char *);
 138extern ssize_t core_alua_store_implicit_trans_secs(struct t10_alua_tg_pt_gp *,
 139                                        const char *, size_t);
 140extern ssize_t core_alua_show_preferred_bit(struct t10_alua_tg_pt_gp *,
 141                                        char *);
 142extern ssize_t core_alua_store_preferred_bit(struct t10_alua_tg_pt_gp *,
 143                                        const char *, size_t);
 144extern ssize_t core_alua_show_offline_bit(struct se_lun *, char *);
 145extern ssize_t core_alua_store_offline_bit(struct se_lun *, const char *,
 146                                        size_t);
 147extern ssize_t core_alua_show_secondary_status(struct se_lun *, char *);
 148extern ssize_t core_alua_store_secondary_status(struct se_lun *,
 149                                        const char *, size_t);
 150extern ssize_t core_alua_show_secondary_write_metadata(struct se_lun *,
 151                                        char *);
 152extern ssize_t core_alua_store_secondary_write_metadata(struct se_lun *,
 153                                        const char *, size_t);
 154extern int core_setup_alua(struct se_device *);
 155extern sense_reason_t target_alua_state_check(struct se_cmd *cmd);
 156
 157#endif /* TARGET_CORE_ALUA_H */
 158