VETH(4) Linux Programmer's Manual VETH(4)
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 de-
vice. 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 allow-
ing communication between network namespaces. To do this, one can provide the netns pa-
rameter 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 some-
thing 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)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-02 06:01 @216.73.216.149 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)