xref: /netbsd/sys/dev/iscsi/iscsi_ioctl.h (revision eb8aeefa)

/*	$NetBSD: iscsi_ioctl.h,v 1.2 2011/10/29 16:04:39 christos Exp $	*/

/*-
 * Copyright (c) 2004,2005,2006,2011 The NetBSD Foundation, Inc.
 * All rights reserved.
 *
 * This code is derived from software contributed to The NetBSD Foundation
 * by Wasabi Systems, Inc.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */
#ifndef _ISCSI_IOCTL_H
#define _ISCSI_IOCTL_H

#include <dev/iscsi/iscsi.h>

/* ==================  Interface Structures ======================== */

/* ===== Login, add_connection, and restore_connection ===== */

typedef struct {
	uint32_t status;
	int socket;
	struct {
		unsigned int HeaderDigest:1;
		unsigned int DataDigest:1;
		unsigned int MaxConnections:1;
		unsigned int DefaultTime2Wait:1;
		unsigned int DefaultTime2Retain:1;
		unsigned int MaxRecvDataSegmentLength:1;
		unsigned int auth_info:1;
		unsigned int user_name:1;
		unsigned int password:1;
		unsigned int target_password:1;
		unsigned int TargetName:1;
		unsigned int TargetAlias:1;
		unsigned int ErrorRecoveryLevel:1;
	} is_present;
	iscsi_auth_info_t auth_info;
	iscsi_login_session_type_t login_type;
	iscsi_digest_t HeaderDigest;
	iscsi_digest_t DataDigest;
	uint32_t session_id;
	uint32_t connection_id;
	uint32_t MaxRecvDataSegmentLength;
	uint16_t MaxConnections;
	uint16_t DefaultTime2Wait;
	uint16_t DefaultTime2Retain;
	uint16_t ErrorRecoveryLevel;
	void *user_name;
	void *password;
	void *target_password;
	void *TargetName;
	void *TargetAlias;
} iscsi_login_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   socket
      A handle to the open TCP connection to the target portal.
   is_present
      Contains a bitfield that indicates which members of the
      iscsi_login_parameters structure contain valid data.
   auth_info
      Is a bitfield of parameters for authorization.
      The members are
         mutual_auth Indicates that authentication should be mutual, i.e.
            the initiator should authenticate the target, and the target
            should authenticate the initiator. If not specified, the target
            will authenticate the initiator only.
         is_secure   Indicates that the connection is secure.
         auth_number Indicates the number of elements in auth_type.
            When 0, no authentication will be used.
   auth_type
      Contains up to ISCSI_AUTH_OPTIONS enumerator values of type
      iscsi_auth_types that indicates the authentication method that should
      be used to establish a login connection (none, CHAP, KRB5, etc.), in
      order of priority.  The first element is the most preferred method, the
      last element the least preferred.
   login_type
      Contains an enumerator value of type login_session_type that indicates
      the type of logon session (discovery, informational, or full featured).
   HeaderDigest
      Indicates which digest (if any) to use for the PDU header.
   DataDigest
      Indicates which digest (if any) to use for the PDU data.
   session_id
      Login: OUT: Receives an integer that identifies the session.
      Add_connection, Restore_connection: IN: Session ID.
   connection_id
      Login, Add_connection: OUT: Receives an integer that identifies the
      connection.
      Restore_connection: IN: Connection ID.
   MaxRecvDataSegmentLength
      Allows limiting or extending the maximum receive data segment length.
      Must contain a value between 512 and 2**24-1 if specified.
   MaxConnections
      Contains a value between 1 and 65535 that specifies the maximum number
      of connections to target devices that can be associated with a single
      logon session. A value of 0 indicates that there no limit to the
      number of connections.
   DefaultTime2Wait
      Specifies the minimum time to wait, in seconds, before attempting to
      reconnect or reassign a connection that has been dropped.
	  The default is 2.
   DefaultTime2Retain
      Specifies the maximum time, in seconds, allowed to reassign a
      connection after the initial wait indicated in DefaultTime2Retain has
      elapsed. The default is 20.
   ErrorRecoveryLevel
      Specifies the desired error recovery level for the session.
	  The default and maximum is 2.
   user_name
      Sets the user (or CHAP) name to use during login authentication of the
      initiator (zero terminated UTF-8 string). Default is initiator name.
   password
      Contains the password to use during login authentication of the
      initiator (zero terminated UTF-8 string). Required if authentication
      is requested.
   target_password
      Contains the password to use during login authentication of the target
      (zero terminated UTF-8 string). Required if mutual authentication is
      requested.
   TargetName
      Indicates the name of the target with which to establish the logon
      session (zero terminated UTF-8 string).
   TargetAlias
      Receives the target alias as a zero terminated UTF-8 string. When
      present, the buffer must be of size ISCSI_STRING_LENGTH.
