Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Drop some .Pps, and convert some empty lines to .Pps.

Browse Source
This commit is contained in:
wiz 2002-01-15 01:44:58 +00:00
parent a6623f6ddf
commit 35f42d96d9
1 changed files with 14 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
share/man/man4/man4.i386/pcibios.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pcibios.4,v 1.11 2001/04/21 14:33:39 wiz Exp $ .\" $NetBSD: pcibios.4,v 1.12 2002/01/15 01:44:58 wiz Exp $
.\" .\"
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc. .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -50,9 +50,8 @@
.Cd "#options PCIBIOS_INTR_FIXUP_FORCE" .Cd "#options PCIBIOS_INTR_FIXUP_FORCE"
.Cd "options PCIBIOS_INTR_GUESS" .Cd "options PCIBIOS_INTR_GUESS"
.Cd "#options PCIINTR_DEBUG" .Cd "#options PCIINTR_DEBUG"
.Pp
.Sh INTRODUCTION .Sh INTRODUCTION
.Nx .Nm
provides support for setting up PCI controllers, bridges, and devices provides support for setting up PCI controllers, bridges, and devices
using information extracted from the BIOS. using information extracted from the BIOS.
.Pp .Pp
@ -65,13 +64,10 @@ boots.
.Pp .Pp
Options: Options:
.Bl -tag -width PCIBIOS_INTR_FIXUP -offset 3n .Bl -tag -width PCIBIOS_INTR_FIXUP -offset 3n
.It Nm PCIBIOS .It Nm PCIBIOS
turn on the PCI BIOS support. turn on the PCI BIOS support.
.It Nm PCIBIOSVERBOSE .It Nm PCIBIOSVERBOSE
make the setup procedure verbose. make the setup procedure verbose.
.It Nm PCIBIOS_ADDR_FIXUP .It Nm PCIBIOS_ADDR_FIXUP
fixup PCI I/O and memory addresses. fixup PCI I/O and memory addresses.
.Pp .Pp
@ -82,18 +78,18 @@ which is
shows this behavior. shows this behavior.
Since necessary space isn't allocated, those devices Since necessary space isn't allocated, those devices
will not work without special handling. will not work without special handling.
.Pp
This option allocates I/O space and memory space This option allocates I/O space and memory space
instead of relying upon the BIOS to do so. instead of relying upon the BIOS to do so.
.Pp
If necessary space is already correctly assigned to the devices, If necessary space is already correctly assigned to the devices,
this option leaves the space as is. this option leaves the space as is.
.Pp
Although many BIOS implementations leave CardBus bridges' Although many BIOS implementations leave CardBus bridges'
space unallocated, the CardBus bridge device driver doesn't space unallocated, the CardBus bridge device driver doesn't
require this option, since the driver allocates necessary space require this option, since the driver allocates necessary space
by itself. by itself.
.Pp
.It Nm PCIBIOS_BUS_FIXUP .It Nm PCIBIOS_BUS_FIXUP
fixup PCI bus numbering; needed for many fixup PCI bus numbering; needed for many
.Xr cardbus 4 .Xr cardbus 4
@ -103,7 +99,7 @@ Each PCI bus and CardBus should have a unique bus number.
But some BIOS implementations don't assign a bus number But some BIOS implementations don't assign a bus number
for subordinate PCI buses. And many BIOS implementations for subordinate PCI buses. And many BIOS implementations
don't assign a bus number for CardBuses. don't assign a bus number for CardBuses.
.Pp
A typical symptom of this is the following boot message: A typical symptom of this is the following boot message:
.D1 Sy cardbus0 at cardslot0: bus 0 device 0... .D1 Sy cardbus0 at cardslot0: bus 0 device 0...
Please note that this cardbus0 has a bus number Please note that this cardbus0 has a bus number
@ -117,26 +113,24 @@ show correct device ID,
because its bus number 0 incorrectly refers to the primary because its bus number 0 incorrectly refers to the primary
PCI bus, and a device ID in the primary PCI bus is shown 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. in the boot message instead of the device's ID in the cardbus0.
.Pp
This option assigns bus numbers for all subordinate This option assigns bus numbers for all subordinate
PCI buses and CardBuses. PCI buses and CardBuses.
.Pp
Since this option renumbers all PCI buses and CardBuses, Since this option renumbers all PCI buses and CardBuses,
all bus numbers of subordinate buses become different all bus numbers of subordinate buses become different
when this option is enabled. when this option is enabled.
.It Nm PCIBIOS_INTR_FIXUP .It Nm PCIBIOS_INTR_FIXUP
fixup PCI interrupt routing. fixup PCI interrupt routing.
.Pp .Pp
Some BIOS implementations don't assign an interrupt for Some BIOS implementations don't assign an interrupt for
some devices. some devices.
.Pp
This option assigns an interrupt for such devices instead This option assigns an interrupt for such devices instead
of relying upon the BIOS to do so. of relying upon the BIOS to do so.
.Pp
If the BIOS has already assigned an interrupt to a device, this If the BIOS has already assigned an interrupt to a device, this
option leaves the interrupt as is. option leaves the interrupt as is.
.It Nm PCIBIOS_IRQS_HINT .It Nm PCIBIOS_IRQS_HINT
hint for IRQ use. hint for IRQ use.
When the When the
@ -154,7 +148,7 @@ The value is a logical or of power-of-2s of allowable interrupts:
For example, For example,
.Qq Sy options PCIBIOS_IRQS_HINT=0x0a00 .Qq Sy options PCIBIOS_IRQS_HINT=0x0a00
allows IRQ 9 and IRQ 11. allows IRQ 9 and IRQ 11.
.Pp
The kernel global variable The kernel global variable
.Va pcibios_irqs_hint .Va pcibios_irqs_hint
holds this value, holds this value,
@ -184,9 +178,7 @@ prompt:
.Dl Ic set pcibios_irqs_hint=0xa00 .Dl Ic set pcibios_irqs_hint=0xa00
.Dl Ic quit .Dl Ic quit
.El .El
.It Nm PCIBIOS_INTR_FIXUP_FORCE .It Nm PCIBIOS_INTR_FIXUP_FORCE
.Pp
Some buggy BIOS implementations provide inconsistent Some buggy BIOS implementations provide inconsistent
information between the PCI Interrupt Configuration Register information between the PCI Interrupt Configuration Register
and the PCI Interrupt Routing table. In such case, and the PCI Interrupt Routing table. In such case,
@ -196,7 +188,7 @@ by default. If this happens, a kernel with
shows shows
.Qq Sy WARNING: preserving irq XX .Qq Sy WARNING: preserving irq XX
in the PCI routing table. in the PCI routing table.
.Pp
If If
.Em PCIBIOS_INTR_FIXUP_FORCE .Em PCIBIOS_INTR_FIXUP_FORCE
is specified in addition to the is specified in addition to the
@ -207,7 +199,6 @@ In this case, a kernel with
shows shows
.Qq Sy WARNING: overriding irq XX .Qq Sy WARNING: overriding irq XX
in the PCI routing table. in the PCI routing table.
.It Nm PCIBIOS_INTR_GUESS .It Nm PCIBIOS_INTR_GUESS
make make
.Em PCIBIOS_INTR_FIXUP .Em PCIBIOS_INTR_FIXUP
@ -215,7 +206,7 @@ work with unknown interrupt router.
.Pp .Pp
If a PCI interrupt router is not known, normally interrupt If a PCI interrupt router is not known, normally interrupt
configuration will not be touched. configuration will not be touched.
.Pp
But if But if
.Em PCIBIOS_INTR_GUESS .Em PCIBIOS_INTR_GUESS
is specified in addition to the is specified in addition to the
@ -224,12 +215,10 @@ 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 one IRQ is available for the entry, the IRQ is assumed to be already
connected to the device, and corresponding PCI Interrupt connected to the device, and corresponding PCI Interrupt
Configuration Register will be configured accordingly. Configuration Register will be configured accordingly.
.It Nm PCIINTR_DEBUG .It Nm PCIINTR_DEBUG
make the make the
.Em PCIBIOS_INTR_FIXUP .Em PCIBIOS_INTR_FIXUP
procedure verbose. procedure verbose.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr cardbus 4 , .Xr cardbus 4 ,