summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorJason McIntyre <jmc@cvs.openbsd.org>2005-11-15 00:26:44 +0000
committerJason McIntyre <jmc@cvs.openbsd.org>2005-11-15 00:26:44 +0000
commitedffb7a8509d457f7f018d67b01d55646b6c830d (patch)
tree3db61fca383db32096ab95c2fb2a5c488da9af6d /share
parent8b445dd6d2d14c3d8d1ea69b42e6e31bf0d8ee61 (diff)
various tweaks;
Diffstat (limited to 'share')
-rw-r--r--share/man/man9/pci_conf_read.943
1 files changed, 22 insertions, 21 deletions
diff --git a/share/man/man9/pci_conf_read.9 b/share/man/man9/pci_conf_read.9
index c8e7a6dc64f..4bf51cb70c5 100644
--- a/share/man/man9/pci_conf_read.9
+++ b/share/man/man9/pci_conf_read.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: pci_conf_read.9,v 1.4 2005/11/14 17:11:53 mickey Exp $
+.\" $OpenBSD: pci_conf_read.9,v 1.5 2005/11/15 00:26:43 jmc Exp $
.\"
.\" Copyright (c) 2005 Michael Shalayeff
.\" All rights reserved.
@@ -16,10 +16,11 @@
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd November 20, 2005
-.Dt pci_conf_read 9
+.Dt PCI_CONF_READ 9
.Os
.Sh NAME
.Nm pci_make_tag ,
+.Nm pci_decompose_tag ,
.Nm pci_conf_read ,
.Nm pci_conf_write
.Nd PCI config space manipulation functions
@@ -41,12 +42,12 @@
.Fn pci_conf_write "pci_chipset_tag_t pc" "pcitag_t tag" "int reg" \
"pcireg_t val"
.Sh DESCRIPTION
-These functions provide a way for accessing PCI configuration space.
+These functions provide a way to access PCI configuration space.
.Pp
-The following types are defined in the MD include
-.Pa Aq pci_machdep.h
-file:
-.Bl -tag -width pci_chipset_tag_t -offset indent
+The following types are defined in the machine dependent include file
+.Aq Pa pci_machdep.h .
+.Pp
+.Bl -tag -width pci_chipset_tag_t -offset indent -compact
.It pci_chipset_tag_t
a PCI chipset descriptor;
.It pcitag_t
@@ -55,7 +56,7 @@ a PCI device tag;
a PCI register datum.
.El
.Pp
-In order to access PCI configuration space a device tag shall be made using
+In order to access PCI configuration space, a device tag shall be made using
.Nm pci_make_tag
given the PCI chipset tag
.Ar pc
@@ -63,21 +64,22 @@ and the device specification in a tuple of
.Ar bus ,
.Ar device ,
.Ar function .
-The PCI tag composition is a PCI chipset dependant operation
-although often as simple as shift and logical OR combination.
+The PCI tag composition is a PCI chipset dependent operation
+although often as simple as a shift and logical OR combination.
+.Pp
The
.Nm pci_decompose_tag
-provides a reverse opration.
-Having a tag composed now it is possible to perform configuration
+provides a reverse operation.
+Once a tag is composed, it is possible to perform configuration
space read and write with
.Nm pci_conf_read
and
-.Nm pci_conf_write
+.Nm pci_conf_write ,
respectively.
Access to PCI configuration space is only provided for whole
.Nm pcireg_t
-items that is usually a 32-bit integer.
-Accesses to non-existant PCI devices do not (or should not) generate
+items, which is usually a 32-bit integer.
+Access to non-existent PCI devices do not (or should not) generate
any kinds of faults or interruptions and thus allow for an easy device
scanning by cycling through all possible device and function numbers
for a given bus.
@@ -86,19 +88,19 @@ Below is an overview of defined PCI configuration space registers for
devices:
.Bl -tag -width 0xff -offset indent
.It 0x00
-Vendor (lower word) and Product (higher word) identification.
+Vendor (lower word) and Product (higher word) identification
(see
.Pa /sys/dev/pci/pcidevs
-for a comprehensive list)
+for a comprehensive list).
.It 0x04
Commands and Status register.
.It 0x08
-PCI device's class and subclass ids.
+PCI device's class and subclass IDs.
See
.Pa /sys/dev/pci/pcireg.h
for PCI_CLASS_* and PCI_SUBCLASS_* definitions.
.It 0x0c
-Specify (low byte to high): cache line size, PCI lattency timer, header type
+Specify (low byte to high): cache line size, PCI latency timer, header type,
and BIST.
.It 0x10 - 0x28
Base address registers for IO and memory space mapped registers.
@@ -112,10 +114,9 @@ Each item is an offset in the configuration space itself.
.It 0x3c
Interrupt line and pin numbers.
.El
-.Pp
.Sh SEE ALSO
.Xr cardbus 4 ,
-.Xr pci 4 .
+.Xr pci 4
.Sh HISTORY
These functions first appeared in
.Ox 1.2 .