New sentence, new line.

Remove superfluous macros and whitespace.
Some wording improvements.
This commit is contained in:
wiz 2017-02-16 14:00:26 +00:00
parent d0da83b571
commit ae4956b2f3

View File

@ -1,4 +1,4 @@
.\" $NetBSD: l2tp.4,v 1.1 2017/02/16 08:32:21 knakahara Exp $ .\" $NetBSD: l2tp.4,v 1.2 2017/02/16 14:00:26 wiz Exp $
.\" .\"
.\" Copyright (C) 2017 Internet Initiative Japan Inc. .\" Copyright (C) 2017 Internet Initiative Japan Inc.
.\" All rights reserved. .\" All rights reserved.
@ -38,34 +38,37 @@
.Sh DESCRIPTION .Sh DESCRIPTION
The The
.Nm .Nm
interface is a version 3 of the Layer Two Tunneling Protocol(L2TPv3) interface is a version 3 of the Layer Two Tunneling Protocol (L2TPv3)
pseudo device. It can tunnel layer 2 protocol traffic over IPv4 or IPv6, pseudo device.
as specified in It can tunnel layer 2 protocol traffic over IPv4 or IPv6, as specified in
.Li RFC3931 . .Li RFC3931 .
.Pp .Pp
L2TPv3 protocol is comprised of two types of messages, control messages The L2TPv3 protocol is comprised of two types of messages, control messages
and data messages. Control messages are used in the establishment, and data messages.
Control messages are used in the establishment,
maintenace, and clearing of control connections and sessions. maintenace, and clearing of control connections and sessions.
.Xr l2tp 4 The
interface can send control messages and data messages, furthermore .Nm
interface can send control messages and data messages; furthermore
the management of control messages is entrusted to userland daemon. the management of control messages is entrusted to userland daemon.
Without management daemon, Without a management daemon, the
.Xr l2tp 4 .Nm
interface can send data messages by using interface can send data messages using the
.Xr ifconfig 8 .Xr ifconfig 8
.Cm tunnel .Cm tunnel
and and
.Cm session .Cm session
subcommands, or subcommands, or the
.Dv SIOCSIFPHYADDR .Dv SIOCSIFPHYADDR
and and
.Dv SIOCSL2TPSESSION .Dv SIOCSL2TPSESSION
ioctls. Additionally, it can use cookie specified in ioctls.
Additionally, it can use cookies specified in
.Li RFC3931 .Li RFC3931
by using by using the
.Xr ifconfig 8 .Xr ifconfig 8
.Cm cookie .Cm cookie
subcommand, or subcommand, or the
.Dv SIOCSL2TPCOOKIE .Dv SIOCSL2TPCOOKIE
ioctl. ioctl.
.Ss Packet format .Ss Packet format
@ -80,7 +83,6 @@ Host X--NetBSD A ----------------tunnel---------- NetBSD B------Host E
\\ | \\ |
\\ / \\ /
+-----Router B--------Router C---------+ +-----Router B--------Router C---------+
.Ed .Ed
configuration example without cookies, configuration example without cookies,
.Pp .Pp
@ -100,7 +102,6 @@ system A
# ifconfig bridge0 up # ifconfig bridge0 up
.Ed .Ed
.Pp .Pp
.Ed
On On
.Nx .Nx
system B system B
@ -136,7 +137,6 @@ system A
# ifconfig bridge0 up # ifconfig bridge0 up
.Ed .Ed
.Pp .Pp
.Ed
On On
.Nx .Nx
system B system B
@ -153,7 +153,6 @@ system B
# ifconfig wm1 up # ifconfig wm1 up
# ifconfig bridge0 up # ifconfig bridge0 up
.Ed .Ed
.Sh SEE ALSO .Sh SEE ALSO
.Xr inet 4 , .Xr inet 4 ,
.Xr inet6 4 , .Xr inet6 4 ,
@ -173,6 +172,6 @@ The
device first appeared in device first appeared in
.Nx 8.0 . .Nx 8.0 .
.Sh BUGS .Sh BUGS
Currently, Currently, the
.Nm .Nm
interface support ethernet frame over IPv4 or IPv6 only. interface supports Ethernet frames over IPv4 or IPv6 only.