*/


/* ===== Logout ===== */

typedef struct {
	uint32_t status;
	uint32_t session_id;
} iscsi_logout_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   session_id
      Contains an integer that identifies the session.
*/

/* ===== remove_connection ===== */

typedef struct {
	uint32_t status;
	uint32_t session_id;
	uint32_t connection_id;
} iscsi_remove_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   session_id
      Contains an integer that identifies the session.
   connection_id
      Contains an integer that identifies the connection.
*/

/* ===== connection status ===== */

typedef struct {
	uint32_t status;
	uint32_t session_id;
	uint32_t connection_id;
} iscsi_conn_status_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   session_id
      Contains an integer that identifies the session.
   connection_id
      Contains an integer that identifies the connection.
*/

/* ===== io_command ===== */

typedef struct {
	uint32_t status;
	uint32_t session_id;
	uint32_t connection_id;
	struct {
		unsigned int immediate:1;
	} options;
	uint64_t lun;
	scsireq_t req;
} iscsi_iocommand_parameters_t;

/*
   status
      Contains, on return, the result of the command (an ISCSI_STATUS code).
   lun
      Indicates which of the target's logical units should provide the data.
   session_id
      Contains an integer that identifies the session.
   connection_id
      Contains an integer that identifies the connection.
      This parameter is optional and should only be used for test purposes.
   options
      A bitfield indicating options for the command.
      The members are
         immediate   Indicates that the command should be sent
                     immediately, ahead of any queued requests.

   req
      Contains the parameters for the request as defined in sys/scsiio.h
      typedef struct scsireq {
         u_long   flags;
         u_long   timeout;
         uint8_t   cmd[16];
         uint8_t   cmdlen;
         void * databuf;
         u_long   datalen;
         u_long   datalen_used;
         uint8_t   sense[SENSEBUFLEN];
         uint8_t   senselen;
         uint8_t   senselen_used;
         uint8_t   status;
         uint8_t   retsts;
         int      error;
      } scsireq_t;

      flags
         Indicates request status and type.
      timeout
         Indicates a timeout value (reserved).
      cmd
         SCSI command buffer.
      cmdlen
         Length of SCSI command in cmd.
      databuf
         Pointer to user-space buffer that holds the data
         read or written by the SCSI command.
      datalen
         Indicates the size in bytes of the buffer at databuf.
      datalen_used
         Returns the number of bytes actually read or written.
      sense
         Sense data buffer.
      senselen
         Indicates the requested size of sense data. Must not exceed
         SENSEBUFLEN (48).
      senselen_used
         Contains, on return, the number of bytes written to sense.
      status
         Contains, on return, the original SCSI status (reserved).
      retsts
         Contains, on return, the status of the command as defined in scsiio.h.
      error
         Contains, on return, the original SCSI error bits (reserved).
*/


/* ===== send_targets ===== */

typedef struct {
	uint32_t status;
	uint32_t session_id;
	void *response_buffer;
	uint32_t response_size;
	uint32_t response_used;
	uint32_t response_total;
	uint8_t key[ISCSI_STRING_LENGTH];
} iscsi_send_targets_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   session_id
      Contains an integer that identifies the session.
   response_buffer
      User mode address of buffer to hold the response data retrieved by
      the iSCSI send targets command.
   response_size
      Contains, on input, the size in bytes of the buffer at
      response_buffer. If this is 0, the command will execute the
      SendTargets request, and return (in response_total) the number of
      bytes required.
   response_used
      Contains, on return, the number of bytes actually retrieved to
      response_buffer.
   response_total
      Contains, on return, the total number of bytes required to hold the
      complete list of targets. This may be larger than response_size.
   key
      Specifies the SendTargets key value ("All", <target name>, or empty).
*/

/* ===== set_node_name ===== */

