git: 2e547442ab38 - main - ng_pppoe: introduce new sysctl net.graph.pppoe.lcp_pcp

From: Eugene Grosbein <eugen_at_FreeBSD.org>
Date: Sun, 01 May 2022 16:47:44 UTC
The branch main has been updated by eugen:

URL: https://cgit.FreeBSD.org/src/commit/?id=2e547442ab3822d3d7c46a68f152032ef5fe337c

commit 2e547442ab3822d3d7c46a68f152032ef5fe337c
Author:     Eugene Grosbein <eugen@FreeBSD.org>
AuthorDate: 2022-05-01 16:34:08 +0000
Commit:     Eugene Grosbein <eugen@FreeBSD.org>
CommitDate: 2022-05-01 16:34:08 +0000

    ng_pppoe: introduce new sysctl net.graph.pppoe.lcp_pcp
    
    New sysctl allows to mark transmitted PPPoE LCP Control
    ethernet frames with needed 3-bit Priority Code Point (PCP) value.
    Confirming driver like if_vlan(4) uses the value to fill
    IEEE 802.1p class of service field.
    
    This is similar to Cisco IOS "control-packets vlan cos priority"
    command.
    
    It helps to avoid premature disconnection of user sessions
    due to control frame drops (LCP Echo etc.)
    if network infrastructure has a botteleck at a switch
    or the xdsl DSLAM.
    
    See also:
    https://sourceforge.net/p/mpd/discussion/44692/thread/c7abe70e3a/
    
    Tested by:      Klaus Fokuhl at SourceForge
    MFC after:      2 weeks
---
 share/man/man4/ng_pppoe.4 | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/share/man/man4/ng_pppoe.4 b/share/man/man4/ng_pppoe.4
index d4ca53e68714..d9853a746512 100644
--- a/share/man/man4/ng_pppoe.4
+++ b/share/man/man4/ng_pppoe.4
@@ -35,7 +35,7 @@
 .\" $FreeBSD$
 .\" $Whistle: ng_pppoe.8,v 1.1 1999/01/25 23:46:27 archie Exp $
 .\"
-.Dd February 14, 2018
+.Dd May 1, 2022
 .Dt NG_PPPOE 4
 .Os
 .Sh NAME
@@ -320,6 +320,18 @@ This node shuts down upon receipt of a
 control message, when all session have been disconnected or when the
 .Dv ethernet
 hook is disconnected.
+.Sh SYSCTL VARIABLES
+The node can mark transmitted LCP Ethernet packets (protocol 0xc021)
+with 3-bit Priority code point (PCP) referring to IEEE 802.1p
+class of service with following
+.Xr sysctl 8
+variable.
+.Bl -tag -width indent
+.It Va net.graph.pppoe.lcp_pcp: 0..7 (default: 0)
+Set it to non-zero value to be used by parent network interface driver
+like
+.Xr vlan 4
+.El
 .Sh EXAMPLES
 The following code uses
 .Dv libnetgraph
@@ -556,7 +568,8 @@ setup(char *ethername, char *service, char *sessname,
 .Xr ng_ppp 4 ,
 .Xr ng_socket 4 ,
 .Xr ngctl 8 ,
-.Xr ppp 8
+.Xr ppp 8 ,
+.Xr vlan 4
 .Rs
 .%A L. Mamakos
 .%A K. Lidl