ISCSI.CONF(5) MidnightBSD File Formats Manual ISCSI.CONF(5)

NAME

iscsi.conf — key options to be negotiated in an iSCSI session

DESCRIPTION

The file iscsi.conf, is read by the iscontrol(8) program. It contains declarations and parameter/key-options. The syntax is very simple,

variable = value;

and they can be grouped via a block declaration:

# this is a comment

target_1 { # nickname

variable = value;

...

} # this must be on a line by itself.

The following are specified in the iSCSI RFC 3720, for a full description see sections 11/12 of the RFC.

AuthMethod

currently only supported authentication method is CHAP, with digest either MD5 or SHA. Default is none.

HeaderDigest

a digest is calculated on the header of all iSCSI PDUs, and checked. Only CRC32C is implemented. Default is none.

DataDigest

same as for HeaderDigest, but on the data part of the iSCSI PDU.

MaxConnections

is the number of simultaneous connections per session, currently only 1.

TargetName

is the name by which the target is known, not to be confused with target address, either obtained via the target administrator, or from a discovery session.

InitiatorName

if not specified, defaults to iqn.2005-01.il.ac.huji.cs: 〈hostname〉.

TargetAlias / InitiatorAlias

not implemented.

TargetAddress

is of the form domainname[:port][,portal-group-tag] to quote the RFC:
The domainname can be specified as either a DNS host name, a dotted-decimal IPv4 address, or a bracketed IPv6 address as specified in [RFC2732].
Note: portal-group-tag is unused at the moment.

TargetPortalGroupTag

not implemented yet.

InitialR2T

not implemented yet.

ImmediateData

not implemented yet.

MaxRecvDataSegmentLength

the maximum data segment length in bytes it can receive in an iSCSI PDU, default is 8192.

MaxBurstLength

not implemented yet.

FirstBurstLength

not implemented yet.

DefaultTime2Wait

not implemented yet.

DefaultTime2Retain

not implemented yet.

MaxOutstandingR2T

is used to calculate/negotiate the tag opening, can be overriden by the tag option.

DataPDUInOrder

not implemented yet.

DataSequenceInOrder

not implemented yet.

ErrorRecoveryLevel

Only level 0 is supported.

SessionType

either Discovery or Normal, default is Normal, see the −d flag of iscontrol.

The following are not specified in the RFC 3720

port

The iSCSI port used by the iSCSI protocol, defaults to 3260.

tags

Sets the tag opening to the value specified.

maxluns

overrides the compiled value of luns, see iscsi_initiator(4). This value can only be reduced.

sockbufsize

sets the receiver and transmitter socket buffer size to size, in kilobytes. The default is 128.

If AuthMethod is set to CHAP, then the following must also be set:

chapSecret

this shared-secret. Can be either an ASCII string (e.g. hello world), a hex string (e.g 0xababcd0987654321...), or base64 string (eg 0b...)

chapIName

the chap-name, defaults to hostname.

chapDigest

can be MD5 or SHA1.

tgtChapSecret/tgtChapName

same as the none tgt counterpart, but to authenticate the target.

FILES

/etc/iscsi.conf

EXAMPLES

#
# Globals
#
port = 3260
#
myiscsi { # nickname

targetaddress

= iscsi1
targetname

= iqn.1900.com.com:sn.123456

}
chaptest {
targetaddress= 10.0.0.1;

targetname

= iqn.1900.com.com:sn.123456

initiatorname= iqn.2005-01.il.ac.huji.cs:nobody
authmethod = CHAP; chapDigest = SHA1;
chapsecret = 0x3713c3336d9a224c2791c873d3d2b174

tags

= 256

}

ERRORS

The parsing is very primitive, so do not expect - at the moment - any error messages.

SEE ALSO

iscsi_initiator(4), iscontrol(8)

STANDARDS

ISCSI RFC 3720

BUGS

Some options have not been implemented, either they were found to be unecessary, or not understood, this can change in the future.
The tags opening value is difficult to calculate, use wisely.

MidnightBSD 0.3 June 5, 2007 MidnightBSD 0.3