]> asedeno.scripts.mit.edu Git - linux.git/commitdiff
um: Mark non-vector net transports as obsolete
authorBrendan Higgins <brendanhiggins@google.com>
Tue, 10 Dec 2019 22:34:03 +0000 (14:34 -0800)
committerRichard Weinberger <richard@nod.at>
Sun, 19 Jan 2020 21:41:56 +0000 (22:41 +0100)
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: Anton Ivanov <anton.ivanov@cambridgegreys.com>
Signed-off-by: Brendan Higgins <brendanhiggins@google.com>
Signed-off-by: Richard Weinberger <richard@nod.at>
arch/um/drivers/Kconfig

index 388096fb45a252e01340e4fdb092815de475ea83..72d4170557820f29d1b951a136d7399e401238e4 100644 (file)
@@ -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"