target_core_alua.h 6.2 KB

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