NAME

       veth - Virtual Ethernet Device

DESCRIPTION

       The  veth  devices  are  virtual Ethernet devices.  They can act as tunnels between network namespaces to
       create a bridge to a physical network device in another namespace, but can also  be  used  as  standalone
       network devices.

       veth devices are always created in interconnected pairs.  A pair can be created using the command:

           # ip link add <p1-name> type veth peer name <p2-name>

       In the above, p1-name and p2-name are the names assigned to the two connected end points.

       Packets  transmitted on one device in the pair are immediately received on the other device.  When either
       devices is down the link state of the pair is down.

       veth device pairs are useful for combining the network facilities of the kernel together  in  interesting
       ways.   A  particularly  interesting use case is to place one end of a veth pair in one network namespace
       and the other end in another network namespace, thus allowing communication between  network  namespaces.
       To do this, one can provide the netns parameter when creating the interfaces:

           # ip link add <p1-name> netns <p1-ns> type veth peer <p2-name> netns <p2-ns>

       or, for an existing veth pair, move one side to the other namespace:

           # ip link set <p2-name> netns <p2-ns>

       ethtool(8) can be used to find the peer of a veth network interface, using commands something like:

           # ip link add ve_A type veth peer name ve_B   # Create veth pair
           # ethtool -S ve_A         # Discover interface index of peer
           NIC statistics:
                peer_ifindex: 16
           # ip link | grep '^16:'   # Look up interface
           16: ve_B@ve_A: <BROADCAST,MULTICAST,M-DOWN> mtu 1500 qdisc ...

SEE ALSO

       clone(2), network_namespaces(7), ip(8), ip-link(8), ip-netns(8)

COLOPHON

       This  page  is  part  of  release  5.10  of  the  Linux man-pages project.  A description of the project,
       information  about  reporting  bugs,  and  the  latest  version  of  this   page,   can   be   found   at
       https://www.kernel.org/doc/man-pages/.

Linux                                              2020-11-01                                            VETH(4)