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

This commit is contained in:
wiz 2002-01-15 01:44:58 +00:00
parent a6623f6ddf
commit 35f42d96d9

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.
.\" All rights reserved.
@ -50,9 +50,8 @@
.Cd "#options PCIBIOS_INTR_FIXUP_FORCE"
.Cd "options PCIBIOS_INTR_GUESS"
.Cd "#options PCIINTR_DEBUG"
.Pp
.Sh INTRODUCTION
.Nx
.Nm
provides support for setting up PCI controllers, bridges, and devices
using information extracted from the BIOS.
.Pp
@ -65,13 +64,10 @@ boots.
.Pp
Options:
.Bl -tag -width PCIBIOS_INTR_FIXUP -offset 3n
.It Nm PCIBIOS
turn on the PCI BIOS support.
.It Nm PCIBIOSVERBOSE
make the setup procedure verbose.
.It Nm PCIBIOS_ADDR_FIXUP
fixup PCI I/O and memory addresses.
.Pp
@ -82,18 +78,18 @@ which is
shows this behavior.
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
Although many BIOS implementations leave CardBus bridges'
space unallocated, the CardBus bridge device driver doesn't
require this option, since the driver allocates necessary space
by itself.
.Pp
.It Nm PCIBIOS_BUS_FIXUP
fixup PCI bus numbering; needed for many
.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
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
@ -117,26 +113,24 @@ 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 Nm PCIBIOS_INTR_FIXUP
fixup PCI interrupt routing.
.Pp
Some 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 the BIOS has already assigned an interrupt to a device, this
option leaves the interrupt as is.
.It Nm PCIBIOS_IRQS_HINT
hint for IRQ use.
When the
@ -154,7 +148,7 @@ The value is a logical or of power-of-2s of allowable interrupts:
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,
@ -184,9 +178,7 @@ prompt:
.Dl Ic set pcibios_irqs_hint=0xa00
.Dl Ic quit
.El
.It Nm PCIBIOS_INTR_FIXUP_FORCE
.Pp
Some buggy BIOS implementations provide inconsistent
information between the PCI Interrupt Configuration Register
and the PCI Interrupt Routing table. In such case,
@ -196,7 +188,7 @@ by default. If this happens, a kernel with
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
@ -207,7 +199,6 @@ In this case, a kernel with
shows
.Qq Sy WARNING: overriding irq XX
in the PCI routing table.
.It Nm PCIBIOS_INTR_GUESS
make
.Em PCIBIOS_INTR_FIXUP
@ -215,7 +206,7 @@ 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
@ -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
connected to the device, and corresponding PCI Interrupt
Configuration Register will be configured accordingly.
.It Nm PCIINTR_DEBUG
make the
.Em PCIBIOS_INTR_FIXUP
procedure verbose.
.El
.Sh SEE ALSO
.Xr cardbus 4 ,