[src/uebayasi-xip]: src/share/man/man4 Add support for Domex 536 PCI SCSI con...

[jakllsch <jakllsch%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/3129ff655777
branches:  uebayasi-xip
changeset: 751635:3129ff655777
user:      jakllsch <jakllsch%NetBSD.org@localhost>
date:      Thu Apr 01 04:04:12 2010 +0000

description:
Add support for Domex 536 PCI SCSI controller to nca(4).
This truly remarkable chip is found on the Domex DMX-3191D SCSI adapter.

diffstat:

 share/man/man4/nca.4 |   53 +++++
 share/man/man4/pci.4 |  521 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 574 insertions(+), 0 deletions(-)

diffs (truncated from 582 to 300 lines):

diff -r 0c31a5606344 -r 3129ff655777 share/man/man4/nca.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/nca.4      Thu Apr 01 04:04:12 2010 +0000
@@ -0,0 +1,53 @@
+.\" $NetBSD: nca.4,v 1.6.2.2 2010/04/01 04:04:12 jakllsch Exp $
+.\"
+.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
+.\" 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. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 April 1, 2010
+.Dt NCA 4
+.Os
+.Sh NAME
+.Nm nca
+.Nd NCR-5380/NCR-53C400 SCSI driver
+.Sh SYNOPSIS
+.Cd "nca0     at isa? port 0x360 irq 15   # Port-mapped NCR 53C80 controller"
+.Cd "nca1     at isa? iomem 0xd8000 irq 5 # Memory-mapped controller (T128...)"
+.Cd "nca*     at pci? dev ? function ?    # Domex 536 (DMX-3191D)"
+.Cd "scsibus* at nca?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the NCR-5380/NCR-53C400 SCSI controllers.
+.Sh SEE ALSO
+.Xr isa 4 ,
+.Xr pci 4 ,
+.Xr scsi 4
+.Sh HISTORY
+The
+.Nm
+driver
+appeared in
+.Nx 1.4 .
+Domex 536 support appeared in
+.Nx 6.0 .
diff -r 0c31a5606344 -r 3129ff655777 share/man/man4/pci.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/pci.4      Thu Apr 01 04:04:12 2010 +0000
@@ -0,0 +1,521 @@
+.\"    $NetBSD: pci.4,v 1.92.2.2 2010/04/01 04:04:12 jakllsch Exp $
+.\"
+.\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
+.\" Copyright (c) 1997 Jonathan Stone
+.\" 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. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgements:
+.\"      This product includes software developed by Jonathan Stone
+.\" 4. 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 April 1, 2010
+.Dt PCI 4
+.Os
+.Sh NAME
+.Nm pci
+.Nd introduction to machine-independent PCI bus support and drivers
+.Sh SYNOPSIS
+.Cd "pci* at mainbus? bus ?"
+.Cd "pci* at pchb? bus ?"
+.Cd "pci* at ppb? bus ?"
+.Pp
+.Cd options PCIVERBOSE
+.Cd options PCI_CONFIG_DUMP
+.Cd options PCI_ADDR_FIXUP
+.Cd options PCI_BUS_FIXUP
+.Cd options PCI_INTR_FIXUP
+.Sh DESCRIPTION
+Other
+.Nm
+attachments are machine-dependent and depend on the bus topology and
+.Tn PCI
+bus interface of your system.
+See
+.Xr intro 4
+for your system for details.
+.Pp
+.Nx
+includes a machine-independent
+.Tn PCI
+bus subsystem and
+several machine-independent
+.Tn PCI
+device drivers.
+.Pp
+Your system may support additional
+.Tn PCI
+devices.
+Drivers for
+.Tn PCI
+devices not listed here are machine-dependent.
+Consult your system's
+.Xr intro 4
+for additional information.
+.Sh OPTIONS
+.Bl -tag -width PCI_ADDR_FIXUP -offset 3n
+.It Dv PCI_ADDR_FIXUP
+Fixup PCI I/O and memory addresses.
+.Pp
+Some i386 and amd64 BIOS implementations don't allocate I/O space and
+memory space for some PCI devices -- primarily BIOS in PnP mode, or laptops
+that expect devices to be configured via ACPI.
+Since necessary space isn't allocated, those devices
+will not work without special handling.
+.Pp
+This option allocates I/O space and memory space
+instead of relying upon the BIOS to do so.
+.Pp
+If necessary space is already correctly assigned to the devices,
+this option leaves the space as is.
+.Pp
+.It Dv PCI_BUS_FIXUP
+Fixup PCI bus numbering; needed for many
+.Xr cardbus 4
+bridges.
+.Pp
+Each PCI bus and CardBus should have a unique bus number.
+But some BIOS implementations don't assign a bus number
+for subordinate PCI buses.
+And many BIOS implementations
+don't assign a bus number for CardBuses.
+.Pp
+A typical symptom of this is the following boot message:
+.D1 Sy cardbus0 at cardslot0: bus 0 device 0...
+Please note that this cardbus0 has a bus number
+.Sq 0 ,
+but normally the bus number 0 is used by the machine's
+primary PCI bus.
+Thus, this bus number for cardbus is incorrect
+.Pq not assigned .
+In this situation, a device located in cardbus0 doesn't
+show correct device ID,
+because its bus number 0 incorrectly refers to the primary
+PCI bus, and a device ID in the primary PCI bus is shown
+in the boot message instead of the device's ID in the cardbus0.
+.Pp
+This option assigns bus numbers for all subordinate
+PCI buses and CardBuses.
+.Pp
+Since this option renumbers all PCI buses and CardBuses,
+all bus numbers of subordinate buses become different
+when this option is enabled.
+.It Dv PCI_INTR_FIXUP
+Fixup PCI interrupt routing via PCIBIOS or ACPI.
+.Pp
+Some i386 and amd64 BIOS implementations don't assign an interrupt for
+some devices.
+.Pp
+This option assigns an interrupt for such devices instead
+of relying upon the BIOS to do so.
+.Pp
+If a valid interrupt has already been assigned to a device, this
+option leaves the interrupt as is.
+.El
+.Sh HARDWARE
+.Nx
+includes machine-independent
+.Tn PCI
+drivers, sorted by device type and driver name:
+.Ss SCSI interfaces
+.Bl -tag -width pcdisplay -offset indent
+.It ahc
+Adaptec 29xx, 39xx, and other AIC-7xxx-based
+.Tn SCSI
+interfaces.
+.It adv
+Advansys
+.Tn SCSI
+interfaces.
+.It adw
+Advansys Ultra Wide
+.Tn SCSI
+interfaces.
+.It bha
+Buslogic BT-9xx
+.Tn SCSI
+interfaces.
+.It dpt
+DPT SmartCache/SmartRAID III and IV
+.Tn SCSI
+interfaces.
+.It iha
+Initio INIC-940/950
+.Tn SCSI
+interfaces.
+.It isp
+QLogic ISP-1020, ISP-1040, and ISP-2100
+.Tn SCSI
+and
+.Tn FibreChannel
+interfaces.
+.It mfi
+LSI Logic \*[Am] Dell MegaRAID SAS RAID controllers.
+.It mly
+Mylex AcceleRAID and eXtremeRAID controllers with v6 firmware.
+.It nca
+Domex 536
+.Tn SCSI
+interfaces.
+.It pcscp
+Advanced Micro Devices Am53c974 PCscsi-PCI
+.Tn SCSI
+interfaces.
+.It siop
+Symbios Logic/NCR 53c8xx-family
+.Tn SCSI
+interfaces.
+.It trm
+Tekram TRM-S1040 ASIC based
+.Tn SCSI
+interfaces.
+.El
+.Ss Disk and tape controllers
+.Bl -tag -width pcdisplay -offset indent
+.It aac
+The Adaptec AAC family of RAID controllers.
+.It ahcisata
+AHCI 1.0 and 1.1 compliant SATA controllers.
+.It amr
+The AMI and LSI Logic MegaRAID family of RAID controllers.
+.It cac
+Compaq array controllers.
+.It icp
+ICP Vortex GDT and Intel Storage RAID controllers.
+.It mlx
+Mylex DAC960 and DEC SWXCR RAID controllers.
+.It pciide
+IDE disk controllers.
+.It twe
+3Ware Escalade RAID controllers.
+.El
+.Ss Network interfaces
+.Bl -tag -width pcdisplay -offset indent
+.It an
+.Tn Aironet
+4500/4800 and
+.Tn Cisco
+340 series 802.11 interfaces.
+.It bnx
+Broadcom NetXtreme II 10/100/1000 Ethernet interfaces.
+.It de
+.Tn DEC
+DC21x4x (Tulip) based
+.Tn Ethernet
+interfaces, including the DE435,
+DE450, and DE500, and Znyx, SMC, Cogent/Adaptec, and Asante single- and
+multi-port
+.Tn Ethernet
+interfaces.
+.It en
+Midway-based Efficient Networks Inc. and Adaptec ATM interfaces.
+.It ep
+3Com 3c590, 3c595, 3c900, and 3c905
+.Tn Ethernet
+interfaces.
+.It epic
+SMC83C170 (EPIC/100)
+.Tn Ethernet
+interfaces.