summaryrefslogtreecommitdiff
path: root/share/man/man4/pppoe.4
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man4/pppoe.4')
-rw-r--r--share/man/man4/pppoe.436
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