diff options
Diffstat (limited to 'static/netbsd/man4/man4.i386/pcibios.4')
| -rw-r--r-- | static/netbsd/man4/man4.i386/pcibios.4 | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/static/netbsd/man4/man4.i386/pcibios.4 b/static/netbsd/man4/man4.i386/pcibios.4 new file mode 100644 index 00000000..3d6350c9 --- /dev/null +++ b/static/netbsd/man4/man4.i386/pcibios.4 @@ -0,0 +1,164 @@ +.\" $NetBSD: pcibios.4,v 1.19 2017/07/03 21:30:59 wiz Exp $ +.\" +.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Lennart Augustsson. +.\" +.\" 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 October 9, 2005 +.Dt PCIBIOS 4 i386 +.Os +.Sh NAME +.Nm pcibios +.Nd introduction to PCI BIOS support +.Sh SYNOPSIS +.Cd "options PCIBIOS" +.Cd "options PCIBIOSVERBOSE" +.Cd "#options PCIBIOS_IRQS_HINT=0x0a00 #IRQ 9,11" +.Cd "#options PCIBIOS_INTR_FIXUP_FORCE" +.Cd "options PCIBIOS_INTR_GUESS" +.Cd "#options PCIINTR_DEBUG" +.Sh INTRODUCTION +.Nm +provides support for setting up PCI controllers, bridges, and devices +using information extracted from the BIOS. +.Pp +Ideally, the boot firmware of a machine (a.k.a. BIOS) should set +up all PCI devices; assigning them I/O and memory addresses and +interrupts. +Alas, this does not always happen, so there is some +PC specific code that can do the initialization when +.Nx +boots. +.Pp +Options: +.Bl -tag -width PCIBIOS_IRQS_HINT -offset 3n +.It Nm PCIBIOS +turn on the PCI BIOS support. +.It Nm PCIBIOSVERBOSE +make the setup procedure verbose. +.It Nm PCIBIOS_IRQS_HINT +hint for IRQ use. +When +.Em PCI_INTR_FIXUP +cannot guess an adequate IRQ for a device, the hint is used. +.Pp +The value is a logical or of power-of-2s of allowable interrupts: +.Bl -column "XX-0xffff" "XX-0xffff" "XX-0xffff" "XX-0xffff" -compact -offset 2n +.It Em "IRQ Value" Ta Em "IRQ Value" Ta Em "IRQ Value" Ta Em "IRQ Value" +.It "\& 0 0x0001" Ta " 4 0x0010" Ta " 8 0x0100" Ta "12 0x1000" +.It "\& 1 0x0002" Ta " 5 0x0020" Ta " 9 0x0200" Ta "13 0x2000" +.It "\& 2 0x0004" Ta " 6 0x0040" Ta "10 0x0400" Ta "14 0x4000" +.It "\& 3 0x0008" Ta " 7 0x0080" Ta "11 0x0800" Ta "15 0x8000" +.El +For example, +.Qq Sy options PCIBIOS_IRQS_HINT=0x0a00 +allows IRQ 9 and IRQ 11. +.Pp +The kernel global variable +.Va pcibios_irqs_hint +holds this value, +so a user can override this value without kernel recompilation. +For example: +.Bl -bullet -compact +.It +To specify this value on the fly, type the following command +at the boot prompt to drop into DDB (the in-kernel debugger; +you have to specify +.Qq Sy options DDB +to make kernel with DDB): +.Dl Ic boot -d +And type the following command on +.Qq Sy db> +prompt: +.Dl Ic write pcibios_irqs_hint 0x0a00 +Then type the following to continue to boot: +.Dl Ic c +.It +To modify kernel image without kernel recompilation, +run the following command on shell: +.Dl Ic gdb --write /netbsd +And type the following commands at the +.Qq Sy (gdb) +prompt: +.Dl Ic set pcibios_irqs_hint=0xa00 +.Dl Ic quit +.El +.It Nm PCIBIOS_INTR_FIXUP_FORCE +Some buggy BIOS implementations provide inconsistent +information between the PCI Interrupt Configuration Register +and the PCI Interrupt Routing table. +In such case, the PCI Interrupt Configuration Register takes precedence +by default. +If this happens, a kernel with +.Em PCIBIOSVERBOSE +shows +.Qq Sy WARNING: preserving irq XX +in the PCI routing table. +.Pp +If +.Em PCIBIOS_INTR_FIXUP_FORCE +is specified in addition to the +.Em PCI_INTR_FIXUP , +the PCI Interrupt Routing table takes precedence. +In this case, a kernel with +.Em PCIBIOSVERBOSE +shows +.Qq Sy WARNING: overriding irq XX +in the PCI routing table. +.It Nm PCIBIOS_INTR_GUESS +make +.Em PCI_INTR_FIXUP +work with unknown interrupt router. +.Pp +If a PCI interrupt router is not known, normally interrupt +configuration will not be touched. +.Pp +But if +.Em PCIBIOS_INTR_GUESS +is specified in addition to the +.Em PCI_INTR_FIXUP , +and if a PCI interrupt routing table entry indicates that only +one IRQ is available for the entry, the IRQ is assumed to be already +connected to the device, and corresponding PCI Interrupt +Configuration Register will be configured accordingly. +.It Nm PCIINTR_DEBUG +make the +.Em PCI_INTR_FIXUP +procedure verbose. +.El +.Sh SEE ALSO +.Xr cardbus 4 , +.Xr pci 4 +.Sh HISTORY +The +.Nm +code appeared in +.Nx 1.5 . +.Sh BUGS +The +.Em PCIBIOS_ADDR_FIXUP +option may conflict with the PCI CardBus driver's own +address fixup. |