From 1459db4abde8666edd6e828e5a1a0060a91a5b4b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Posp=C3=AD=C5=A1ek?= Date: Tue, 3 Oct 2017 15:52:04 +0200 Subject: [PATCH] veth.4: New page document veth virtual ethernet devices MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Based on a page from Tomáš Pospíšek, with some clean-ups by mtk. Signed-off-by: Michael Kerrisk --- man4/veth.4 | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 man4/veth.4 diff --git a/man4/veth.4 b/man4/veth.4 new file mode 100644 index 000000000..58a6cecb5 --- /dev/null +++ b/man4/veth.4 @@ -0,0 +1,55 @@ +.\" Copyright (c) 2012 Tomáš Pospíšek (tpo_deb@sourcepole.ch), +.\" Fri, 03 Nov 2012 22:35:33 +0100 +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, +.\" USA. +.\" +.\" +.TH veth 4 2017-10-03 "Linux" "Linux Programmer's Manual" +.SH NAME +veth \- Virtual Ethernet Device +.SH DESCRIPTION +The +.B veth +devices are virtual Ethernet devices. +.PP +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. +.PP +Because of their original purpose for tunneling +.B veth +devices are always created in pairs, that are +interconnected with each other. +When one +.B veth +end receives a packet it appears on its pair and vice versa. +.PP +.B Veth +devices can be manipulated with the +.BR ip (8) +tool. +See +.I "ip link help" +for more information. +.PP +.SH "SEE ALSO" +.BR clone (2), +.BR ip (8)