wwan: adjust documentation to latest CLI syntax version

(cherry picked from commit 5a8a33ac3677147b8642423e7246015c5d2f457a)

3 files changed, 108 insertions, 129 deletions

diff --git a/docs/configuration/interfaces/index.rst b/docs/configuration/interfaces/index.rst
index 85d2c177..3c75f482 100644
--- a/docs/configuration/interfaces/index.rst
+++ b/docs/configuration/interfaces/index.rst
@@ -23,6 +23,6 @@ Interfaces
    vxlan
    wireguard
    wireless
-   wirelessmodem
+   wwan
 
 
diff --git a/docs/configuration/interfaces/wirelessmodem.rst b/docs/configuration/interfaces/wirelessmodem.rst
deleted file mode 100644
index a65a47f4..00000000
--- a/docs/configuration/interfaces/wirelessmodem.rst
+++ /dev/null
@@ -1,128 +0,0 @@
-.. _wwan-interface:
-
-####################
-WirelessModem (WWAN)
-####################
-
-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.
-
-*************
-Configuration
-*************
-
-Common interface configuration
-==============================
-
-.. cmdinclude:: /_include/interface-description.txt
-   :var0: wirelessmodem
-   :var1: wlm0
-
-.. cmdinclude:: /_include/interface-disable.txt
-   :var0: wirelessmodem
-   :var1: wlm0
-
-.. cmdinclude:: /_include/interface-vrf.txt
-   :var0: wirelessmodem
-   :var1: wlm0
-
-WirelessModem (WWAN) options
-============================
-
-.. 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. Contact your Service Provider for correct APN.
-
-.. 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> connect-on-demand
-
-   When set the interface is enabled for "dial-on-demand".
-
-   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.
-
-*********
-Operation
-*********
-
-.. opcmd:: show interfaces wirelessmodem <interface>
-
-   Retrive interface information from given WWAN interface.
-
-   .. code-block:: none
-
-     vyos@vyos:~$ show interfaces wirelessmodem wlm0
-     wlm0: <POINTOPOINT,MULTICAST,NOARP,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast master black state UNKNOWN group default qlen 3
-         link/ppp
-         inet 10.26.238.93 peer 10.64.64.64/32 scope global wlm0
-            valid_lft forever preferred_lft forever
-         Description: baaar
-
-         RX:  bytes    packets     errors    dropped    overrun      mcast
-                 38          5          0          0          0          0
-         TX:  bytes    packets     errors    dropped    carrier collisions
-                217          8          0          0          0          0
-
-.. opcmd:: show interfaces wirelessmodem <interface> statistics
-
-   Retrive interface statistics from given WWAN interface.
-
-   .. code-block:: none
-
-     vyos@vyos:~$ show interfaces wirelessmodem wlm0 statistics
-         IN   PACK VJCOMP  VJUNC  VJERR  |      OUT   PACK VJCOMP  VJUNC NON-VJ
-         38      5      0      0      0  |      217      8      0      0      8
-
-.. opcmd:: show interfaces wirelessmodem <interface> log
-
-   Displays log information for a WWAN interface.
-
-
-*******
-Example
-*******
-
-The following example is based on a Sierra Wireless MC7710 miniPCIe card (only
-the form factor in reality it runs UBS) and Deutsche Telekom as ISP. The card
-is assembled into a :ref:`pc-engines-apu4`.
-
-.. code-block:: none
-
-  set interfaces wirelessmodem wlm0 apn 'internet.telekom'
-  set interfaces wirelessmodem wlm0 backup distance '100'
-  set interfaces wirelessmodem wlm0 device 'ttyUSB2'
-  set interfaces wirelessmodem wlm0 disable
-  set interfaces wirelessmodem wlm0 no-peer-dns
-
-*****************
-Supported Modules
-*****************
-
-The following hardware modules have been tested successfully in an
-:ref:`pc-engines-apu4` board:
-
-* Sierra Wireless AirPrime MC7304 miniPCIe card (LTE)
-* Sierra Wireless AirPrime MC7430 miniPCIe card (LTE)
-* Sierra Wireless AirPrime MC7455 miniPCIe card (LTE)
-* Sierra Wireless AirPrime MC7710 miniPCIe card (LTE)
-* Huawei ME909u-521 miniPCIe card (LTE)
-* Huawei ME909s-120 miniPCIe card (LTE)
diff --git a/docs/configuration/interfaces/wwan.rst b/docs/configuration/interfaces/wwan.rst
new file mode 100644
index 00000000..cfe074f6
--- /dev/null
+++ b/docs/configuration/interfaces/wwan.rst
@@ -0,0 +1,107 @@
+.. _wwan-interface:
+
+#################################
+Wireless Wide-Area-Network (WWAN)
+#################################
+
+The Wireless Wide-Area-Network interface provides access (through a wireless
+modem/wwan) to wireless networks provided by various cellular providers.
+
+VyOS uses the `interfaces wwan` subsystem for configuration.
+
+*************
+Configuration
+*************
+
+Common interface configuration
+==============================
+
+.. cmdinclude:: /_include/interface-address-with-dhcp.txt
+   :var0: wwan
+   :var1: wwan0
+
+
+.. cmdinclude:: /_include/interface-description.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-disable.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-disable-link-detect.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-mtu.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-ip.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-ipv6.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-vrf.txt
+   :var0: wwan
+   :var1: wwan0
+
+**DHCP(v6)**
+
+.. cmdinclude:: /_include/interface-dhcp-options.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-dhcpv6-options.txt
+   :var0: wwan
+   :var1: wwan0
+
+.. cmdinclude:: /_include/interface-dhcpv6-prefix-delegation.txt
+   :var0: wwan
+   :var1: wwan0
+
+WirelessModem (WWAN) options
+============================
+
+.. cfgcmd:: set interfaces wwan <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. Contact your Service Provider for correct APN.
+
+
+*********
+Operation
+*********
+
+TBD
+
+*******
+Example
+*******
+
+The following example is based on a Sierra Wireless MC7710 miniPCIe card (only
+the form factor in reality it runs UBS) and Deutsche Telekom as ISP. The card
+is assembled into a :ref:`pc-engines-apu4`.
+
+.. code-block:: none
+
+  set interfaces wwan wwan0 apn 'internet.telekom'
+  set interfaces wwan wwan0 address 'dhcp'
+
+*****************
+Supported Modules
+*****************
+
+The following hardware modules have been tested successfully in an
+:ref:`pc-engines-apu4` board:
+
+* Sierra Wireless AirPrime MC7304 miniPCIe card (LTE)
+* Sierra Wireless AirPrime MC7430 miniPCIe card (LTE)
+* Sierra Wireless AirPrime MC7455 miniPCIe card (LTE)
+* Sierra Wireless AirPrime MC7710 miniPCIe card (LTE)
+* Huawei ME909u-521 miniPCIe card (LTE)
+* Huawei ME909s-120 miniPCIe card (LTE)