From c5a591f1addd844e34f85e260a14445753c82b9b Mon Sep 17 00:00:00 2001 From: ru Date: Fri, 13 Dec 2002 10:38:42 +0000 Subject: mdoc(7) police: markup overhaul. --- share/man/man4/ng_h4.4 | 55 ++++++++++++++++++++++++++------------------------ 1 file changed, 29 insertions(+), 26 deletions(-) (limited to 'share/man/man4/ng_h4.4') diff --git a/share/man/man4/ng_h4.4 b/share/man/man4/ng_h4.4 index bc76e1c..606e272 100644 --- a/share/man/man4/ng_h4.4 +++ b/share/man/man4/ng_h4.4 @@ -1,8 +1,6 @@ -.\" ng_h4.4 -.\" .\" Copyright (c) 2001-2002 Maksim Yevmenkin .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -11,7 +9,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE @@ -23,15 +21,15 @@ .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. -.\" -.\" $Id: ng_h4.4,v 1.3 2002/11/12 17:10:13 max Exp $ +.\" .\" $FreeBSD$ +.\" .Dd June 14, 2002 .Dt NG_H4 4 .Os .Sh NAME -.Nm h4 -.Nd Netgraph node type that is also a H4 line discipline +.Nm ng_h4 +.Nd Netgraph node type that is also an H4 line discipline .Sh SYNOPSIS .In sys/types.h .In sys/ttycom.h @@ -39,20 +37,22 @@ .In netgraph/ng_h4.h .Sh DESCRIPTION The -.Nm -node type is both a persistent Netgraph node type and a H4 line -discipline. It implements a Bluetooth HCI UART transport layer as -per chapter H4 of the Bluetooth Specification Book v1.1. A new -node is created when the corresponding line discipline, +.Nm h4 +node type is both a persistent Netgraph node type and a H4 line +discipline. +It implements a Bluetooth HCI UART transport layer as +per chapter H4 of the Bluetooth Specification Book v1.1. +A new node is created when the corresponding line discipline, .Dv H4DISC , is registered on a tty device (see .Xr tty 4 ) . .Pp The node has a single hook called .Dv hook . -Incoming bytes received on the tty device are re-assembled into -HCI frames (according to the length). Full HCI frames are sent out on -the hook. HCI frames received on +Incoming bytes received on the tty device are re-assembled into +HCI frames (according to the length). +Full HCI frames are sent out on the hook. +HCI frames received on .Dv hook are transmitted out on the tty device. No modification to the data is performed in either direction. @@ -65,22 +65,22 @@ Information about the node is available via the netgraph command .Dv NGIOCGINFO . This command returns a -.Dv "struct nodeinfo" +.Vt "struct nodeinfo" similar to the .Dv NGM_NODEINFO -netgraph control message. +.Xr netgraph 4 +control message. .Sh HOOKS This node type supports the following hooks: -.Pp -.Bl -tag -width foobar +.Bl -tag -width indent .It Dv hook single HCI frame contained in single -.Dv mbuf +.Vt mbuf structure. .El .Sh CONTROL MESSAGES This node type supports the generic control messages, plus the following: -.Bl -tag -width foo +.Bl -tag -width indent .It Dv NGM_H4_NODE_RESET Reset the node. .It Dv NGM_H4_NODE_GET_STATE @@ -96,8 +96,8 @@ Returns current length of outgoing queue for the node. This command takes an integer argument and sets maximum length of outgoing queue for the node. .It Dv NGM_H4_NODE_GET_STAT -Returns various statistic information for the node, such as: number of -bytes (frames) sent, number of bytes (frames) received and number of +Returns various statistic information for the node, such as: number of +bytes (frames) sent, number of bytes (frames) received and number of input (output) errors. .It Dv NGM_H4_NODE_RESET_STAT Reset all statistic counters to zero. @@ -106,7 +106,10 @@ Reset all statistic counters to zero. This node shuts down when the corresponding device is closed (or the line discipline is uninstalled on the device). .Sh BUGS -This node still uses spltty() to lock tty layer. This is wrong. +This node still uses +.Xr spltty 9 +to lock tty layer. +This is wrong. .Sh SEE ALSO .Xr ioctl 2 , .Xr netgraph 4 , @@ -114,7 +117,7 @@ This node still uses spltty() to lock tty layer. This is wrong. .Xr ngctl 8 .Sh HISTORY The -.Nm +.Nm h4 node type was implemented in .Fx 5.0 . .Sh AUTHORS -- cgit v1.1