typedef struct {
	uint32_t status;
	uint8_t InitiatorName[ISCSI_STRING_LENGTH];
	uint8_t InitiatorAlias[ISCSI_STRING_LENGTH];
	uint8_t ISID[6];
} iscsi_set_node_name_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   InitiatorName
      Specifies the InitiatorName used during login. Required.
   InitiatorAlias
      Specifies the InitiatorAlias for use during login. May be empty.
   ISID
      Specifies the ISID (a 6 byte binary value) for use during login.
      May be zero (all bytes) for the initiator to use a default value.
*/

/* ===== register_event and deregister_event ===== */

typedef struct {
	uint32_t status;
	uint32_t event_id;
} iscsi_register_event_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   event_id
      Returns driver-assigned event ID to be used in
      subsequent calls to wait_event and deregister_event.
*/

/* ===== wait_event ===== */

typedef enum {
	ISCSI_SESSION_TERMINATED = 1,
	ISCSI_CONNECTION_TERMINATED,
	ISCSI_RECOVER_CONNECTION,
	ISCSI_DRIVER_TERMINATING
} iscsi_event_t;

/*
   Driver Events

   ISCSI_SESSION_TERMINATED
      The specified session (including all of its associated connections)
      has been terminated.
   ISCSI_CONNECTION_TERMINATED
      The specified connection has been terminated.
   ISCSI_RECOVER_CONNECTION
      The application should attempt to recover the given connection.
   ISCSI_DRIVER_TERMINATING
      The driver is unloading.
      The application MUST call ISCSI_DEREGISTER_EVENT as soon as possible
      after receiving this event. After performing the deregister IOCTL,
      the application must no longer attempt to access the driver.
*/


typedef struct {
	uint32_t status;
	uint32_t event_id;
	iscsi_event_t event_kind;
	uint32_t session_id;
	uint32_t connection_id;
	uint32_t reason;
} iscsi_wait_event_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   event_id
      Driver assigned event ID.
   event_kind
      Identifies the event.
   session_id
      Identifies the affected session (0 for DRIVER_TERMINATING).
   connection_id
      Identifies the affected connection (0 for DRIVER_TERMINATING).
   reason
      Identifies the termination reason (ISCSI status code).
*/

typedef struct {
	uint32_t status;
	uint16_t interface_version;
	uint16_t major;
	uint16_t minor;
	uint8_t version_string[ISCSI_STRING_LENGTH];
} iscsi_get_version_parameters_t;

/*
   status
      Contains, on return, the result of the command.
   interface_version
      Updated when interface changes. Current Version is 2.
   major
      Major version number.
   minor
      Minor version number.
   version_string
      Displayable version string (zero terminated).
*/

/* =========================  IOCTL Codes =========================== */

#define ISCSI_GET_VERSION        _IOWR(0,  1, iscsi_get_version_parameters_t)
#define ISCSI_LOGIN              _IOWR(0,  2, iscsi_login_parameters_t)
#define ISCSI_LOGOUT             _IOWR(0,  3, iscsi_logout_parameters_t)
#define ISCSI_ADD_CONNECTION     _IOWR(0,  4, iscsi_login_parameters_t)
#define ISCSI_RESTORE_CONNECTION _IOWR(0,  5, iscsi_login_parameters_t)
#define ISCSI_REMOVE_CONNECTION  _IOWR(0,  6, iscsi_remove_parameters_t)
#define ISCSI_CONNECTION_STATUS  _IOWR(0,  7, iscsi_conn_status_parameters_t)
#define ISCSI_SEND_TARGETS       _IOWR(0,  8, iscsi_send_targets_parameters_t)
#define ISCSI_SET_NODE_NAME      _IOWR(0,  9, iscsi_set_node_name_parameters_t)
#define ISCSI_IO_COMMAND         _IOWR(0, 10, iscsi_iocommand_parameters_t)
#define ISCSI_REGISTER_EVENT     _IOWR(0, 11, iscsi_register_event_parameters_t)
#define ISCSI_DEREGISTER_EVENT   _IOWR(0, 12, iscsi_register_event_parameters_t)
#define ISCSI_WAIT_EVENT         _IOWR(0, 13, iscsi_wait_event_parameters_t)
#define ISCSI_POLL_EVENT         _IOWR(0, 14, iscsi_wait_event_parameters_t)

#endif /* !_ISCSI_IOCTL_H */