diff options
-rw-r--r-- | docs/interfaces/advanced-index.rst | 11 | ||||
-rw-r--r-- | docs/interfaces/wirelessmodem.rst | 71 |
2 files changed, 77 insertions, 5 deletions
diff --git a/docs/interfaces/advanced-index.rst b/docs/interfaces/advanced-index.rst index 73c471e9..e34cf2b0 100644 --- a/docs/interfaces/advanced-index.rst +++ b/docs/interfaces/advanced-index.rst @@ -7,14 +7,15 @@ Advanced Network Interfaces .. toctree:: :maxdepth: 1 - dummy - bridge bond + bridge + dummy + geneve l2tpv3 pseudo-ethernet - wireless + qinq tunnel vlan - qinq vxlan - geneve + wireless + wirelessmodem diff --git a/docs/interfaces/wirelessmodem.rst b/docs/interfaces/wirelessmodem.rst new file mode 100644 index 00000000..a300d7f4 --- /dev/null +++ b/docs/interfaces/wirelessmodem.rst @@ -0,0 +1,71 @@ +.. _wwan-interface: + +#################### +WirelessModem (WWAN) +#################### + +Configuration +############# + +The wirelessmodem interface provides access (through a wireless modem/wwan) to +wireless networks provided by various cellular providers. VyOS uses the +interfaces wirelessmodem subsystem for configuration. + +Address +------- + +.. cfgcmd:: set interfaces wirelessmodem <interface> apn <apn> + + Every WWAN connection requires an :abbr:`APN (Access Point Name)` which is + used by the client to dial into the ISPs network. This is a mandatory + parameter. See the following list of well-known APNs: + + - AT&T (isp.cingular) + - Deutsche Telekom (internet.t-d1.de or internet.telekom) + +.. cfgcmd:: set interfaces wirelessmodem <interface> backup distance <metric> + + Configure metric of the default route added via the Wireless Modem interface. + The default metric if not specified is 10. + +.. cfgcmd:: set interfaces wirelessmodem <interface> device <tty> + + Device identifier of the underlaying physical interface. This is usually a + ttyUSB device, if not configured this defaults to ttyUSB2. + +.. cfgcmd:: set interfaces wirelessmodem <interface> no-peer-dns + + Do not install DNS nameservers received from ISP into system wide nameserver + list. + +.. cfgcmd:: set interfaces wirelessmodem <interface> ondemand + + Enables or disables on-demand WWAN connection. + + Use this command to instruct the system to establish a PPP connection + automatically once traffic passes through the interface. A disabled on-demand + connection is established at boot time and remains up. If the link fails for + any reason, the link is brought back up immediately. + +Link Administration +------------------- + +.. cfgcmd:: set interfaces wirelessmodem <interface> description <description> + + Assign given `<description>` to interface. Description will also be passed + to SNMP monitoring systems. + +.. cfgcmd:: set interfaces wirelessmodem <interface> disable + + Disable given `<interface>`. It will be placed in administratively down + state. + +.. cfgcmd:: set interfaces wirelessmodem <interface> mtu <mtu> + + Configure :abbr:`MTU (Maximum Transmission Unit)` on given `<interface>`. It + is the size (in bytes) of the largest ethernet frame sent on this link. + + + +Operation +========= |