Commit 40814b98 authored by Brendan Higgins's avatar Brendan Higgins Committed by Richard Weinberger
Browse files

um: Mark non-vector net transports as obsolete

UML_NET_VECTOR now supports filters compiled with pcap outside of UML;
it also supports: EoGRE, EoL2TPv3, RAW (+/- BPF), TAP and BESS.

While vector drivers are not 1:1 replacements for the existing drivers,
you can achieve the same topologies and the same connectivity at much
higher performance (2.5 to 9 Gbit on mid-range Ryzen desktop) - the old
drivers test out in the 500Mbit range on the same hardware.

For all these reasons, the non-vector based transports are now
unnecessary, and some, most notably pcap and vde are maintenance
burdens. Thus, it makes sense to at least start thinking about removing
the non-vector transports, so for now, mark them as obsolete.

Link: https://lore.kernel.org/lkml/15f048d3-07ab-61c1-c6e0-0712e626dd33@cambridgegreys.com/T/#u


Suggested-by: default avatarAnton Ivanov <anton.ivanov@cambridgegreys.com>
Signed-off-by: default avatarBrendan Higgins <brendanhiggins@google.com>
Signed-off-by: default avatarRichard Weinberger <richard@nod.at>
parent f1dc67d0
Loading
Loading
Loading
Loading
+41 −40
Original line number Diff line number Diff line
@@ -147,7 +147,7 @@ config UML_NET
	  make use of UML networking.

config UML_NET_ETHERTAP
	bool "Ethertap transport"
	bool "Ethertap transport (obsolete)"
	depends on UML_NET
	help
	  The Ethertap User-Mode Linux network transport allows a single
@@ -167,14 +167,13 @@ config UML_NET_ETHERTAP
	  has examples of the UML command line to use to enable Ethertap
	  networking.

	  If you'd like to set up an IP network with the host and/or the
	  outside world, say Y to this, the Daemon Transport and/or the
	  Slip Transport.  You'll need at least one of them, but may choose
	  more than one without conflict.  If you don't need UML networking,
	  say N.
	  NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	  migrate to UML_NET_VECTOR.

	  If unsure, say N.

config UML_NET_TUNTAP
	bool "TUN/TAP transport"
	bool "TUN/TAP transport (obsolete)"
	depends on UML_NET
	help
	  The UML TUN/TAP network transport allows a UML instance to exchange
@@ -185,8 +184,13 @@ config UML_NET_TUNTAP
	  To use this transport, your host kernel must have support for TUN/TAP
	  devices, either built-in or as a module.

	  NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	  migrate to UML_NET_VECTOR.

	  If unsure, say N.

config UML_NET_SLIP
	bool "SLIP transport"
	bool "SLIP transport (obsolete)"
	depends on UML_NET
	help
	  The slip User-Mode Linux network transport allows a running UML to
@@ -201,16 +205,13 @@ config UML_NET_SLIP
	  has examples of the UML command line to use to enable slip
	  networking, and details of a few quirks with it.

	  The Ethertap Transport is preferred over slip because of its
	  limitations.  If you prefer slip, however, say Y here.  Otherwise
	  choose the Multicast transport (to network multiple UMLs on
	  multiple hosts), Ethertap (to network with the host and the
	  outside world), and/or the Daemon transport (to network multiple
	  UMLs on a single host).  You may choose more than one without
	  conflict.  If you don't need UML networking, say N.
	  NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	  migrate to UML_NET_VECTOR.

	  If unsure, say N.

config UML_NET_DAEMON
	bool "Daemon transport"
	bool "Daemon transport (obsolete)"
	depends on UML_NET
	help
	  This User-Mode Linux network transport allows one or more running
@@ -225,13 +226,10 @@ config UML_NET_DAEMON
	  has examples of the UML command line to use to enable Daemon
	  networking.

	  If you'd like to set up a network with other UMLs on a single host,
	  say Y.  If you need a network between UMLs on multiple physical
	  hosts, choose the Multicast Transport.  To set up a network with
	  the host and/or other IP machines, say Y to the Ethertap or Slip
	  transports.  You'll need at least one of them, but may choose
	  more than one without conflict.  If you don't need UML networking,
	  say N.
	  NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	  migrate to UML_NET_VECTOR.

	  If unsure, say N.

config UML_NET_VECTOR
	bool "Vector I/O high performance network devices"
@@ -245,7 +243,7 @@ config UML_NET_VECTOR
	drivers.

config UML_NET_VDE
	bool "VDE transport"
	bool "VDE transport (obsolete)"
	depends on UML_NET
	help
	This User-Mode Linux network transport allows one or more running
@@ -263,11 +261,13 @@ config UML_NET_VDE
	That site has a good overview of what VDE is and also examples
	of the UML command line to use to enable VDE networking.

	If you need UML networking with VDE,
	say Y.
	NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	migrate to UML_NET_VECTOR.

	If unsure, say N.

config UML_NET_MCAST
	bool "Multicast transport"
	bool "Multicast transport (obsolete)"
	depends on UML_NET
	help
	  This Multicast User-Mode Linux network transport allows multiple
@@ -284,15 +284,13 @@ config UML_NET_MCAST
	  has examples of the UML command line to use to enable Multicast
	  networking, and notes about the security of this approach.

	  If you need UMLs on multiple physical hosts to communicate as if
	  they shared an Ethernet network, say Y.  If you need to communicate
	  with other IP machines, make sure you select one of the other
	  transports (possibly in addition to Multicast; they're not
	  exclusive).  If you don't need to network UMLs say N to each of
	  the transports.
	  NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	  migrate to UML_NET_VECTOR.

	  If unsure, say N.

config UML_NET_PCAP
	bool "pcap transport"
	bool "pcap transport (obsolete)"
	depends on UML_NET
	help
	The pcap transport makes a pcap packet stream on the host look
@@ -304,11 +302,13 @@ config UML_NET_PCAP
	  <http://user-mode-linux.sourceforge.net/old/networking.html>  That site
	  has examples of the UML command line to use to enable this option.

	If you intend to use UML as a network monitor for the host, say
	Y here.  Otherwise, say N.
	NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	migrate to UML_NET_VECTOR.

	If unsure, say N.

config UML_NET_SLIRP
	bool "SLiRP transport"
	bool "SLiRP transport (obsolete)"
	depends on UML_NET
	help
	  The SLiRP User-Mode Linux network transport allows a running UML
@@ -328,9 +328,10 @@ config UML_NET_SLIRP
	  that of a host behind a firewall that masquerades all network
	  connections passing through it (but is less secure).

	  To use this you should first have slirp compiled somewhere
	  accessible on the host, and have read its documentation.  If you
	  don't need UML networking, say N.
	  NOTE: THIS TRANSPORT IS DEPRECATED AND WILL BE REMOVED SOON!!! Please
	  migrate to UML_NET_VECTOR.

	  If unsure, say N.

	  Startup example: "eth0=slirp,FE:FD:01:02:03:04,/usr/local/bin/slirp"