summaryrefslogtreecommitdiff
path: root/docs/interfaces/index.rst
diff options
context:
space:
mode:
authorKim <kim.sidney@gmail.com>2019-03-05 21:37:25 +0100
committerGitHub <noreply@github.com>2019-03-05 21:37:25 +0100
commitf4456860eda554395ff96dfd66946722611bae4e (patch)
tree35e7d2dc808c048450b43cfc685ee82eee823197 /docs/interfaces/index.rst
parent56b851b9fd9e9637545adedc85342f2a65f922c5 (diff)
parente6fa2569332c15a61f3c99ba0fe639696836d3bd (diff)
downloadvyos-documentation-f4456860eda554395ff96dfd66946722611bae4e.tar.gz
vyos-documentation-f4456860eda554395ff96dfd66946722611bae4e.zip
Merge pull request #10 from kmpm/features/split-interfaces
Split network-interfaces into multiple files
Diffstat (limited to 'docs/interfaces/index.rst')
-rw-r--r--docs/interfaces/index.rst60
1 files changed, 60 insertions, 0 deletions
diff --git a/docs/interfaces/index.rst b/docs/interfaces/index.rst
new file mode 100644
index 00000000..577ffe09
--- /dev/null
+++ b/docs/interfaces/index.rst
@@ -0,0 +1,60 @@
+.. _network-interfaces:
+
+Network Interfaces
+==================
+
+Configured interfaces on a VyOS system can be displayed using the
+`show interfaces` command.
+
+.. code-block:: sh
+
+ vyos@vyos:~$ show interfaces
+ Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down
+ Interface IP Address S/L Description
+ --------- ---------- --- -----------
+ eth0 172.16.51.129/24 u/u OUTSIDE
+ eth1 192.168.0.1/24 u/u INSIDE
+ lo 127.0.0.1/8 u/u
+ ::1/128
+ vyos@vyos:~$
+
+A specific interface can be shown using the `show interfaces <type> <name>`
+command.
+
+.. code-block:: sh
+
+ vyos@vyos:~$ show interfaces ethernet eth0
+ eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
+ link/ether 00:0c:29:44:3b:0f brd ff:ff:ff:ff:ff:ff
+ inet 172.16.51.129/24 brd 172.16.51.255 scope global eth0
+ inet6 fe80::20c:29ff:fe44:3b0f/64 scope link
+ valid_lft forever preferred_lft forever
+ Description: OUTSIDE
+
+ RX: bytes packets errors dropped overrun mcast
+ 274397 3064 0 0 0 0
+ TX: bytes packets errors dropped carrier collisions
+ 257276 1890 0 0 0 0
+ vyos@vyos:~$
+
+Different network interfaces provide type-specific configuration. Ethernet
+interfaces, for example, allow the configuration of speed and duplex.
+
+Many services, such as network routing, firewall, and traffic policy also
+maintain interface-specific configuration. These will be covered in their
+respective sections.
+
+
+.. toctree::
+ :maxdepth: 2
+ :hidden:
+
+ addresses
+ ethernet
+ wireless
+ bridging
+ bonding
+ vti
+ vlan
+ vxlan
+ wireguard