[src/trunk]: src/usr.sbin/ofctl Document -l, -r, and -w, based on input by jm...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c37e8231c38e
branches:  trunk
changeset: 323009:c37e8231c38e
user:      wiz <wiz%NetBSD.org@localhost>
date:      Mon May 28 12:42:02 2018 +0000

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

Bump date.

diffstat:

 usr.sbin/ofctl/ofctl.8 |  25 +++++++++++++++++++++----
 1 files changed, 21 insertions(+), 4 deletions(-)

diffs (65 lines):

diff -r 020deed2bd6f -r c37e8231c38e usr.sbin/ofctl/ofctl.8
--- a/usr.sbin/ofctl/ofctl.8    Mon May 28 11:35:50 2018 +0000
+++ b/usr.sbin/ofctl/ofctl.8    Mon May 28 12:42:02 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ofctl.8,v 1.6 2018/05/26 12:40:06 wiz Exp $
+.\"    $NetBSD: ofctl.8,v 1.7 2018/05/28 12:42:02 wiz Exp $
 .\"
 .\" Copyright (c) 2006 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 26, 2018
+.Dd May 28, 2018
 .Dt OFCTL 8
 .Os
 .Sh NAME
@@ -35,8 +35,10 @@
 .Nd display the OpenPROM or OpenFirmware device tree
 .Sh SYNOPSIS
 .Nm
-.Op Fl pv
+.Op Fl lpv
 .Op Fl f Ar file
+.Op Fl r Ar propfile
+.Op Fl w Ar propfile
 .Op Ar node
 .Sh DESCRIPTION
 .Nm
@@ -54,7 +56,7 @@
 will display that node and its child nodes.
 .Pp
 The options are as follows:
-.Bl -tag -offset indent -width 8n
+.Bl -tag -offset indent -width 12n
 .It Fl f Ar file
 On systems with OpenPROM, use
 .Ar file
@@ -64,10 +66,25 @@
 .Ar file
 instead of the default
 .Pa /dev/openfirm .
+.It Fl l
+Dump a partial tree starting from
+.Ar node .
 .It Fl p
 Display each node's properties.
+.It Fl r Ar propfile
+Instead of reading from the openprom or openfirm device,
+use the proplib file
+.Ar propfile
+as input.
+See also
+.Fl w .
 .It Fl v
 Display the full path name for each node.
+.It Fl w Ar propfile
+Write the device tree to the proplib file
+.Ar propfile .
+See also
+.Fl r .
 .El
 .Sh FILES
 .Bl -tag -width "/dev/openprom "