Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
ISCSI.CONF(5)             FreeBSD 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.

FreeBSD 11.0-PRERELEASE          June 5, 2007          FreeBSD 11.0-PRERELEASE

NAME | DESCRIPTION | FILES | EXAMPLES | ERRORS | SEE ALSO | STANDARDS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=iscsi.conf&sektion=5&manpath=FreeBSD+7.0-RELEASE>

home | help