diff options
Diffstat (limited to 'static/freebsd/man4/sym.4 3.html')
| -rw-r--r-- | static/freebsd/man4/sym.4 3.html | 389 |
1 files changed, 0 insertions, 389 deletions
diff --git a/static/freebsd/man4/sym.4 3.html b/static/freebsd/man4/sym.4 3.html deleted file mode 100644 index d673ed29..00000000 --- a/static/freebsd/man4/sym.4 3.html +++ /dev/null @@ -1,389 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">SYM(4)</td> - <td class="head-vol">Device Drivers Manual</td> - <td class="head-rtitle">SYM(4)</td> - </tr> -</table> -<div class="manual-text"> -<section class="Sh"> -<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> -<p class="Pp"><code class="Nm">sym</code> — - <span class="Nd">NCR/Symbios/LSI Logic 53C8XX PCI SCSI host adapter - driver</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<p class="Pp">To compile this driver into the kernel, place the following lines - in your kernel configuration file:</p> -<div class="Bd Pp Bd-indent"><code class="Cd">device pci</code> -<br/> -<code class="Cd">device scbus</code> -<br/> -<code class="Cd">device sym</code></div> -<p class="Pp">To disable PCI parity checking (needed for broken bridges): - <br/> - <code class="Cd">options SYM_SETUP_PCI_PARITY=<boolean></code></p> -<p class="Pp">To control driver probing against HVD buses: - <br/> - <code class="Cd">options SYM_SETUP_SCSI_DIFF=<bit - combination></code></p> -<p class="Pp">Alternatively, to load the driver as a module at boot time, place - the following line in <a class="Xr">loader.conf(5)</a>:</p> -<div class="Bd Pp Bd-indent Li"> -<pre>sym_load="YES"</pre> -</div> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp">This driver provides support for the Symbios/LSI Logic 53C8XX PCI - SCSI controllers.</p> -<p class="Pp">Driver features include support for wide SCSI busses and fast10, - fast20, fast40 and fast80-dt synchronous data transfers depending on - controller capabilities. It also provides generic SCSI features such as - tagged command queueing and auto-request sense. This driver is configured by - default for a maximum of 446 outstanding commands per bus, 8 LUNs per target - and 64 tagged tasks per LUN. These numbers are not so much limited by design - as they are considered reasonable values for current SCSI technology. These - values can be increased by changing appropriate constants in driver header - files (not recommended).</p> -<p class="Pp">This driver supports the entire Symbios 53C8XX family of PCI SCSI - controllers. It also offers the advantage of architectural improvements - available only with newer chips.</p> -<p class="Pp"><code class="Nm">sym</code> notably handles phase mismatch from - SCRIPTS for the 53C896, 53C895A, and 53C1010 cores. As a result, it - guarantees that no more than 1 interrupt per IO completion is delivered to - the CPU, and that the SCRIPTS processor is never stalled waiting for CPU - attention in normal situations.</p> -<p class="Pp"><code class="Nm">sym</code> also uses LOAD/STORE SCRIPTS - instructions for chips that support it. Only the early 810, 815 and 825 NCR - chips do not support LOAD/STORE. Use of LOAD/STORE instead of MEMORY MOVE - allows SCRIPTS to access IO registers internal to the chip (no external PCI - cycles). As a result, the driver guarantees that no PCI self-mastering will - occur for chips that support LOAD/STORE.</p> -<p class="Pp">LOAD/STORE instructions are also faster than MEMORY MOVE because - they do not involve the chip DMA FIFO and are coded on 2 DWORDs instead of - 3.</p> -<p class="Pp">For the early NCR 810, 815 and 825 chips, the driver uses a - separate SCRIPTS set that uses MEMORY MOVE instructions for data movements. - This is because LOAD/STORE are not supported by these chips.</p> -<p class="Pp">HVD/LVD capable controllers (895, 895A, 896, and 897) report the - actual bus mode in the STEST4 chip IO registers. This feature allows the - driver to safely probe against bus mode and to set up the chip accordingly. - By default the driver only supports HVD for these chips. For other chips - that can support HVD but not LVD, the driver has to probe implementation - dependent registers (GPIO) in order to detect HVD bus mode. Only HVD - implementations that conform with Symbios Logic recommendations can be - detected by the driver. When the <var class="Ar">SYM_SETUP_SCSI_DIFF</var> - kernel option is assigned a value of 1, the driver will also probe against - HVD for 825a, 875, 876 and 885 chips, assuming Symbios Logic compatible - implementation of HVD.</p> -<p class="Pp">When the <var class="Ar">SYM_SETUP_PCI_PARITY</var> is assigned a - value of 0, the driver will not enable PCI parity checking for 53C8XX - devices. PCI parity checking should not be an option for PCI SCSI - controllers, but some systems have been reported to fail using 53C8XX chips, - due to spurious or permanent PCI parity errors detected. This option is - supplied for convenience but it is neither recommended nor supported.</p> -<p class="Pp">This driver offers other options that are not currently exported - to the user. They are defined and documented in the - <span class="Pa">sym_conf.h</span> driver file. Changing these options is - not recommended unless absolutely necessary. Some of these options are - planned to be exported through <a class="Xr">sysctl(3)</a> or an equivalent - mechanism in a future driver releases and therefore, no compatibility is - guaranteed.</p> -<p class="Pp">At initialization, the driver tries to detect and read user - settings from controller NVRAM. The Symbios/Logic NVRAM layout and the - Tekram NVRAM layout are currently supported. If the reading of the NVRAM - succeeds, the following settings are taken into account and reported to - CAM:</p> -<table class="Bl-column"> - <tr id="Host"> - <td><a class="permalink" href="#Host"><i class="Em">Host - settings</i></a></td> - <td>Symbios</td> - <td>Tekram</td> - </tr> - <tr> - <td>SCSI parity checking</td> - <td>Y</td> - <td>N</td> - </tr> - <tr> - <td>Host SCSI ident</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>Verbose messages</td> - <td>Y</td> - <td>N</td> - </tr> - <tr> - <td>Scan targets hi-lo</td> - <td>Y</td> - <td>N</td> - </tr> - <tr> - <td>Avoid SCSI bus reset</td> - <td>Y</td> - <td>N</td> - </tr> -</table> -<table class="Bl-column"> - <tr id="Device"> - <td><a class="permalink" href="#Device"><i class="Em">Device - settings</i></a></td> - <td>Symbios</td> - <td>Tekram</td> - </tr> - <tr> - <td>Synchronous period</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>SCSI bus width</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>Queue tag enable</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>Number of tags</td> - <td>NA</td> - <td>Y</td> - </tr> - <tr> - <td>Disconnect enable</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>Scan at boot time</td> - <td>Y</td> - <td>N</td> - </tr> - <tr> - <td>Scan LUN</td> - <td>Y</td> - <td>N</td> - </tr> -</table> -<p class="Pp">Devices that are configured as disabled for 'scan' in the NVRAM - are not reported to CAM at system start-up. They can be discovered later - using the ‘<code class="Li">camcontrol rescan</code>’ - command.</p> -<p class="Pp">The table below summarizes the main features and capabilities of - the NCR/Symbios/LSI Logic 53C8XX family of PCI SCSI controllers.</p> -<table class="Bl-column"> - <tr id="Chip"> - <td><a class="permalink" href="#Chip"><i class="Em">Chip</i></a></td> - <td>Sync</td> - <td>Width</td> - <td>SRAM</td> - <td>PCI64</td> - <td>Supported</td> - </tr> - <tr> - <td>sym53c810</td> - <td>10MHz</td> - <td>8Bit</td> - <td>N</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c810a</td> - <td>10MHz</td> - <td>8Bit</td> - <td>N</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c815</td> - <td>10MHz</td> - <td>8Bit</td> - <td>N</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c825</td> - <td>10MHz</td> - <td>16Bit</td> - <td>N</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c825a</td> - <td>10MHz</td> - <td>16Bit</td> - <td>4KB</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c860</td> - <td>20MHz</td> - <td>8Bit</td> - <td>N</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c875</td> - <td>20MHz</td> - <td>16Bit</td> - <td>4KB</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c876</td> - <td>20MHz</td> - <td>16Bit</td> - <td>4KB</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c885</td> - <td>20MHz</td> - <td>16Bit</td> - <td>4KB</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c895</td> - <td>40MHz</td> - <td>16Bit</td> - <td>4KB</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c895A</td> - <td>40MHz</td> - <td>16Bit</td> - <td>8KB</td> - <td>N</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c896</td> - <td>40MHz</td> - <td>16Bit</td> - <td>8KB</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c897</td> - <td>40MHz</td> - <td>16Bit</td> - <td>8KB</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c1510D</td> - <td>40MHz</td> - <td>16Bit</td> - <td>4KB</td> - <td>Y</td> - <td>Y</td> - </tr> - <tr> - <td>sym53c1010</td> - <td>80MHz</td> - <td>16Bit</td> - <td>8KB</td> - <td>Y</td> - <td>Y</td> - </tr> -</table> -</section> -<section class="Sh"> -<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1> -<p class="Pp">The <code class="Nm">sym</code> driver provides support for the - following Symbios/LSI Logic PCI SCSI controllers:</p> -<p class="Pp"></p> -<ul class="Bl-bullet Bl-compact"> - <li>53C810</li> - <li>53C810A</li> - <li>53C815</li> - <li>53C825</li> - <li>53C825A</li> - <li>53C860</li> - <li>53C875</li> - <li>53C876</li> - <li>53C895</li> - <li>53C895A</li> - <li>53C896</li> - <li>53C897</li> - <li>53C1000</li> - <li>53C1000R</li> - <li>53C1010-33</li> - <li>53C1010-66</li> - <li>53C1510D</li> -</ul> -<p class="Pp">The SCSI controllers supported by <code class="Nm">sym</code> can - be either embedded on a motherboard, or on one of the following add-on - boards:</p> -<p class="Pp"></p> -<ul class="Bl-bullet Bl-compact"> - <li>ASUS SC-200, SC-896</li> - <li>Data Technology DTC3130 (all variants)</li> - <li>DawiControl DC2976UW</li> - <li>Diamond FirePort (all)</li> - <li>NCR cards (all)</li> - <li>Symbios cards (all)</li> - <li>Tekram DC390W, 390U, 390F, 390U2B, 390U2W, 390U3D, and 390U3W</li> - <li>Tyan S1365</li> -</ul> -</section> -<section class="Sh"> -<h1 class="Sh" id="MISC"><a class="permalink" href="#MISC">MISC</a></h1> -<p class="Pp">The DEC KZPCA-AA is a rebadged SYM8952U.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE - ALSO</a></h1> -<p class="Pp"><a class="Xr">cd(4)</a>, <a class="Xr">da(4)</a>, - <a class="Xr">sa(4)</a>, <a class="Xr">scsi(4)</a>, - <a class="Xr">camcontrol(8)</a></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1> -<p class="Pp">The <code class="Nm">sym</code> driver appeared in - <span class="Ux">FreeBSD 4.0</span>.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> -<p class="Pp">The <code class="Nm">sym</code> driver was written by - <span class="An">Gerard Roudier</span> and is derived from the Linux - sym53c8xx driver from the same author. The sym53c8xx driver is derived from - the ncr53c8xx driver, which was ported from the - <span class="Ux">FreeBSD</span> <a class="Xr">ncr(4)</a> driver to - Linux-1.2.13. The original <a class="Xr">ncr(4)</a> driver was written for - <span class="Ux">386BSD</span> and <span class="Ux">FreeBSD</span> by - <span class="An">Wolfgang Stanglmeier</span> and <span class="An">Stefan - Esser</span>.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> -<p class="Pp">No known bugs.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">December 26, 2020</td> - <td class="foot-os">FreeBSD 15.0</td> - </tr> -</table> |