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: