1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef ISCSI_PARAMETERS_H
3#define ISCSI_PARAMETERS_H
4
5#include <linux/types.h>
6#include <scsi/iscsi_proto.h>
7
8struct iscsi_extra_response {
9 char key[KEY_MAXLEN];
10 char value[32];
11 struct list_head er_list;
12} ____cacheline_aligned;
13
14struct iscsi_param {
15 char *name;
16 char *value;
17 u8 set_param;
18 u8 phase;
19 u8 scope;
20 u8 sender;
21 u8 type;
22 u8 use;
23 u16 type_range;
24 u32 state;
25 struct list_head p_list;
26} ____cacheline_aligned;
27
28struct iscsit_conn;
29struct iscsi_conn_ops;
30struct iscsi_param_list;
31struct iscsi_sess_ops;
32
33extern int iscsi_login_rx_data(struct iscsit_conn *, char *, int);
34extern int iscsi_login_tx_data(struct iscsit_conn *, char *, char *, int);
35extern void iscsi_dump_conn_ops(struct iscsi_conn_ops *);
36extern void iscsi_dump_sess_ops(struct iscsi_sess_ops *);
37extern void iscsi_print_params(struct iscsi_param_list *);
38extern int iscsi_create_default_params(struct iscsi_param_list **);
39extern int iscsi_set_keys_to_negotiate(struct iscsi_param_list *, bool);
40extern int iscsi_set_keys_irrelevant_for_discovery(struct iscsi_param_list *);
41extern int iscsi_copy_param_list(struct iscsi_param_list **,
42 struct iscsi_param_list *, int);
43extern int iscsi_change_param_value(char *, struct iscsi_param_list *, int);
44extern void iscsi_release_param_list(struct iscsi_param_list *);
45extern struct iscsi_param *iscsi_find_param_from_key(char *, struct iscsi_param_list *);
46extern int iscsi_extract_key_value(char *, char **, char **);
47extern int iscsi_update_param_value(struct iscsi_param *, char *);
48extern int iscsi_decode_text_input(u8, u8, char *, u32, struct iscsit_conn *);
49extern int iscsi_encode_text_output(u8, u8, char *, u32 *,
50 struct iscsi_param_list *, bool);
51extern int iscsi_check_negotiated_keys(struct iscsi_param_list *);
52extern void iscsi_set_connection_parameters(struct iscsi_conn_ops *,
53 struct iscsi_param_list *);
54extern void iscsi_set_session_parameters(struct iscsi_sess_ops *,
55 struct iscsi_param_list *, int);
56
57#define YES "Yes"
58#define NO "No"
59#define ALL "All"
60#define IRRELEVANT "Irrelevant"
61#define NONE "None"
62#define NOTUNDERSTOOD "NotUnderstood"
63#define REJECT "Reject"
64
65/*
66 * The Parameter Names.
67 */
68#define AUTHMETHOD "AuthMethod"
69#define HEADERDIGEST "HeaderDigest"
70#define DATADIGEST "DataDigest"
71#define MAXCONNECTIONS "MaxConnections"
72#define SENDTARGETS "SendTargets"
73#define TARGETNAME "TargetName"
74#define INITIATORNAME "InitiatorName"
75#define TARGETALIAS "TargetAlias"
76#define INITIATORALIAS "InitiatorAlias"
77#define TARGETADDRESS "TargetAddress"
78#define TARGETPORTALGROUPTAG "TargetPortalGroupTag"
79#define INITIALR2T "InitialR2T"
80#define IMMEDIATEDATA "ImmediateData"
81#define MAXRECVDATASEGMENTLENGTH "MaxRecvDataSegmentLength"
82#define MAXXMITDATASEGMENTLENGTH "MaxXmitDataSegmentLength"
83#define MAXBURSTLENGTH "MaxBurstLength"
84#define FIRSTBURSTLENGTH "FirstBurstLength"
85#define DEFAULTTIME2WAIT "DefaultTime2Wait"
86#define DEFAULTTIME2RETAIN "DefaultTime2Retain"
87#define MAXOUTSTANDINGR2T "MaxOutstandingR2T"
88#define DATAPDUINORDER "DataPDUInOrder"
89#define DATASEQUENCEINORDER "DataSequenceInOrder"
90#define ERRORRECOVERYLEVEL "ErrorRecoveryLevel"
91#define SESSIONTYPE "SessionType"
92#define IFMARKER "IFMarker"
93#define OFMARKER "OFMarker"
94#define IFMARKINT "IFMarkInt"
95#define OFMARKINT "OFMarkInt"
96
97/*
98 * Parameter names of iSCSI Extentions for RDMA (iSER). See RFC-5046
99 */
100#define RDMAEXTENSIONS "RDMAExtensions"
101#define INITIATORRECVDATASEGMENTLENGTH "InitiatorRecvDataSegmentLength"
102#define TARGETRECVDATASEGMENTLENGTH "TargetRecvDataSegmentLength"
103
104/*
105 * For AuthMethod.
106 */
107#define KRB5 "KRB5"
108#define SPKM1 "SPKM1"
109#define SPKM2 "SPKM2"
110#define SRP "SRP"
111#define CHAP "CHAP"
112
113/*
114 * Initial values for Parameter Negotiation.
115 */
116#define INITIAL_AUTHMETHOD CHAP
117#define INITIAL_HEADERDIGEST "CRC32C,None"
118#define INITIAL_DATADIGEST "CRC32C,None"
119#define INITIAL_MAXCONNECTIONS "1"
120#define INITIAL_SENDTARGETS ALL
121#define INITIAL_TARGETNAME "LIO.Target"
122#define INITIAL_INITIATORNAME "LIO.Initiator"
123#define INITIAL_TARGETALIAS "LIO Target"
124#define INITIAL_INITIATORALIAS "LIO Initiator"
125#define INITIAL_TARGETADDRESS "0.0.0.0:0000,0"
126#define INITIAL_TARGETPORTALGROUPTAG "1"
127#define INITIAL_INITIALR2T YES
128#define INITIAL_IMMEDIATEDATA YES
129#define INITIAL_MAXRECVDATASEGMENTLENGTH "8192"
130/*
131 * Match outgoing MXDSL default to incoming Open-iSCSI default
132 */
133#define INITIAL_MAXXMITDATASEGMENTLENGTH "262144"
134#define INITIAL_MAXBURSTLENGTH "262144"
135#define INITIAL_FIRSTBURSTLENGTH "65536"
136#define INITIAL_DEFAULTTIME2WAIT "2"
137#define INITIAL_DEFAULTTIME2RETAIN "20"
138#define INITIAL_MAXOUTSTANDINGR2T "1"
139#define INITIAL_DATAPDUINORDER YES
140#define INITIAL_DATASEQUENCEINORDER YES
141#define INITIAL_ERRORRECOVERYLEVEL "0"
142#define INITIAL_SESSIONTYPE NORMAL
143#define INITIAL_IFMARKER NO
144#define INITIAL_OFMARKER NO
145#define INITIAL_IFMARKINT REJECT
146#define INITIAL_OFMARKINT REJECT
147
148/*
149 * Initial values for iSER parameters following RFC-5046 Section 6
150 */
151#define INITIAL_RDMAEXTENSIONS NO
152#define INITIAL_INITIATORRECVDATASEGMENTLENGTH "262144"
153#define INITIAL_TARGETRECVDATASEGMENTLENGTH "8192"
154
155/*
156 * For [Header,Data]Digests.
157 */
158#define CRC32C "CRC32C"
159
160/*
161 * For SessionType.
162 */
163#define DISCOVERY "Discovery"
164#define NORMAL "Normal"
165
166/*
167 * struct iscsi_param->use
168 */
169#define USE_LEADING_ONLY 0x01
170#define USE_INITIAL_ONLY 0x02
171#define USE_ALL 0x04
172
173#define IS_USE_LEADING_ONLY(p) ((p)->use & USE_LEADING_ONLY)
174#define IS_USE_INITIAL_ONLY(p) ((p)->use & USE_INITIAL_ONLY)
175#define IS_USE_ALL(p) ((p)->use & USE_ALL)
176
177#define SET_USE_INITIAL_ONLY(p) ((p)->use |= USE_INITIAL_ONLY)
178
179/*
180 * struct iscsi_param->sender
181 */
182#define SENDER_INITIATOR 0x01
183#define SENDER_TARGET 0x02
184#define SENDER_BOTH 0x03
185/* Used in iscsi_check_key() */
186#define SENDER_RECEIVER 0x04
187
188#define IS_SENDER_INITIATOR(p) ((p)->sender & SENDER_INITIATOR)
189#define IS_SENDER_TARGET(p) ((p)->sender & SENDER_TARGET)
190#define IS_SENDER_BOTH(p) ((p)->sender & SENDER_BOTH)
191
192/*
193 * struct iscsi_param->scope
194 */
195#define SCOPE_CONNECTION_ONLY 0x01
196#define SCOPE_SESSION_WIDE 0x02
197
198#define IS_SCOPE_CONNECTION_ONLY(p) ((p)->scope & SCOPE_CONNECTION_ONLY)
199#define IS_SCOPE_SESSION_WIDE(p) ((p)->scope & SCOPE_SESSION_WIDE)
200
201/*
202 * struct iscsi_param->phase
203 */
204#define PHASE_SECURITY 0x01
205#define PHASE_OPERATIONAL 0x02
206#define PHASE_DECLARATIVE 0x04
207#define PHASE_FFP0 0x08
208
209#define IS_PHASE_SECURITY(p) ((p)->phase & PHASE_SECURITY)
210#define IS_PHASE_OPERATIONAL(p) ((p)->phase & PHASE_OPERATIONAL)
211#define IS_PHASE_DECLARATIVE(p) ((p)->phase & PHASE_DECLARATIVE)
212#define IS_PHASE_FFP0(p) ((p)->phase & PHASE_FFP0)
213
214/*
215 * struct iscsi_param->type
216 */
217#define TYPE_BOOL_AND 0x01
218#define TYPE_BOOL_OR 0x02
219#define TYPE_NUMBER 0x04
220#define TYPE_NUMBER_RANGE 0x08
221#define TYPE_STRING 0x10
222#define TYPE_VALUE_LIST 0x20
223
224#define IS_TYPE_BOOL_AND(p) ((p)->type & TYPE_BOOL_AND)
225#define IS_TYPE_BOOL_OR(p) ((p)->type & TYPE_BOOL_OR)
226#define IS_TYPE_NUMBER(p) ((p)->type & TYPE_NUMBER)
227#define IS_TYPE_NUMBER_RANGE(p) ((p)->type & TYPE_NUMBER_RANGE)
228#define IS_TYPE_STRING(p) ((p)->type & TYPE_STRING)
229#define IS_TYPE_VALUE_LIST(p) ((p)->type & TYPE_VALUE_LIST)
230
231/*
232 * struct iscsi_param->type_range
233 */
234#define TYPERANGE_BOOL_AND 0x0001
235#define TYPERANGE_BOOL_OR 0x0002
236#define TYPERANGE_0_TO_2 0x0004
237#define TYPERANGE_0_TO_3600 0x0008
238#define TYPERANGE_0_TO_32767 0x0010
239#define TYPERANGE_0_TO_65535 0x0020
240#define TYPERANGE_1_TO_65535 0x0040
241#define TYPERANGE_2_TO_3600 0x0080
242#define TYPERANGE_512_TO_16777215 0x0100
243#define TYPERANGE_AUTH 0x0200
244#define TYPERANGE_DIGEST 0x0400
245#define TYPERANGE_ISCSINAME 0x0800
246#define TYPERANGE_SESSIONTYPE 0x1000
247#define TYPERANGE_TARGETADDRESS 0x2000
248#define TYPERANGE_UTF8 0x4000
249
250#define IS_TYPERANGE_0_TO_2(p) ((p)->type_range & TYPERANGE_0_TO_2)
251#define IS_TYPERANGE_0_TO_3600(p) ((p)->type_range & TYPERANGE_0_TO_3600)
252#define IS_TYPERANGE_0_TO_32767(p) ((p)->type_range & TYPERANGE_0_TO_32767)
253#define IS_TYPERANGE_0_TO_65535(p) ((p)->type_range & TYPERANGE_0_TO_65535)
254#define IS_TYPERANGE_1_TO_65535(p) ((p)->type_range & TYPERANGE_1_TO_65535)
255#define IS_TYPERANGE_2_TO_3600(p) ((p)->type_range & TYPERANGE_2_TO_3600)
256#define IS_TYPERANGE_512_TO_16777215(p) ((p)->type_range & \
257 TYPERANGE_512_TO_16777215)
258#define IS_TYPERANGE_AUTH_PARAM(p) ((p)->type_range & TYPERANGE_AUTH)
259#define IS_TYPERANGE_DIGEST_PARAM(p) ((p)->type_range & TYPERANGE_DIGEST)
260#define IS_TYPERANGE_SESSIONTYPE(p) ((p)->type_range & \
261 TYPERANGE_SESSIONTYPE)
262
263/*
264 * struct iscsi_param->state
265 */
266#define PSTATE_ACCEPTOR 0x01
267#define PSTATE_NEGOTIATE 0x02
268#define PSTATE_PROPOSER 0x04
269#define PSTATE_IRRELEVANT 0x08
270#define PSTATE_REJECT 0x10
271#define PSTATE_REPLY_OPTIONAL 0x20
272#define PSTATE_RESPONSE_GOT 0x40
273#define PSTATE_RESPONSE_SENT 0x80
274
275#define IS_PSTATE_ACCEPTOR(p) ((p)->state & PSTATE_ACCEPTOR)
276#define IS_PSTATE_NEGOTIATE(p) ((p)->state & PSTATE_NEGOTIATE)
277#define IS_PSTATE_PROPOSER(p) ((p)->state & PSTATE_PROPOSER)
278#define IS_PSTATE_IRRELEVANT(p) ((p)->state & PSTATE_IRRELEVANT)
279#define IS_PSTATE_REJECT(p) ((p)->state & PSTATE_REJECT)
280#define IS_PSTATE_REPLY_OPTIONAL(p) ((p)->state & PSTATE_REPLY_OPTIONAL)
281#define IS_PSTATE_RESPONSE_GOT(p) ((p)->state & PSTATE_RESPONSE_GOT)
282#define IS_PSTATE_RESPONSE_SENT(p) ((p)->state & PSTATE_RESPONSE_SENT)
283
284#define SET_PSTATE_ACCEPTOR(p) ((p)->state |= PSTATE_ACCEPTOR)
285#define SET_PSTATE_NEGOTIATE(p) ((p)->state |= PSTATE_NEGOTIATE)
286#define SET_PSTATE_PROPOSER(p) ((p)->state |= PSTATE_PROPOSER)
287#define SET_PSTATE_IRRELEVANT(p) ((p)->state |= PSTATE_IRRELEVANT)
288#define SET_PSTATE_REJECT(p) ((p)->state |= PSTATE_REJECT)
289#define SET_PSTATE_REPLY_OPTIONAL(p) ((p)->state |= PSTATE_REPLY_OPTIONAL)
290#define SET_PSTATE_RESPONSE_GOT(p) ((p)->state |= PSTATE_RESPONSE_GOT)
291#define SET_PSTATE_RESPONSE_SENT(p) ((p)->state |= PSTATE_RESPONSE_SENT)
292
293#endif /* ISCSI_PARAMETERS_H */
294

source code of linux/drivers/target/iscsi/iscsi_target_parameters.h