Module Name: src
Committed By: snj
Date: Sun Sep 21 18:38:53 UTC 2014
Modified Files:
src/usr.sbin/pcictl [netbsd-7]: pcictl.8
Log Message:
Pull up following revision(s) (requested by riastradh in ticket #105):
usr.sbin/pcictl/pcictl.8: revisions 1.15-1.16
Sternly advise against `pcictl read/write'. Use .Cm, not .Nm, while here.
Fix pasto.
To generate a diff of this commit:
cvs rdiff -u -r1.10.22.1 -r1.10.22.2 src/usr.sbin/pcictl/pcictl.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/usr.sbin/pcictl/pcictl.8
diff -u src/usr.sbin/pcictl/pcictl.8:1.10.22.1 src/usr.sbin/pcictl/pcictl.8:1.10.22.2
--- src/usr.sbin/pcictl/pcictl.8:1.10.22.1 Wed Sep 10 08:38:31 2014
+++ src/usr.sbin/pcictl/pcictl.8 Sun Sep 21 18:38:53 2014
@@ -1,4 +1,4 @@
-.\" $NetBSD: pcictl.8,v 1.10.22.1 2014/09/10 08:38:31 martin Exp $
+.\" $NetBSD: pcictl.8,v 1.10.22.2 2014/09/21 18:38:53 snj Exp $
.\"
.\" Copyright 2001 Wasabi Systems, Inc.
.\" All rights reserved.
@@ -80,7 +80,7 @@ If the bus is not specified, it defaults
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
@@ -92,7 +92,16 @@ If the bus is not specified, it defaults
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
@@ -104,6 +113,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 write
+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
