linux/drivers/target/iscsi/iscsi_target_parameters.h
<<
>>
Prefs
   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 iscsi_conn;
  29struct iscsi_conn_ops;
  30struct iscsi_param_list;
  31struct iscsi_sess_ops;
  32
  33extern int iscsi_login_rx_data(struct iscsi_conn *, char *, int);
  34extern int iscsi_login_tx_data(struct iscsi_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 iscsi_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#define X_EXTENSIONKEY                  "X-com.sbei.version"
  97#define X_EXTENSIONKEY_CISCO_NEW        "X-com.cisco.protocol"
  98#define X_EXTENSIONKEY_CISCO_OLD        "X-com.cisco.iscsi.draft"
  99
 100/*
 101 * Parameter names of iSCSI Extentions for RDMA (iSER).  See RFC-5046
 102 */
 103#define RDMAEXTENSIONS                  "RDMAExtensions"
 104#define INITIATORRECVDATASEGMENTLENGTH  "InitiatorRecvDataSegmentLength"
 105#define TARGETRECVDATASEGMENTLENGTH     "TargetRecvDataSegmentLength"
 106
 107/*
 108 * For AuthMethod.
 109 */
 110#define KRB5                            "KRB5"
 111#define SPKM1                           "SPKM1"
 112#define SPKM2                           "SPKM2"
 113#define SRP                             "SRP"
 114#define CHAP                            "CHAP"
 115
 116/*
 117 * Initial values for Parameter Negotiation.
 118 */
 119#define INITIAL_AUTHMETHOD                      CHAP
 120#define INITIAL_HEADERDIGEST                    "CRC32C,None"
 121#define INITIAL_DATADIGEST                      "CRC32C,None"
 122#define INITIAL_MAXCONNECTIONS                  "1"
 123#define INITIAL_SENDTARGETS                     ALL
 124#define INITIAL_TARGETNAME                      "LIO.Target"
 125#define INITIAL_INITIATORNAME                   "LIO.Initiator"
 126#define INITIAL_TARGETALIAS                     "LIO Target"
 127#define INITIAL_INITIATORALIAS                  "LIO Initiator"
 128#define INITIAL_TARGETADDRESS                   "0.0.0.0:0000,0"
 129#define INITIAL_TARGETPORTALGROUPTAG            "1"
 130#define INITIAL_INITIALR2T                      YES
 131#define INITIAL_IMMEDIATEDATA                   YES
 132#define INITIAL_MAXRECVDATASEGMENTLENGTH        "8192"
 133/*
 134 * Match outgoing MXDSL default to incoming Open-iSCSI default
 135 */
 136#define INITIAL_MAXXMITDATASEGMENTLENGTH        "262144"
 137#define INITIAL_MAXBURSTLENGTH                  "262144"
 138#define INITIAL_FIRSTBURSTLENGTH                "65536"
 139#define INITIAL_DEFAULTTIME2WAIT                "2"
 140#define INITIAL_DEFAULTTIME2RETAIN              "20"
 141#define INITIAL_MAXOUTSTANDINGR2T               "1"
 142#define INITIAL_DATAPDUINORDER                  YES
 143#define INITIAL_DATASEQUENCEINORDER             YES
 144#define INITIAL_ERRORRECOVERYLEVEL              "0"
 145#define INITIAL_SESSIONTYPE                     NORMAL
 146#define INITIAL_IFMARKER                        NO
 147#define INITIAL_OFMARKER                        NO
 148#define INITIAL_IFMARKINT                       REJECT
 149#define INITIAL_OFMARKINT                       REJECT
 150
 151/*
 152 * Initial values for iSER parameters following RFC-5046 Section 6
 153 */
 154#define INITIAL_RDMAEXTENSIONS                  NO
 155#define INITIAL_INITIATORRECVDATASEGMENTLENGTH  "262144"
 156#define INITIAL_TARGETRECVDATASEGMENTLENGTH     "8192"
 157
 158/*
 159 * For [Header,Data]Digests.
 160 */
 161#define CRC32C                          "CRC32C"
 162
 163/*
 164 * For SessionType.
 165 */
 166#define DISCOVERY                       "Discovery"
 167#define NORMAL                          "Normal"
 168
 169/*
 170 * struct iscsi_param->use
 171 */
 172#define USE_LEADING_ONLY                0x01
 173#define USE_INITIAL_ONLY                0x02
 174#define USE_ALL                         0x04
 175
 176#define IS_USE_LEADING_ONLY(p)          ((p)->use & USE_LEADING_ONLY)
 177#define IS_USE_INITIAL_ONLY(p)          ((p)->use & USE_INITIAL_ONLY)
 178#define IS_USE_ALL(p)                   ((p)->use & USE_ALL)
 179
 180#define SET_USE_INITIAL_ONLY(p)         ((p)->use |= USE_INITIAL_ONLY)
 181
 182/*
 183 * struct iscsi_param->sender
 184 */
 185#define SENDER_INITIATOR                0x01
 186#define SENDER_TARGET                   0x02
 187#define SENDER_BOTH                     0x03
 188/* Used in iscsi_check_key() */
 189#define SENDER_RECEIVER                 0x04
 190
 191#define IS_SENDER_INITIATOR(p)          ((p)->sender & SENDER_INITIATOR)
 192#define IS_SENDER_TARGET(p)             ((p)->sender & SENDER_TARGET)
 193#define IS_SENDER_BOTH(p)               ((p)->sender & SENDER_BOTH)
 194
 195/*
 196 * struct iscsi_param->scope
 197 */
 198#define SCOPE_CONNECTION_ONLY           0x01
 199#define SCOPE_SESSION_WIDE              0x02
 200
 201#define IS_SCOPE_CONNECTION_ONLY(p)     ((p)->scope & SCOPE_CONNECTION_ONLY)
 202#define IS_SCOPE_SESSION_WIDE(p)        ((p)->scope & SCOPE_SESSION_WIDE)
 203
 204/*
 205 * struct iscsi_param->phase
 206 */
 207#define PHASE_SECURITY                  0x01
 208#define PHASE_OPERATIONAL               0x02
 209#define PHASE_DECLARATIVE               0x04
 210#define PHASE_FFP0                      0x08
 211
 212#define IS_PHASE_SECURITY(p)            ((p)->phase & PHASE_SECURITY)
 213#define IS_PHASE_OPERATIONAL(p)         ((p)->phase & PHASE_OPERATIONAL)
 214#define IS_PHASE_DECLARATIVE(p)         ((p)->phase & PHASE_DECLARATIVE)
 215#define IS_PHASE_FFP0(p)                ((p)->phase & PHASE_FFP0)
 216
 217/*
 218 * struct iscsi_param->type
 219 */
 220#define TYPE_BOOL_AND                   0x01
 221#define TYPE_BOOL_OR                    0x02
 222#define TYPE_NUMBER                     0x04
 223#define TYPE_NUMBER_RANGE               0x08
 224#define TYPE_STRING                     0x10
 225#define TYPE_VALUE_LIST                 0x20
 226
 227#define IS_TYPE_BOOL_AND(p)             ((p)->type & TYPE_BOOL_AND)
 228#define IS_TYPE_BOOL_OR(p)              ((p)->type & TYPE_BOOL_OR)
 229#define IS_TYPE_NUMBER(p)               ((p)->type & TYPE_NUMBER)
 230#define IS_TYPE_NUMBER_RANGE(p)         ((p)->type & TYPE_NUMBER_RANGE)
 231#define IS_TYPE_STRING(p)               ((p)->type & TYPE_STRING)
 232#define IS_TYPE_VALUE_LIST(p)           ((p)->type & TYPE_VALUE_LIST)
 233
 234/*
 235 * struct iscsi_param->type_range
 236 */
 237#define TYPERANGE_BOOL_AND              0x0001
 238#define TYPERANGE_BOOL_OR               0x0002
 239#define TYPERANGE_0_TO_2                0x0004
 240#define TYPERANGE_0_TO_3600             0x0008
 241#define TYPERANGE_0_TO_32767            0x0010
 242#define TYPERANGE_0_TO_65535            0x0020
 243#define TYPERANGE_1_TO_65535            0x0040
 244#define TYPERANGE_2_TO_3600             0x0080
 245#define TYPERANGE_512_TO_16777215       0x0100
 246#define TYPERANGE_AUTH                  0x0200
 247#define TYPERANGE_DIGEST                0x0400
 248#define TYPERANGE_ISCSINAME             0x0800
 249#define TYPERANGE_SESSIONTYPE           0x1000
 250#define TYPERANGE_TARGETADDRESS         0x2000
 251#define TYPERANGE_UTF8                  0x4000
 252
 253#define IS_TYPERANGE_0_TO_2(p)          ((p)->type_range & TYPERANGE_0_TO_2)
 254#define IS_TYPERANGE_0_TO_3600(p)       ((p)->type_range & TYPERANGE_0_TO_3600)
 255#define IS_TYPERANGE_0_TO_32767(p)      ((p)->type_range & TYPERANGE_0_TO_32767)
 256#define IS_TYPERANGE_0_TO_65535(p)      ((p)->type_range & TYPERANGE_0_TO_65535)
 257#define IS_TYPERANGE_1_TO_65535(p)      ((p)->type_range & TYPERANGE_1_TO_65535)
 258#define IS_TYPERANGE_2_TO_3600(p)       ((p)->type_range & TYPERANGE_2_TO_3600)
 259#define IS_TYPERANGE_512_TO_16777215(p) ((p)->type_range & \
 260                                                TYPERANGE_512_TO_16777215)
 261#define IS_TYPERANGE_AUTH_PARAM(p)      ((p)->type_range & TYPERANGE_AUTH)
 262#define IS_TYPERANGE_DIGEST_PARAM(p)    ((p)->type_range & TYPERANGE_DIGEST)
 263#define IS_TYPERANGE_SESSIONTYPE(p)     ((p)->type_range & \
 264                                                TYPERANGE_SESSIONTYPE)
 265
 266/*
 267 * struct iscsi_param->state
 268 */
 269#define PSTATE_ACCEPTOR                 0x01
 270#define PSTATE_NEGOTIATE                0x02
 271#define PSTATE_PROPOSER                 0x04
 272#define PSTATE_IRRELEVANT               0x08
 273#define PSTATE_REJECT                   0x10
 274#define PSTATE_REPLY_OPTIONAL           0x20
 275#define PSTATE_RESPONSE_GOT             0x40
 276#define PSTATE_RESPONSE_SENT            0x80
 277
 278#define IS_PSTATE_ACCEPTOR(p)           ((p)->state & PSTATE_ACCEPTOR)
 279#define IS_PSTATE_NEGOTIATE(p)          ((p)->state & PSTATE_NEGOTIATE)
 280#define IS_PSTATE_PROPOSER(p)           ((p)->state & PSTATE_PROPOSER)
 281#define IS_PSTATE_IRRELEVANT(p)         ((p)->state & PSTATE_IRRELEVANT)
 282#define IS_PSTATE_REJECT(p)             ((p)->state & PSTATE_REJECT)
 283#define IS_PSTATE_REPLY_OPTIONAL(p)     ((p)->state & PSTATE_REPLY_OPTIONAL)
 284#define IS_PSTATE_RESPONSE_GOT(p)       ((p)->state & PSTATE_RESPONSE_GOT)
 285#define IS_PSTATE_RESPONSE_SENT(p)      ((p)->state & PSTATE_RESPONSE_SENT)
 286
 287#define SET_PSTATE_ACCEPTOR(p)          ((p)->state |= PSTATE_ACCEPTOR)
 288#define SET_PSTATE_NEGOTIATE(p)         ((p)->state |= PSTATE_NEGOTIATE)
 289#define SET_PSTATE_PROPOSER(p)          ((p)->state |= PSTATE_PROPOSER)
 290#define SET_PSTATE_IRRELEVANT(p)        ((p)->state |= PSTATE_IRRELEVANT)
 291#define SET_PSTATE_REJECT(p)            ((p)->state |= PSTATE_REJECT)
 292#define SET_PSTATE_REPLY_OPTIONAL(p)    ((p)->state |= PSTATE_REPLY_OPTIONAL)
 293#define SET_PSTATE_RESPONSE_GOT(p)      ((p)->state |= PSTATE_RESPONSE_GOT)
 294#define SET_PSTATE_RESPONSE_SENT(p)     ((p)->state |= PSTATE_RESPONSE_SENT)
 295
 296#endif /* ISCSI_PARAMETERS_H */
 297