6fea88c26e
- debug log is now using syslog - seperate options for log level and foreground mode - writes a pidfile so that /etc/rc.d/iscsid works Now links with libutil for pidfile(), the functions login() and logout() needed to be renamed to avoid a conflict. - drops the nothreads option - handles signals to shut down gracefully - the driver may also shut down the daemon when it terminates Currently this cannot work as the driver can only terminate when the daemon has closed the driver file handle.
914 lines
20 KiB
C
914 lines
20 KiB
C
/* $NetBSD: iscsid.h,v 1.5 2016/05/29 13:35:45 mlelstv Exp $ */
|
|
|
|
/*-
|
|
* Copyright (c) 2004,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 _ISCSID_H_
|
|
#define _ISCSID_H_
|
|
|
|
#include <dev/iscsi/iscsi.h>
|
|
|
|
#ifndef __BEGIN_DECLS
|
|
# if defined(__cplusplus)
|
|
# define __BEGIN_DECLS extern "C" {
|
|
# define __END_DECLS }
|
|
# else
|
|
# define __BEGIN_DECLS
|
|
# define __END_DECLS
|
|
# endif
|
|
#endif
|
|
|
|
__BEGIN_DECLS
|
|
|
|
/* The socket name */
|
|
|
|
#define ISCSID_SOCK_NAME "/var/run/iscsid_socket"
|
|
|
|
|
|
/* ==== Requests ==== */
|
|
|
|
#define ISCSID_ADD_TARGET 1
|
|
#define ISCSID_ADD_PORTAL 2
|
|
#define ISCSID_SET_TARGET_OPTIONS 3
|
|
#define ISCSID_GET_TARGET_OPTIONS 4
|
|
#define ISCSID_SET_TARGET_AUTHENTICATION 5
|
|
#define ISCSID_SLP_FIND_TARGETS 6
|
|
#define ISCSID_REFRESH_TARGETS 7
|
|
#define ISCSID_REMOVE_TARGET 8
|
|
#define ISCSID_SEARCH_LIST 9
|
|
#define ISCSID_GET_LIST 10
|
|
#define ISCSID_GET_TARGET_INFO 11
|
|
#define ISCSID_GET_PORTAL_INFO 12
|
|
#define ISCSID_ADD_ISNS_SERVER 13
|
|
#define ISCSID_GET_ISNS_SERVER 14
|
|
#define ISCSID_SLP_FIND_ISNS_SERVERS 15
|
|
#define ISCSID_REMOVE_ISNS_SERVER 17
|
|
#define ISCSID_ADD_INITIATOR_PORTAL 18
|
|
#define ISCSID_GET_INITIATOR_PORTAL 19
|
|
#define ISCSID_REMOVE_INITIATOR_PORTAL 20
|
|
#define ISCSID_LOGIN 21
|
|
#define ISCSID_ADD_CONNECTION 22
|
|
#define ISCSID_LOGOUT 23
|
|
#define ISCSID_REMOVE_CONNECTION 24
|
|
#define ISCSID_GET_SESSION_LIST 25
|
|
#define ISCSID_GET_CONNECTION_LIST 26
|
|
#define ISCSID_GET_CONNECTION_INFO 27
|
|
#define ISCSID_SET_NODE_NAME 28
|
|
|
|
#define ISCSID_GET_VERSION 100
|
|
|
|
#define ISCSID_DAEMON_TEST 900
|
|
#define ISCSID_DAEMON_TERMINATE 999
|
|
|
|
/* ==== List kind used in some requests ==== */
|
|
|
|
typedef enum {
|
|
TARGET_LIST, /* list of targets */
|
|
PORTAL_LIST, /* list of target portals */
|
|
SEND_TARGETS_LIST, /* list of send targets portals */
|
|
ISNS_LIST, /* list of isns servers */
|
|
SESSION_LIST, /* list of sessions */
|
|
INITIATOR_LIST, /* list of initiator portals */
|
|
NUM_DAEMON_LISTS /* Number of lists the daemon keeps */
|
|
} iscsid_list_kind_t;
|
|
|
|
/* ==== Search kind for search_list request ==== */
|
|
|
|
typedef enum {
|
|
FIND_ID, /* search for numeric ID */
|
|
FIND_NAME, /* search for symbolic name */
|
|
FIND_TARGET_NAME, /* search for target or initiator name */
|
|
FIND_ADDRESS /* search for target or server address */
|
|
} iscsid_search_kind_t;
|
|
|
|
/* ==== Symbolic or numeric ID ==== */
|
|
|
|
typedef struct {
|
|
uint32_t id;
|
|
uint8_t name[ISCSI_STRING_LENGTH];
|
|
} iscsid_sym_id_t;
|
|
|
|
/*
|
|
id
|
|
Numeric ID.
|
|
name
|
|
Symbolic ID. Ignored if numeric ID is nonzero.
|
|
*/
|
|
|
|
/* ==== Symbolic/Numeric ID with list kind ==== */
|
|
|
|
typedef struct {
|
|
iscsid_list_kind_t list_kind;
|
|
iscsid_sym_id_t id;
|
|
} iscsid_list_id_t;
|
|
|
|
/*
|
|
list_kind
|
|
Which list (generally TARGET_LIST or SEND_TARGETS_LIST)
|
|
id
|
|
numeric/symbolic ID
|
|
*/
|
|
|
|
|
|
typedef struct {
|
|
struct {
|
|
unsigned int HeaderDigest:1;
|
|
unsigned int DataDigest:1;
|
|
unsigned int MaxRecvDataSegmentLength:1;
|
|
} is_present;
|
|
iscsi_digest_t HeaderDigest;
|
|
iscsi_digest_t DataDigest;
|
|
uint32_t MaxRecvDataSegmentLength;
|
|
} iscsid_portal_options_t;
|
|
|
|
/*
|
|
is_present
|
|
Contains a bitfield that indicates which members of the structure
|
|
contain valid data.
|
|
HeaderDigest
|
|
Indicates the digest to use for PDU headers.
|
|
DataDigest
|
|
Indicates the digest to use for PDU data.
|
|
MaxRecvDataSegmentLength
|
|
Allows limiting or extending the maximum receive data segment length.
|
|
Must contain a value between 512 and 2**24-1 if specified.
|
|
*/
|
|
|
|
|
|
/* ==== General request structure ==== */
|
|
|
|
typedef struct {
|
|
uint32_t request;
|
|
uint32_t parameter_length;
|
|
uint8_t parameter[0];
|
|
} iscsid_request_t;
|
|
|
|
/*
|
|
request
|
|
Is the request ID.
|
|
parameter_length
|
|
Specifies the size in bytes of the parameter structure contained in
|
|
parameter.
|
|
parameter
|
|
Contains a structure defining the parameters for the request.
|
|
*/
|
|
|
|
|
|
/* ==== General response structure ==== */
|
|
|
|
typedef struct {
|
|
uint32_t status;
|
|
uint32_t parameter_length;
|
|
uint8_t parameter[0];
|
|
} iscsid_response_t;
|
|
|
|
/*
|
|
status
|
|
Is the result of the request.
|
|
parameter_length
|
|
Specifies the size in bytes of the parameter structure contained in
|
|
parameter.
|
|
parameter
|
|
Contains a structure defining the parameters for the response.
|
|
*/
|
|
|
|
/* ==== ADD_TARGET ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
iscsid_list_kind_t list_kind;
|
|
uint8_t sym_name[ISCSI_STRING_LENGTH];
|
|
uint8_t TargetName[ISCSI_STRING_LENGTH];
|
|
uint32_t num_portals;
|
|
iscsi_portal_address_t portal[0];
|
|
} iscsid_add_target_req_t;
|
|
|
|
/*
|
|
list_kind
|
|
Kind of target list (TARGET_LIST or SEND_TARGETS_LIST)
|
|
sym_name
|
|
Symbolic name of the target (optional)
|
|
TargetName
|
|
Indicates the name of the target (zero terminated UTF-8 string).
|
|
num_portals
|
|
Number of portal addresses (may be zero).
|
|
portal
|
|
Array of portals for this target.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t target_id;
|
|
uint32_t num_portals;
|
|
uint32_t portal_id[0];
|
|
} iscsid_add_target_rsp_t;
|
|
|
|
/*
|
|
target_id
|
|
Is the unique ID assigned to this target.
|
|
num_portals
|
|
Number of portal IDs following.
|
|
portal_id
|
|
Array of unique IDs for the given portals, in the same order as in
|
|
the request.
|
|
*/
|
|
|
|
/* ==== ADD_PORTAL ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t target_id;
|
|
uint8_t sym_name[ISCSI_STRING_LENGTH];
|
|
iscsi_portal_address_t portal;
|
|
iscsid_portal_options_t options;
|
|
} iscsid_add_portal_req_t;
|
|
|
|
/*
|
|
target_id
|
|
Is the unique ID for the target.
|
|
sym_name
|
|
Symbolic name of the portal (optional).
|
|
portal
|
|
Portal address.
|
|
options
|
|
Portal options.
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t target_id;
|
|
iscsid_sym_id_t portal_id;
|
|
} iscsid_add_portal_rsp_t;
|
|
|
|
/*
|
|
target_id
|
|
Reflects the target ID.
|
|
portal_id
|
|
Returns the unique ID of the portal and its name.
|
|
*/
|
|
|
|
/* ==== SET_TARGET_OPTIONS ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
iscsid_list_kind_t list_kind;
|
|
iscsid_sym_id_t target_id;
|
|
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 ErrorRecoveryLevel:1;
|
|
} is_present;
|
|
iscsi_digest_t HeaderDigest;
|
|
iscsi_digest_t DataDigest;
|
|
uint32_t MaxRecvDataSegmentLength;
|
|
uint16_t MaxConnections;
|
|
uint16_t DefaultTime2Wait;
|
|
uint16_t DefaultTime2Retain;
|
|
uint16_t ErrorRecoveryLevel;
|
|
} iscsid_get_set_target_options_t;
|
|
|
|
/*
|
|
list_kind
|
|
Which list (TARGET_LIST or SEND_TARGETS_LIST)
|
|
target_id
|
|
Is the unique ID for the target.
|
|
is_present
|
|
Contains a bitfield that indicates which members of the structure
|
|
contain valid data.
|
|
HeaderDigest
|
|
Indicates the digest to use for PDU headers.
|
|
DataDigest
|
|
Indicates the digest to use for PDU data.
|
|
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.
|
|
DefaultTime2Retain
|
|
Specifies the maximum time, in seconds, allowed to reassign a
|
|
connection after the initial wait indicated in DefaultTime2Retain
|
|
has elapsed.
|
|
ErrorRecoveryLevel
|
|
Specifies the desired error recovery level for the session.
|
|
The default and maximum is 2.
|
|
*/
|
|
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ==== GET_TARGET_OPTIONS ==== */
|
|
|
|
/*
|
|
* Request: iscsid_list_id_t
|
|
*/
|
|
|
|
/*
|
|
Response: iscsid_get_set_target_options_t, see SET_TARGET_OPTIONS.
|
|
*/
|
|
|
|
/* ==== SET_TARGET_AUTHENTICATION ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
iscsid_list_kind_t list_kind;
|
|
iscsid_sym_id_t target_id;
|
|
iscsi_auth_info_t auth_info;
|
|
uint8_t user_name[ISCSI_STRING_LENGTH];
|
|
uint8_t password[ISCSI_STRING_LENGTH];
|
|
uint8_t target_password[ISCSI_STRING_LENGTH];
|
|
} iscsid_set_target_authentication_req_t;
|
|
|
|
/*
|
|
list_kind
|
|
Which list (TARGET_LIST or SEND_TARGETS_LIST)
|
|
target_id
|
|
Is the unique ID for the target or target portal.
|
|
auth_info
|
|
Is the information about authorization types and options.
|
|
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.
|
|
*/
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ==== SLP_FIND_TARGETS ==== */
|
|
|
|
/*
|
|
Request:
|
|
The parameter contains the LDAPv3 filter string for the SLP search.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t num_portals;
|
|
uint32_t portal_id[1];
|
|
} iscsid_slp_find_targets_rsp_t;
|
|
|
|
/*
|
|
num_portals
|
|
Number of portal IDs following.
|
|
portal_id
|
|
Array of unique IDs for the discovered portals.
|
|
*/
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ==== REFRESH_TARGETS ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
iscsid_list_kind_t kind;
|
|
uint32_t num_ids;
|
|
uint32_t id[1];
|
|
} iscsid_refresh_req_t;
|
|
|
|
/*
|
|
kind
|
|
The kind of list to refresh - either SEND_TARGETS_LIST or ISNS_LIST.
|
|
num_ids
|
|
Number of IDs following. If zero, all list members are used to
|
|
refresh the target list.
|
|
id
|
|
Array of IDs to refresh.
|
|
*/
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ==== REMOVE_TARGET ==== */
|
|
|
|
/*
|
|
* Request: iscsid_list_id_t
|
|
*/
|
|
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ==== SEARCH_LIST ==== */
|
|
|
|
typedef struct {
|
|
iscsid_list_kind_t list_kind;
|
|
iscsid_search_kind_t search_kind;
|
|
uint8_t strval[ISCSI_STRING_LENGTH];
|
|
uint32_t intval;
|
|
} iscsid_search_list_req_t;
|
|
|
|
/*
|
|
list_kind
|
|
Is the list kind.
|
|
search_kind
|
|
What to search for, also defines the contents of the 'strval' and/or
|
|
'intval' fields.
|
|
strval
|
|
Is the string to look for.
|
|
intval
|
|
Is the integer value to look for.
|
|
*/
|
|
|
|
/*
|
|
* Response: iscsid_sym_id_t
|
|
*/
|
|
|
|
/* ==== GET_LIST ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
iscsid_list_kind_t list_kind;
|
|
} iscsid_get_list_req_t;
|
|
|
|
/*
|
|
list_kind
|
|
Is the list kind.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t num_entries;
|
|
uint32_t id[1];
|
|
} iscsid_get_list_rsp_t;
|
|
|
|
/*
|
|
num_entries
|
|
Number of ID entries following.
|
|
id
|
|
Array of IDs in the requested list.
|
|
*/
|
|
|
|
/* ==== GET_TARGET_INFO ==== */
|
|
|
|
/*
|
|
* Request: iscsid_list_id_t
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t target_id;
|
|
uint8_t TargetName[ISCSI_STRING_LENGTH];
|
|
uint8_t TargetAlias[ISCSI_STRING_LENGTH];
|
|
uint32_t num_portals;
|
|
uint32_t portal[1];
|
|
} iscsid_get_target_rsp_t;
|
|
|
|
/*
|
|
TargetName
|
|
The name of the target (zero terminated UTF-8 string).
|
|
TargetAlias
|
|
The alias of the target (zero terminated UTF-8 string).
|
|
num_portals
|
|
Number of portal IDs following.
|
|
portal
|
|
Array of portal IDs for this target.
|
|
*/
|
|
|
|
/* ==== GET_PORTAL_INFO ==== */
|
|
|
|
/*
|
|
* Request: iscsid_list_id_t
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t portal_id;
|
|
iscsid_sym_id_t target_id;
|
|
iscsi_portal_address_t portal;
|
|
iscsid_portal_options_t options;
|
|
} iscsid_get_portal_rsp_t;
|
|
|
|
/*
|
|
portal_id
|
|
ID and symbolic name for the portal
|
|
target_id
|
|
ID and symbolic name for the associated target
|
|
portal
|
|
Portal address
|
|
options
|
|
Portal options
|
|
*/
|
|
|
|
/* ==== ADD_ISNS_SERVER ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
uint8_t name[ISCSI_STRING_LENGTH];
|
|
uint8_t address[ISCSI_ADDRESS_LENGTH];
|
|
uint16_t port;
|
|
} iscsid_add_isns_server_req_t;
|
|
|
|
/*
|
|
name
|
|
Symbolic name (optional)
|
|
address
|
|
Address (DNS name or IP address) of the iSNS server
|
|
port
|
|
IP port number.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t server_id;
|
|
} iscsid_add_isns_server_rsp_t;
|
|
|
|
/*
|
|
server_id
|
|
Unique ID for the iSNS server.
|
|
*/
|
|
|
|
/* ==== GET_ISNS_SERVER ==== */
|
|
|
|
/*
|
|
* Request: iscsid_sym_id_t
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t server_id;
|
|
uint8_t address[ISCSI_STRING_LENGTH];
|
|
uint16_t port;
|
|
} iscsid_get_isns_server_rsp_t;
|
|
|
|
/*
|
|
server_id
|
|
ID and symbolic name for the server
|
|
address
|
|
Server address
|
|
port
|
|
IP port number.
|
|
*/
|
|
|
|
/* ==== SLP_FIND_ISNS_SERVERS ==== */
|
|
|
|
/*
|
|
Request:
|
|
The parameter may optionally contain a comma separated list of
|
|
scope names.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t num_servers;
|
|
uint32_t server_id[1];
|
|
} iscsid_find_isns_rsp_t;
|
|
|
|
/*
|
|
num_servers
|
|
Number of iSNS server IDs following.
|
|
server_id
|
|
Array of server IDs.
|
|
*/
|
|
|
|
/* ==== REMOVE_ISNS_SERVER ==== */
|
|
|
|
/*
|
|
* Request: iscsid_sym_id_t
|
|
*/
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ==== ADD_INITIATOR_PORTAL ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
uint8_t name[ISCSI_STRING_LENGTH];
|
|
uint8_t address[ISCSI_ADDRESS_LENGTH];
|
|
} iscsid_add_initiator_req_t;
|
|
|
|
/*
|
|
name
|
|
Symbolic name for this entry. Optional.
|
|
address
|
|
Interface address to add. Required.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t portal_id;
|
|
} iscsid_add_initiator_rsp_t;
|
|
|
|
/*
|
|
id
|
|
Unique ID for the portal.
|
|
*/
|
|
|
|
/* ==== GET_INITIATOR_PORTAL ==== */
|
|
|
|
/*
|
|
* Request: iscsid_sym_id_t
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t portal_id;
|
|
uint8_t address[ISCSI_ADDRESS_LENGTH];
|
|
} iscsid_get_initiator_rsp_t;
|
|
|
|
/*
|
|
portal_id
|
|
numeric and symbolic ID
|
|
address
|
|
Portal address.
|
|
*/
|
|
|
|
/* ==== REMOVE_INITIATOR_PORTAL ==== */
|
|
|
|
/*
|
|
* Request: iscsid_sym_id_t
|
|
*/
|
|
/*
|
|
Response: status only.
|
|
*/
|
|
|
|
/* ==== LOGIN ==== */
|
|
|
|
/* Request */
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t initiator_id;
|
|
iscsid_sym_id_t session_id;
|
|
iscsid_sym_id_t portal_id;
|
|
uint8_t sym_name[ISCSI_STRING_LENGTH];
|
|
iscsi_login_session_type_t login_type;
|
|
} iscsid_login_req_t;
|
|
|
|
/*
|
|
initiator_id
|
|
Contains the initiator portal ID. When 0, the initiator portal
|
|
is selected automatically.
|
|
session_id
|
|
Contains the session ID for this connection. Must be 0 for login, a valid
|
|
session ID for add_connection.
|
|
portal_id
|
|
Contains the target portal ID to connect to.
|
|
sym_name
|
|
Optional unique non-numeric symbolic session (or connection) name.
|
|
login_type
|
|
Contains an enumerator value of type LOGINSESSIONTYPE that
|
|
indicates the type of logon session (discovery, non-mapped, or
|
|
mapped).
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t session_id;
|
|
iscsid_sym_id_t connection_id;
|
|
} iscsid_login_rsp_t;
|
|
|
|
/*
|
|
session_id
|
|
Receives an integer that identifies the session.
|
|
connection_id
|
|
Receives an integer that identifies the connection.
|
|
*/
|
|
|
|
/* ==== ADD_CONNECTION ==== */
|
|
|
|
/*
|
|
Request and Response: see LOGIN.
|
|
*/
|
|
|
|
/* ==== LOGOUT ==== */
|
|
|
|
/*
|
|
* Request: iscsid_sym_id_t
|
|
*/
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
|
|
/* ==== REMOVE_CONNECTION ==== */
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t session_id;
|
|
iscsid_sym_id_t connection_id;
|
|
} iscsid_remove_connection_req_t;
|
|
|
|
/*
|
|
session_id
|
|
Contains an integer that identifies the session.
|
|
connection_id
|
|
Identifies the connection to remove.
|
|
*/
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ==== GET_SESSION_LIST ==== */
|
|
|
|
/*
|
|
Request: No parameter.
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t session_id;
|
|
uint32_t first_connection_id;
|
|
uint32_t num_connections;
|
|
uint32_t portal_id;
|
|
uint32_t initiator_id;
|
|
} iscsid_session_list_entry_t;
|
|
|
|
|
|
/*
|
|
session_id
|
|
Contains the session identifier.
|
|
first_connection_id
|
|
Contains the connection identifier for the first connection.
|
|
num_connections
|
|
The number of active connections in this session.
|
|
portal_id
|
|
Target portal ID.
|
|
initiator_id
|
|
Index of the initiator portal. May be zero.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t num_entries;
|
|
iscsid_session_list_entry_t session[1];
|
|
} iscsid_get_session_list_rsp_t;
|
|
|
|
/*
|
|
num_entries
|
|
The number of entries following.
|
|
session
|
|
The list entries (see above)
|
|
*/
|
|
|
|
|
|
/* ==== GET_CONNECTION_LIST ==== */
|
|
|
|
/*
|
|
* Request: iscsid_sym_id_t - session ID
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t connection_id;
|
|
iscsid_sym_id_t target_portal_id;
|
|
iscsi_portal_address_t target_portal;
|
|
} iscsid_connection_list_entry_t;
|
|
|
|
/*
|
|
connection_id
|
|
Connection ID.
|
|
target_portal_id
|
|
Target portal ID.
|
|
target_portal
|
|
Portal addresses of the target.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint32_t num_connections;
|
|
iscsid_connection_list_entry_t connection[1];
|
|
} iscsid_get_connection_list_rsp_t;
|
|
|
|
/*
|
|
num_connections
|
|
The number of connection descriptors following.
|
|
connection
|
|
The list entries (see above).
|
|
*/
|
|
|
|
|
|
/* ==== GET_CONNECTION_INFO ==== */
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t session_id;
|
|
iscsid_sym_id_t connection_id;
|
|
} iscsid_get_connection_info_req_t;
|
|
|
|
/*
|
|
session_id
|
|
Contains an integer that identifies the session.
|
|
connection_id
|
|
Identifies the connection to retrieve.
|
|
*/
|
|
|
|
typedef struct {
|
|
iscsid_sym_id_t session_id;
|
|
iscsid_sym_id_t connection_id;
|
|
iscsid_sym_id_t initiator_id;
|
|
iscsid_sym_id_t target_portal_id;
|
|
uint8_t initiator_address[ISCSI_ADDRESS_LENGTH];
|
|
uint8_t TargetName[ISCSI_STRING_LENGTH];
|
|
uint8_t TargetAlias[ISCSI_STRING_LENGTH];
|
|
iscsi_portal_address_t target_portal;
|
|
} iscsid_get_connection_info_rsp_t;
|
|
|
|
/*
|
|
session_id
|
|
Reflects session ID
|
|
connection_id
|
|
Reflects connection ID
|
|
initiator_id
|
|
Initiator portal ID. May be empty.
|
|
target_portal_id
|
|
Target portal ID.
|
|
initiator_address
|
|
Portal addresses of the initiator. May be empty if no initiators defined.
|
|
TargetName
|
|
The name of the target (zero terminated UTF-8 string).
|
|
TargetAlias
|
|
The alias of the target (zero terminated UTF-8 string).
|
|
target_portal
|
|
Portal addresses of the target.
|
|
*/
|
|
|
|
/* ===== set_node_name ===== */
|
|
|
|
typedef struct {
|
|
uint8_t InitiatorName[ISCSI_STRING_LENGTH];
|
|
uint8_t InitiatorAlias[ISCSI_STRING_LENGTH];
|
|
uint8_t ISID[6];
|
|
} iscsid_set_node_name_req_t;
|
|
|
|
/*
|
|
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.
|
|
*/
|
|
/*
|
|
Response: Status only.
|
|
*/
|
|
|
|
/* ===== get_version ===== */
|
|
|
|
/*
|
|
Request: No parameter.
|
|
*/
|
|
|
|
typedef struct {
|
|
uint16_t interface_version;
|
|
uint16_t major;
|
|
uint16_t minor;
|
|
uint8_t version_string[ISCSI_STRING_LENGTH];
|
|
uint16_t driver_interface_version;
|
|
uint16_t driver_major;
|
|
uint16_t driver_minor;
|
|
uint8_t driver_version_string[ISCSI_STRING_LENGTH];
|
|
} iscsid_get_version_rsp_t;
|
|
|
|
/*
|
|
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).
|
|
driver_xxx
|
|
Corresponding version information for driver.
|
|
*/
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* !_ISCSID_H_ */
|