TGTD(8) [FIXME: manual] TGTD(8)NAME
tgtd - The SCSI Target Daemon
SYNOPSIS
tgtd
tgtd [-C --control-port <INTEGER>] [-d --debug <INTEGER>] [-f --foregound] [-h --help] [--iscsi <...>]
DESCRIPTION
Tgtd is a SCSI Target daemon. It can be used to provide SCSI target service to a network. The most common service is iSCSI but other
services are also supported.
DEVICE TYPES
Tgtd provides support for both emulated and passthrough of real devices.
Tgtd can emulate the following types of devices:
disk : Normal disk device. Emulates a SCSI harddisk.
tape : Tape device. Emulates a SCSI tape drive.
cd : CD device. Emulates a SCSI DVD burner.
changer : Media changer. Emulate the changer device for a virtual tape library or DVD jukebox.
OPTIONS -d --debug <INTEGER>
Set to non-zero value to activate additional debugging messages to be logged.
-f --foreground
Run the daemon in the foreground.
-h --help
Print help text to the screen.
-C --control-port <INTEGER>
This comamnd is used to specify the control port to use for this instance of tgtd. This allows to run multiple instances of TGTD on a
host.
TGTADM has a matching argument to control which instance to connect to.
--iscsi <...>
ISCSI specific options. See the ISCSI section below for options specific to this frontend.
ISCSI OPTIONS
These parameters apply only to the iSCSI frontend.
portal=<ip-address[:port]>
This option is used to bind tgtd to a specific ip-address/portal and/or port. By default tgtd will bind to port 3260 on the wildcard
address. The ip-address part (before the ":") can be missing to designate the wildcard address with a none-default port.
Example: to bind tgtd to a specific address and port
tgtd --iscsi portal=192.0.2.1:3260
Example: to bind tgtd to any address but a none-default port
tgtd --iscsi portal=:3251
SEE ALSO tgtadm(8), tgt-admin(8), tgtimg(8), tgt-setup-lun(8). http://stgt.sourceforge.net/
COPYRIGHT /LICENSE
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, see http://www.gnu.org/licenses/.
[FIXME: source] 10/02/2010 TGTD(8)
Check Out this Related Man Page
ISCSI.CONF(5) BSD File Formats Manual ISCSI.CONF(5)NAME
iscsi.conf -- iSCSI initiator configuration file
DESCRIPTION
The file iscsi.conf, is used by the iscsictl(8) and iscontrol(8) utilities. 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. (not yet tested)
TargetName is the name by which the target is known, not to be confused with target address, either obtained via the target administra-
tor, or from a discovery session.
InitiatorName if not specified, defaults to iqn.2005-01.il.ac.huji.cs: <hostname>.
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. not implemented yet.
MaxRecvDataSegmentLength
the maximum data segment length in bytes it can receive in an iSCSI PDU, default is 8192.
MaxOutstandingR2T
is used to calculate/negotiate the tag opening, can be overridden by the tag option.
SessionType either Discovery or Normal, default is Normal, see the -d flag of iscontrol.
The following are not specified in the RFC 3720
offload Name of selected iSCSI hardware offload driver.
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.
tgtChapName/tgtChapSecret
name and secret used for mutual CHAP; by default, mutual CHAP is not used.
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
}
SEE ALSO iscsi_initiator(4), iscontrol(8), iscsictl(8)STANDARDS
ISCSI RFC 3720
BUGS
Some options have not been implemented, either they were found to be unnecessary, or not understood, this can change in the future.
The tags opening value is difficult to calculate, use wisely.
BSD February 4, 2015 BSD