Introduction
-------------
Linux target framework (tgt) aims to simplify various SCSI target
driver (iSCSI, Fibre Channel, SRP, etc) creation and maintenance.

Currently, tgt supports the following target drivers:

- iSCSI software target driver for Ethernet NICs

- iSER software target driver for Infiniband and RDMA NICs

- IBM System p VIO server

- FCoE software target driver for Ethernet NICs (in progress)

- Qlogic qla2xxx FC target driver (in progress)

Tgt consists of kernel modules, user-space daemon, and user-space
tools. iSCSI, iSER, and FCoE target drivers use only user-space daemon
and tools (i.e. they are just user-space applications. They don't need
any kernel support).

tgt can emulate the following device types:

- SBC: a virtual disk drive that can use a file to store the content.

- SMC: a virtual media jukebox that can be controlled by the "mtx"
tool (partially functional).

- MMC: a virtual DVD drive that can read DVD-ROM iso files and create
burnable DVD+R. It can be combined with SMC to provide a fully
operational DVD jukebox.

- SSC: a virtual tape device (aka VTL) that can use a file to store
the content (in progress).

- OSD: a virtual object-based storage device that can use a file to
store the content (in progress).

The code is under the GNU General Public License version 2.


Preparation
-------------
Target drivers have their own ways to build, configure, etc. Please
find an appropriate documentation in the doc directory. You might find
other useful information on tgt's site:

http://stgt.sourceforge.net/


Developer Notes
-------------
The central resource for tgt development is the mailing list
(stgt@vger.kernel.org).

First, please read the following documents (in short, follow Linux
kernel development rules):

http://lxr.linux.no/source/Documentation/CodingStyle
http://lxr.linux.no/source/Documentation/SubmittingPatches

Then, check your patches with the patch style checker prior to
submission (scripts/checkpatch.pl) like the following example.

fujita@arbre:~/git/tgt$ ./scripts/checkpatch.pl ~/0001-add-bidi-support.patch
Your patch has no obvious style problems and is ready for submission.