Subject: kern/4680: ncr(4) manpage doesn't mention any options
To: None <gnats-bugs@gnats.netbsd.org>
From: Dave Huang <khym@bga.com>
List: netbsd-bugs
Date: 12/13/1997 06:58:12
>Number: 4680
>Category: kern
>Synopsis: ncr(4) manpage doesn't mention any options
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: kern-bug-people (Kernel Bug People)
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Sat Dec 13 05:05:02 1997
>Last-Modified:
>Originator: Dave Huang
>Organization:
Name: Dave Huang | Mammal, mammal / their names are called /
INet: khym@bga.com | they raise a paw / the bat, the cat /
FurryMUCK: Dahan | dolphin and dog / koala bear and hog -- TMBG
Dahan: Hani G Y+C 22 Y++ L+++ W- C++ T++ A+ E+ S++ V++ F- Q+++ P+ B+ PA+ PL++
>Release: NetBSD-1.3_BETA as of December 12, 1997
>Environment:
System: NetBSD dahan.metonymy.com 1.3_BETA NetBSD 1.3_BETA (SPIFF) #168: Fri Dec 12 20:49:51 CST 1997 khym@dahan.metonymy.com:/usr/src.local/sys/arch/i386/compile/SPIFF i386
>Description:
The ncr(4) manpage doesn't mention any of the driver's options.
>How-To-Repeat:
man 4 ncr
>Fix:
Maybe someone who knows nroff can figure out how to keep the
description of SCSI_NCR_SYMBIOS_COMPAT in one piece. nroff puts a blank
line in the middle of it...
--- /usr/src/share/man/man4/ncr.4 Wed Jan 15 06:16:28 1997
+++ ncr.4 Sat Dec 13 06:34:10 1997
@@ -32,11 +32,61 @@
.Sh SYNOPSIS
.Cd "ncr* at pci? dev ? function ?"
.Cd "scsibus* at ncr?"
+.Pp
+.Cd "options FAILSAFE"
+.Cd "options NCR_CDROM_ASYNC"
+.Cd "options NCR_IOMAPPED"
+.Cd "options NCR_TEKRAM_EEPROM"
+.Cd "options SCSI_NCR_DFLT_TAGS=integer"
+.Cd "options SCSI_NCR_MAX_SYNC=integer"
+.Cd "options SCSI_NCR_MAX_WIDE=integer"
+.Cd "options SCSI_NCR_SYMBIOS_COMPAT"
+.Cd "options SCSI_NCR_TRUST_BIOS"
.Sh DESCRIPTION
The
.Nm
-driver provides support for the NCR 53C810, 53C825, 53C860, and 53C875
-SCSI controller chips.
+driver provides support for the NCR (Symbios) 53C810, 53C815, 53C820,
+53C825, 53C860, 53C875, 53C885, 53C895, and 53C896 SCSI controller chips.
+.Pp
+The following kernel configuration options are available:
+.Bl -ohang
+.It Cd options FAILSAFE
+Disables tagged command queuing and forces asynchronous transfers for
+CDROM devices.
+.It Cd options NCR_CDROM_ASYNC
+Always use asynchronous transfers with CDROM devices. By default,
+synchronous transfers are used if the CDROM supports it.
+.It Cd options NCR_IOMAPPED
+Attempt to access the controller chip via I/O port-mapped I/O, falling back
+to memory-mapped I/O if the I/O ports couldn't be mapped. By default,
+memory-mapped I/O is tried first.
+.It Cd options NCR_TEKRAM_EEPROM
+Enables support for reading the configuration EEPROM of the Tekram DC-390
+series of SCSI cards. Enable this only if using a Tekram DC-390 card.
+.It Cd options SCSI_NCR_DFLT_TAGS=integer
+Specifies the maximum number of tags per logical unit. Unless
+.Dv FAILSAFE
+is defined, the default value is 4. A value of 0 will disable tagged
+command queuing.
+.It Cd options SCSI_NCR_MAX_SYNC=integer
+Specifies the maximum synchronous transfer frequency to use, in kHz. A
+value of 0 means asynchronous transfers only. The default is 20000 (20MHz),
+unless the controller chip only supports fast transfers, in which case it's
+10000 (10MHz).
+.It Cd options SCSI_NCR_MAX_WIDE=integer
+Specifies the maximum SCSI bus width, in bytes. Defaults to 1 on chips
+that support wide SCSI, 0 otherwise. Set this to 0 to disable wide transfers
+even if both controller and device support them (e.g. when using a wide
+controller and wide drive through a narrow cable).
+.It Cd options SCSI_NCR_SYMBIOS_COMPAT
+Enables the use of the GPIO register as a disk activity indicator. Enable
+this if the activity LED isn't working, but make sure the card doesn't
+use GPIO for something else. Cards known to support this:
+ASUS SC875, Diamond FirePort 40, and Symbios SYM8751S.
+.It Cd options SCSI_NCR_TRUST_BIOS
+Specifies that the driver should use the register configuration set by the
+firmware instead of letting configuring the chip itself.
+.El
.Sh SEE ALSO
.Xr intro 4 ,
.Xr sd 4 ,
>Audit-Trail:
>Unformatted: