<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>Transport classes</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="SCSI Interfaces Guide" /><link rel="up" href="ch03.html" title="Chapter 3. SCSI mid layer" /><link rel="prev" href="re103.html" title="scsi_print_status" /><link rel="next" href="re104.html" title="fc_get_event_number" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Transport classes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re103.html">Prev</a> </td><th width="60%" align="center">Chapter 3. SCSI mid layer</th><td width="20%" align="right"> <a accesskey="n" href="re104.html">Next</a></td></tr></table><hr /></div><div class="sect1" title="Transport classes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Transport_classes"></a>Transport classes</h2></div></div></div><div class="toc"><dl><dt><span class="sect2"><a href="ch03s02.html#Fibre_Channel_transport">Fibre Channel transport</a></span></dt><dt><span class="sect2"><a href="ch03s02.html#iSCSI_transport">iSCSI transport class</a></span></dt><dt><span class="sect2"><a href="ch03s02.html#SAS_transport">Serial Attached SCSI (SAS) transport class</a></span></dt><dt><span class="sect2"><a href="ch03s02.html#SATA_transport">SATA transport class</a></span></dt><dt><span class="sect2"><a href="ch03s02.html#SPI_transport">Parallel SCSI (SPI) transport class</a></span></dt><dt><span class="sect2"><a href="ch03s02.html#SRP_transport">SCSI RDMA (SRP) transport class</a></span></dt></dl></div><p>
Transport classes are service libraries for drivers in the SCSI
lower layer, which expose transport attributes in sysfs.
</p><div class="sect2" title="Fibre Channel transport"><div class="titlepage"><div><div><h3 class="title"><a id="Fibre_Channel_transport"></a>Fibre Channel transport</h3></div></div></div><div class="toc"><dl><dt><span class="refentrytitle"><a href="re104.html"><span>fc_get_event_number</span></a></span><span class="refpurpose"> —
Obtain the next sequential FC event number
</span></dt><dt><span class="refentrytitle"><a href="re105.html"><span>fc_host_post_event</span></a></span><span class="refpurpose"> —
called to post an even on an fc_host.
</span></dt><dt><span class="refentrytitle"><a href="re106.html"><span>fc_host_post_vendor_event</span></a></span><span class="refpurpose"> —
called to post a vendor unique event on an fc_host
</span></dt><dt><span class="refentrytitle"><a href="re107.html"><span>fc_remove_host</span></a></span><span class="refpurpose"> —
called to terminate any fc_transport-related elements for a scsi host.
</span></dt><dt><span class="refentrytitle"><a href="re108.html"><span>fc_remote_port_add</span></a></span><span class="refpurpose"> —
notify fc transport of the existence of a remote FC port.
</span></dt><dt><span class="refentrytitle"><a href="re109.html"><span>fc_remote_port_delete</span></a></span><span class="refpurpose"> —
notifies the fc transport that a remote port is no longer in existence.
</span></dt><dt><span class="refentrytitle"><a href="re110.html"><span>fc_remote_port_rolechg</span></a></span><span class="refpurpose"> —
notifies the fc transport that the roles on a remote may have changed.
</span></dt><dt><span class="refentrytitle"><a href="re111.html"><span>fc_block_scsi_eh</span></a></span><span class="refpurpose"> —
Block SCSI eh thread for blocked fc_rport
</span></dt><dt><span class="refentrytitle"><a href="re112.html"><span>fc_vport_create</span></a></span><span class="refpurpose"> —
Admin App or LLDD requests creation of a vport
</span></dt><dt><span class="refentrytitle"><a href="re113.html"><span>fc_vport_terminate</span></a></span><span class="refpurpose"> —
Admin App or LLDD requests termination of a vport
</span></dt></dl></div><p>
The file drivers/scsi/scsi_transport_fc.c defines transport attributes
for Fibre Channel.
</p></div><div class="sect2" title="iSCSI transport class"><div class="titlepage"><div><div><h3 class="title"><a id="iSCSI_transport"></a>iSCSI transport class</h3></div></div></div><div class="toc"><dl><dt><span class="refentrytitle"><a href="re114.html"><span>iscsi_scan_finished</span></a></span><span class="refpurpose"> —
helper to report when running scans are done
</span></dt><dt><span class="refentrytitle"><a href="re115.html"><span>iscsi_unblock_session</span></a></span><span class="refpurpose"> —
set a session as logged in and start IO.
</span></dt><dt><span class="refentrytitle"><a href="re116.html"><span>iscsi_create_session</span></a></span><span class="refpurpose"> —
create iscsi class session
</span></dt><dt><span class="refentrytitle"><a href="re117.html"><span>iscsi_destroy_session</span></a></span><span class="refpurpose"> —
destroy iscsi session
</span></dt><dt><span class="refentrytitle"><a href="re118.html"><span>iscsi_create_conn</span></a></span><span class="refpurpose"> —
create iscsi class connection
</span></dt><dt><span class="refentrytitle"><a href="re119.html"><span>iscsi_destroy_conn</span></a></span><span class="refpurpose"> —
destroy iscsi class connection
</span></dt><dt><span class="refentrytitle"><a href="re120.html"><span>iscsi_session_event</span></a></span><span class="refpurpose"> —
send session destr. completion event
</span></dt></dl></div><p>
The file drivers/scsi/scsi_transport_iscsi.c defines transport
attributes for the iSCSI class, which sends SCSI packets over TCP/IP
connections.
</p></div><div class="sect2" title="Serial Attached SCSI (SAS) transport class"><div class="titlepage"><div><div><h3 class="title"><a id="SAS_transport"></a>Serial Attached SCSI (SAS) transport class</h3></div></div></div><div class="toc"><dl><dt><span class="refentrytitle"><a href="re121.html"><span>sas_remove_children</span></a></span><span class="refpurpose"> —
tear down a devices SAS data structures
</span></dt><dt><span class="refentrytitle"><a href="re122.html"><span>sas_remove_host</span></a></span><span class="refpurpose"> —
tear down a Scsi_Host's SAS data structures
</span></dt><dt><span class="refentrytitle"><a href="re123.html"><span>sas_tlr_supported</span></a></span><span class="refpurpose"> —
checking TLR bit in vpd 0x90
</span></dt><dt><span class="refentrytitle"><a href="re124.html"><span>sas_disable_tlr</span></a></span><span class="refpurpose"> —
setting TLR flags
</span></dt><dt><span class="refentrytitle"><a href="re125.html"><span>sas_enable_tlr</span></a></span><span class="refpurpose"> —
setting TLR flags
</span></dt><dt><span class="refentrytitle"><a href="re126.html"><span>sas_phy_alloc</span></a></span><span class="refpurpose"> —
allocates and initialize a SAS PHY structure
</span></dt><dt><span class="refentrytitle"><a href="re127.html"><span>sas_phy_add</span></a></span><span class="refpurpose"> —
add a SAS PHY to the device hierarchy
</span></dt><dt><span class="refentrytitle"><a href="re128.html"><span>sas_phy_free</span></a></span><span class="refpurpose"> —
free a SAS PHY
</span></dt><dt><span class="refentrytitle"><a href="re129.html"><span>sas_phy_delete</span></a></span><span class="refpurpose"> —
remove SAS PHY
</span></dt><dt><span class="refentrytitle"><a href="re130.html"><span>scsi_is_sas_phy</span></a></span><span class="refpurpose"> —
check if a struct device represents a SAS PHY
</span></dt><dt><span class="refentrytitle"><a href="re131.html"><span>sas_port_add</span></a></span><span class="refpurpose"> —
add a SAS port to the device hierarchy
</span></dt><dt><span class="refentrytitle"><a href="re132.html"><span>sas_port_free</span></a></span><span class="refpurpose"> —
free a SAS PORT
</span></dt><dt><span class="refentrytitle"><a href="re133.html"><span>sas_port_delete</span></a></span><span class="refpurpose"> —
remove SAS PORT
</span></dt><dt><span class="refentrytitle"><a href="re134.html"><span>scsi_is_sas_port</span></a></span><span class="refpurpose"> —
check if a struct device represents a SAS port
</span></dt><dt><span class="refentrytitle"><a href="re135.html"><span>sas_port_add_phy</span></a></span><span class="refpurpose"> —
add another phy to a port to form a wide port
</span></dt><dt><span class="refentrytitle"><a href="re136.html"><span>sas_port_delete_phy</span></a></span><span class="refpurpose"> —
remove a phy from a port or wide port
</span></dt><dt><span class="refentrytitle"><a href="re137.html"><span>sas_end_device_alloc</span></a></span><span class="refpurpose"> —
allocate an rphy for an end device
</span></dt><dt><span class="refentrytitle"><a href="re138.html"><span>sas_expander_alloc</span></a></span><span class="refpurpose"> —
allocate an rphy for an end device
</span></dt><dt><span class="refentrytitle"><a href="re139.html"><span>sas_rphy_add</span></a></span><span class="refpurpose"> —
add a SAS remote PHY to the device hierarchy
</span></dt><dt><span class="refentrytitle"><a href="re140.html"><span>sas_rphy_free</span></a></span><span class="refpurpose"> —
free a SAS remote PHY
</span></dt><dt><span class="refentrytitle"><a href="re141.html"><span>sas_rphy_delete</span></a></span><span class="refpurpose"> —
remove and free SAS remote PHY
</span></dt><dt><span class="refentrytitle"><a href="re142.html"><span>sas_rphy_remove</span></a></span><span class="refpurpose"> —
remove SAS remote PHY
</span></dt><dt><span class="refentrytitle"><a href="re143.html"><span>scsi_is_sas_rphy</span></a></span><span class="refpurpose"> —
check if a struct device represents a SAS remote PHY
</span></dt><dt><span class="refentrytitle"><a href="re144.html"><span>sas_attach_transport</span></a></span><span class="refpurpose"> —
instantiate SAS transport template
</span></dt><dt><span class="refentrytitle"><a href="re145.html"><span>sas_release_transport</span></a></span><span class="refpurpose"> —
release SAS transport template instance
</span></dt></dl></div><p>
The file drivers/scsi/scsi_transport_sas.c defines transport
attributes for Serial Attached SCSI, a variant of SATA aimed at
large high-end systems.
</p><p>
The SAS transport class contains common code to deal with SAS HBAs,
an aproximated representation of SAS topologies in the driver model,
and various sysfs attributes to expose these topologies and management
interfaces to userspace.
</p><p>
In addition to the basic SCSI core objects this transport class
introduces two additional intermediate objects: The SAS PHY
as represented by struct sas_phy defines an "outgoing" PHY on
a SAS HBA or Expander, and the SAS remote PHY represented by
struct sas_rphy defines an "incoming" PHY on a SAS Expander or
end device. Note that this is purely a software concept, the
underlying hardware for a PHY and a remote PHY is the exactly
the same.
</p><p>
There is no concept of a SAS port in this code, users can see
what PHYs form a wide port based on the port_identifier attribute,
which is the same for all PHYs in a port.
</p></div><div class="sect2" title="SATA transport class"><div class="titlepage"><div><div><h3 class="title"><a id="SATA_transport"></a>SATA transport class</h3></div></div></div><p>
The SATA transport is handled by libata, which has its own book of
documentation in this directory.
</p></div><div class="sect2" title="Parallel SCSI (SPI) transport class"><div class="titlepage"><div><div><h3 class="title"><a id="SPI_transport"></a>Parallel SCSI (SPI) transport class</h3></div></div></div><div class="toc"><dl><dt><span class="refentrytitle"><a href="re146.html"><span>spi_schedule_dv_device</span></a></span><span class="refpurpose"> —
schedule domain validation to occur on the device
</span></dt><dt><span class="refentrytitle"><a href="re147.html"><span>spi_display_xfer_agreement</span></a></span><span class="refpurpose"> —
Print the current target transfer agreement
</span></dt></dl></div><p>
The file drivers/scsi/scsi_transport_spi.c defines transport
attributes for traditional (fast/wide/ultra) SCSI busses.
</p></div><div class="sect2" title="SCSI RDMA (SRP) transport class"><div class="titlepage"><div><div><h3 class="title"><a id="SRP_transport"></a>SCSI RDMA (SRP) transport class</h3></div></div></div><div class="toc"><dl><dt><span class="refentrytitle"><a href="re148.html"><span>srp_rport_add</span></a></span><span class="refpurpose"> —
add a SRP remote port to the device hierarchy
</span></dt><dt><span class="refentrytitle"><a href="re149.html"><span>srp_rport_del</span></a></span><span class="refpurpose"> —
remove a SRP remote port
</span></dt><dt><span class="refentrytitle"><a href="re150.html"><span>srp_remove_host</span></a></span><span class="refpurpose"> —
tear down a Scsi_Host's SRP data structures
</span></dt><dt><span class="refentrytitle"><a href="re151.html"><span>srp_attach_transport</span></a></span><span class="refpurpose"> —
instantiate SRP transport template
</span></dt><dt><span class="refentrytitle"><a href="re152.html"><span>srp_release_transport</span></a></span><span class="refpurpose"> —
release SRP transport template instance
</span></dt></dl></div><p>
The file drivers/scsi/scsi_transport_srp.c defines transport
attributes for SCSI over Remote Direct Memory Access.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re103.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re104.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>scsi_print_status</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>fc_get_event_number</span></td></tr></table></div></body></html>
