Mon Jun 18 15:31:49 2018 UTC ()
Pull up following revision(s) (requested by sevan in ticket #882):

	usr.sbin/ofctl/ofctl.8: revision 1.6
	usr.sbin/ofctl/ofctl.8: revision 1.7

Merge single-letter options. Use more markup.

Document -l, -r, and -w, based on input by jmcneill@

Bump date.


(martin)
diff -r1.4 -r1.4.52.1 src/usr.sbin/ofctl/ofctl.8
cvs diff -r1.4 -r1.4.52.1 src/usr.sbin/ofctl/ofctl.8 (expand / switch to unified diff)

--- src/usr.sbin/ofctl/ofctl.8 2008/09/25 22:44:51 1.4
+++ src/usr.sbin/ofctl/ofctl.8 2018/06/18 15:31:49 1.4.52.1
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: ofctl.8,v 1.4 2008/09/25 22:44:51 reed Exp $ 1.\" $NetBSD: ofctl.8,v 1.4.52.1 2018/06/18 15:31:49 martin Exp $
2.\" 2.\"
3.\" Copyright (c) 2006 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Matt Thomas. 7.\" by Matt Thomas.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -17,62 +17,79 @@ @@ -17,62 +17,79 @@
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd September 29, 2006 30.Dd June 18, 2018
31.Dt OFCTL 8 31.Dt OFCTL 8
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm ofctl 34.Nm ofctl
35.Nd display the OpenPROM or OpenFirmware device tree 35.Nd display the OpenPROM or OpenFirmware device tree
36.Sh SYNOPSIS 36.Sh SYNOPSIS
37.Nm 37.Nm
38.Op Fl p 38.Op Fl lp
39.Op Fl f Ar file 39.Op Fl f Ar file
 40.Op Fl r Ar propfile
 41.Op Fl w Ar propfile
40.Op Ar node 42.Op Ar node
41.Sh DESCRIPTION 43.Sh DESCRIPTION
42.Nm 44.Nm
43provides an interface for displaying the OpenPROM or OpenFirmware 45provides an interface for displaying the OpenPROM or OpenFirmware
44device tree and node properties. 46device tree and node properties.
45The 47The
46.Nm 48.Nm
47program is only installed on supported platforms. 49program is only installed on supported platforms.
48.Pp 50.Pp
49Without any arguments, 51Without any arguments,
50.Nm 52.Nm
51will dump the full tree. 53will dump the full tree.
52When given the name of a specific node, 54When given the name of a specific node,
53.Nm 55.Nm
54will display that node and its child nodes. 56will display that node and its child nodes.
55.Pp 57.Pp
56The options are as follows: 58The options are as follows:
57.Bl -tag -offset indent -width 8n 59.Bl -tag -offset indent -width 12n
58.It Fl f Ar file 60.It Fl f Ar file
59On systems with OpenPROM, use 61On systems with OpenPROM, use
60.Ar file 62.Ar file
61instead of the default 63instead of the default
62.Pa /dev/openprom . 64.Pa /dev/openprom .
63On systems with OpenFirmware, use 65On systems with OpenFirmware, use
64.Ar file 66.Ar file
65instead of the default 67instead of the default
66.Pa /dev/openfirm . 68.Pa /dev/openfirm .
 69.It Fl l
 70Dump a partial tree starting from
 71.Ar node .
67.It Fl p 72.It Fl p
68Display each node's properties. 73Display each node's properties.
 74.It Fl r Ar propfile
 75Instead of reading from the openprom or openfirm device,
 76use the proplib file
 77.Ar propfile
 78as input.
 79See also
 80.Fl w .
 81.It Fl w Ar propfile
 82Write the device tree to the proplib file
 83.Ar propfile .
 84See also
 85.Fl r .
69.El 86.El
70.Sh FILES 87.Sh FILES
71.Bl -tag -width "/dev/openprom " 88.Bl -tag -width "/dev/openprom "
72.It /dev/openprom 89.It Pa /dev/openprom
73The openprom device on systems with OpenPROM. 90The openprom device on systems with OpenPROM.
74.It /dev/openfirm 91.It Pa /dev/openfirm
75The openfirm device on systems with OpenFirmware. 92The openfirm device on systems with OpenFirmware.
76.El 93.El
77.Sh SEE ALSO 94.Sh SEE ALSO
78.Xr eeprom 8 95.Xr eeprom 8