diff options
Diffstat (limited to 'static/freebsd/man4/ahd.4 3.html')
| -rw-r--r-- | static/freebsd/man4/ahd.4 3.html | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/static/freebsd/man4/ahd.4 3.html b/static/freebsd/man4/ahd.4 3.html new file mode 100644 index 00000000..819cbe9b --- /dev/null +++ b/static/freebsd/man4/ahd.4 3.html @@ -0,0 +1,192 @@ +<table class="head"> + <tr> + <td class="head-ltitle">AHD(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">AHD(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">ahd</code> — <span class="Nd">Adaptec + PCI/PCI-X Ultra320 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 ahd</code> +<p class="Pp">To compile in debugging code: + <br/> + <code class="Cd">options AHD_DEBUG</code> + <br/> + <code class="Cd">options AHD_DEBUG_OPTS=<bitmask of options></code> + <br/> + <code class="Cd">options AHD_REG_PRETTY_PRINT</code></p> +</div> +<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>ahd_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 access to the SCSI bus(es) connected to + Adaptec AIC79xx host adapter chips.</p> +<p class="Pp">Driver features include support for narrow and wide busses, fast, + ultra, ultra2, ultra160, and ultra320 synchronous transfers, packetized + transfers, tagged queueing, 512 SCB's, and target mode.</p> +<p class="Pp">The <code class="Dv">AHD_DEBUG_OPTS</code> option is used to + control which diagnostic messages are printed to the console when + <code class="Dv">AHD_DEBUG</code> is enabled. Logically OR the following + bits together:</p> +<table class="Bl-column Bd-indent"> + <tr id="Value"> + <td><a class="permalink" href="#Value"><i class="Em">Value</i></a></td> + <td>Function</td> + </tr> + <tr> + <td>0x0001</td> + <td>Show miscellaneous information</td> + </tr> + <tr> + <td>0x0002</td> + <td>Show sense data</td> + </tr> + <tr> + <td>0x0004</td> + <td>Show Serial EEPROM contents</td> + </tr> + <tr> + <td>0x0008</td> + <td>Show bus termination settings</td> + </tr> + <tr> + <td>0x0010</td> + <td>Show host memory usage</td> + </tr> + <tr> + <td>0x0020</td> + <td>Show SCSI protocol messages</td> + </tr> + <tr> + <td>0x0040</td> + <td>Show mode pointer of the chip register window</td> + </tr> + <tr> + <td>0x0080</td> + <td>Show selection timeouts</td> + </tr> + <tr> + <td>0x0100</td> + <td>Show FIFO usage messages</td> + </tr> + <tr> + <td>0x0200</td> + <td>Show Queue Full status</td> + </tr> + <tr> + <td>0x0400</td> + <td>Show SCB queue status</td> + </tr> + <tr> + <td>0x0800</td> + <td>Show inbound packet information</td> + </tr> + <tr> + <td>0x1000</td> + <td>Show S/G list information</td> + </tr> + <tr> + <td>0x2000</td> + <td>Enable extra diagnostic code in the firmware</td> + </tr> +</table> +<p class="Pp">The <code class="Dv">AHD_REG_PRETTY_PRINT</code> option compiles + in support for human-readable bit definitions for each register that is + printed by the debugging code. However, it also bloats the compiled size of + the driver by approximately 215KB.</p> +<p class="Pp">Per target configuration performed in the SCSI-Select menu, + accessible at boot, is honored by this driver. This includes + synchronous/asynchronous transfers, maximum synchronous negotiation rate, + wide transfers, disconnection, and the host adapter's SCSI ID.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="CONFIGURATION_OPTIONS"><a class="permalink" href="#CONFIGURATION_OPTIONS">CONFIGURATION + OPTIONS</a></h1> +<p class="Pp">To statically configure one or more controllers to assume the + target role:</p> +<p class="Pp"><code class="Cd">options AHD_TMODE_ENABLE <bitmask of + units></code></p> +<div class="Bd Pp Bd-indent">The value assigned to this option should be a + bitmap of all units where target mode is desired. For example, a value of + 0x25, would enable target mode on units 0, 2, and 5. A value of 0x8a enables + it for units 1, 3, and 7. +<p class="Pp">Note that controllers can be dynamically configured through a + device hint documented below.</p> +<p class="Pp"></p> +</div> +</section> +<section class="Sh"> +<h1 class="Sh" id="BOOT_OPTIONS"><a class="permalink" href="#BOOT_OPTIONS">BOOT + OPTIONS</a></h1> +<p class="Pp">The following options are switchable by setting values in + <span class="Pa">/boot/device.hints</span>.</p> +<p class="Pp">They are:</p> +<dl class="Bl-tag"> + <dt id="hint.ahd."><var class="Va">hint.ahd.</var><var class="Ar">N</var><var class="Va">.tmode_enable</var></dt> + <dd>A hint to define whether the SCSI target mode is enabled (0 -- disabled, 1 + -- enabled).</dd> +</dl> +</section> +<section class="Sh"> +<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1> +<p class="Pp">The <code class="Nm">ahd</code> driver supports the following + PCI/PCI-X parallel SCSI controllers:</p> +<p class="Pp"></p> +<ul class="Bl-bullet Bl-compact"> + <li>Adaptec AIC7901 host adapter chip</li> + <li>Adaptec AIC7901A host adapter chip</li> + <li>Adaptec AIC7902 host adapter chip</li> + <li>Adaptec 29320 host adapter</li> + <li>Adaptec 39320 host adapter</li> + <li>Many motherboards with on-board SCSI support</li> +</ul> +</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">ahc(4)</a>, <a class="Xr">cd(4)</a>, + <a class="Xr">da(4)</a>, <a class="Xr">sa(4)</a>, + <a class="Xr">scsi(4)</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">ahd</code> driver first appeared in + <span class="Ux">FreeBSD 4.7</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">ahd</code> driver, the AIC7xxx sequencer-code + assembler, and the firmware running on the aic79xx chips was written by + <span class="An">Justin T. Gibbs</span>. This manual page is based on the + <a class="Xr">ahc(4)</a> manual page.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> +<p class="Pp">The current generation of 79xx chips do not support target mode in + Ultra320 mode. Target mode in general has not been well tested in this + driver.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">September 29, 2025</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |