sys/dev/iscsi/initiator/iscsi.h

   1 /*-
   2  * Copyright (c) 2005-2007 Daniel Braniss <danny@cs.huji.ac.il>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  *
  26  * $FreeBSD$
  27  */
  28 /*
  29  | $Id: iscsi.h,v 1.17 2006/12/01 09:10:17 danny Exp danny $
  30  */
  31 #define TRUE    1
  32 #define FALSE   0
  33 #ifndef _KERNEL
  34 typedef int boolean_t;
  35 #endif
  36
  37 #include <cam/cam.h>
  38
  39 #define ISCSIDEV        "iscsi"
  40
  41 #define ISCSI_MAX_TARGETS       4 //64
  42
  43 #define ISCSI_MAX_LUNS          4
  44
  45 /*
  46  | iSCSI commands
  47  */
  48
  49 /*
  50  | Initiator Opcodes:
  51  */
  52 #define ISCSI_NOP_OUT           0x00
  53 #define ISCSI_SCSI_CMD          0x01
  54 #define ISCSI_TASK_CMD          0x02
  55 #define ISCSI_LOGIN_CMD         0x03
  56 #define ISCSI_TEXT_CMD          0x04
  57 #define ISCSI_WRITE_DATA        0x05
  58 #define ISCSI_LOGOUT_CMD        0x06
  59 #define ISCSI_SNACK             0x10
  60 /*
  61  | Target Opcodes:
  62  */
  63 #define ISCSI_NOP_IN            0x20
  64 #define ISCSI_SCSI_RSP          0x21
  65 #define ISCSI_TASK_RSP          0x22
  66 #define ISCSI_LOGIN_RSP         0x23
  67 #define ISCSI_TEXT_RSP          0x24
  68 #define ISCSI_READ_DATA         0x25
  69 #define ISCSI_LOGOUT_RSP        0x26
  70 #define ISCSI_R2T               0x31
  71 #define ISCSI_ASYNC             0x32
  72 #define ISCSI_REJECT            0x3f
  73 /*
  74  | PDU stuff
  75  */
  76 /*
  77  | BHS Basic Header Segment
  78  */
  79 typedef struct bhs {
  80      // the order is network byte order!
  81      u_char     opcode:6;
  82      u_char     I:1;
  83      u_char     _:1;
  84      u_char     __:7;
  85      u_char     F:1;                    // Final bit
  86      u_char     ___[2];
  87
  88      u_int      AHSLength:8;            // in 4byte words
  89      u_int      DSLength:24;            // in bytes
  90
  91      u_int      LUN[2];                 // or Opcode-specific fields
  92      u_int      itt;
  93      u_int      OpcodeSpecificFields[7];
  94 #define CmdSN           OpcodeSpecificFields[1]
  95 #define ExpStSN         OpcodeSpecificFields[2]
  96 #define MaxCmdSN        OpcodeSpecificFields[3]
  97 } bhs_t;
  98
  99 typedef struct ahs {
 100      u_int      len:16;
 101      u_int      type:8;
 102      u_int      spec:8;
 103      char       data[0];
 104 } ahs_t;
 105
 106 typedef struct {
 107      // Sequence Numbers
 108      // (computers were invented to count, right?)
 109      int        cmd;
 110      int        expcmd;
 111      int        maxcmd;
 112 } req_sn_t;
 113
 114 typedef struct {
 115      // Sequence Numbers
 116      // (computers were invented to count, right?)
 117      int        stat;
 118      int        expcmd;
 119      int        maxcmd;
 120 } rsp_sn_t;
 121
 122 typedef struct scsi_req {
 123      u_char     opcode:6; // 0x01
 124      u_char     I:1;
 125      u_char     _:1;
 126
 127      u_char     attr:3;
 128      u_char     _0:2;
 129      u_char     W:1;
 130      u_char     R:1;
 131      u_char     F:1;
 132 #define         iSCSI_TASK_UNTAGGED     0
 133 #define         iSCSI_TASK_SIMPLE       1
 134 #define         iSCSI_TASK_ORDER        2
 135 #define         iSCSI_TASK_HOFQ         3
 136 #define         iSCSI_TASK_ACA          4
 137      char       _1[2];
 138      int        len;
 139      int        lun[2];
 140      int        itt;
 141      int        edtlen;         // expectect data transfere length
 142      int        cmdSN;
 143      int        extStatSN;
 144      int        cdb[4];
 145 } scsi_req_t;
 146
 147 typedef struct scsi_rsp {
 148      char       opcode; // 0x21
 149      u_char     flag;
 150      u_char     response;
 151      u_char     status;
 152
 153      int        len;
 154      int        _[2];
 155      int        itt;
 156      int        stag;
 157      rsp_sn_t   sn;
 158      int        expdatasn;
 159      int        bdrcnt; // bidirectional residual count
 160      int        rcnt;   // residual count
 161 } scsi_rsp_t;
 162
 163 typedef struct nop_out {
 164      // the order is network byte order!
 165      u_char     opcode:6;
 166      u_char     I:1;
 167      u_char     _:1;
 168      u_char     __:7;
 169      u_char     F:1;                    // Final bit
 170      u_char     ___[2];
 171
 172      u_int      len;
 173      u_int      lun[2];
 174      u_int      itt;
 175      u_int      ttt;
 176      req_sn_t   sn;
 177      u_int      mbz[3];
 178 } nop_out_t;
 179
 180 typedef struct nop_in {
 181      // the order is network byte order!
 182      u_char     opcode:6;
 183      u_char     I:1;
 184      u_char     _:1;
 185      u_char     __:7;
 186      u_char     F:1;                    // Final bit
 187      u_char     ___[2];
 188
 189      u_int      len;
 190      u_int      lun[2];
 191      u_int      itt;
 192      u_int      ttt;
 193      rsp_sn_t   sn;
 194      u_int      ____[2];
 195
 196 } nop_in_t;
 197
 198 typedef struct r2t {
 199      u_char     opcode:6;
 200      u_char     I:1;
 201      u_char     _:1;
 202      u_char     __:7;
 203      u_char     F:1;                    // Final bit
 204      u_char     ___[2];
 205
 206      u_int      len;
 207      u_int      lun[2];
 208      u_int      itt;
 209      u_int      ttt;
 210      rsp_sn_t   sn;
 211      u_int      r2tSN;
 212      u_int      bo;
 213      u_int      ddtl;
 214 } r2t_t;
 215
 216 typedef struct data_out {
 217      u_char     opcode:6;
 218      u_char     I:1;
 219      u_char     _:1;
 220      u_char     __:7;
 221      u_char     F:1;                    // Final bit
 222      u_char     ___[2];
 223
 224      u_int      len;
 225      u_int      lun[2];
 226      u_int      itt;
 227      u_int      ttt;
 228      rsp_sn_t   sn;
 229      u_int      dsn;    // data seq. number
 230      u_int      bo;
 231      u_int      ____;
 232 } data_out_t;
 233
 234 typedef struct data_in {
 235      u_char     opcode:6;
 236      u_char     I:1;
 237      u_char     _:1;
 238
 239      u_char     S:1;
 240      u_char     U:1;
 241      u_char     O:1;
 242      u_char     __:3;
 243      u_char     A:1;
 244      u_char     F:1;                    // Final bit
 245      u_char     ___[1];
 246      u_char     status;
 247
 248      u_int      len;
 249      u_int      lun[2];
 250      u_int      itt;
 251      u_int      ttt;
 252      rsp_sn_t   sn;
 253      u_int      dataSN;
 254      u_int      bo;
 255      u_int      ____;
 256 } data_in_t;
 257
 258 typedef struct reject {
 259      u_char     opcode:6;
 260      u_char     _:2;
 261      u_char     F:1;
 262      u_char     __:7;
 263      u_char     reason;
 264      u_char     ___;
 265
 266      u_int      len;
 267      u_int      ____[2];
 268      u_int      tt[2];  // must be -1
 269      rsp_sn_t   sn;
 270      u_int      dataSN; // or R2TSN or reserved
 271      u_int      _____[2];
 272 } reject_t;
 273
 274 typedef struct async {
 275      u_char     opcode:6;
 276      u_char     _:2;
 277      u_char     F:1;
 278      u_char     __:7;
 279      u_char     ___[2];
 280
 281      u_int      len;
 282      u_int      lun[2];
 283      u_int      itt;    // must be -1
 284      u_int      ____;
 285      rsp_sn_t   sn;
 286
 287      u_char     asyncEvent;
 288      u_char     asyncVCode;
 289      u_char     param1[2];
 290      u_char     param2[2];
 291      u_char     param3[2];
 292
 293      u_int      _____;
 294
 295 } async_t;
 296
 297 union ipdu_u {
 298      bhs_t      bhs;
 299      scsi_req_t scsi_req;
 300      scsi_rsp_t scsi_rsp;
 301      nop_out_t  nop_out;
 302      nop_in_t   nop_in;
 303      r2t_t      r2t;
 304      data_out_t data_out;
 305      data_in_t  data_in;
 306      reject_t   reject;
 307      async_t    async;
 308 };
 309
 310 /*
 311  | Sequence Numbers
 312  */
 313 typedef struct {
 314      u_int      itt;
 315      u_int      cmd;
 316      u_int      expCmd;
 317      u_int      maxCmd;
 318      u_int      stat;
 319      u_int      expStat;
 320      u_int      data;
 321 } sn_t;
 322
 323 /*
 324  | in-core version of a Protocol Data Unit
 325  */
 326 typedef struct {
 327      union ipdu_u       ipdu;
 328
 329      ahs_t              *ahs;
 330      u_int              ahs_len;
 331      u_int              ahs_size;       // the allocated size
 332      u_int              hdr_dig;        // header digest
 333
 334      u_char             *ds;
 335      u_int              ds_len;
 336      u_int              ds_size;        // the allocated size
 337      u_int              ds_dig;         // data digest
 338 } pdu_t;
 339
 340 typedef struct opvals {
 341      int        port;
 342      int        tags;
 343      int        maxluns;
 344      int        sockbufsize;
 345
 346      int        maxConnections;
 347      int        maxRecvDataSegmentLength;
 348      int        maxXmitDataSegmentLength; // pseudo ...
 349      int        maxBurstLength;
 350      int        firstBurstLength;
 351      int        defaultTime2Wait;
 352      int        defaultTime2Retain;
 353      int        maxOutstandingR2T;
 354      int        errorRecoveryLevel;
 355      int        targetPortalGroupTag;
 356
 357      boolean_t  initialR2T;
 358      boolean_t  immediateData;
 359      boolean_t  dataPDUInOrder;
 360      boolean_t  dataSequenceInOrder;
 361      char       *headerDigest;
 362      char       *dataDigest;
 363      char       *sessionType;
 364      char       *sendTargets;
 365      char       *targetAddress;
 366      char       *targetAlias;
 367      char       *targetName;
 368      char       *initiatorName;
 369      char       *initiatorAlias;
 370      char       *authMethod;
 371      char       *chapSecret;
 372      char       *chapIName;
 373      char       *chapDigest;
 374      char       *tgtChapName;
 375      char       *tgtChapSecret;
 376      int        tgtChallengeLen;
 377      u_char     tgtChapID;
 378      char       *tgtChapDigest;
 379      char       *iqn;
 380 } isc_opt_t;
 381
 382 /*
 383  | ioctl
 384  */
 385 #define ISCSISETSES     _IOR('i', 1, int)
 386 #define ISCSISETSOC     _IOW('i', 2, int)
 387 #define ISCSISETOPT     _IOW('i', 5, isc_opt_t)
 388 #define ISCSIGETOPT     _IOR('i', 6, isc_opt_t)
 389
 390 #define ISCSISEND       _IOW('i', 10, pdu_t)
 391 #define ISCSIRECV       _IOWR('i', 11, pdu_t)
 392
 393 #define ISCSIPING       _IO('i', 20)
 394 #define ISCSISIGNAL     _IOW('i', 21, int *)
 395
 396 #define ISCSISTART      _IO('i', 30)
 397 #define ISCSIRESTART    _IO('i', 31)
 398 #define ISCSISTOP       _IO('i', 32)
 399
 400 typedef struct iscsi_cam {
 401      path_id_t          path_id;
 402      target_id_t        target_id;
 403      int                target_nluns;
 404      lun_id_t           target_lun[ISCSI_MAX_LUNS];
 405 } iscsi_cam_t;
 406
 407 #define ISCSIGETCAM     _IOR('i', 33, iscsi_cam_t)