Poster of Linux kernelThe best gift for a Linux geek
TGTIMG

TGTIMG

Section: (8) Updated: 04/04/2010
Local index Up
 

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>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
REPORTING BUGS

This document was created by man2html, using the manual pages.
Time: 22:02:30 GMT, April 16, 2011