xref: /linux/net/Kconfig (revision d53b8e36925256097a08d7cb749198d85cbf9b2b)
1# SPDX-License-Identifier: GPL-2.0-only
2#
3# Network configuration
4#
5
6menuconfig NET
7	bool "Networking support"
8	select NLATTR
9	select GENERIC_NET_UTILS
10	select BPF
11	help
12	  Unless you really know what you are doing, you should say Y here.
13	  The reason is that some programs need kernel networking support even
14	  when running on a stand-alone machine that isn't connected to any
15	  other computer.
16
17	  If you are upgrading from an older kernel, you
18	  should consider updating your networking tools too because changes
19	  in the kernel and the tools often go hand in hand. The tools are
20	  contained in the package net-tools, the location and version number
21	  of which are given in <file:Documentation/Changes>.
22
23	  For a general introduction to Linux networking, it is highly
24	  recommended to read the NET-HOWTO, available from
25	  <http://www.tldp.org/docs.html#howto>.
26
27if NET
28
29config WANT_COMPAT_NETLINK_MESSAGES
30	bool
31	help
32	  This option can be selected by other options that need compat
33	  netlink messages.
34
35config COMPAT_NETLINK_MESSAGES
36	def_bool y
37	depends on COMPAT
38	depends on WEXT_CORE || WANT_COMPAT_NETLINK_MESSAGES
39	help
40	  This option makes it possible to send different netlink messages
41	  to tasks depending on whether the task is a compat task or not. To
42	  achieve this, you need to set skb_shinfo(skb)->frag_list to the
43	  compat skb before sending the skb, the netlink code will sort out
44	  which message to actually pass to the task.
45
46	  Newly written code should NEVER need this option but do
47	  compat-independent messages instead!
48
49config NET_INGRESS
50	bool
51
52config NET_EGRESS
53	bool
54
55config NET_XGRESS
56	select NET_INGRESS
57	select NET_EGRESS
58	bool
59
60config NET_REDIRECT
61	bool
62
63config SKB_DECRYPTED
64	bool
65
66config SKB_EXTENSIONS
67	bool
68
69menu "Networking options"
70
71source "net/packet/Kconfig"
72source "net/unix/Kconfig"
73source "net/tls/Kconfig"
74source "net/xfrm/Kconfig"
75source "net/iucv/Kconfig"
76source "net/smc/Kconfig"
77source "net/xdp/Kconfig"
78
79config NET_HANDSHAKE
80	bool
81	depends on SUNRPC || NVME_TARGET_TCP || NVME_TCP
82	default y
83
84config NET_HANDSHAKE_KUNIT_TEST
85	tristate "KUnit tests for the handshake upcall mechanism" if !KUNIT_ALL_TESTS
86	default KUNIT_ALL_TESTS
87	depends on KUNIT
88	help
89	  This builds the KUnit tests for the handshake upcall mechanism.
90
91	  KUnit tests run during boot and output the results to the debug
92	  log in TAP format (https://testanything.org/). Only useful for
93	  kernel devs running KUnit test harness and are not for inclusion
94	  into a production build.
95
96	  For more information on KUnit and unit tests in general, refer
97	  to the KUnit documentation in Documentation/dev-tools/kunit/.
98
99config INET
100	bool "TCP/IP networking"
101	help
102	  These are the protocols used on the Internet and on most local
103	  Ethernets. It is highly recommended to say Y here (this will enlarge
104	  your kernel by about 400 KB), since some programs (e.g. the X window
105	  system) use TCP/IP even if your machine is not connected to any
106	  other computer. You will get the so-called loopback device which
107	  allows you to ping yourself (great fun, that!).
108
109	  For an excellent introduction to Linux networking, please read the
110	  Linux Networking HOWTO, available from
111	  <http://www.tldp.org/docs.html#howto>.
112
113	  If you say Y here and also to "/proc file system support" and
114	  "Sysctl support" below, you can change various aspects of the
115	  behavior of the TCP/IP code by writing to the (virtual) files in
116	  /proc/sys/net/ipv4/*; the options are explained in the file
117	  <file:Documentation/networking/ip-sysctl.rst>.
118
119	  Short answer: say Y.
120
121if INET
122source "net/ipv4/Kconfig"
123source "net/ipv6/Kconfig"
124source "net/netlabel/Kconfig"
125source "net/mptcp/Kconfig"
126
127endif # if INET
128
129config NETWORK_SECMARK
130	bool "Security Marking"
131	help
132	  This enables security marking of network packets, similar
133	  to nfmark, but designated for security purposes.
134	  If you are unsure how to answer this question, answer N.
135
136config NET_PTP_CLASSIFY
137	def_bool n
138
139config NETWORK_PHY_TIMESTAMPING
140	bool "Timestamping in PHY devices"
141	select NET_PTP_CLASSIFY
142	help
143	  This allows timestamping of network packets by PHYs (or
144	  other MII bus snooping devices) with hardware timestamping
145	  capabilities. This option adds some overhead in the transmit
146	  and receive paths.
147
148	  If you are unsure how to answer this question, answer N.
149
150menuconfig NETFILTER
151	bool "Network packet filtering framework (Netfilter)"
152	help
153	  Netfilter is a framework for filtering and mangling network packets
154	  that pass through your Linux box.
155
156	  The most common use of packet filtering is to run your Linux box as
157	  a firewall protecting a local network from the Internet. The type of
158	  firewall provided by this kernel support is called a "packet
159	  filter", which means that it can reject individual network packets
160	  based on type, source, destination etc. The other kind of firewall,
161	  a "proxy-based" one, is more secure but more intrusive and more
162	  bothersome to set up; it inspects the network traffic much more
163	  closely, modifies it and has knowledge about the higher level
164	  protocols, which a packet filter lacks. Moreover, proxy-based
165	  firewalls often require changes to the programs running on the local
166	  clients. Proxy-based firewalls don't need support by the kernel, but
167	  they are often combined with a packet filter, which only works if
168	  you say Y here.
169
170	  You should also say Y here if you intend to use your Linux box as
171	  the gateway to the Internet for a local network of machines without
172	  globally valid IP addresses. This is called "masquerading": if one
173	  of the computers on your local network wants to send something to
174	  the outside, your box can "masquerade" as that computer, i.e. it
175	  forwards the traffic to the intended outside destination, but
176	  modifies the packets to make it look like they came from the
177	  firewall box itself. It works both ways: if the outside host
178	  replies, the Linux box will silently forward the traffic to the
179	  correct local computer. This way, the computers on your local net
180	  are completely invisible to the outside world, even though they can
181	  reach the outside and can receive replies. It is even possible to
182	  run globally visible servers from within a masqueraded local network
183	  using a mechanism called portforwarding. Masquerading is also often
184	  called NAT (Network Address Translation).
185
186	  Another use of Netfilter is in transparent proxying: if a machine on
187	  the local network tries to connect to an outside host, your Linux
188	  box can transparently forward the traffic to a local server,
189	  typically a caching proxy server.
190
191	  Yet another use of Netfilter is building a bridging firewall. Using
192	  a bridge with Network packet filtering enabled makes iptables "see"
193	  the bridged traffic. For filtering on the lower network and Ethernet
194	  protocols over the bridge, use ebtables (under bridge netfilter
195	  configuration).
196
197	  Various modules exist for netfilter which replace the previous
198	  masquerading (ipmasqadm), packet filtering (ipchains), transparent
199	  proxying, and portforwarding mechanisms. Please see
200	  <file:Documentation/Changes> under "iptables" for the location of
201	  these packages.
202
203if NETFILTER
204
205config NETFILTER_ADVANCED
206	bool "Advanced netfilter configuration"
207	depends on NETFILTER
208	default y
209	help
210	  If you say Y here you can select between all the netfilter modules.
211	  If you say N the more unusual ones will not be shown and the
212	  basic ones needed by most people will default to 'M'.
213
214	  If unsure, say Y.
215
216config BRIDGE_NETFILTER
217	tristate "Bridged IP/ARP packets filtering"
218	depends on BRIDGE
219	depends on NETFILTER && INET
220	depends on NETFILTER_ADVANCED
221	select NETFILTER_FAMILY_BRIDGE
222	select SKB_EXTENSIONS
223	help
224	  Enabling this option will let arptables resp. iptables see bridged
225	  ARP resp. IP traffic. If you want a bridging firewall, you probably
226	  want this option enabled.
227	  Enabling or disabling this option doesn't enable or disable
228	  ebtables.
229
230	  If unsure, say N.
231
232source "net/netfilter/Kconfig"
233source "net/ipv4/netfilter/Kconfig"
234source "net/ipv6/netfilter/Kconfig"
235source "net/bridge/netfilter/Kconfig"
236
237endif
238
239source "net/dccp/Kconfig"
240source "net/sctp/Kconfig"
241source "net/rds/Kconfig"
242source "net/tipc/Kconfig"
243source "net/atm/Kconfig"
244source "net/l2tp/Kconfig"
245source "net/802/Kconfig"
246source "net/bridge/Kconfig"
247source "net/dsa/Kconfig"
248source "net/8021q/Kconfig"
249source "net/llc/Kconfig"
250source "net/appletalk/Kconfig"
251source "net/x25/Kconfig"
252source "net/lapb/Kconfig"
253source "net/phonet/Kconfig"
254source "net/6lowpan/Kconfig"
255source "net/ieee802154/Kconfig"
256source "net/mac802154/Kconfig"
257source "net/sched/Kconfig"
258source "net/dcb/Kconfig"
259source "net/dns_resolver/Kconfig"
260source "net/batman-adv/Kconfig"
261source "net/openvswitch/Kconfig"
262source "net/vmw_vsock/Kconfig"
263source "net/netlink/Kconfig"
264source "net/mpls/Kconfig"
265source "net/nsh/Kconfig"
266source "net/hsr/Kconfig"
267source "net/switchdev/Kconfig"
268source "net/l3mdev/Kconfig"
269source "net/qrtr/Kconfig"
270source "net/ncsi/Kconfig"
271
272config PCPU_DEV_REFCNT
273	bool "Use percpu variables to maintain network device refcount"
274	depends on SMP
275	default y
276	help
277	  network device refcount are using per cpu variables if this option is set.
278	  This can be forced to N to detect underflows (with a performance drop).
279
280config MAX_SKB_FRAGS
281	int "Maximum number of fragments per skb_shared_info"
282	range 17 45
283	default 17
284	help
285	  Having more fragments per skb_shared_info can help GRO efficiency.
286	  This helps BIG TCP workloads, but might expose bugs in some
287	  legacy drivers.
288	  This also increases memory overhead of small packets,
289	  and in drivers using build_skb().
290	  If unsure, say 17.
291
292config RPS
293	bool "Receive packet steering"
294	depends on SMP && SYSFS
295	default y
296	help
297	  Software receive side packet steering (RPS) distributes the
298	  load of received packet processing across multiple CPUs.
299
300config RFS_ACCEL
301	bool "Hardware acceleration of RFS"
302	depends on RPS
303	select CPU_RMAP
304	default y
305	help
306	  Allowing drivers for multiqueue hardware with flow filter tables to
307	  accelerate RFS.
308
309config SOCK_RX_QUEUE_MAPPING
310	bool
311
312config XPS
313	bool
314	depends on SMP
315	select SOCK_RX_QUEUE_MAPPING
316	default y
317
318config HWBM
319	bool
320
321config CGROUP_NET_PRIO
322	bool "Network priority cgroup"
323	depends on CGROUPS
324	select SOCK_CGROUP_DATA
325	help
326	  Cgroup subsystem for use in assigning processes to network priorities on
327	  a per-interface basis.
328
329config CGROUP_NET_CLASSID
330	bool "Network classid cgroup"
331	depends on CGROUPS
332	select SOCK_CGROUP_DATA
333	help
334	  Cgroup subsystem for use as general purpose socket classid marker that is
335	  being used in cls_cgroup and for netfilter matching.
336
337config NET_RX_BUSY_POLL
338	bool
339	default y if !PREEMPT_RT || (PREEMPT_RT && !NETCONSOLE)
340
341config BQL
342	bool
343	prompt "Enable Byte Queue Limits"
344	depends on SYSFS
345	select DQL
346	default y
347
348config BPF_STREAM_PARSER
349	bool "enable BPF STREAM_PARSER"
350	depends on INET
351	depends on BPF_SYSCALL
352	depends on CGROUP_BPF
353	select STREAM_PARSER
354	select NET_SOCK_MSG
355	help
356	  Enabling this allows a TCP stream parser to be used with
357	  BPF_MAP_TYPE_SOCKMAP.
358
359config NET_FLOW_LIMIT
360	bool "Net flow limit"
361	depends on RPS
362	default y
363	help
364	  The network stack has to drop packets when a receive processing CPU's
365	  backlog reaches netdev_max_backlog. If a few out of many active flows
366	  generate the vast majority of load, drop their traffic earlier to
367	  maintain capacity for the other flows. This feature provides servers
368	  with many clients some protection against DoS by a single (spoofed)
369	  flow that greatly exceeds average workload.
370
371menu "Network testing"
372
373config NET_PKTGEN
374	tristate "Packet Generator (USE WITH CAUTION)"
375	depends on INET && PROC_FS
376	help
377	  This module will inject preconfigured packets, at a configurable
378	  rate, out of a given interface.  It is used for network interface
379	  stress testing and performance analysis.  If you don't understand
380	  what was just said, you don't need it: say N.
381
382	  Documentation on how to use the packet generator can be found
383	  at <file:Documentation/networking/pktgen.rst>.
384
385	  To compile this code as a module, choose M here: the
386	  module will be called pktgen.
387
388config NET_DROP_MONITOR
389	tristate "Network packet drop alerting service"
390	depends on INET && TRACEPOINTS
391	help
392	  This feature provides an alerting service to userspace in the
393	  event that packets are discarded in the network stack.  Alerts
394	  are broadcast via netlink socket to any listening user space
395	  process.  If you don't need network drop alerts, or if you are ok
396	  just checking the various proc files and other utilities for
397	  drop statistics, say N here.
398
399endmenu
400
401endmenu
402
403source "net/ax25/Kconfig"
404source "net/can/Kconfig"
405source "net/bluetooth/Kconfig"
406source "net/rxrpc/Kconfig"
407source "net/kcm/Kconfig"
408source "net/strparser/Kconfig"
409source "net/mctp/Kconfig"
410
411config FIB_RULES
412	bool
413
414menuconfig WIRELESS
415	bool "Wireless"
416	depends on !S390
417	default y
418
419if WIRELESS
420
421source "net/wireless/Kconfig"
422source "net/mac80211/Kconfig"
423
424endif # WIRELESS
425
426source "net/rfkill/Kconfig"
427source "net/9p/Kconfig"
428source "net/caif/Kconfig"
429source "net/ceph/Kconfig"
430source "net/nfc/Kconfig"
431source "net/psample/Kconfig"
432source "net/ife/Kconfig"
433
434config LWTUNNEL
435	bool "Network light weight tunnels"
436	help
437	  This feature provides an infrastructure to support light weight
438	  tunnels like mpls. There is no netdevice associated with a light
439	  weight tunnel endpoint. Tunnel encapsulation parameters are stored
440	  with light weight tunnel state associated with fib routes.
441
442config LWTUNNEL_BPF
443	bool "Execute BPF program as route nexthop action"
444	depends on LWTUNNEL && INET
445	default y if LWTUNNEL=y
446	help
447	  Allows to run BPF programs as a nexthop action following a route
448	  lookup for incoming and outgoing packets.
449
450config DST_CACHE
451	bool
452	default n
453
454config GRO_CELLS
455	bool
456	default n
457
458config SOCK_VALIDATE_XMIT
459	bool
460
461config NET_IEEE8021Q_HELPERS
462	bool
463
464config NET_SELFTESTS
465	def_tristate PHYLIB
466	depends on PHYLIB && INET
467
468config NET_SOCK_MSG
469	bool
470	default n
471	help
472	  The NET_SOCK_MSG provides a framework for plain sockets (e.g. TCP) or
473	  ULPs (upper layer modules, e.g. TLS) to process L7 application data
474	  with the help of BPF programs.
475
476config NET_DEVLINK
477	bool
478	default n
479
480config PAGE_POOL
481	bool
482
483config PAGE_POOL_STATS
484	default n
485	bool "Page pool stats"
486	depends on PAGE_POOL
487	help
488	  Enable page pool statistics to track page allocation and recycling
489	  in page pools. This option incurs additional CPU cost in allocation
490	  and recycle paths and additional memory cost to store the statistics.
491	  These statistics are only available if this option is enabled and if
492	  the driver using the page pool supports exporting this data.
493
494	  If unsure, say N.
495
496config FAILOVER
497	tristate "Generic failover module"
498	help
499	  The failover module provides a generic interface for paravirtual
500	  drivers to register a netdev and a set of ops with a failover
501	  instance. The ops are used as event handlers that get called to
502	  handle netdev register/unregister/link change/name change events
503	  on slave pci ethernet devices with the same mac address as the
504	  failover netdev. This enables paravirtual drivers to use a
505	  VF as an accelerated low latency datapath. It also allows live
506	  migration of VMs with direct attached VFs by failing over to the
507	  paravirtual datapath when the VF is unplugged.
508
509config ETHTOOL_NETLINK
510	bool "Netlink interface for ethtool"
511	select DIMLIB
512	default y
513	help
514	  An alternative userspace interface for ethtool based on generic
515	  netlink. It provides better extensibility and some new features,
516	  e.g. notification messages.
517
518config NETDEV_ADDR_LIST_TEST
519	tristate "Unit tests for device address list"
520	default KUNIT_ALL_TESTS
521	depends on KUNIT
522
523config NET_TEST
524	tristate "KUnit tests for networking" if !KUNIT_ALL_TESTS
525	depends on KUNIT
526	default KUNIT_ALL_TESTS
527	help
528	  KUnit tests covering core networking infra, such as sk_buff.
529
530	  If unsure, say N.
531
532endif   # if NET
533