tgtimg(8) [debian man page]

TGTIMG(8)																 TGTIMG(8)

NAME

       tgtimg - Linux SCSI Target Framework Image File Utility

SYNOPSIS

       tgtimg [-o --op <operation>] [-Y --device-type <device-type>] [-b --barcode <barcode>] [-s --size <size>] [-t --type <media-type>]
	      [-f --file <path>]

       tgtimg --help

DESCRIPTION

       Tgtimg is a utility to create and manage the image files used by the TGTD device emulation.

       This command is used to initialize device image files with the additional metadata, such as barcode, list of blocks, total size, etc that
       the TGTD emulation needs.

OPTIONS

       -h, --help
	   Show a help screen and exit.

       -o, --op {new|show}
	   Operation. Is either new to create a new image file or show to show the content of an existing image file.

       -Y, --device-type <type>
	   This specifies the type of image file.

	   Supported device types are :
	       cd   : to create media for a dvd device
	       disk : to create media for a disk device
	       tape : to create media for a tape device

       -t, --type <media-type>
	   When creating a new image, this specifies the type of media to emulate. The available mediatypes depend on the type of the device.

	   Supported media types for cd devices are :
	       dvd+r : create a blank writeable DVD+R disk

	   Supported media types for disk devices are :
	       disk  : create an empty disk

	   Supported media types for tape devices are :
	       data  : create a normal data tape
	       clean : create a cleaning tape
	       worm  : create a worm

       -b, --barcode <barcode>
	   When creating a new image, this argument specifies the barcode to use with this image file. Backup application software often uses
	   barcodes to identify specific tapes. When emulating a VTL, make sure that all tape images use unique barcodes.

       -s, --size <size>
	   When creating a new image, this specifies the size in megabytes for the virtual tape image.

       -f, --file <path>
	   The filename of the image file.

EXAMPLES

       To create a new 100MByte disk

		 tgtimg --op new --device-type disk --type disk --size 100 --file /data/hd001.raw

       To create a new tape image

		 tgtimg --op new --device-type tape --barcode 12345 --size 100 --type data --file /data/tape001.img

       To view the content of an existing image

		 tgtimg --op show --device-type tape --file /data/tape001.img

       To create a new blank DVD+R image

		 tgtimg --op new --device-type cd --type dvd+r --file /data/dvd001.iso

SEE ALSO

       tgtd(8), tgtadm(8), tgt-admin(8), tgt-setup-lun(8).  http://stgt.sourceforge.net/

REPORTING BUGS

       Report bugs to <stgt@vger.kernel.org>

								    04/04/2010								 TGTIMG(8)

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)