- Docs updates
[mirror/scst/.git] / www / index.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
3 <head>\r
4 <meta name="Keywords" content="Generic SCSI Target Middle Level for Linux, SCST, SCSI Target" />\r
5 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />\r
6 <meta name="author" content="Daniel Fernandes"/>\r
7 <meta name="Robots" content="index,follow" />\r
8 <link rel="stylesheet" href="images/Orange.css" type="text/css" />      \r
9 <title>SCST: Generic SCSI Target Middle Level for Linux</title>\r
10 </head>\r
11 \r
12 <body>\r
13 <div id="wrap"> \r
14         <div id="header">       \r
15                 <div class="logoimg"></div><h1 id="logo"><span class="orange"></span></h1>\r
16                 <h2 id="slogan">SCSI Target Middle Level for Linux</h2> \r
17         </div>\r
18         <div id="menu">\r
19                 <ul>\r
20                         <li id="sponsorship"><a href="sponsorship.html">Sponsorship</a></li>
21                         <li id="current"><a href="index.html">Home</a></li>
22                         <li><a href="http://www.sourceforge.net/projects/scst">Main</a></li>\r
23                         <li><a href="targets.html">Drivers</a></li>\r
24                         <li><a href="downloads.html">Downloads</a></li>\r
25                         <li><a href="contributing.html">Contributing</a></li>\r
26                         <li><a href="scstvsstgt.html">SCST vs STGT</a></li>                     \r
27                 </ul>\r
28         </div>  \r
29         <div id="content-wrap">\r
30                         <div id="main">\r
31                                 <h1>Generic SCSI Target Middle Level for Linux</h1>
32                                                 \r
33                                 <p>The <strong>SCSI target mid-level subsystem for Linux (SCST)</strong> is an alternative
34                                         implementation of SCSI target subsystem for Linux. It provides unified,
35                                         consistent interface between SCSI target drivers and 
36                                         Linux kernel and simplifies target drivers development.
37                                         
38                                 <p>SCST allows creation of sophisticated storage devices, which  provide advanced 
39                                         functionality, like <EM>replication</EM>, <EM>thin provisioning</EM>,
40                                         <EM>deduplication</EM>, <EM>high availability</EM>, <EM>automatic backup</EM>, etc.
41                                         Another class of such devices are <EM>Virtual Tape Libraries</EM> (VTL)
42                                         as well as other disk-based backup solutions. </p>
43
44                                 <p>SCST project consists from a set of subprojects: <strong>SCST core</strong> itself
45                                         with a set of <strong>device handlers</strong> as well as <strong>target
46                                         drivers</strong> and <strong>user space utilities</strong>.
47                                 
48                                 <h1>Features of SCST Core</h1>
49                                 <ul>                                    \r
50                                         <li><span>Simple, easy to use interface with target drivers. 
51                                                                  Particularly, SCST core performs required pre- and post- processing of incoming requests as well as 
52                                                                  necessary error recovery.</span></li>\r
53                                         <li><span>Undertakes most problems, related to execution contexts, thus practically eliminating one of the most 
54                                                                  complicated problem in the kernel drivers development. For example, a target driver for QLogic 
55                                                                  22xx/23xx cards, which has all necessary features, is only about 2000 lines of code long.
56                                                                  The same is true for InfiniBand SRP target driver.</span></li>
57                                         <li><span>Very low overhead, fine-grained locks and simplest commands processing path, which allow to reach 
58                                                                  maximum possible performance and scalability. Particularly, incoming requests can be processed in 
59                                                                  the caller's context or in one of the internal SCST core's tasklets without any
60                                                                  extra context switches.</span></li>
61                                         <li><span>Device handlers, i.e. plugins, architecture provides extra flexibility by allowing various I/O 
62                                                                  modes in backstorage handling. For example, pass-through device handlers allows to use real 
63                                                                  SCSI hardware and vdisk device handler allows to use files as virtual disks.</span></li>
64                                         <li><span>Provides advanced per-initiator device visibility management (LUN masking), which allows different 
65                                                                  initiators to see different set of devices with different access permissions. For instance, 
66                                                                  initiator A could see exported from target T devices X and Y read-writable, and initiator B from 
67                                                                  the same target T could see devices Y read-only and Z read-writable.</span></li>
68                                         <li><span>Emulates necessary functionality of SCSI host adapter, because from remote initiators point of view 
69                                                                  SCST acts as a SCSI host with its own devices. This is especially important in pass-through mode with 
70                                                                  one to many relationship, i.e. when multiple initiators can connect to the exported pass-through 
71                                                                  devices. You can find more deep elaboration why it is needed in <a href=http://www.mail-archive.com/linux-scsi@vger.kernel.org/msg06911.html>this</a> 
72                                                                  message in thread "Question for pass-through target design" in linux-scsi mailing list. Some of the emulated functions are the following:
73                                                                  <ul>
74                                                                         <li><span>Generation of necessary UNIT ATTENTIONs, their storage and delivery to all connected 
75                                                                                                  remote initiators.</span></li>                                                          
76                                                                         <li><span>RESERVE/RELEASE functionality.</span></li>
77                                                                         <li><span>CA/ACA conditions (not implemented yet).</span></li>
78                                                                         <li><span>All types of RESETs and other task management functions.</span></li>
79                                                                         <li><span>REPORT LUNS command as well as SCSI address space management in order to have consistent 
80                                                                                                  address space on all remote initiators, since local SCSI devices could not know about each
81                                                                                                  other to report via REPORT LUNS command. Additionally, SCST core responds with error on all 
82                                                                                                  commands to non-existing devices and provides access control, so different remote 
83                                                                                                  initiators could see different set of devices.</span></li>
84                                                                         <li><span>Other necessary functionality (task attributes, etc.) as specified in SAM-2, SPC-2, SAM-3,
85                                                                                                  SPC-3 and other SCSI standards.</span></li>
86                                                                  </ul>
87                                                                  </span></li>
88                                         <li><span>Multithreaded design and complete SMP support, so, if necessary, all your processors will participate in the commands
89                                                                  processing.</span></li>
90                                         <li><span>Well documented.</span></li>                                                  \r
91                                 </ul>                                   
92                                 <p>Interoperability between SCST core and local SCSI initiators (i.e. sd, st, etc.) is the additional issue that SCST is going to 
93                                 address (it is not implemented yet). It is necessary, because local SCSI initiators can change the state of the 
94                                 device, for example RESERVE the device, or some of its parameters and that could be done behind SCST, which could 
95                                 lead to various problems, including data corruption. Thus, RESERVE/RELEASE commands, locally generated 
96                                 UNIT ATTENTIONs, etc. should be intercepted and processed as if local SCSI initiators act as remote SCSI 
97                                 initiators connected to SCST.</p>                               
98                                 <p>Interface between SCST core and target drivers is based on work, done by <a href="http://www.iol.unh.edu/">University
99                                  of New Hampshire Interoperability Labs (UNH IOL)</a> for the <a href="http://www.iol.unh.edu/consortiums/iscsi/index.html">
100                                  UNH-iSCSI project</a>, which was developed on <a href="http://unh-iscsi.sourceforge.net/">SourceForge.net</a>.</p>                             
101                                                                 
102                                 <h1>SCST core supports the following I/O modes</h1>
103                                 <ul>
104                                         <li><span><strong>Pass-through mode</strong> with one to many relationship, i.e. when multiple initiators can 
105                                                 connect to the exported pass-through devices, for virtually all SCSI devices types: <strong>disks (type 0), 
106                                                 tapes (type 1), processors (type 3), CDROMs (type 5), MO disks (type 7), medium changers (type 8) and RAID 
107                                                 controllers (type 0xC)</strong>.</span></li>
108                                 <li><span><strong>FILEIO mode</strong>, which allows to use files on file systems or block devices as virtual 
109                                         remotely available SCSI disks or CDROMs with benefits of the <strong>Linux page cache</strong>.</span></li>
110                                 <li><span><strong>BLOCKIO mode</strong>, which performs direct block IO with a block device, bypassing 
111                                         page-cache for all operations. This mode works ideally with high-end storage HBAs and for applications that 
112                                         either do not need caching between application and disk or need the large block throughput.</span></li>
113                                 <li><span><strong>User space mode</strong> using scst_user device handler, which allows to implement in the 
114                                         user space virtual SCSI devices in the SCST environment.</span></li>
115                                 <li><span><strong>"Performance" device handlers</strong>, which provide in pseudo pass-through mode a way for 
116                                         direct performance measurements without overhead of actual data transferring from/to underlying SCSI device.
117                                         </span></li>
118                                 </ul>                   \r
119                         </div>\r
120                         <div id="rightbar">\r
121                                 <h1>Documentation</h1>
122                                 <p><a href="scst_pg.html">HTML</a></p>
123                                 <p><a href="scst_pg.pdf">PDF</a></p>
124                                 <p><a href="iscsi-scst-howto.txt">HOWTO For iSCSI-SCST</a></p>
125                                 <p><a href="qla2x00t-howto.html">HOWTO For QLogic Target Driver</a></p>
126                                 <p><a href="scst_user_spec.txt">SCST User Interface Description</a></p>
127                                 <h1>SCST 0.9.6 graphs</h1>
128                                 <p><a href=images/init_scst.png>init_scst</a></p>
129                                 <p><a href=images/scst_cmd_thread.png>scst_cmd_thread</a></p>                           
130                                 <p><a href=images/scst_mgmt_cmd_thread.png>scst_mgmt_cmd_thread</a></p>
131                                 <p><a href=images/scst_mgmt_thread.png>scst_mgmt_thread</a></p>
132                                 <p>by Ming Zhang</p>
133                                 <h1>QUESTIONS</h1>
134                                 <p>If you have any questions you can ask them via<br><a href=https://lists.sourceforge.net/lists/listinfo/scst-devel>
135                                         scst-devel mailing list</a><br><br> 
136                                         See <a href=http://sourceforge.net/mail/?group_id=110471>mailing lists page</a> for more info about SCST mailing 
137                                         lists.</p>
138                                 <h1>SourceForge</h1>\r
139                                 <p><a href="http://sourceforge.net">
140                                         <img src="http://sourceforge.net/sflogo.php?group_id=110471&amp;type=2" alt="SourceForge.net Logo" border="0">
141                                         </a></p>                \r
142                         </div>\r
143         </div>\r
144 </div>          \r
145 <!-- footer starts here -->             \r
146                 <div id="footer">\r
147                         <p>\r
148                         &copy; Copyright 2008 <b><font color="#EC981F">Vladislav Bolkhovitin & others.</font>&nbsp;&nbsp;\r
149                         Design by: <b><font color="#EC981F">Daniel Fernandes</font></b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;         \r
150                         \r
151                         </p>            \r
152                 </div>  \r
153 <!-- footer ends here -->\r
154 </body>\r
155 </html>