projects / linux-2.6-block.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
License cleanup: add SPDX GPL-2.0 license identifier to files with no license
[linux-2.6-block.git] / drivers / target / target_core_alua.h
CommitLineData
b2441318 1/* SPDX-License-Identifier: GPL-2.0 */
c66ac9db
NB		 2#ifndef TARGET_CORE_ALUA_H
3#define TARGET_CORE_ALUA_H
4
8dcf07be
BVA		 5#include <target/target_core_base.h>
6
c66ac9db
NB		 7/*
8 * INQUIRY response data, TPGS Field
9 *
10 * from spc4r17 section 6.4.2 Table 135
11 */
12#define TPGS_NO_ALUA 0x00
125d0119
HR		 13#define TPGS_IMPLICIT_ALUA 0x10
14#define TPGS_EXPLICIT_ALUA 0x20
c66ac9db
NB		 15
16/*
17 * ASYMMETRIC ACCESS STATE field
18 *
c66094bf 19 * from spc4r36j section 6.37 Table 307
c66ac9db 20 */
73f3bf51 21#define ALUA_ACCESS_STATE_ACTIVE_OPTIMIZED 0x0
c66ac9db
NB		 22#define ALUA_ACCESS_STATE_ACTIVE_NON_OPTIMIZED 0x1
23#define ALUA_ACCESS_STATE_STANDBY 0x2
24#define ALUA_ACCESS_STATE_UNAVAILABLE 0x3
c66094bf 25#define ALUA_ACCESS_STATE_LBA_DEPENDENT 0x4
c66ac9db
NB		 26#define ALUA_ACCESS_STATE_OFFLINE 0xe
27#define ALUA_ACCESS_STATE_TRANSITION 0xf
28
c0dc941e
HR		 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
c66ac9db
NB		 40/*
41 * REPORT_TARGET_PORT_GROUP STATUS CODE
42 *
43 * from spc4r17 section 6.27 Table 246
44 */
45#define ALUA_STATUS_NONE 0x00
125d0119
HR		 46#define ALUA_STATUS_ALTERED_BY_EXPLICIT_STPG 0x01
47#define ALUA_STATUS_ALTERED_BY_IMPLICIT_ALUA 0x02
c66ac9db
NB		 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/*
125d0119 64 * Used for implicit and explicit ALUA transitional delay, that is disabled
c66ac9db
NB		 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 */
5b9a4d72 69/*
125d0119 70 * Used for the recommended application client implicit transition timeout
5b9a4d72
NB		 71 * in seconds, returned by the REPORT_TARGET_PORT_GROUPS w/ extended header.
72 */
125d0119
HR		 73#define ALUA_DEFAULT_IMPLICIT_TRANS_SECS 0
74#define ALUA_MAX_IMPLICIT_TRANS_SECS 255
c66ac9db
NB		 75/*
76 * Used by core_alua_update_tpg_primary_metadata() and
77 * core_alua_update_tpg_secondary_metadata()
78 */
79#define ALUA_METADATA_PATH_LEN 512
80/*
81 * Used by core_alua_update_tpg_secondary_metadata()
82 */
83#define ALUA_SECONDARY_METADATA_WWN_LEN 256
84
1e0b9403
HR		 85/* Used by core_alua_update_tpg_(primary,secondary)_metadata */
86#define ALUA_MD_BUF_LEN 1024
87
c66ac9db
NB		 88extern struct kmem_cache *t10_alua_lu_gp_cache;
89extern struct kmem_cache *t10_alua_lu_gp_mem_cache;
90extern struct kmem_cache *t10_alua_tg_pt_gp_cache;
229d4f11
HR		 91extern struct kmem_cache *t10_alua_lba_map_cache;
92extern struct kmem_cache *t10_alua_lba_map_mem_cache;
c66ac9db 93
de103c93
CH		 94extern sense_reason_t target_emulate_report_target_port_groups(struct se_cmd *);
95extern sense_reason_t target_emulate_set_target_port_groups(struct se_cmd *);
c66094bf 96extern sense_reason_t target_emulate_report_referrals(struct se_cmd *);
c66ac9db
NB		 97extern int core_alua_check_nonop_delay(struct se_cmd *);
98extern int core_alua_do_port_transition(struct t10_alua_tg_pt_gp *,
adf653f9 99 struct se_device *, struct se_lun *,
c66ac9db
NB		 100 struct se_node_acl *, int, int);
101extern char *core_alua_dump_status(int);
229d4f11
HR		 102extern struct t10_alua_lba_map *core_alua_allocate_lba_map(
103 struct list_head *, u64, u64);
104extern int core_alua_allocate_lba_map_mem(struct t10_alua_lba_map *, int, int);
105extern void core_alua_free_lba_map(struct list_head *);
106extern void core_alua_set_lba_map(struct se_device *, struct list_head *,
107 int, int);
c66ac9db
NB		 108extern struct t10_alua_lu_gp *core_alua_allocate_lu_gp(const char *, int);
109extern int core_alua_set_lu_gp_id(struct t10_alua_lu_gp *, u16);
110extern void core_alua_free_lu_gp(struct t10_alua_lu_gp *);
111extern void core_alua_free_lu_gp_mem(struct se_device *);
112extern struct t10_alua_lu_gp *core_alua_get_lu_gp_by_name(const char *);
113extern void core_alua_put_lu_gp_from_name(struct t10_alua_lu_gp *);
114extern void __core_alua_attach_lu_gp_mem(struct t10_alua_lu_gp_member *,
115 struct t10_alua_lu_gp *);
116extern void __core_alua_drop_lu_gp_mem(struct t10_alua_lu_gp_member *,
117 struct t10_alua_lu_gp *);
118extern void core_alua_drop_lu_gp_dev(struct se_device *);
119extern struct t10_alua_tg_pt_gp *core_alua_allocate_tg_pt_gp(
0fd97ccf 120 struct se_device *, const char *, int);
c66ac9db 121extern int core_alua_set_tg_pt_gp_id(struct t10_alua_tg_pt_gp *, u16);
c66ac9db 122extern void core_alua_free_tg_pt_gp(struct t10_alua_tg_pt_gp *);
adf653f9
CH		 123extern void target_detach_tg_pt_gp(struct se_lun *);
124extern void target_attach_tg_pt_gp(struct se_lun *, struct t10_alua_tg_pt_gp *);
125extern ssize_t core_alua_show_tg_pt_gp_info(struct se_lun *, char *);
126extern ssize_t core_alua_store_tg_pt_gp_info(struct se_lun *, const char *,
c66ac9db
NB		 127 size_t);
128extern ssize_t core_alua_show_access_type(struct t10_alua_tg_pt_gp *, char *);
129extern ssize_t core_alua_store_access_type(struct t10_alua_tg_pt_gp *,
130 const char *, size_t);
131extern ssize_t core_alua_show_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
132 char *);
133extern ssize_t core_alua_store_nonop_delay_msecs(struct t10_alua_tg_pt_gp *,
134 const char *, size_t);
135extern ssize_t core_alua_show_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
136 char *);
137extern ssize_t core_alua_store_trans_delay_msecs(struct t10_alua_tg_pt_gp *,
138 const char *, size_t);
125d0119 139extern ssize_t core_alua_show_implicit_trans_secs(struct t10_alua_tg_pt_gp *,
5b9a4d72 140 char *);
125d0119 141extern ssize_t core_alua_store_implicit_trans_secs(struct t10_alua_tg_pt_gp *,
5b9a4d72 142 const char *, size_t);
c66ac9db
NB		 143extern ssize_t core_alua_show_preferred_bit(struct t10_alua_tg_pt_gp *,
144 char *);
145extern ssize_t core_alua_store_preferred_bit(struct t10_alua_tg_pt_gp *,
146 const char *, size_t);
147extern ssize_t core_alua_show_offline_bit(struct se_lun *, char *);
148extern ssize_t core_alua_store_offline_bit(struct se_lun *, const char *,
149 size_t);
150extern ssize_t core_alua_show_secondary_status(struct se_lun *, char *);
151extern ssize_t core_alua_store_secondary_status(struct se_lun *,
152 const char *, size_t);
153extern ssize_t core_alua_show_secondary_write_metadata(struct se_lun *,
154 char *);
155extern ssize_t core_alua_store_secondary_write_metadata(struct se_lun *,
156 const char *, size_t);
0fd97ccf 157extern int core_setup_alua(struct se_device *);
de103c93 158extern sense_reason_t target_alua_state_check(struct se_cmd *cmd);
c66ac9db
NB		 159
160#endif /* TARGET_CORE_ALUA_H */
Linux 6.x block layer and io_uring tree(s)