summaryrefslogtreecommitdiff
path: root/usr.sbin/pcictl
diff options
context:
space:
mode:
authorriastradh <riastradh@NetBSD.org>2014-09-10 21:09:32 +0000
committerriastradh <riastradh@NetBSD.org>2014-09-10 21:09:32 +0000
commit7e1cfde7059cd45c2dff7ec0467c6aacb12043e8 (patch)
tree2ff2f780f7e2cd3a5adfd564c436ace2ef777342 /usr.sbin/pcictl
parent3e2398835bdc376e48c3c63884442b3b5d08dbd1 (diff)
Sternly advise against `pcictl read/write'. Use .Cm, not .Nm, while here.
Diffstat (limited to 'usr.sbin/pcictl')
-rw-r--r--usr.sbin/pcictl/pcictl.824
1 files changed, 21 insertions, 3 deletions
diff --git a/usr.sbin/pcictl/pcictl.8 b/usr.sbin/pcictl/pcictl.8
index dab215c8346..59fba9d66cd 100644
--- a/usr.sbin/pcictl/pcictl.8
+++ b/usr.sbin/pcictl/pcictl.8
@@ -1,4 +1,4 @@
-.\" $NetBSD: pcictl.8,v 1.14 2014/09/01 07:11:19 manu Exp $
+.\" $NetBSD: pcictl.8,v 1.15 2014/09/10 21:09:32 riastradh Exp $
.\"
.\" Copyright 2001 Wasabi Systems, Inc.
.\" All rights reserved.
@@ -84,7 +84,7 @@ If the bus is not specified, it defaults to the bus number of the
PCI bus specified on the command line.
If the function is not specified, it defaults to 0.
.Pp
-.Nm read
+.Cm read
.Op Fl b Ar bus
.Fl d Ar device
.Op Fl f Ar function
@@ -96,7 +96,16 @@ If the bus is not specified, it defaults to the bus number of the
PCI bus specified on the command line.
If the function is not specified, it defaults to 0.
.Pp
-.Nm write
+.Em WARNING:
+.Nm
+.Cm read
+is a dangerous command that can damage hardware and panic the operating
+system, even though it appears to be a harmless read-only operation.
+It is meant as a diagnostic tool for experiments or to debug device
+drivers.
+Do not use it as a substitute for a device driver!
+.Pp
+.Cm write
.Op Fl b Ar bus
.Fl d Ar device
.Op Fl f Ar function
@@ -108,6 +117,15 @@ configuration register.
If the bus is not specified, it defaults to the bus number of the
PCI bus specified on the command line.
If the function is not specified, it defaults to 0.
+.Pp
+.Em WARNING:
+.Nm
+.Cm read
+is a dangerous command that can damage hardware and panic the operating
+system.
+It is meant as a diagnostic tool for experiments or to debug device
+drivers.
+Do not use it as a substitute for a device driver!
.Sh FILES
.Pa /dev/pci*
- PCI bus device nodes