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 8 struct iscsi_extra_response { 9 char key[KEY_MAXLEN]; 10 char value[32]; 11 struct list_head er_list; 12 } ____cacheline_aligned; 13 14 struct 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 28 struct iscsi_conn; 29 struct iscsi_conn_ops; 30 struct iscsi_param_list; 31 struct iscsi_sess_ops; 32 33 extern int iscsi_login_rx_data(struct iscsi_conn *, char *, int); 34 extern int iscsi_login_tx_data(struct iscsi_conn *, char *, char *, int); 35 extern void iscsi_dump_conn_ops(struct iscsi_conn_ops *); 36 extern void iscsi_dump_sess_ops(struct iscsi_sess_ops *); 37 extern void iscsi_print_params(struct iscsi_param_list *); 38 extern int iscsi_create_default_params(struct iscsi_param_list **); 39 extern int iscsi_set_keys_to_negotiate(struct iscsi_param_list *, bool); 40 extern int iscsi_set_keys_irrelevant_for_discovery(struct iscsi_param_list *); 41 extern int iscsi_copy_param_list(struct iscsi_param_list **, 42 struct iscsi_param_list *, int); 43 extern int iscsi_change_param_value(char *, struct iscsi_param_list *, int); 44 extern void iscsi_release_param_list(struct iscsi_param_list *); 45 extern struct iscsi_param *iscsi_find_param_from_key(char *, struct iscsi_param_list *); 46 extern int iscsi_extract_key_value(char *, char **, char **); 47 extern int iscsi_update_param_value(struct iscsi_param *, char *); 48 extern int iscsi_decode_text_input(u8, u8, char *, u32, struct iscsi_conn *); 49 extern int iscsi_encode_text_output(u8, u8, char *, u32 *, 50 struct iscsi_param_list *, bool); 51 extern int iscsi_check_negotiated_keys(struct iscsi_param_list *); 52 extern void iscsi_set_connection_parameters(struct iscsi_conn_ops *, 53 struct iscsi_param_list *); 54 extern 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