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 core_emulate_report_target_port_groups(struct se_cmd *);
70 extern int core_emulate_set_target_port_groups(struct se_cmd *);
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 */
127