less verbose KERNEL OPTIONS section; help/ok sthen

1 files changed, 13 insertions, 23 deletions

diff --git a/share/man/man4/pppoe.4 b/share/man/man4/pppoe.4
index f22b9af9aa5..3a426710385 100644
--- a/share/man/man4/pppoe.4
+++ b/share/man/man4/pppoe.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pppoe.4,v 1.32 2016/08/16 08:56:28 mpi Exp $
+.\"	$OpenBSD: pppoe.4,v 1.33 2017/03/22 21:37:24 jmc Exp $
 .\"	$NetBSD: pppoe.4,v 1.26 2003/10/02 07:06:36 wiz Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
@@ -28,7 +28,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: August 16 2016 $
+.Dd $Mdocdate: March 22 2017 $
 .Dt PPPOE 4
 .Os
 .Sh NAME
@@ -125,33 +125,23 @@ every address suggested by the peer will be accepted.
 To wildcard the local address set it to 0.0.0.0; to wildcard the remote
 address set it to 0.0.0.1.
 .Sh KERNEL OPTIONS
-A
 .Nm
-enabled kernel will not interfere with other PPPoE implementations
+does not interfere with other PPPoE implementations
 running on the same machine.
-Under special circumstances
-(details below) this is not desirable, so the
+However under some circumstances
+(such as after a crash or power failure)
+the peer device might initially refuse to
+reestablish a new PPPoE connection
+because there is already an open session.
+This would be indicated by the client sending a high number of PADI packets
+before successfully connecting.
+The
 .Nm
 driver can be told to kill all unknown PPPoE sessions
-received by the Ethernet interface used for a configured
-.Nm
-interface.
-To do this,
-add the following to your kernel config file:
+by sending a PADT packet to explicitly terminate the old session.
+Add the following to the kernel config file:
 .Pp
 .Dl option PPPOE_TERM_UNKNOWN_SESSIONS
-.Pp
-This option is only useful if you have a static IP address assigned and
-your ISP does not use LCP echo requests to monitor the link status.
-After a crash or power failure the peer device still tries to send data to
-the no longer active session on your computer, and might refuse to
-reestablish a new connection, because there already is an open session.
-On receipt of such packets, the
-.Nm
-driver with this option set will send a PADT packet
-(request to terminate the session).
-The peer will immediately disconnect
-the orphaned session and allow a new one to be established.
 .Sh MTU/MSS ISSUES
 Problems can arise on machines with private IPs connecting to the Internet
 via a machine running both