summaryrefslogtreecommitdiff
path: root/docs/interfaces/loopback.rst
blob: 06486faaca6c8badd8aa780a90dc34888d866155 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
.. _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
=============

Common interface configuration
------------------------------

.. cmdinclude:: ../_include/interface-address.txt
   :var0: loopback
   :var1: lo

.. cmdinclude:: ../_include/interface-description.txt
   :var0: loopback
   :var1: lo

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