__ __ __ __ _____ _ _ _____ _ _ _ | \/ | \ \ / / | __ \ (_) | | / ____| | | | | | \ / |_ __\ V / | |__) | __ ___ ____ _| |_ ___ | (___ | |__ ___| | | | |\/| | '__|> < | ___/ '__| \ \ / / _` | __/ _ \ \___ \| '_ \ / _ \ | | | | | | |_ / . \ | | | | | |\ V / (_| | || __/ ____) | | | | __/ | | |_| |_|_(_)_/ \_\ |_| |_| |_| \_/ \__,_|\__\___| |_____/|_| |_|\___V 2.1 if you need WebShell for Seo everyday contact me on Telegram Telegram Address : @jackleetFor_More_Tools:
<!DOCTYPE html>
<html lang="en" data-content_root="../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Chelsio S3 iSCSI Driver for Linux — The Linux Kernel documentation</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/alabaster.css?v=3918102e" />
<script src="../_static/documentation_options.js?v=5929fcd5"></script>
<script src="../_static/doctools.js?v=9bcbadda"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="dc395x SCSI driver" href="dc395x.html" />
<link rel="prev" title="BusLogic MultiMaster and FlashPoint SCSI Driver for Linux" href="BusLogic.html" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
</head><body>
<div class="document">
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/logo.svg" alt="Logo of The Linux Kernel"/>
</a></p>
<h1 class="logo"><a href="../index.html">The Linux Kernel</a></h1>
<p class="blurb">6.18.50</p>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
<p>
<h3 class="kernel-toc-contents">Contents</h3>
<input type="checkbox" class="kernel-toc-toggle" id = "kernel-toc-toggle" checked>
<label class="kernel-toc-title" for="kernel-toc-toggle"></label>
<div class="kerneltoc" id="kerneltoc">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../process/development-process.html">Development process</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/submitting-patches.html">Submitting patches</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/code-of-conduct.html">Code of conduct</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintainer/index.html">Maintainer handbook</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/index.html">All development-process docs</a></li>
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../core-api/index.html">Core API</a></li>
<li class="toctree-l1"><a class="reference internal" href="../driver-api/index.html">Driver APIs</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../subsystem-apis.html">Subsystems</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#core-subsystems">Core subsystems</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#human-interfaces">Human interfaces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#networking-interfaces">Networking interfaces</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../subsystem-apis.html#storage-interfaces">Storage interfaces</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../filesystems/index.html">Filesystems in the Linux kernel</a></li>
<li class="toctree-l3"><a class="reference internal" href="../block/index.html">Block</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cdrom/index.html">CD-ROM</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="index.html">SCSI Subsystem</a></li>
<li class="toctree-l3"><a class="reference internal" href="../target/index.html">TCM Virtual Device</a></li>
<li class="toctree-l3"><a class="reference internal" href="../nvme/index.html">NVMe Subsystem</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#other-subsystems">Other subsystems</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../locking/index.html">Locking</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../process/license-rules.html">Licensing rules</a></li>
<li class="toctree-l1"><a class="reference internal" href="../doc-guide/index.html">Writing documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev-tools/index.html">Development tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev-tools/testing-overview.html">Testing guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../kernel-hacking/index.html">Hacking guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../trace/index.html">Tracing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../fault-injection/index.html">Fault injection</a></li>
<li class="toctree-l1"><a class="reference internal" href="../livepatch/index.html">Livepatching</a></li>
<li class="toctree-l1"><a class="reference internal" href="../rust/index.html">Rust</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../admin-guide/index.html">Administration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../kbuild/index.html">Build system</a></li>
<li class="toctree-l1"><a class="reference internal" href="../admin-guide/reporting-issues.html">Reporting issues</a></li>
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">Userspace tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../userspace-api/index.html">Userspace API</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../firmware-guide/index.html">Firmware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../devicetree/index.html">Firmware and Devicetree</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../arch/index.html">CPU architectures</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../staging/index.html">Unsorted documentation</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../translations/index.html">Translations</a></li>
</ul>
</div>
<script type="text/javascript"> <!--
var sbar = document.getElementsByClassName("sphinxsidebar")[0];
let currents = document.getElementsByClassName("current")
if (currents.length) {
sbar.scrollTop = currents[currents.length - 1].offsetTop;
}
--> </script>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/scsi/cxgb3i.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="chelsio-s3-iscsi-driver-for-linux">
<h1>Chelsio S3 iSCSI Driver for Linux<a class="headerlink" href="#chelsio-s3-iscsi-driver-for-linux" title="Link to this heading">¶</a></h1>
<section id="introduction">
<h2>Introduction<a class="headerlink" href="#introduction" title="Link to this heading">¶</a></h2>
<p>The Chelsio T3 ASIC based Adapters (S310, S320, S302, S304, Mezz cards, etc.
series of products) support iSCSI acceleration and iSCSI Direct Data Placement
(DDP) where the hardware handles the expensive byte touching operations, such
as CRC computation and verification, and direct DMA to the final host memory
destination:</p>
<blockquote>
<div><ul>
<li><p>iSCSI PDU digest generation and verification</p>
<p>On transmitting, Chelsio S3 h/w computes and inserts the Header and
Data digest into the PDUs.
On receiving, Chelsio S3 h/w computes and verifies the Header and
Data digest of the PDUs.</p>
</li>
<li><p>Direct Data Placement (DDP)</p>
<p>S3 h/w can directly place the iSCSI Data-In or Data-Out PDU’s
payload into pre-posted final destination host-memory buffers based
on the Initiator Task Tag (ITT) in Data-In or Target Task Tag (TTT)
in Data-Out PDUs.</p>
</li>
<li><p>PDU Transmit and Recovery</p>
<p>On transmitting, S3 h/w accepts the complete PDU (header + data)
from the host driver, computes and inserts the digests, decomposes
the PDU into multiple TCP segments if necessary, and transmit all
the TCP segments onto the wire. It handles TCP retransmission if
needed.</p>
<p>On receiving, S3 h/w recovers the iSCSI PDU by reassembling TCP
segments, separating the header and data, calculating and verifying
the digests, then forwarding the header to the host. The payload data,
if possible, will be directly placed into the pre-posted host DDP
buffer. Otherwise, the payload data will be sent to the host too.</p>
</li>
</ul>
</div></blockquote>
<p>The cxgb3i driver interfaces with open-iscsi initiator and provides the iSCSI
acceleration through Chelsio hardware wherever applicable.</p>
</section>
<section id="using-the-cxgb3i-driver">
<h2>Using the cxgb3i Driver<a class="headerlink" href="#using-the-cxgb3i-driver" title="Link to this heading">¶</a></h2>
<p>The following steps need to be taken to accelerates the open-iscsi initiator:</p>
<ol class="arabic">
<li><p>Load the cxgb3i driver: “modprobe cxgb3i”</p>
<p>The cxgb3i module registers a new transport class “cxgb3i” with open-iscsi.</p>
<ul>
<li><p>in the case of recompiling the kernel, the cxgb3i selection is located at:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Device Drivers
SCSI device support --->
[*] SCSI low-level drivers --->
<M> Chelsio S3xx iSCSI support
</pre></div>
</div>
</li>
</ul>
</li>
<li><p>Create an interface file located under /etc/iscsi/ifaces/ for the new
transport class “cxgb3i”.</p>
<p>The content of the file should be in the following format:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>iface.transport_name = cxgb3i
iface.net_ifacename = <ethX>
iface.ipaddress = <iscsi ip address>
</pre></div>
</div>
<ul class="simple">
<li><p>if iface.ipaddress is specified, <iscsi ip address> needs to be either the
same as the ethX’s ip address or an address on the same subnet. Make
sure the ip address is unique in the network.</p></li>
</ul>
</li>
<li><p>edit /etc/iscsi/iscsid.conf
The default setting for MaxRecvDataSegmentLength (131072) is too big;
replace with a value no bigger than 15360 (for example 8192):</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>node.conn[0].iscsi.MaxRecvDataSegmentLength = 8192
</pre></div>
</div>
<ul class="simple">
<li><p>The login would fail for a normal session if MaxRecvDataSegmentLength is
too big. A error message in the format of
“cxgb3i: ERR! MaxRecvSegmentLength <X> too big. Need to be <= <Y>.”
would be logged to dmesg.</p></li>
</ul>
</li>
<li><p>To direct open-iscsi traffic to go through cxgb3i’s accelerated path,
“-I <iface file name>” option needs to be specified with most of the
iscsiadm command. <iface file name> is the transport interface file created
in step 2.</p></li>
</ol>
</section>
</section>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
©The kernel development community.
|
Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.1.3</a>
& <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
|
<a href="../_sources/scsi/cxgb3i.rst.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| scsi_transport_srp | Folder | 0755 |
|
|
| 53c700.html | File | 14.24 KB | 0644 |
|
| BusLogic.html | File | 40.51 KB | 0644 |
|
| FlashPoint.html | File | 17.51 KB | 0644 |
|
| NinjaSCSI.html | File | 14.65 KB | 0644 |
|
| aacraid.html | File | 24.06 KB | 0644 |
|
| advansys.html | File | 22.78 KB | 0644 |
|
| aha152x.html | File | 17.97 KB | 0644 |
|
| aic79xx.html | File | 39.05 KB | 0644 |
|
| aic7xxx.html | File | 39.95 KB | 0644 |
|
| arcmsr_spec.html | File | 47.74 KB | 0644 |
|
| bfa.html | File | 13.08 KB | 0644 |
|
| bnx2fc.html | File | 11.76 KB | 0644 |
|
| cxgb3i.html | File | 12.03 KB | 0644 |
|
| dc395x.html | File | 13.48 KB | 0644 |
|
| dpti.html | File | 12.29 KB | 0644 |
|
| g_NCR5380.html | File | 12.35 KB | 0644 |
|
| hpsa.html | File | 14.53 KB | 0644 |
|
| hptiop.html | File | 19.61 KB | 0644 |
|
| index.html | File | 13.43 KB | 0644 |
|
| libsas.html | File | 27.98 KB | 0644 |
|
| link_power_management_policy.html | File | 8.92 KB | 0644 |
|
| lpfc.html | File | 11.34 KB | 0644 |
|
| megaraid.html | File | 11.93 KB | 0644 |
|
| ncr53c8xx.html | File | 115.22 KB | 0644 |
|
| ppa.html | File | 8.8 KB | 0644 |
|
| qlogicfas.html | File | 11.85 KB | 0644 |
|
| scsi-changer.html | File | 16.8 KB | 0644 |
|
| scsi-generic.html | File | 13.62 KB | 0644 |
|
| scsi-parameters.html | File | 11.93 KB | 0644 |
|
| scsi.html | File | 10.65 KB | 0644 |
|
| scsi_eh.html | File | 36.79 KB | 0644 |
|
| scsi_fc_transport.html | File | 38.88 KB | 0644 |
|
| scsi_mid_low_api.html | File | 71.01 KB | 0644 |
|
| sd-parameters.html | File | 9.52 KB | 0644 |
|
| smartpqi.html | File | 11.98 KB | 0644 |
|
| st.html | File | 41.47 KB | 0644 |
|
| sym53c500_cs.html | File | 9.4 KB | 0644 |
|
| sym53c8xx_2.html | File | 66.19 KB | 0644 |
|
| tcm_qla2xxx.html | File | 9.28 KB | 0644 |
|
| ufs.html | File | 17.85 KB | 0644 |
|
| wd719x.html | File | 9.04 KB | 0644 |
|