NetBSD/share/man/man4/ncr.4
fair a576d424e0 Marathon man page editing session to fix broken .Xr's, add important
references, add a little white space here & there for readability,
clean up some mdoc(7) macro usage and so on. Whew!
1998-04-30 08:50:03 +00:00

116 lines
4.0 KiB
Groff

.\" $NetBSD: ncr.4,v 1.6 1998/04/30 08:50:08 fair Exp $
.\"
.\" Copyright (c) 1994 James A. Jegers
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. The name of the author may not be used to endorse or promote products
.\" derived from this software without specific prior written permission
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\"
.Dd January 15, 1997
.Dt NCR 4
.Os NetBSD
.Sh NAME
.Nm ncr
.Nd NCR 53C8xx SCSI driver
.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 (Symbios) 53C810, 53C815, 53C820,
53C825, 53C860, 53C875, 53C885, 53C895, and 53C896
.Tn 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
.Tn CD-ROM
devices.
.It Cd options NCR_CDROM_ASYNC
Always use asynchronous transfers with
.Tn CD-ROM
devices.
By default, synchronous transfers are used if the
.Tn CD-ROM
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
.Tn EEPROM
of the Tekram DC-390 series of
.Tn 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
.Tn SCSI
bus width, in bytes.
Defaults to 1 on chips that support wide
.Tn 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 configuring the chip itself.
.El
.Sh SEE ALSO
.Xr intro 4 ,
.Xr scsi 4 ,
.Xr sd 4 ,
.Xr st 4 ,
.Xr cd 4 ,
.Xr ch 4 ,
.Xr uk 4