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, 389 insertions, 0 deletions
diff --git a/static/freebsd/man4/sym.4 3.html b/static/freebsd/man4/sym.4 3.html new file mode 100644 index 00000000..d673ed29 --- /dev/null +++ b/static/freebsd/man4/sym.4 3.html @@ -0,0 +1,389 @@ +<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> |