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