Kconfig.net 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204
  1. # SPDX-License-Identifier: GPL-2.0
  2. menu "UML Network Devices"
  3. depends on NET
  4. # UML virtual driver
  5. config UML_NET
  6. bool "Virtual network device"
  7. help
  8. While the User-Mode port cannot directly talk to any physical
  9. hardware devices, this choice and the following transport options
  10. provide one or more virtual network devices through which the UML
  11. kernels can talk to each other, the host, and with the host's help,
  12. machines on the outside world.
  13. For more information, including explanations of the networking and
  14. sample configurations, see
  15. <http://user-mode-linux.sourceforge.net/old/networking.html>.
  16. If you'd like to be able to enable networking in the User-Mode
  17. linux environment, say Y; otherwise say N. Note that you must
  18. enable at least one of the following transport options to actually
  19. make use of UML networking.
  20. config UML_NET_ETHERTAP
  21. bool "Ethertap transport"
  22. depends on UML_NET
  23. help
  24. The Ethertap User-Mode Linux network transport allows a single
  25. running UML to exchange packets with its host over one of the
  26. host's Ethertap devices, such as /dev/tap0. Additional running
  27. UMLs can use additional Ethertap devices, one per running UML.
  28. While the UML believes it's on a (multi-device, broadcast) virtual
  29. Ethernet network, it's in fact communicating over a point-to-point
  30. link with the host.
  31. To use this, your host kernel must have support for Ethertap
  32. devices. Also, if your host kernel is 2.4.x, it must have
  33. CONFIG_NETLINK_DEV configured as Y or M.
  34. For more information, see
  35. <http://user-mode-linux.sourceforge.net/old/networking.html> That site
  36. has examples of the UML command line to use to enable Ethertap
  37. networking.
  38. If you'd like to set up an IP network with the host and/or the
  39. outside world, say Y to this, the Daemon Transport and/or the
  40. Slip Transport. You'll need at least one of them, but may choose
  41. more than one without conflict. If you don't need UML networking,
  42. say N.
  43. config UML_NET_TUNTAP
  44. bool "TUN/TAP transport"
  45. depends on UML_NET
  46. help
  47. The UML TUN/TAP network transport allows a UML instance to exchange
  48. packets with the host over a TUN/TAP device. This option will only
  49. work with a 2.4 host, unless you've applied the TUN/TAP patch to
  50. your 2.2 host kernel.
  51. To use this transport, your host kernel must have support for TUN/TAP
  52. devices, either built-in or as a module.
  53. config UML_NET_SLIP
  54. bool "SLIP transport"
  55. depends on UML_NET
  56. help
  57. The slip User-Mode Linux network transport allows a running UML to
  58. network with its host over a point-to-point link. Unlike Ethertap,
  59. which can carry any Ethernet frame (and hence even non-IP packets),
  60. the slip transport can only carry IP packets.
  61. To use this, your host must support slip devices.
  62. For more information, see
  63. <http://user-mode-linux.sourceforge.net/old/networking.html>.
  64. has examples of the UML command line to use to enable slip
  65. networking, and details of a few quirks with it.
  66. The Ethertap Transport is preferred over slip because of its
  67. limitations. If you prefer slip, however, say Y here. Otherwise
  68. choose the Multicast transport (to network multiple UMLs on
  69. multiple hosts), Ethertap (to network with the host and the
  70. outside world), and/or the Daemon transport (to network multiple
  71. UMLs on a single host). You may choose more than one without
  72. conflict. If you don't need UML networking, say N.
  73. config UML_NET_DAEMON
  74. bool "Daemon transport"
  75. depends on UML_NET
  76. help
  77. This User-Mode Linux network transport allows one or more running
  78. UMLs on a single host to communicate with each other, but not to
  79. the host.
  80. To use this form of networking, you'll need to run the UML
  81. networking daemon on the host.
  82. For more information, see
  83. <http://user-mode-linux.sourceforge.net/old/networking.html> That site
  84. has examples of the UML command line to use to enable Daemon
  85. networking.
  86. If you'd like to set up a network with other UMLs on a single host,
  87. say Y. If you need a network between UMLs on multiple physical
  88. hosts, choose the Multicast Transport. To set up a network with
  89. the host and/or other IP machines, say Y to the Ethertap or Slip
  90. transports. You'll need at least one of them, but may choose
  91. more than one without conflict. If you don't need UML networking,
  92. say N.
  93. config UML_NET_VDE
  94. bool "VDE transport"
  95. depends on UML_NET
  96. help
  97. This User-Mode Linux network transport allows one or more running
  98. UMLs on a single host to communicate with each other and also
  99. with the rest of the world using Virtual Distributed Ethernet,
  100. an improved fork of uml_switch.
  101. You must have libvdeplug installed in order to build the vde
  102. transport into UML.
  103. To use this form of networking, you will need to run vde_switch
  104. on the host.
  105. For more information, see <http://wiki.virtualsquare.org/>
  106. That site has a good overview of what VDE is and also examples
  107. of the UML command line to use to enable VDE networking.
  108. If you need UML networking with VDE,
  109. say Y.
  110. config UML_NET_MCAST
  111. bool "Multicast transport"
  112. depends on UML_NET
  113. help
  114. This Multicast User-Mode Linux network transport allows multiple
  115. UMLs (even ones running on different host machines!) to talk to
  116. each other over a virtual ethernet network. However, it requires
  117. at least one UML with one of the other transports to act as a
  118. bridge if any of them need to be able to talk to their hosts or any
  119. other IP machines.
  120. To use this, your host kernel(s) must support IP Multicasting.
  121. For more information, see
  122. <http://user-mode-linux.sourceforge.net/old/networking.html> That site
  123. has examples of the UML command line to use to enable Multicast
  124. networking, and notes about the security of this approach.
  125. If you need UMLs on multiple physical hosts to communicate as if
  126. they shared an Ethernet network, say Y. If you need to communicate
  127. with other IP machines, make sure you select one of the other
  128. transports (possibly in addition to Multicast; they're not
  129. exclusive). If you don't need to network UMLs say N to each of
  130. the transports.
  131. config UML_NET_PCAP
  132. bool "pcap transport"
  133. depends on UML_NET
  134. help
  135. The pcap transport makes a pcap packet stream on the host look
  136. like an ethernet device inside UML. This is useful for making
  137. UML act as a network monitor for the host. You must have libcap
  138. installed in order to build the pcap transport into UML.
  139. For more information, see
  140. <http://user-mode-linux.sourceforge.net/old/networking.html> That site
  141. has examples of the UML command line to use to enable this option.
  142. If you intend to use UML as a network monitor for the host, say
  143. Y here. Otherwise, say N.
  144. config UML_NET_SLIRP
  145. bool "SLiRP transport"
  146. depends on UML_NET
  147. help
  148. The SLiRP User-Mode Linux network transport allows a running UML
  149. to network by invoking a program that can handle SLIP encapsulated
  150. packets. This is commonly (but not limited to) the application
  151. known as SLiRP, a program that can re-socket IP packets back onto
  152. the host on which it is run. Only IP packets are supported,
  153. unlike other network transports that can handle all Ethernet
  154. frames. In general, slirp allows the UML the same IP connectivity
  155. to the outside world that the host user is permitted, and unlike
  156. other transports, SLiRP works without the need of root level
  157. privleges, setuid binaries, or SLIP devices on the host. This
  158. also means not every type of connection is possible, but most
  159. situations can be accommodated with carefully crafted slirp
  160. commands that can be passed along as part of the network device's
  161. setup string. The effect of this transport on the UML is similar
  162. that of a host behind a firewall that masquerades all network
  163. connections passing through it (but is less secure).
  164. To use this you should first have slirp compiled somewhere
  165. accessible on the host, and have read its documentation. If you
  166. don't need UML networking, say N.
  167. Startup example: "eth0=slirp,FE:FD:01:02:03:04,/usr/local/bin/slirp"
  168. endmenu