summaryrefslogtreecommitdiff
path: root/docs/interfaces/loopback.rst
diff options
context:
space:
mode:
authorDaniel Thorpe <1077065+dantho281@users.noreply.github.com>2021-02-11 02:25:57 +0000
committerGitHub <noreply@github.com>2021-02-11 02:25:57 +0000
commite88fba68357181bd54fcc7489cbba08780cee6cd (patch)
treeb67e88b1208fa835edf0420a42dd2b624ec2105b /docs/interfaces/loopback.rst
parentdab473bfd04ab2930c043b853ba9995d1ff335e6 (diff)
parentf33b0c78b07c80998d2c0e64d6a20bcb109f6db5 (diff)
downloadvyos-documentation-e88fba68357181bd54fcc7489cbba08780cee6cd.tar.gz
vyos-documentation-e88fba68357181bd54fcc7489cbba08780cee6cd.zip
Merge pull request #1 from vyos/master
Update fork
Diffstat (limited to 'docs/interfaces/loopback.rst')
-rw-r--r--docs/interfaces/loopback.rst75
1 files changed, 0 insertions, 75 deletions
diff --git a/docs/interfaces/loopback.rst b/docs/interfaces/loopback.rst
deleted file mode 100644
index e15062cf..00000000
--- a/docs/interfaces/loopback.rst
+++ /dev/null
@@ -1,75 +0,0 @@
-.. _loopback-interface:
-
-########
-Loopback
-########
-
-The loopback networking interface is a virtual network device implemented
-entirely in software. All traffic sent to it "loops back" and just targets
-services on your local machine.
-
-.. note:: There can only be one loopback ``lo`` interface on the system. If
- you need multiple interfaces, please use the :ref:`dummy-interface`
- interface type.
-
-.. hint:: A lookback interface is always up, thus it could be used for
- management traffic or as source/destination for and :abbr:`IGP (Interior
- Gateway Protocol)` like :ref:`bgp` so your internal BGP link is not dependent
- on physical link states and multiple routes can be chosen to the
- destination. A :ref:`dummy-interface` Interface should always be preferred
- over a :ref:`loopback-interface` interface.
-
-Configuration
-=============
-
-Address
--------
-
-.. cfgcmd:: set interfaces loopback lo address <address>
-
- Configure Loopback interface `lo` with one or more interface addresses.
- Address can be specified multiple times as IPv4 and/or IPv6 address, e.g.
- 192.0.2.1/24 and/or 2001:db8::1/64.
-
-Link Administration
--------------------
-
-.. cfgcmd:: set interfaces loopback lo description <description>
-
- Assign given `<description>` to interface `lo`. Description will also be
- passed to SNMP monitoring systems.
-
-Operation
-=========
-
-.. opcmd:: show interfaces loopback
-
- Show brief interface information.
-
- .. code-block:: none
-
- vyos@vyos:~$ show interfaces loopback
- Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down
- Interface IP Address S/L Description
- --------- ---------- --- -----------
- lo 127.0.0.1/8 u/u
- ::1/128
-
-.. opcmd:: show interfaces loopback lo
-
- Show detailed information on given loopback interface `lo`.
-
- .. code-block:: none
-
- vyos@vyos:~$ show interfaces ethernet eth0
- lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
- link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
- inet 127.0.0.1/8 scope host lo
- valid_lft forever preferred_lft forever
- inet6 ::1/128 scope host
- valid_lft forever preferred_lft forever
-
- RX: bytes packets errors dropped overrun mcast
- 300 6 0 0 0 0
- TX: bytes packets errors dropped carrier collisions
- 300 6 0 0 0 0