| ISCSI-INITIATOR(8) | System Manager's Manual | ISCSI-INITIATOR(8) | 
iscsi-initiator —
| iscsi-initiator | [ -46bcDfVv] [-aauthentication-type] [-ddigest-type] [-htarget-hostname] [-ptarget-port-number] [-ttarget-number] [-uusername] mount_point | 
iscsi-initiator utility can be used to access an
  iSCSI target, such as
  iscsi-target(8), to access
  block storage which has been exported. Information pertaining to the target is
  displayed underneath the mount point, along with the device corresponding to
  the storage which the target exports.
The various arguments are as follows:
-4-6-a
    authentication-type-b-c-d
    digest-type-D-f-h
    hostname-p
    port-number-t
    target-u
    username-V-vThe refuse(3) library is used to provide the file system features.
The mandatory parameter is the local mount point.
This iSCSI initiator presents a view of the targets underneath the mount point. Firstly, it creates a directory tree with the hostname of the target, and, in that directory, a virtual directory is created for each target name exported by the iSCSI target program. Within that virtual target directory, symbolic links exist for the hostname (for convenience), a textual representation of the IP address, the iSCSI target product name, the iSCSI target IQN, the iSCSI target vendor and version number. One other directory entry is presented in the virtual target directory, relating to the storage presented by the iSCSI target. This can be in the form of a regular file, which is also the default, a block device or a character device.
Please note that the iscsi-initiator
    utility needs the “puffs” kernel module loaded via
    modload(8) to operate.
# ./iscsi-initiator -u agc -h iscsi-target0.alistaircrooks.co.uk /mnt # ls -al /mnt/target0 total 576 drwxr-xr-x 2 agc agc 512 May 11 22:24 . drwxr-xr-x 2 agc agc 512 May 11 22:24 .. lrw-r--r-- 1 agc agc 39 May 11 22:24 hostname -> iscsi-target0.alistaircrooks.co.uk lrw-r--r-- 1 agc agc 14 May 11 22:24 ip -> 172.16.135.130 lrw-r--r-- 1 agc agc 16 May 11 22:24 product -> NetBSD iSCSI -rw-r--r-- 1 agc agc 104857600 May 11 22:24 storage lrw-r--r-- 1 agc agc 43 May 11 22:24 targetname -> iqn.1994-04.org.netbsd.iscsi-target:target0 lrw-r--r-- 1 agc agc 8 May 11 22:24 vendor -> NetBSD lrw-r--r-- 1 agc agc 4 May 11 22:24 version -> 0 #
iscsi-initiator utility first appeared in
  NetBSD 6.0. An earlier version called iscsifs was
  available in NetBSD 5.0 in source format only.
iscsi-initiator utility was written by
  Alistair Crooks ⟨agc@NetBSD.org⟩.
iscsi-initiator currently only supports a CHAP challenge
  length of 16 octets. Other initiators support up to 1024 and thus it is
  expected that most targets will also support such lengths. This means that
  CHAP compatibility with other targets apart from
  iscsi-target(8) is likely
  to be poor. To workaround this, please use authentication type none by not
  specifying a username with the -u option.
| February 22, 2011 | NetBSD 9.4 |