summaryrefslogtreecommitdiff
path: root/Documentation/networking/ppp_generic.rst
diff options
context:
space:
mode:
authorTom Parkin <tparkin@katalix.com>2020-12-10 18:50:58 +0300
committerDavid S. Miller <davem@davemloft.net>2020-12-11 00:57:36 +0300
commit563b603bd65db452edd66f44f66823ce6fe40a0d (patch)
treeb633e77edf2fb0e76dad0a86be929f5da0db6023 /Documentation/networking/ppp_generic.rst
parent4cf476ced45d7f12df30a68e833b263e7a2202d1 (diff)
downloadlinux-563b603bd65db452edd66f44f66823ce6fe40a0d.tar.xz
docs: update ppp_generic.rst to document new ioctls
Add documentation of the newly-added PPPIOCBRIDGECHAN and PPPIOCUNBRIDGECHAN ioctls. Signed-off-by: Tom Parkin <tparkin@katalix.com> Signed-off-by: David S. Miller <davem@davemloft.net>
Diffstat (limited to 'Documentation/networking/ppp_generic.rst')
-rw-r--r--Documentation/networking/ppp_generic.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/Documentation/networking/ppp_generic.rst b/Documentation/networking/ppp_generic.rst
index e60504377900..5a10abce5964 100644
--- a/Documentation/networking/ppp_generic.rst
+++ b/Documentation/networking/ppp_generic.rst
@@ -314,6 +314,22 @@ channel are:
it is connected to. It will return an EINVAL error if the channel
is not connected to an interface.
+* PPPIOCBRIDGECHAN bridges a channel with another. The argument should
+ point to an int containing the channel number of the channel to bridge
+ to. Once two channels are bridged, frames presented to one channel by
+ ppp_input() are passed to the bridge instance for onward transmission.
+ This allows frames to be switched from one channel into another: for
+ example, to pass PPPoE frames into a PPPoL2TP session. Since channel
+ bridging interrupts the normal ppp_input() path, a given channel may
+ not be part of a bridge at the same time as being part of a unit.
+ This ioctl will return an EALREADY error if the channel is already
+ part of a bridge or unit, or ENXIO if the requested channel does not
+ exist.
+
+* PPPIOCUNBRIDGECHAN performs the inverse of PPPIOCBRIDGECHAN, unbridging
+ a channel pair. This ioctl will return an EINVAL error if the channel
+ does not form part of a bridge.
+
* All other ioctl commands are passed to the channel ioctl() function.
The ioctl calls that are available on an instance that is attached to