drivers/target/target_core_alua.h

   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 by core_alua_update_tpg_primary_metadata() and
  56  * core_alua_update_tpg_secondary_metadata()
  57  */
  58 #define ALUA_METADATA_PATH_LEN                          512
  59 /*
  60  * Used by core_alua_update_tpg_secondary_metadata()
  61  */
  62 #define ALUA_SECONDARY_METADATA_WWN_LEN                 256
  63
  64 extern struct kmem_cache *t10_alua_lu_gp_cache;
  65 extern struct kmem_cache *t10_alua_lu_gp_mem_cache;
  66 extern struct kmem_cache *t10_alua_tg_pt_gp_cache;
  67 extern struct kmem_cache *t10_alua_tg_pt_gp_mem_cache;
  68
  69 extern int target_emulate_report_target_port_groups(struct se_task *);
  70 extern int target_emulate_set_target_port_groups(struct se_task *);
  71 extern int core_alua_check_nonop_delay(struct se_cmd *);
  72 extern int core_alua_do_port_transition(struct t10_alua_tg_pt_gp *,
  73                                 struct se_device *, struct se_port *,
  74                                 struct se_node_acl *, int, int);
  75 extern char *core_alua_dump_status(int);
  76 extern struct t10_alua_lu_gp *core_alua_allocate_lu_gp(const char *, int);
  77 extern int core_alua_set_lu_gp_id(struct t10_alua_lu_gp *, u16);
  78 extern void core_alua_free_lu_gp(struct t10_alua_lu_gp *);
  79 extern void core_alua_free_lu_gp_mem(struct se_device *);
  80 extern struct t10_alua_lu_gp *core_alua_get_lu_gp_by_name(const char *);
  81 extern void core_alua_put_lu_gp_from_name(struct t10_alua_lu_gp *);
  82 extern void __core_alua_attach_lu_gp_mem(struct t10_alua_lu_gp_member *,
  83                                         struct t10_alua_lu_gp *);
  84 extern void __core_alua_drop_lu_gp_mem(struct t10_alua_lu_gp_member *,
  85                                         struct t10_alua_lu_gp *);
  86 extern void core_alua_drop_lu_gp_dev(struct se_device *);
  87 extern struct t10_alua_tg_pt_gp *core_alua_allocate_tg_pt_gp(
  88                         struct se_subsystem_dev *, const char *, int);
  89 extern int core_alua_set_tg_pt_gp_id(struct t10_alua_tg_pt_gp *, u16);
  90 extern struct t10_alua_tg_pt_gp_member *core_alua_allocate_tg_pt_gp_mem(
  91                                         struct se_port *);
  92 extern void core_alua_free_tg_pt_gp(struct t10_alua_tg_pt_gp *);
  93 extern void core_alua_free_tg_pt_gp_mem(struct se_port *);
  94 extern void __core_alua_attach_tg_pt_gp_mem(struct t10_alua_tg_pt_gp_member *,
  95                                         struct t10_alua_tg_pt_gp *);
  96 extern ssize_t core_alua_show_tg_pt_gp_info(struct se_port *, char *);
  97 extern ssize_t core_alua_store_tg_pt_gp_info(struct se_port *, const char *,
  98                                                 size_t);
  99 extern ssize_t core_alua_show_access_type(struct t10_alua_tg_pt_gp *, char *);
 100 extern ssize_t core_alua_store_access_type(struct t10_alua_tg_pt_gp *,
 101                                         const char *, size_t);
 102 extern ssize_t core_alua_show_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
 103                                                 char *);
 104 extern ssize_t core_alua_store_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
 105                                         const char *, size_t);
 106 extern ssize_t core_alua_show_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
 107                                         char *);
 108 extern ssize_t core_alua_store_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
 109                                         const char *, size_t);
 110 extern ssize_t core_alua_show_preferred_bit(struct t10_alua_tg_pt_gp *,
 111                                         char *);
 112 extern ssize_t core_alua_store_preferred_bit(struct t10_alua_tg_pt_gp *,
 113                                         const char *, size_t);
 114 extern ssize_t core_alua_show_offline_bit(struct se_lun *, char *);
 115 extern ssize_t core_alua_store_offline_bit(struct se_lun *, const char *,
 116                                         size_t);
 117 extern ssize_t core_alua_show_secondary_status(struct se_lun *, char *);
 118 extern ssize_t core_alua_store_secondary_status(struct se_lun *,
 119                                         const char *, size_t);
 120 extern ssize_t core_alua_show_secondary_write_metadata(struct se_lun *,
 121                                         char *);
 122 extern ssize_t core_alua_store_secondary_write_metadata(struct se_lun *,
 123                                         const char *, size_t);
 124 extern int core_setup_alua(struct se_device *, int);
 125
 126 #endif /* TARGET_CORE_ALUA_H */