blob: 502d6a572b4ffccd86ce47cdeffe3cd549d89c75 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/proc/sys/net/ipv4/* Variables:
2
3ip_forward - BOOLEAN
4 0 - disabled (default)
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00005 not 0 - enabled
Linus Torvalds1da177e2005-04-16 15:20:36 -07006
7 Forward Packets between interfaces.
8
9 This variable is special, its change resets all configuration
10 parameters to their default state (RFC1122 for hosts, RFC1812
11 for routers)
12
13ip_default_ttl - INTEGER
Eric Dumazetcc6f02d2010-12-13 12:50:49 -080014 Default value of TTL field (Time To Live) for outgoing (but not
15 forwarded) IP packets. Should be between 1 and 255 inclusive.
16 Default: 64 (as recommended by RFC1700)
Linus Torvalds1da177e2005-04-16 15:20:36 -070017
Hannes Frederic Sowacd174e62013-12-14 05:13:45 +010018ip_no_pmtu_disc - INTEGER
19 Disable Path MTU Discovery. If enabled in mode 1 and a
Hannes Frederic Sowa188b04d2013-12-14 04:42:13 +010020 fragmentation-required ICMP is received, the PMTU to this
21 destination will be set to min_pmtu (see below). You will need
22 to raise min_pmtu to the smallest interface MTU on your system
23 manually if you want to avoid locally generated fragments.
Hannes Frederic Sowacd174e62013-12-14 05:13:45 +010024
25 In mode 2 incoming Path MTU Discovery messages will be
26 discarded. Outgoing frames are handled the same as in mode 1,
27 implicitly setting IP_PMTUDISC_DONT on every created socket.
28
Hannes Frederic Sowa8ed1dc42014-01-09 10:01:17 +010029 Mode 3 is a hardend pmtu discover mode. The kernel will only
30 accept fragmentation-needed errors if the underlying protocol
31 can verify them besides a plain socket lookup. Current
32 protocols for which pmtu events will be honored are TCP, SCTP
33 and DCCP as they verify e.g. the sequence number or the
34 association. This mode should not be enabled globally but is
35 only intended to secure e.g. name servers in namespaces where
36 TCP path mtu must still work but path MTU information of other
37 protocols should be discarded. If enabled globally this mode
38 could break other protocols.
39
40 Possible values: 0-3
Hannes Frederic Sowa188b04d2013-12-14 04:42:13 +010041 Default: FALSE
Linus Torvalds1da177e2005-04-16 15:20:36 -070042
43min_pmtu - INTEGER
Eric Dumazet20db93c2011-11-08 14:21:44 -050044 default 552 - minimum discovered Path MTU
Linus Torvalds1da177e2005-04-16 15:20:36 -070045
Hannes Frederic Sowaf87c10a2014-01-09 10:01:15 +010046ip_forward_use_pmtu - BOOLEAN
47 By default we don't trust protocol path MTUs while forwarding
48 because they could be easily forged and can lead to unwanted
49 fragmentation by the router.
50 You only need to enable this if you have user-space software
51 which tries to discover path mtus by itself and depends on the
52 kernel honoring this information. This is normally not the
53 case.
54 Default: 0 (disabled)
55 Possible values:
56 0 - disabled
57 1 - enabled
58
Loganaden Velvindron219b5f22014-11-04 03:02:49 -080059fwmark_reflect - BOOLEAN
60 Controls the fwmark of kernel-generated IPv4 reply packets that are not
61 associated with a socket for example, TCP RSTs or ICMP echo replies).
62 If unset, these packets have a fwmark of zero. If set, they have the
63 fwmark of the packet they are replying to.
64 Default: 0
65
Ben Greearcbaf0872010-11-08 09:13:48 +000066route/max_size - INTEGER
67 Maximum number of routes allowed in the kernel. Increase
68 this when using large numbers of interfaces and/or routes.
Ani Sinha25050c62015-01-07 15:45:56 -080069 From linux kernel 3.6 onwards, this is deprecated for ipv4
70 as route cache is no longer used.
Ben Greearcbaf0872010-11-08 09:13:48 +000071
YOSHIFUJI Hideaki / 吉藤英明27246802013-01-22 05:20:05 +000072neigh/default/gc_thresh1 - INTEGER
73 Minimum number of entries to keep. Garbage collector will not
74 purge entries if there are fewer than this number.
Li RongQingb66c66d2013-03-14 22:49:47 +000075 Default: 128
YOSHIFUJI Hideaki / 吉藤英明27246802013-01-22 05:20:05 +000076
stephen hemmingera3d12142014-08-25 15:05:30 -070077neigh/default/gc_thresh2 - INTEGER
78 Threshold when garbage collector becomes more aggressive about
79 purging entries. Entries older than 5 seconds will be cleared
80 when over this number.
81 Default: 512
82
Ben Greearcbaf0872010-11-08 09:13:48 +000083neigh/default/gc_thresh3 - INTEGER
84 Maximum number of neighbor entries allowed. Increase this
85 when using large numbers of interfaces and when communicating
86 with large numbers of directly-connected peers.
Shan Weicc868022012-12-04 18:50:35 +000087 Default: 1024
Ben Greearcbaf0872010-11-08 09:13:48 +000088
Eric Dumazet8b5c1712011-11-09 12:07:14 +000089neigh/default/unres_qlen_bytes - INTEGER
90 The maximum number of bytes which may be used by packets
91 queued for each unresolved address by other network layers.
92 (added in linux 3.3)
stephen hemminger3b09adc2013-01-03 07:50:29 +000093 Setting negative value is meaningless and will return error.
Shan Weicc868022012-12-04 18:50:35 +000094 Default: 65536 Bytes(64KB)
Eric Dumazet8b5c1712011-11-09 12:07:14 +000095
96neigh/default/unres_qlen - INTEGER
97 The maximum number of packets which may be queued for each
98 unresolved address by other network layers.
99 (deprecated in linux 3.3) : use unres_qlen_bytes instead.
Shan Weicc868022012-12-04 18:50:35 +0000100 Prior to linux 3.3, the default value is 3 which may cause
Shan Wei5d248c42012-12-06 16:27:51 +0000101 unexpected packet loss. The current default value is calculated
Shan Weicc868022012-12-04 18:50:35 +0000102 according to default value of unres_qlen_bytes and true size of
103 packet.
104 Default: 31
Eric Dumazet8b5c1712011-11-09 12:07:14 +0000105
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106mtu_expires - INTEGER
107 Time, in seconds, that cached PMTU information is kept.
108
109min_adv_mss - INTEGER
110 The advertised MSS depends on the first hop route MTU, but will
111 never be lower than this setting.
112
113IP Fragmentation:
114
115ipfrag_high_thresh - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000116 Maximum memory used to reassemble IP fragments. When
Linus Torvalds1da177e2005-04-16 15:20:36 -0700117 ipfrag_high_thresh bytes of memory is allocated for this purpose,
118 the fragment handler will toss packets until ipfrag_low_thresh
Nikolay Aleksandrov1bab4c72014-07-24 16:50:37 +0200119 is reached. This also serves as a maximum limit to namespaces
120 different from the initial one.
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000121
Linus Torvalds1da177e2005-04-16 15:20:36 -0700122ipfrag_low_thresh - INTEGER
Florian Westphalb13d3cb2014-07-24 16:50:32 +0200123 Maximum memory used to reassemble IP fragments before the kernel
124 begins to remove incomplete fragment queues to free up resources.
125 The kernel still accepts new fragments for defragmentation.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700126
127ipfrag_time - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000128 Time in seconds to keep an IP fragment in memory.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700129
Herbert Xu89cee8b2005-12-13 23:14:27 -0800130ipfrag_max_dist - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000131 ipfrag_max_dist is a non-negative integer value which defines the
132 maximum "disorder" which is allowed among fragments which share a
133 common IP source address. Note that reordering of packets is
134 not unusual, but if a large number of fragments arrive from a source
135 IP address while a particular fragment queue remains incomplete, it
136 probably indicates that one or more fragments belonging to that queue
137 have been lost. When ipfrag_max_dist is positive, an additional check
138 is done on fragments before they are added to a reassembly queue - if
139 ipfrag_max_dist (or more) fragments have arrived from a particular IP
140 address between additions to any IP fragment queue using that source
141 address, it's presumed that one or more fragments in the queue are
142 lost. The existing fragment queue will be dropped, and a new one
Herbert Xu89cee8b2005-12-13 23:14:27 -0800143 started. An ipfrag_max_dist value of zero disables this check.
144
145 Using a very small value, e.g. 1 or 2, for ipfrag_max_dist can
146 result in unnecessarily dropping fragment queues when normal
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000147 reordering of packets occurs, which could lead to poor application
148 performance. Using a very large value, e.g. 50000, increases the
149 likelihood of incorrectly reassembling IP fragments that originate
Herbert Xu89cee8b2005-12-13 23:14:27 -0800150 from different IP datagrams, which could result in data corruption.
151 Default: 64
152
Linus Torvalds1da177e2005-04-16 15:20:36 -0700153INET peer storage:
154
155inet_peer_threshold - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000156 The approximate size of the storage. Starting from this threshold
Linus Torvalds1da177e2005-04-16 15:20:36 -0700157 entries will be thrown aggressively. This threshold also determines
158 entries' time-to-live and time intervals between garbage collection
159 passes. More entries, less time-to-live, less GC interval.
160
161inet_peer_minttl - INTEGER
162 Minimum time-to-live of entries. Should be enough to cover fragment
163 time-to-live on the reassembling side. This minimum time-to-live is
164 guaranteed if the pool size is less than inet_peer_threshold.
Stephen Hemminger77a538d2008-07-01 17:22:48 -0700165 Measured in seconds.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166
167inet_peer_maxttl - INTEGER
168 Maximum time-to-live of entries. Unused entries will expire after
169 this period of time if there is no memory pressure on the pool (i.e.
170 when the number of entries in the pool is very small).
Stephen Hemminger77a538d2008-07-01 17:22:48 -0700171 Measured in seconds.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700172
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000173TCP variables:
Linus Torvalds1da177e2005-04-16 15:20:36 -0700174
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800175somaxconn - INTEGER
176 Limit of socket listen() backlog, known in userspace as SOMAXCONN.
177 Defaults to 128. See also tcp_max_syn_backlog for additional tuning
178 for TCP sockets.
179
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800180tcp_abort_on_overflow - BOOLEAN
181 If listening service is too slow to accept new connections,
182 reset them. Default state is FALSE. It means that if overflow
183 occurred due to a burst, connection will recover. Enable this
184 option _only_ if you are really sure that listening daemon
185 cannot be tuned to accept connections faster. Enabling this
186 option can harm clients of your server.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700187
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800188tcp_adv_win_scale - INTEGER
189 Count buffering overhead as bytes/2^tcp_adv_win_scale
190 (if tcp_adv_win_scale > 0) or bytes-bytes/2^(-tcp_adv_win_scale),
191 if it is <= 0.
Alexey Dobriyan0147fc02010-11-22 12:54:21 +0000192 Possible values are [-31, 31], inclusive.
Eric Dumazetb49960a2012-05-02 02:28:41 +0000193 Default: 1
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800194
195tcp_allowed_congestion_control - STRING
196 Show/set the congestion control choices available to non-privileged
197 processes. The list is a subset of those listed in
198 tcp_available_congestion_control.
199 Default is "reno" and the default setting (tcp_congestion_control).
200
201tcp_app_win - INTEGER
202 Reserve max(window/2^tcp_app_win, mss) of window for application
203 buffer. Value 0 is special, it means that nothing is reserved.
204 Default: 31
205
Eric Dumazetf54b3112013-12-05 22:36:05 -0800206tcp_autocorking - BOOLEAN
207 Enable TCP auto corking :
208 When applications do consecutive small write()/sendmsg() system calls,
209 we try to coalesce these small writes as much as possible, to lower
210 total amount of sent packets. This is done if at least one prior
211 packet for the flow is waiting in Qdisc queues or device transmit
212 queue. Applications can still use TCP_CORK for optimal behavior
213 when they know how/when to uncork their sockets.
214 Default : 1
215
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800216tcp_available_congestion_control - STRING
217 Shows the available congestion control choices that are registered.
218 More congestion control algorithms may be available as modules,
219 but not loaded.
220
John Heffner71599cd2007-02-27 10:03:56 -0800221tcp_base_mss - INTEGER
Stephen Hemminger4edc2f32008-07-10 16:50:26 -0700222 The initial value of search_low to be used by the packetization layer
223 Path MTU discovery (MTU probing). If MTU probing is enabled,
224 this is the initial MSS used by the connection.
John Heffner71599cd2007-02-27 10:03:56 -0800225
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800226tcp_congestion_control - STRING
227 Set the congestion control algorithm to be used for new
228 connections. The algorithm "reno" is always available, but
229 additional choices may be available based on kernel configuration.
230 Default is set as part of kernel configuration.
Eric Dumazetd8a6e652011-11-30 01:02:41 +0000231 For passive connections, the listener congestion control choice
232 is inherited.
233 [see setsockopt(listenfd, SOL_TCP, TCP_CONGESTION, "name" ...) ]
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800234
235tcp_dsack - BOOLEAN
236 Allows TCP to send "duplicate" SACKs.
237
Yuchung Chengeed530b2012-05-02 13:30:03 +0000238tcp_early_retrans - INTEGER
239 Enable Early Retransmit (ER), per RFC 5827. ER lowers the threshold
240 for triggering fast retransmit when the amount of outstanding data is
241 small and when no previously unsent data can be transmitted (such
Nandita Dukkipati6ba8a3b2013-03-11 10:00:43 +0000242 that limited transmit could be used). Also controls the use of
Masanari Iida3dd17ed2013-05-24 07:05:59 +0000243 Tail loss probe (TLP) that converts RTOs occurring due to tail
Nandita Dukkipati6ba8a3b2013-03-11 10:00:43 +0000244 losses into fast recovery (draft-dukkipati-tcpm-tcp-loss-probe-01).
Yuchung Chengeed530b2012-05-02 13:30:03 +0000245 Possible values:
246 0 disables ER
247 1 enables ER
248 2 enables ER but delays fast recovery and fast retransmit
249 by a fourth of RTT. This mitigates connection falsely
250 recovers when network has a small degree of reordering
251 (less than 3 packets).
Nandita Dukkipati6ba8a3b2013-03-11 10:00:43 +0000252 3 enables delayed ER and TLP.
253 4 enables TLP only.
254 Default: 3
Yuchung Chengeed530b2012-05-02 13:30:03 +0000255
Peter Chubb34a6ef32011-02-02 15:39:58 -0800256tcp_ecn - INTEGER
Rick Jones7e3a2dc2012-11-28 09:53:10 +0000257 Control use of Explicit Congestion Notification (ECN) by TCP.
258 ECN is used only when both ends of the TCP connection indicate
259 support for it. This feature is useful in avoiding losses due
260 to congestion by allowing supporting routers to signal
261 congestion before having to drop packets.
Ilpo Järvinen255cac92009-05-04 11:07:36 -0700262 Possible values are:
Rick Jones7e3a2dc2012-11-28 09:53:10 +0000263 0 Disable ECN. Neither initiate nor accept ECN.
Vijay Subramanian3d55b322013-01-09 12:21:30 +0000264 1 Enable ECN when requested by incoming connections and
265 also request ECN on outgoing connection attempts.
266 2 Enable ECN when requested by incoming connections
Rick Jones7e3a2dc2012-11-28 09:53:10 +0000267 but do not request ECN on outgoing connections.
Ilpo Järvinen255cac92009-05-04 11:07:36 -0700268 Default: 2
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800269
Daniel Borkmann49213552015-05-19 21:04:22 +0200270tcp_ecn_fallback - BOOLEAN
271 If the kernel detects that ECN connection misbehaves, enable fall
272 back to non-ECN. Currently, this knob implements the fallback
273 from RFC3168, section 6.1.1.1., but we reserve that in future,
274 additional detection mechanisms could be implemented under this
275 knob. The value is not used, if tcp_ecn or per route (or congestion
276 control) ECN settings are disabled.
277 Default: 1 (fallback enabled)
278
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800279tcp_fack - BOOLEAN
280 Enable FACK congestion avoidance and fast retransmission.
281 The value is not used, if tcp_sack is not enabled.
282
283tcp_fin_timeout - INTEGER
Rick Jonesd825da22012-12-10 11:33:00 +0000284 The length of time an orphaned (no longer referenced by any
285 application) connection will remain in the FIN_WAIT_2 state
286 before it is aborted at the local end. While a perfectly
287 valid "receive only" state for an un-orphaned connection, an
288 orphaned connection in FIN_WAIT_2 state could otherwise wait
289 forever for the remote to close its end of the connection.
290 Cf. tcp_max_orphans
291 Default: 60 seconds
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800292
Ilpo Järvinen89808062007-02-27 10:10:55 -0800293tcp_frto - INTEGER
Yuchung Chenge33099f2013-03-20 13:33:00 +0000294 Enables Forward RTO-Recovery (F-RTO) defined in RFC5682.
Ilpo Järvinencd998892007-09-20 11:35:26 -0700295 F-RTO is an enhanced recovery algorithm for TCP retransmission
Yuchung Chenge33099f2013-03-20 13:33:00 +0000296 timeouts. It is particularly beneficial in networks where the
297 RTT fluctuates (e.g., wireless). F-RTO is sender-side only
298 modification. It does not require any support from the peer.
Stephen Hemminger4edc2f32008-07-10 16:50:26 -0700299
Yuchung Chenge33099f2013-03-20 13:33:00 +0000300 By default it's enabled with a non-zero value. 0 disables F-RTO.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700301
Neal Cardwell032ee422015-02-06 16:04:38 -0500302tcp_invalid_ratelimit - INTEGER
303 Limit the maximal rate for sending duplicate acknowledgments
304 in response to incoming TCP packets that are for an existing
305 connection but that are invalid due to any of these reasons:
306
307 (a) out-of-window sequence number,
308 (b) out-of-window acknowledgment number, or
309 (c) PAWS (Protection Against Wrapped Sequence numbers) check failure
310
311 This can help mitigate simple "ack loop" DoS attacks, wherein
312 a buggy or malicious middlebox or man-in-the-middle can
313 rewrite TCP header fields in manner that causes each endpoint
314 to think that the other is sending invalid TCP segments, thus
315 causing each side to send an unterminating stream of duplicate
316 acknowledgments for invalid segments.
317
318 Using 0 disables rate-limiting of dupacks in response to
319 invalid segments; otherwise this value specifies the minimal
320 space between sending such dupacks, in milliseconds.
321
322 Default: 500 (milliseconds).
323
Linus Torvalds1da177e2005-04-16 15:20:36 -0700324tcp_keepalive_time - INTEGER
325 How often TCP sends out keepalive messages when keepalive is enabled.
326 Default: 2hours.
327
328tcp_keepalive_probes - INTEGER
329 How many keepalive probes TCP sends out, until it decides that the
330 connection is broken. Default value: 9.
331
332tcp_keepalive_intvl - INTEGER
333 How frequently the probes are send out. Multiplied by
334 tcp_keepalive_probes it is time to kill not responding connection,
335 after probes started. Default value: 75sec i.e. connection
336 will be aborted after ~11 minutes of retries.
337
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800338tcp_low_latency - BOOLEAN
339 If set, the TCP stack makes decisions that prefer lower
340 latency as opposed to higher throughput. By default, this
341 option is not set meaning that higher throughput is preferred.
342 An example of an application where this default should be
343 changed would be a Beowulf compute cluster.
344 Default: 0
Linus Torvalds1da177e2005-04-16 15:20:36 -0700345
346tcp_max_orphans - INTEGER
347 Maximal number of TCP sockets not attached to any user file handle,
348 held by system. If this number is exceeded orphaned connections are
349 reset immediately and warning is printed. This limit exists
350 only to prevent simple DoS attacks, you _must_ not rely on this
351 or lower the limit artificially, but rather increase it
352 (probably, after increasing installed memory),
353 if network conditions require more than default value,
354 and tune network services to linger and kill such states
355 more aggressively. Let me to remind again: each orphan eats
356 up to ~64K of unswappable memory.
357
Linus Torvalds1da177e2005-04-16 15:20:36 -0700358tcp_max_syn_backlog - INTEGER
Peter Pan(潘卫平)99b53bd2011-12-05 21:39:41 +0000359 Maximal number of remembered connection requests, which have not
360 received an acknowledgment from connecting client.
361 The minimal value is 128 for low memory machines, and it will
362 increase in proportion to the memory of machine.
363 If server suffers from overload, try increasing this number.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700364
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800365tcp_max_tw_buckets - INTEGER
366 Maximal number of timewait sockets held by system simultaneously.
367 If this number is exceeded time-wait socket is immediately destroyed
368 and warning is printed. This limit exists only to prevent
369 simple DoS attacks, you _must_ not lower the limit artificially,
370 but rather increase it (probably, after increasing installed memory),
371 if network conditions require more than default value.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700372
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800373tcp_mem - vector of 3 INTEGERs: min, pressure, max
374 min: below this number of pages TCP is not bothered about its
375 memory appetite.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700376
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800377 pressure: when amount of memory allocated by TCP exceeds this number
378 of pages, TCP moderates its memory consumption and enters memory
379 pressure mode, which is exited when memory consumption falls
380 under "min".
Linus Torvalds1da177e2005-04-16 15:20:36 -0700381
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800382 max: number of pages allowed for queueing by all TCP sockets.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700383
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800384 Defaults are calculated at boot time from amount of available
385 memory.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700386
Yuchung Chengf6722582015-10-16 21:57:42 -0700387tcp_min_rtt_wlen - INTEGER
388 The window length of the windowed min filter to track the minimum RTT.
389 A shorter window lets a flow more quickly pick up new (higher)
390 minimum RTT when it is moved to a longer path (e.g., due to traffic
391 engineering). A longer window makes the filter more resistant to RTT
392 inflations such as transient congestion. The unit is seconds.
393 Default: 300
394
John Heffner71599cd2007-02-27 10:03:56 -0800395tcp_moderate_rcvbuf - BOOLEAN
Stephen Hemminger4edc2f32008-07-10 16:50:26 -0700396 If set, TCP performs receive buffer auto-tuning, attempting to
John Heffner71599cd2007-02-27 10:03:56 -0800397 automatically size the buffer (no greater than tcp_rmem[2]) to
398 match the size required by the path for full throughput. Enabled by
399 default.
400
401tcp_mtu_probing - INTEGER
402 Controls TCP Packetization-Layer Path MTU Discovery. Takes three
403 values:
404 0 - Disabled
405 1 - Disabled by default, enabled when an ICMP black hole detected
406 2 - Always enabled, use initial MSS of tcp_base_mss.
407
Fan Dufab42762015-03-06 11:18:25 +0800408tcp_probe_interval - INTEGER
409 Controls how often to start TCP Packetization-Layer Path MTU
410 Discovery reprobe. The default is reprobing every 10 minutes as
411 per RFC4821.
412
413tcp_probe_threshold - INTEGER
414 Controls when TCP Packetization-Layer Path MTU Discovery probing
415 will stop in respect to the width of search range in bytes. Default
416 is 8 bytes.
417
John Heffner71599cd2007-02-27 10:03:56 -0800418tcp_no_metrics_save - BOOLEAN
419 By default, TCP saves various connection metrics in the route cache
420 when the connection closes, so that connections established in the
421 near future can use these to set initial conditions. Usually, this
422 increases overall performance, but may sometimes cause performance
Simon Arlott0f035b82007-10-20 01:30:25 +0200423 degradation. If set, TCP will not cache metrics on closing
John Heffner71599cd2007-02-27 10:03:56 -0800424 connections.
425
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800426tcp_orphan_retries - INTEGER
Damian Lukowski5d789222009-09-01 10:24:04 +0000427 This value influences the timeout of a locally closed TCP connection,
428 when RTO retransmissions remain unacknowledged.
429 See tcp_retries2 for more details.
430
David S. Miller06b8fc52011-07-08 09:31:31 -0700431 The default value is 8.
Damian Lukowski5d789222009-09-01 10:24:04 +0000432 If your machine is a loaded WEB server,
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800433 you should think about lowering this value, such sockets
434 may consume significant resources. Cf. tcp_max_orphans.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700435
436tcp_reordering - INTEGER
Eric Dumazetdca145f2014-10-27 21:45:24 -0700437 Initial reordering level of packets in a TCP stream.
438 TCP stack can then dynamically adjust flow reordering level
439 between this initial value and tcp_max_reordering
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000440 Default: 3
Linus Torvalds1da177e2005-04-16 15:20:36 -0700441
Eric Dumazetdca145f2014-10-27 21:45:24 -0700442tcp_max_reordering - INTEGER
443 Maximal reordering level of packets in a TCP stream.
444 300 is a fairly conservative value, but you might increase it
445 if paths are using per packet load balancing (like bonding rr mode)
446 Default: 300
447
Linus Torvalds1da177e2005-04-16 15:20:36 -0700448tcp_retrans_collapse - BOOLEAN
449 Bug-to-bug compatibility with some broken printers.
450 On retransmit try to send bigger packets to work around bugs in
451 certain TCP stacks.
452
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800453tcp_retries1 - INTEGER
Damian Lukowski5d789222009-09-01 10:24:04 +0000454 This value influences the time, after which TCP decides, that
455 something is wrong due to unacknowledged RTO retransmissions,
456 and reports this suspicion to the network layer.
457 See tcp_retries2 for more details.
458
459 RFC 1122 recommends at least 3 retransmissions, which is the
460 default.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700461
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800462tcp_retries2 - INTEGER
Damian Lukowski5d789222009-09-01 10:24:04 +0000463 This value influences the timeout of an alive TCP connection,
464 when RTO retransmissions remain unacknowledged.
465 Given a value of N, a hypothetical TCP connection following
466 exponential backoff with an initial RTO of TCP_RTO_MIN would
467 retransmit N times before killing the connection at the (N+1)th RTO.
468
469 The default value of 15 yields a hypothetical timeout of 924.6
470 seconds and is a lower bound for the effective timeout.
471 TCP will effectively time out at the first RTO which exceeds the
472 hypothetical timeout.
473
474 RFC 1122 recommends at least 100 seconds for the timeout,
475 which corresponds to a value of at least 8.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700476
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800477tcp_rfc1337 - BOOLEAN
478 If set, the TCP stack behaves conforming to RFC1337. If unset,
479 we are not conforming to RFC, but prevent TCP TIME_WAIT
480 assassination.
481 Default: 0
Linus Torvalds1da177e2005-04-16 15:20:36 -0700482
483tcp_rmem - vector of 3 INTEGERs: min, default, max
484 min: Minimal size of receive buffer used by TCP sockets.
485 It is guaranteed to each TCP socket, even under moderate memory
486 pressure.
Max Matveev6539fef2011-06-21 21:18:13 +0000487 Default: 1 page
Linus Torvalds1da177e2005-04-16 15:20:36 -0700488
J. Bruce Fields53025f52008-07-10 16:47:41 -0700489 default: initial size of receive buffer used by TCP sockets.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700490 This value overrides net.core.rmem_default used by other protocols.
491 Default: 87380 bytes. This value results in window of 65535 with
492 default setting of tcp_adv_win_scale and tcp_app_win:0 and a bit
493 less for default tcp_app_win. See below about these variables.
494
495 max: maximal size of receive buffer allowed for automatically
496 selected receiver buffers for TCP socket. This value does not override
J. Bruce Fields53025f52008-07-10 16:47:41 -0700497 net.core.rmem_max. Calling setsockopt() with SO_RCVBUF disables
498 automatic tuning of that socket's receive buffer size, in which
499 case this value is ignored.
Eric Dumazetb49960a2012-05-02 02:28:41 +0000500 Default: between 87380B and 6MB, depending on RAM size.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700501
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800502tcp_sack - BOOLEAN
503 Enable select acknowledgments (SACKS).
Rick Jones15d99e02006-03-20 22:40:29 -0800504
David S. Miller35089bb2006-06-13 22:33:04 -0700505tcp_slow_start_after_idle - BOOLEAN
506 If set, provide RFC2861 behavior and time out the congestion
507 window after an idle period. An idle period is defined at
508 the current RTO. If unset, the congestion window will not
509 be timed out after an idle period.
510 Default: 1
511
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800512tcp_stdurg - BOOLEAN
Stephen Hemminger4edc2f32008-07-10 16:50:26 -0700513 Use the Host requirements interpretation of the TCP urgent pointer field.
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800514 Most hosts use the older BSD interpretation, so if you turn this on
515 Linux might not communicate correctly with them.
516 Default: FALSE
517
518tcp_synack_retries - INTEGER
519 Number of times SYNACKs for a passive TCP connection attempt will
520 be retransmitted. Should not be higher than 255. Default value
Alex Bergmann6c9ff972012-08-31 02:48:31 +0000521 is 5, which corresponds to 31seconds till the last retransmission
522 with the current initial RTO of 1second. With this the final timeout
523 for a passive TCP connection will happen after 63seconds.
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800524
525tcp_syncookies - BOOLEAN
Shan Weia3c910d2013-06-21 15:18:32 +0800526 Only valid when the kernel was compiled with CONFIG_SYN_COOKIES
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800527 Send out syncookies when the syn backlog queue of a socket
Stephen Hemminger4edc2f32008-07-10 16:50:26 -0700528 overflows. This is to prevent against the common 'SYN flood attack'
Shan Weia3c910d2013-06-21 15:18:32 +0800529 Default: 1
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800530
531 Note, that syncookies is fallback facility.
532 It MUST NOT be used to help highly loaded servers to stand
Stephen Hemminger4edc2f32008-07-10 16:50:26 -0700533 against legal connection rate. If you see SYN flood warnings
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800534 in your logs, but investigation shows that they occur
535 because of overload with legal connections, you should tune
536 another parameters until this warning disappear.
537 See: tcp_max_syn_backlog, tcp_synack_retries, tcp_abort_on_overflow.
538
539 syncookies seriously violate TCP protocol, do not allow
540 to use TCP extensions, can result in serious degradation
541 of some services (f.e. SMTP relaying), visible not by you,
542 but your clients and relays, contacting you. While you see
Stephen Hemminger4edc2f32008-07-10 16:50:26 -0700543 SYN flood warnings in logs not being really flooded, your server
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800544 is seriously misconfigured.
545
Hannes Frederic Sowa5ad37d52013-07-26 17:43:23 +0200546 If you want to test which effects syncookies have to your
547 network connections you can set this knob to 2 to enable
548 unconditionally generation of syncookies.
549
Yuchung Chengcf60af02012-07-19 06:43:09 +0000550tcp_fastopen - INTEGER
551 Enable TCP Fast Open feature (draft-ietf-tcpm-fastopen) to send data
552 in the opening SYN packet. To use this feature, the client application
Jerry Chu10467162012-08-31 12:29:11 +0000553 must use sendmsg() or sendto() with MSG_FASTOPEN flag rather than
554 connect() to perform a TCP handshake automatically.
Yuchung Chengcf60af02012-07-19 06:43:09 +0000555
Jerry Chu10467162012-08-31 12:29:11 +0000556 The values (bitmap) are
Yuchung Cheng0d41cca2013-10-31 09:19:32 -0700557 1: Enables sending data in the opening SYN on the client w/ MSG_FASTOPEN.
Jerry Chu10467162012-08-31 12:29:11 +0000558 2: Enables TCP Fast Open on the server side, i.e., allowing data in
559 a SYN packet to be accepted and passed to the application before
560 3-way hand shake finishes.
561 4: Send data in the opening SYN regardless of cookie availability and
562 without a cookie option.
563 0x100: Accept SYN data w/o validating the cookie.
564 0x200: Accept data-in-SYN w/o any cookie option present.
565 0x400/0x800: Enable Fast Open on all listeners regardless of the
566 TCP_FASTOPEN socket option. The two different flags designate two
567 different ways of setting max_qlen without the TCP_FASTOPEN socket
568 option.
Yuchung Chengcf60af02012-07-19 06:43:09 +0000569
Yuchung Cheng0d41cca2013-10-31 09:19:32 -0700570 Default: 1
Yuchung Chengcf60af02012-07-19 06:43:09 +0000571
Jerry Chu10467162012-08-31 12:29:11 +0000572 Note that the client & server side Fast Open flags (1 and 2
573 respectively) must be also enabled before the rest of flags can take
574 effect.
575
576 See include/net/tcp.h and the code for more details.
577
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800578tcp_syn_retries - INTEGER
579 Number of times initial SYNs for an active TCP connection attempt
580 will be retransmitted. Should not be higher than 255. Default value
stephen hemminger3b09adc2013-01-03 07:50:29 +0000581 is 6, which corresponds to 63seconds till the last retransmission
Alex Bergmann6c9ff972012-08-31 02:48:31 +0000582 with the current initial RTO of 1second. With this the final timeout
583 for an active TCP connection attempt will happen after 127seconds.
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800584
585tcp_timestamps - BOOLEAN
586 Enable timestamps as defined in RFC1323.
587
Eric Dumazet95bd09e2013-08-27 05:46:32 -0700588tcp_min_tso_segs - INTEGER
589 Minimal number of segments per TSO frame.
590 Since linux-3.12, TCP does an automatic sizing of TSO frames,
591 depending on flow rate, instead of filling 64Kbytes packets.
592 For specific usages, it's possible to force TCP to build big
593 TSO frames. Note that TCP stack might split too big TSO packets
594 if available window is too small.
595 Default: 2
596
Eric Dumazet43e122b2015-08-21 17:38:02 -0700597tcp_pacing_ss_ratio - INTEGER
598 sk->sk_pacing_rate is set by TCP stack using a ratio applied
599 to current rate. (current_rate = cwnd * mss / srtt)
600 If TCP is in slow start, tcp_pacing_ss_ratio is applied
601 to let TCP probe for bigger speeds, assuming cwnd can be
602 doubled every other RTT.
603 Default: 200
604
605tcp_pacing_ca_ratio - INTEGER
606 sk->sk_pacing_rate is set by TCP stack using a ratio applied
607 to current rate. (current_rate = cwnd * mss / srtt)
608 If TCP is in congestion avoidance phase, tcp_pacing_ca_ratio
609 is applied to conservatively probe for bigger throughput.
610 Default: 120
611
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800612tcp_tso_win_divisor - INTEGER
613 This allows control over what percentage of the congestion window
614 can be consumed by a single TSO frame.
615 The setting of this parameter is a choice between burstiness and
616 building larger TSO frames.
617 Default: 3
618
619tcp_tw_recycle - BOOLEAN
620 Enable fast recycling TIME-WAIT sockets. Default value is 0.
621 It should not be changed without advice/request of technical
622 experts.
623
624tcp_tw_reuse - BOOLEAN
625 Allow to reuse TIME-WAIT sockets for new connections when it is
626 safe from protocol viewpoint. Default value is 0.
627 It should not be changed without advice/request of technical
628 experts.
629
630tcp_window_scaling - BOOLEAN
631 Enable window scaling as defined in RFC1323.
632
633tcp_wmem - vector of 3 INTEGERs: min, default, max
J. Bruce Fields53025f52008-07-10 16:47:41 -0700634 min: Amount of memory reserved for send buffers for TCP sockets.
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800635 Each TCP socket has rights to use it due to fact of its birth.
Max Matveev6539fef2011-06-21 21:18:13 +0000636 Default: 1 page
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800637
J. Bruce Fields53025f52008-07-10 16:47:41 -0700638 default: initial size of send buffer used by TCP sockets. This
639 value overrides net.core.wmem_default used by other protocols.
640 It is usually lower than net.core.wmem_default.
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800641 Default: 16K
642
J. Bruce Fields53025f52008-07-10 16:47:41 -0700643 max: Maximal amount of memory allowed for automatically tuned
644 send buffers for TCP sockets. This value does not override
645 net.core.wmem_max. Calling setsockopt() with SO_SNDBUF disables
646 automatic tuning of that socket's send buffer size, in which case
647 this value is ignored.
648 Default: between 64K and 4MB, depending on RAM size.
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800649
Eric Dumazetc9bee3b2013-07-22 20:27:07 -0700650tcp_notsent_lowat - UNSIGNED INTEGER
651 A TCP socket can control the amount of unsent bytes in its write queue,
652 thanks to TCP_NOTSENT_LOWAT socket option. poll()/select()/epoll()
653 reports POLLOUT events if the amount of unsent bytes is below a per
654 socket value, and if the write queue is not full. sendmsg() will
655 also not add new buffers if the limit is hit.
656
657 This global variable controls the amount of unsent data for
658 sockets not using TCP_NOTSENT_LOWAT. For these sockets, a change
659 to the global variable has immediate effect.
660
661 Default: UINT_MAX (0xFFFFFFFF)
662
Stephen Hemmingeref56e622006-11-09 16:37:26 -0800663tcp_workaround_signed_windows - BOOLEAN
664 If set, assume no receipt of a window scaling option means the
665 remote TCP is broken and treats the window as a signed quantity.
666 If unset, assume the remote TCP is not broken even if we do
667 not receive a window scaling option from them.
668 Default: 0
669
Andreas Petlund36e31b0a2010-02-18 02:47:01 +0000670tcp_thin_linear_timeouts - BOOLEAN
671 Enable dynamic triggering of linear timeouts for thin streams.
672 If set, a check is performed upon retransmission by timeout to
673 determine if the stream is thin (less than 4 packets in flight).
674 As long as the stream is found to be thin, up to 6 linear
675 timeouts may be performed before exponential backoff mode is
676 initiated. This improves retransmission latency for
677 non-aggressive thin streams, often found to be time-dependent.
678 For more information on thin streams, see
679 Documentation/networking/tcp-thin.txt
680 Default: 0
681
Andreas Petlund7e380172010-02-18 04:48:19 +0000682tcp_thin_dupack - BOOLEAN
683 Enable dynamic triggering of retransmissions after one dupACK
684 for thin streams. If set, a check is performed upon reception
685 of a dupACK to determine if the stream is thin (less than 4
686 packets in flight). As long as the stream is found to be thin,
687 data is retransmitted on the first received dupACK. This
688 improves retransmission latency for non-aggressive thin
689 streams, often found to be time-dependent.
690 For more information on thin streams, see
691 Documentation/networking/tcp-thin.txt
692 Default: 0
693
Eric Dumazet46d3cea2012-07-11 05:50:31 +0000694tcp_limit_output_bytes - INTEGER
695 Controls TCP Small Queue limit per tcp socket.
696 TCP bulk sender tends to increase packets in flight until it
697 gets losses notifications. With SNDBUF autotuning, this can
698 result in a large amount of packets queued in qdisc/device
699 on the local machine, hurting latency of other flows, for
700 typical pfifo_fast qdiscs.
701 tcp_limit_output_bytes limits the number of bytes on qdisc
702 or device to reduce artificial RTT/cwnd and reduce bufferbloat.
Eric Dumazet46d3cea2012-07-11 05:50:31 +0000703 Default: 131072
704
Eric Dumazet282f23c2012-07-17 10:13:05 +0200705tcp_challenge_ack_limit - INTEGER
706 Limits number of Challenge ACK sent per second, as recommended
707 in RFC 5961 (Improving TCP's Robustness to Blind In-Window Attacks)
708 Default: 100
709
Hideo Aoki95766ff2007-12-31 00:29:24 -0800710UDP variables:
711
712udp_mem - vector of 3 INTEGERs: min, pressure, max
713 Number of pages allowed for queueing by all UDP sockets.
714
715 min: Below this number of pages UDP is not bothered about its
716 memory appetite. When amount of memory allocated by UDP exceeds
717 this number, UDP starts to moderate memory usage.
718
719 pressure: This value was introduced to follow format of tcp_mem.
720
721 max: Number of pages allowed for queueing by all UDP sockets.
722
723 Default is calculated at boot time from amount of available memory.
724
725udp_rmem_min - INTEGER
726 Minimal size of receive buffer used by UDP sockets in moderation.
727 Each UDP socket is able to use the size for receiving data, even if
728 total pages of UDP sockets exceed udp_mem pressure. The unit is byte.
Max Matveev6539fef2011-06-21 21:18:13 +0000729 Default: 1 page
Hideo Aoki95766ff2007-12-31 00:29:24 -0800730
731udp_wmem_min - INTEGER
732 Minimal size of send buffer used by UDP sockets in moderation.
733 Each UDP socket is able to use the size for sending data, even if
734 total pages of UDP sockets exceed udp_mem pressure. The unit is byte.
Max Matveev6539fef2011-06-21 21:18:13 +0000735 Default: 1 page
Hideo Aoki95766ff2007-12-31 00:29:24 -0800736
Paul Moore8802f612006-08-03 16:45:49 -0700737CIPSOv4 Variables:
738
739cipso_cache_enable - BOOLEAN
740 If set, enable additions to and lookups from the CIPSO label mapping
741 cache. If unset, additions are ignored and lookups always result in a
742 miss. However, regardless of the setting the cache is still
743 invalidated when required when means you can safely toggle this on and
744 off and the cache will always be "safe".
745 Default: 1
746
747cipso_cache_bucket_size - INTEGER
748 The CIPSO label cache consists of a fixed size hash table with each
749 hash bucket containing a number of cache entries. This variable limits
750 the number of entries in each hash bucket; the larger the value the
751 more CIPSO label mappings that can be cached. When the number of
752 entries in a given hash bucket reaches this limit adding new entries
753 causes the oldest entry in the bucket to be removed to make room.
754 Default: 10
755
756cipso_rbm_optfmt - BOOLEAN
757 Enable the "Optimized Tag 1 Format" as defined in section 3.4.2.6 of
758 the CIPSO draft specification (see Documentation/netlabel for details).
759 This means that when set the CIPSO tag will be padded with empty
760 categories in order to make the packet data 32-bit aligned.
761 Default: 0
762
763cipso_rbm_structvalid - BOOLEAN
764 If set, do a very strict check of the CIPSO option when
765 ip_options_compile() is called. If unset, relax the checks done during
766 ip_options_compile(). Either way is "safe" as errors are caught else
767 where in the CIPSO processing code but setting this to 0 (False) should
768 result in less work (i.e. it should be faster) but could cause problems
769 with other implementations that require strict checking.
770 Default: 0
771
Linus Torvalds1da177e2005-04-16 15:20:36 -0700772IP Variables:
773
774ip_local_port_range - 2 INTEGERS
775 Defines the local port range that is used by TCP and UDP to
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000776 choose the local port. The first number is the first, the
Eric Dumazet07f4c902015-05-24 14:49:35 -0700777 second the last local port number.
778 If possible, it is better these numbers have different parity.
779 (one even and one odd values)
780 The default values are 32768 and 60999 respectively.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700781
Amerigo Wange3826f12010-05-05 00:27:06 +0000782ip_local_reserved_ports - list of comma separated ranges
783 Specify the ports which are reserved for known third-party
784 applications. These ports will not be used by automatic port
785 assignments (e.g. when calling connect() or bind() with port
786 number 0). Explicit port allocation behavior is unchanged.
787
788 The format used for both input and output is a comma separated
789 list of ranges (e.g. "1,2-4,10-10" for ports 1, 2, 3, 4 and
790 10). Writing to the file will clear all previously reserved
791 ports and update the current list with the one given in the
792 input.
793
794 Note that ip_local_port_range and ip_local_reserved_ports
795 settings are independent and both are considered by the kernel
796 when determining which ports are available for automatic port
797 assignments.
798
799 You can reserve ports which are not in the current
800 ip_local_port_range, e.g.:
801
802 $ cat /proc/sys/net/ipv4/ip_local_port_range
Eric Dumazet07f4c902015-05-24 14:49:35 -0700803 32000 60999
Amerigo Wange3826f12010-05-05 00:27:06 +0000804 $ cat /proc/sys/net/ipv4/ip_local_reserved_ports
805 8080,9148
806
807 although this is redundant. However such a setting is useful
808 if later the port range is changed to a value that will
809 include the reserved ports.
810
811 Default: Empty
812
Linus Torvalds1da177e2005-04-16 15:20:36 -0700813ip_nonlocal_bind - BOOLEAN
814 If set, allows processes to bind() to non-local IP addresses,
815 which can be quite useful - but may break some applications.
816 Default: 0
817
818ip_dynaddr - BOOLEAN
819 If set non-zero, enables support for dynamic addresses.
820 If set to a non-zero value larger than 1, a kernel log
821 message will be printed when dynamic address rewriting
822 occurs.
823 Default: 0
824
Cong Wange3d73bc2013-06-11 18:54:39 +0800825ip_early_demux - BOOLEAN
826 Optimize input packet processing down to one demux for
827 certain kinds of local sockets. Currently we only do this
828 for established TCP sockets.
829
830 It may add an additional cost for pure routing workloads that
831 reduces overall throughput, in such case you should disable it.
832 Default: 1
833
Linus Torvalds1da177e2005-04-16 15:20:36 -0700834icmp_echo_ignore_all - BOOLEAN
David S. Miller7ce312462005-10-03 16:07:30 -0700835 If set non-zero, then the kernel will ignore all ICMP ECHO
836 requests sent to it.
837 Default: 0
838
Linus Torvalds1da177e2005-04-16 15:20:36 -0700839icmp_echo_ignore_broadcasts - BOOLEAN
David S. Miller7ce312462005-10-03 16:07:30 -0700840 If set non-zero, then the kernel will ignore all ICMP ECHO and
841 TIMESTAMP requests sent to it via broadcast/multicast.
842 Default: 1
Linus Torvalds1da177e2005-04-16 15:20:36 -0700843
844icmp_ratelimit - INTEGER
845 Limit the maximal rates for sending ICMP packets whose type matches
846 icmp_ratemask (see below) to specific targets.
Stephen Hemminger6dbf4bc2008-07-01 19:29:07 -0700847 0 to disable any limiting,
848 otherwise the minimal space between responses in milliseconds.
Eric Dumazet4cdf5072014-09-19 07:38:40 -0700849 Note that another sysctl, icmp_msgs_per_sec limits the number
850 of ICMP packets sent on all targets.
Stephen Hemminger6dbf4bc2008-07-01 19:29:07 -0700851 Default: 1000
Linus Torvalds1da177e2005-04-16 15:20:36 -0700852
Eric Dumazet4cdf5072014-09-19 07:38:40 -0700853icmp_msgs_per_sec - INTEGER
854 Limit maximal number of ICMP packets sent per second from this host.
855 Only messages whose type matches icmp_ratemask (see below) are
856 controlled by this limit.
857 Default: 1000
858
859icmp_msgs_burst - INTEGER
860 icmp_msgs_per_sec controls number of ICMP packets sent per second,
861 while icmp_msgs_burst controls the burst size of these packets.
862 Default: 50
863
Linus Torvalds1da177e2005-04-16 15:20:36 -0700864icmp_ratemask - INTEGER
865 Mask made of ICMP types for which rates are being limited.
866 Significant bits: IHGFEDCBA9876543210
867 Default mask: 0000001100000011000 (6168)
868
869 Bit definitions (see include/linux/icmp.h):
870 0 Echo Reply
871 3 Destination Unreachable *
872 4 Source Quench *
873 5 Redirect
874 8 Echo Request
875 B Time Exceeded *
876 C Parameter Problem *
877 D Timestamp Request
878 E Timestamp Reply
879 F Info Request
880 G Info Reply
881 H Address Mask Request
882 I Address Mask Reply
883
884 * These are rate limited by default (see default mask above)
885
886icmp_ignore_bogus_error_responses - BOOLEAN
887 Some routers violate RFC1122 by sending bogus responses to broadcast
888 frames. Such violations are normally logged via a kernel warning.
889 If this is set to TRUE, the kernel will not give such warnings, which
890 will avoid log file clutter.
Rami Rosene8b265e2013-06-07 20:16:19 +0000891 Default: 1
Linus Torvalds1da177e2005-04-16 15:20:36 -0700892
Horms95f7daf2006-02-02 17:02:25 -0800893icmp_errors_use_inbound_ifaddr - BOOLEAN
894
Paolo Abeni02a6d612015-10-14 14:25:53 +0200895 If zero, icmp error messages are sent with the primary address of
896 the exiting interface.
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000897
Horms95f7daf2006-02-02 17:02:25 -0800898 If non-zero, the message will be sent with the primary address of
899 the interface that received the packet that caused the icmp error.
900 This is the behaviour network many administrators will expect from
901 a router. And it can make debugging complicated network layouts
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000902 much easier.
Horms95f7daf2006-02-02 17:02:25 -0800903
904 Note that if no primary address exists for the interface selected,
905 then the primary address of the first non-loopback interface that
Matt LaPlanted6bc8ac2006-10-03 22:54:15 +0200906 has one will be used regardless of this setting.
Horms95f7daf2006-02-02 17:02:25 -0800907
908 Default: 0
909
Linus Torvalds1da177e2005-04-16 15:20:36 -0700910igmp_max_memberships - INTEGER
911 Change the maximum number of multicast groups we can subscribe to.
912 Default: 20
913
Jeremy Ederd67ef352010-11-15 05:41:31 +0000914 Theoretical maximum value is bounded by having to send a membership
915 report in a single datagram (i.e. the report can't span multiple
916 datagrams, or risk confusing the switch and leaving groups you don't
917 intend to).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700918
Jeremy Ederd67ef352010-11-15 05:41:31 +0000919 The number of supported groups 'M' is bounded by the number of group
920 report entries you can fit into a single datagram of 65535 bytes.
921
922 M = 65536-sizeof (ip header)/(sizeof(Group record))
923
924 Group records are variable length, with a minimum of 12 bytes.
925 So net.ipv4.igmp_max_memberships should not be set higher than:
926
927 (65536-24) / 12 = 5459
928
929 The value 5459 assumes no IP header options, so in practice
930 this number may be lower.
931
932 conf/interface/* changes special settings per interface (where
933 "interface" is the name of your network interface)
934
935 conf/all/* is special, changes the settings for all interfaces
Linus Torvalds1da177e2005-04-16 15:20:36 -0700936
Hannes Frederic Sowaa9fe8e22014-09-02 15:49:26 +0200937igmp_qrv - INTEGER
938 Controls the IGMP query robustness variable (see RFC2236 8.1).
939 Default: 2 (as specified by RFC2236 8.1)
940 Minimum: 1 (as specified by RFC6636 4.5)
941
Linus Torvalds1da177e2005-04-16 15:20:36 -0700942log_martians - BOOLEAN
943 Log packets with impossible addresses to kernel log.
944 log_martians for the interface will be enabled if at least one of
945 conf/{all,interface}/log_martians is set to TRUE,
946 it will be disabled otherwise
947
948accept_redirects - BOOLEAN
949 Accept ICMP redirect messages.
950 accept_redirects for the interface will be enabled if:
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000951 - both conf/{all,interface}/accept_redirects are TRUE in the case
952 forwarding for the interface is enabled
Linus Torvalds1da177e2005-04-16 15:20:36 -0700953 or
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000954 - at least one of conf/{all,interface}/accept_redirects is TRUE in the
955 case forwarding for the interface is disabled
Linus Torvalds1da177e2005-04-16 15:20:36 -0700956 accept_redirects for the interface will be disabled otherwise
957 default TRUE (host)
958 FALSE (router)
959
960forwarding - BOOLEAN
961 Enable IP forwarding on this interface.
962
963mc_forwarding - BOOLEAN
964 Do multicast routing. The kernel needs to be compiled with CONFIG_MROUTE
965 and a multicast routing daemon is required.
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000966 conf/all/mc_forwarding must also be set to TRUE to enable multicast
967 routing for the interface
Linus Torvalds1da177e2005-04-16 15:20:36 -0700968
969medium_id - INTEGER
970 Integer value used to differentiate the devices by the medium they
971 are attached to. Two devices can have different id values when
972 the broadcast packets are received only on one of them.
973 The default value 0 means that the device is the only interface
974 to its medium, value of -1 means that medium is not known.
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +0000975
Linus Torvalds1da177e2005-04-16 15:20:36 -0700976 Currently, it is used to change the proxy_arp behavior:
977 the proxy_arp feature is enabled for packets forwarded between
978 two devices attached to different media.
979
980proxy_arp - BOOLEAN
981 Do proxy arp.
982 proxy_arp for the interface will be enabled if at least one of
983 conf/{all,interface}/proxy_arp is set to TRUE,
984 it will be disabled otherwise
985
Jesper Dangaard Brouer65324142010-01-05 05:50:47 +0000986proxy_arp_pvlan - BOOLEAN
987 Private VLAN proxy arp.
988 Basically allow proxy arp replies back to the same interface
989 (from which the ARP request/solicitation was received).
990
991 This is done to support (ethernet) switch features, like RFC
992 3069, where the individual ports are NOT allowed to
993 communicate with each other, but they are allowed to talk to
994 the upstream router. As described in RFC 3069, it is possible
995 to allow these hosts to communicate through the upstream
996 router by proxy_arp'ing. Don't need to be used together with
997 proxy_arp.
998
999 This technology is known by different names:
1000 In RFC 3069 it is called VLAN Aggregation.
1001 Cisco and Allied Telesyn call it Private VLAN.
1002 Hewlett-Packard call it Source-Port filtering or port-isolation.
1003 Ericsson call it MAC-Forced Forwarding (RFC Draft).
1004
Linus Torvalds1da177e2005-04-16 15:20:36 -07001005shared_media - BOOLEAN
1006 Send(router) or accept(host) RFC1620 shared media redirects.
1007 Overrides ip_secure_redirects.
1008 shared_media for the interface will be enabled if at least one of
1009 conf/{all,interface}/shared_media is set to TRUE,
1010 it will be disabled otherwise
1011 default TRUE
1012
1013secure_redirects - BOOLEAN
1014 Accept ICMP redirect messages only for gateways,
1015 listed in default gateway list.
1016 secure_redirects for the interface will be enabled if at least one of
1017 conf/{all,interface}/secure_redirects is set to TRUE,
1018 it will be disabled otherwise
1019 default TRUE
1020
1021send_redirects - BOOLEAN
1022 Send redirects, if router.
1023 send_redirects for the interface will be enabled if at least one of
1024 conf/{all,interface}/send_redirects is set to TRUE,
1025 it will be disabled otherwise
1026 Default: TRUE
1027
1028bootp_relay - BOOLEAN
1029 Accept packets with source address 0.b.c.d destined
1030 not to this host as local ones. It is supposed, that
1031 BOOTP relay daemon will catch and forward such packets.
1032 conf/all/bootp_relay must also be set to TRUE to enable BOOTP relay
1033 for the interface
1034 default FALSE
1035 Not Implemented Yet.
1036
1037accept_source_route - BOOLEAN
1038 Accept packets with SRR option.
1039 conf/all/accept_source_route must also be set to TRUE to accept packets
1040 with SRR option on the interface
1041 default TRUE (router)
1042 FALSE (host)
1043
Patrick McHardy8153a102009-12-03 01:25:58 +00001044accept_local - BOOLEAN
Sébastien Barré72b126a2014-09-10 18:20:23 +02001045 Accept packets with local source addresses. In combination with
1046 suitable routing, this can be used to direct packets between two
1047 local interfaces over the wire and have them accepted properly.
Patrick McHardy8153a102009-12-03 01:25:58 +00001048 default FALSE
1049
Thomas Grafd0daebc32012-06-12 00:44:01 +00001050route_localnet - BOOLEAN
1051 Do not consider loopback addresses as martian source or destination
1052 while routing. This enables the use of 127/8 for local routing purposes.
1053 default FALSE
1054
Stephen Hemmingerc1cf8422009-02-20 08:25:36 +00001055rp_filter - INTEGER
Linus Torvalds1da177e2005-04-16 15:20:36 -07001056 0 - No source validation.
Stephen Hemmingerc1cf8422009-02-20 08:25:36 +00001057 1 - Strict mode as defined in RFC3704 Strict Reverse Path
1058 Each incoming packet is tested against the FIB and if the interface
1059 is not the best reverse path the packet check will fail.
1060 By default failed packets are discarded.
1061 2 - Loose mode as defined in RFC3704 Loose Reverse Path
1062 Each incoming packet's source address is also tested against the FIB
1063 and if the source address is not reachable via any interface
1064 the packet check will fail.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001065
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001066 Current recommended practice in RFC3704 is to enable strict mode
Jesper Dangaard Brouerbf869c32009-02-23 04:37:55 +00001067 to prevent IP spoofing from DDos attacks. If using asymmetric routing
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001068 or other complicated routing, then loose mode is recommended.
Stephen Hemmingerc1cf8422009-02-20 08:25:36 +00001069
Shan Wei1f5865e2009-12-02 15:39:04 -08001070 The max value from conf/{all,interface}/rp_filter is used
1071 when doing source validation on the {interface}.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001072
1073 Default value is 0. Note that some distributions enable it
1074 in startup scripts.
1075
1076arp_filter - BOOLEAN
1077 1 - Allows you to have multiple network interfaces on the same
1078 subnet, and have the ARPs for each interface be answered
1079 based on whether or not the kernel would route a packet from
1080 the ARP'd IP out that interface (therefore you must use source
1081 based routing for this to work). In other words it allows control
1082 of which cards (usually 1) will respond to an arp request.
1083
1084 0 - (default) The kernel can respond to arp requests with addresses
1085 from other interfaces. This may seem wrong but it usually makes
1086 sense, because it increases the chance of successful communication.
1087 IP addresses are owned by the complete host on Linux, not by
1088 particular interfaces. Only for more complex setups like load-
1089 balancing, does this behaviour cause problems.
1090
1091 arp_filter for the interface will be enabled if at least one of
1092 conf/{all,interface}/arp_filter is set to TRUE,
1093 it will be disabled otherwise
1094
1095arp_announce - INTEGER
1096 Define different restriction levels for announcing the local
1097 source IP address from IP packets in ARP requests sent on
1098 interface:
1099 0 - (default) Use any local address, configured on any interface
1100 1 - Try to avoid local addresses that are not in the target's
1101 subnet for this interface. This mode is useful when target
1102 hosts reachable via this interface require the source IP
1103 address in ARP requests to be part of their logical network
1104 configured on the receiving interface. When we generate the
1105 request we will check all our subnets that include the
1106 target IP and will preserve the source address if it is from
1107 such subnet. If there is no such subnet we select source
1108 address according to the rules for level 2.
1109 2 - Always use the best local address for this target.
1110 In this mode we ignore the source address in the IP packet
1111 and try to select local address that we prefer for talks with
1112 the target host. Such local address is selected by looking
1113 for primary IP addresses on all our subnets on the outgoing
1114 interface that include the target IP address. If no suitable
1115 local address is found we select the first local address
1116 we have on the outgoing interface or on all other interfaces,
1117 with the hope we will receive reply for our request and
1118 even sometimes no matter the source IP address we announce.
1119
1120 The max value from conf/{all,interface}/arp_announce is used.
1121
1122 Increasing the restriction level gives more chance for
1123 receiving answer from the resolved target while decreasing
1124 the level announces more valid sender's information.
1125
1126arp_ignore - INTEGER
1127 Define different modes for sending replies in response to
1128 received ARP requests that resolve local target IP addresses:
1129 0 - (default): reply for any local target IP address, configured
1130 on any interface
1131 1 - reply only if the target IP address is local address
1132 configured on the incoming interface
1133 2 - reply only if the target IP address is local address
1134 configured on the incoming interface and both with the
1135 sender's IP address are part from same subnet on this interface
1136 3 - do not reply for local addresses configured with scope host,
1137 only resolutions for global and link addresses are replied
1138 4-7 - reserved
1139 8 - do not reply for all local addresses
1140
1141 The max value from conf/{all,interface}/arp_ignore is used
1142 when ARP request is received on the {interface}
1143
Stephen Hemmingereefef1c2009-02-01 01:04:33 -08001144arp_notify - BOOLEAN
1145 Define mode for notification of address and device changes.
1146 0 - (default): do nothing
Ian Campbell3f8dc232010-05-26 00:09:41 +00001147 1 - Generate gratuitous arp requests when device is brought up
Stephen Hemmingereefef1c2009-02-01 01:04:33 -08001148 or hardware address changes.
1149
Neil Hormanc1b1bce2006-03-20 22:40:03 -08001150arp_accept - BOOLEAN
Octavian Purdila6d955182010-01-18 12:58:44 +00001151 Define behavior for gratuitous ARP frames who's IP is not
1152 already present in the ARP table:
1153 0 - don't create new entries in the ARP table
1154 1 - create new entries in the ARP table
1155
1156 Both replies and requests type gratuitous arp will trigger the
1157 ARP table to be updated, if this setting is on.
1158
1159 If the ARP table already contains the IP address of the
1160 gratuitous arp frame, the arp table will be updated regardless
1161 if this setting is on or off.
1162
YOSHIFUJI Hideaki/吉藤英明89c69d32015-03-19 22:42:04 +09001163mcast_solicit - INTEGER
1164 The maximum number of multicast probes in INCOMPLETE state,
1165 when the associated hardware address is unknown. Defaults
1166 to 3.
1167
1168ucast_solicit - INTEGER
1169 The maximum number of unicast probes in PROBE state, when
1170 the hardware address is being reconfirmed. Defaults to 3.
Neil Hormanc1b1bce2006-03-20 22:40:03 -08001171
Linus Torvalds1da177e2005-04-16 15:20:36 -07001172app_solicit - INTEGER
1173 The maximum number of probes to send to the user space ARP daemon
1174 via netlink before dropping back to multicast probes (see
YOSHIFUJI Hideaki/吉藤英明89c69d32015-03-19 22:42:04 +09001175 mcast_resolicit). Defaults to 0.
1176
1177mcast_resolicit - INTEGER
1178 The maximum number of multicast probes after unicast and
1179 app probes in PROBE state. Defaults to 0.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001180
1181disable_policy - BOOLEAN
1182 Disable IPSEC policy (SPD) for this interface
1183
1184disable_xfrm - BOOLEAN
1185 Disable IPSEC encryption on this interface, whatever the policy
1186
Hannes Frederic Sowafc4eba52013-08-14 01:03:46 +02001187igmpv2_unsolicited_report_interval - INTEGER
1188 The interval in milliseconds in which the next unsolicited
1189 IGMPv1 or IGMPv2 report retransmit will take place.
1190 Default: 10000 (10 seconds)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001191
Hannes Frederic Sowafc4eba52013-08-14 01:03:46 +02001192igmpv3_unsolicited_report_interval - INTEGER
1193 The interval in milliseconds in which the next unsolicited
1194 IGMPv3 report retransmit will take place.
1195 Default: 1000 (1 seconds)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001196
Martin Schwenked922e1c2014-01-28 15:26:42 +11001197promote_secondaries - BOOLEAN
1198 When a primary IP address is removed from this interface
1199 promote a corresponding secondary IP address instead of
1200 removing all the corresponding secondary IP addresses.
1201
1202
Linus Torvalds1da177e2005-04-16 15:20:36 -07001203tag - INTEGER
1204 Allows you to write a number, which can be used as required.
1205 Default value is 0.
1206
Alexander Duycke69948a2015-08-11 13:35:01 -07001207xfrm4_gc_thresh - INTEGER
1208 The threshold at which we will start garbage collecting for IPv4
1209 destination cache entries. At twice this value the system will
1210 refuse new allocations.
1211
Philip Downey87583eb2015-08-31 11:30:38 +01001212igmp_link_local_mcast_reports - BOOLEAN
1213 Enable IGMP reports for link local multicast groups in the
1214 224.0.0.X range.
1215 Default TRUE
1216
Linus Torvalds1da177e2005-04-16 15:20:36 -07001217Alexey Kuznetsov.
1218kuznet@ms2.inr.ac.ru
1219
1220Updated by:
1221Andi Kleen
1222ak@muc.de
1223Nicolas Delon
1224delon.nicolas@wanadoo.fr
1225
1226
1227
1228
1229/proc/sys/net/ipv6/* Variables:
1230
1231IPv6 has no global variables such as tcp_*. tcp_* settings under ipv4/ also
1232apply to IPv6 [XXX?].
1233
1234bindv6only - BOOLEAN
1235 Default value for IPV6_V6ONLY socket option,
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001236 which restricts use of the IPv6 socket to IPv6 communication
Linus Torvalds1da177e2005-04-16 15:20:36 -07001237 only.
1238 TRUE: disable IPv4-mapped address feature
1239 FALSE: enable IPv4-mapped address feature
1240
Geoffrey Thomasd5c073ca2011-08-22 11:28:57 -07001241 Default: FALSE (as specified in RFC3493)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001242
Florent Fourcot6444f722014-01-17 17:15:05 +01001243flowlabel_consistency - BOOLEAN
1244 Protect the consistency (and unicity) of flow label.
1245 You have to disable it to use IPV6_FL_F_REFLECT flag on the
1246 flow label manager.
1247 TRUE: enabled
1248 FALSE: disabled
1249 Default: TRUE
1250
Tom Herbert42240902015-07-31 16:52:12 -07001251auto_flowlabels - INTEGER
1252 Automatically generate flow labels based on a flow hash of the
1253 packet. This allows intermediate devices, such as routers, to
1254 identify packet flows for mechanisms like Equal Cost Multipath
Tom Herbertcb1ce2e2014-07-01 21:33:10 -07001255 Routing (see RFC 6438).
Tom Herbert42240902015-07-31 16:52:12 -07001256 0: automatic flow labels are completely disabled
1257 1: automatic flow labels are enabled by default, they can be
1258 disabled on a per socket basis using the IPV6_AUTOFLOWLABEL
1259 socket option
1260 2: automatic flow labels are allowed, they may be enabled on a
1261 per socket basis using the IPV6_AUTOFLOWLABEL socket option
1262 3: automatic flow labels are enabled and enforced, they cannot
1263 be disabled by the socket option
Tom Herbertb5677412015-07-31 16:52:14 -07001264 Default: 1
Tom Herbertcb1ce2e2014-07-01 21:33:10 -07001265
Tom Herbert82a584b2015-04-29 15:33:21 -07001266flowlabel_state_ranges - BOOLEAN
1267 Split the flow label number space into two ranges. 0-0x7FFFF is
1268 reserved for the IPv6 flow manager facility, 0x80000-0xFFFFF
1269 is reserved for stateless flow labels as described in RFC6437.
1270 TRUE: enabled
1271 FALSE: disabled
1272 Default: true
1273
FX Le Bail509aba32014-01-07 14:57:27 +01001274anycast_src_echo_reply - BOOLEAN
1275 Controls the use of anycast addresses as source addresses for ICMPv6
1276 echo reply
1277 TRUE: enabled
1278 FALSE: disabled
1279 Default: FALSE
1280
Hannes Frederic Sowa9f0761c2015-03-23 23:36:06 +01001281idgen_delay - INTEGER
1282 Controls the delay in seconds after which time to retry
1283 privacy stable address generation if a DAD conflict is
1284 detected.
1285 Default: 1 (as specified in RFC7217)
1286
1287idgen_retries - INTEGER
1288 Controls the number of retries to generate a stable privacy
1289 address if a DAD conflict is detected.
1290 Default: 3 (as specified in RFC7217)
1291
Hannes Frederic Sowa2f711932014-09-02 15:49:25 +02001292mld_qrv - INTEGER
1293 Controls the MLD query robustness variable (see RFC3810 9.1).
1294 Default: 2 (as specified by RFC3810 9.1)
1295 Minimum: 1 (as specified by RFC6636 4.5)
1296
Linus Torvalds1da177e2005-04-16 15:20:36 -07001297IPv6 Fragmentation:
1298
1299ip6frag_high_thresh - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001300 Maximum memory used to reassemble IPv6 fragments. When
Linus Torvalds1da177e2005-04-16 15:20:36 -07001301 ip6frag_high_thresh bytes of memory is allocated for this purpose,
1302 the fragment handler will toss packets until ip6frag_low_thresh
1303 is reached.
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001304
Linus Torvalds1da177e2005-04-16 15:20:36 -07001305ip6frag_low_thresh - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001306 See ip6frag_high_thresh
Linus Torvalds1da177e2005-04-16 15:20:36 -07001307
1308ip6frag_time - INTEGER
1309 Time in seconds to keep an IPv6 fragment in memory.
1310
Linus Torvalds1da177e2005-04-16 15:20:36 -07001311conf/default/*:
1312 Change the interface-specific default settings.
1313
1314
1315conf/all/*:
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001316 Change all the interface-specific settings.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001317
1318 [XXX: Other special features than forwarding?]
1319
1320conf/all/forwarding - BOOLEAN
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001321 Enable global IPv6 forwarding between all interfaces.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001322
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001323 IPv4 and IPv6 work differently here; e.g. netfilter must be used
Linus Torvalds1da177e2005-04-16 15:20:36 -07001324 to control which interfaces may forward packets and which not.
1325
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001326 This also sets all interfaces' Host/Router setting
Linus Torvalds1da177e2005-04-16 15:20:36 -07001327 'forwarding' to the specified value. See below for details.
1328
1329 This referred to as global forwarding.
1330
YOSHIFUJI Hideakifbea49e2006-09-22 14:43:49 -07001331proxy_ndp - BOOLEAN
1332 Do proxy ndp.
1333
Loganaden Velvindron219b5f22014-11-04 03:02:49 -08001334fwmark_reflect - BOOLEAN
1335 Controls the fwmark of kernel-generated IPv6 reply packets that are not
1336 associated with a socket for example, TCP RSTs or ICMPv6 echo replies).
1337 If unset, these packets have a fwmark of zero. If set, they have the
1338 fwmark of the packet they are replying to.
1339 Default: 0
1340
Linus Torvalds1da177e2005-04-16 15:20:36 -07001341conf/interface/*:
1342 Change special settings per interface.
1343
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001344 The functional behaviour for certain settings is different
Linus Torvalds1da177e2005-04-16 15:20:36 -07001345 depending on whether local forwarding is enabled or not.
1346
Roy.Li605b91c2011-09-28 19:51:54 +00001347accept_ra - INTEGER
Linus Torvalds1da177e2005-04-16 15:20:36 -07001348 Accept Router Advertisements; autoconfigure using them.
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001349
Tore Anderson026359b2011-08-28 23:47:33 +00001350 It also determines whether or not to transmit Router
1351 Solicitations. If and only if the functional setting is to
1352 accept Router Advertisements, Router Solicitations will be
1353 transmitted.
1354
Thomas Grafae8abfa2010-09-03 05:47:30 +00001355 Possible values are:
1356 0 Do not accept Router Advertisements.
1357 1 Accept Router Advertisements if forwarding is disabled.
1358 2 Overrule forwarding behaviour. Accept Router Advertisements
1359 even if forwarding is enabled.
1360
Linus Torvalds1da177e2005-04-16 15:20:36 -07001361 Functional default: enabled if local forwarding is disabled.
1362 disabled if local forwarding is enabled.
1363
YOSHIFUJI Hideaki65f5c7c2006-03-20 16:55:08 -08001364accept_ra_defrtr - BOOLEAN
1365 Learn default router in Router Advertisement.
1366
1367 Functional default: enabled if accept_ra is enabled.
1368 disabled if accept_ra is disabled.
1369
Ben Greeard9333192014-06-25 14:44:53 -07001370accept_ra_from_local - BOOLEAN
1371 Accept RA with source-address that is found on local machine
1372 if the RA is otherwise proper and able to be accepted.
1373 Default is to NOT accept these as it may be an un-intended
1374 network loop.
1375
1376 Functional default:
1377 enabled if accept_ra_from_local is enabled
1378 on a specific interface.
1379 disabled if accept_ra_from_local is disabled
1380 on a specific interface.
1381
Hangbin Liu8013d1d2015-07-30 14:28:42 +08001382accept_ra_min_hop_limit - INTEGER
1383 Minimum hop limit Information in Router Advertisement.
1384
1385 Hop limit Information in Router Advertisement less than this
1386 variable shall be ignored.
1387
1388 Default: 1
1389
YOSHIFUJI Hideakic4fd30e2006-03-20 16:55:26 -08001390accept_ra_pinfo - BOOLEAN
Matt LaPlante2fe0ae72006-10-03 22:50:39 +02001391 Learn Prefix Information in Router Advertisement.
YOSHIFUJI Hideakic4fd30e2006-03-20 16:55:26 -08001392
1393 Functional default: enabled if accept_ra is enabled.
1394 disabled if accept_ra is disabled.
1395
YOSHIFUJI Hideaki09c884d2006-03-20 17:07:03 -08001396accept_ra_rt_info_max_plen - INTEGER
1397 Maximum prefix length of Route Information in RA.
1398
1399 Route Information w/ prefix larger than or equal to this
1400 variable shall be ignored.
1401
1402 Functional default: 0 if accept_ra_rtr_pref is enabled.
1403 -1 if accept_ra_rtr_pref is disabled.
1404
YOSHIFUJI Hideaki930d6ff2006-03-20 17:05:30 -08001405accept_ra_rtr_pref - BOOLEAN
1406 Accept Router Preference in RA.
1407
1408 Functional default: enabled if accept_ra is enabled.
1409 disabled if accept_ra is disabled.
1410
Harout Hedeshianc2943f12015-01-20 10:06:05 -07001411accept_ra_mtu - BOOLEAN
1412 Apply the MTU value specified in RA option 5 (RFC4861). If
1413 disabled, the MTU specified in the RA will be ignored.
1414
1415 Functional default: enabled if accept_ra is enabled.
1416 disabled if accept_ra is disabled.
1417
Linus Torvalds1da177e2005-04-16 15:20:36 -07001418accept_redirects - BOOLEAN
1419 Accept Redirects.
1420
1421 Functional default: enabled if local forwarding is disabled.
1422 disabled if local forwarding is enabled.
1423
YOSHIFUJI Hideaki0bcbc922007-04-24 14:58:30 -07001424accept_source_route - INTEGER
1425 Accept source routing (routing extension header).
1426
YOSHIFUJI Hideakibb4dbf92007-07-10 22:55:49 -07001427 >= 0: Accept only routing header type 2.
YOSHIFUJI Hideaki0bcbc922007-04-24 14:58:30 -07001428 < 0: Do not accept routing header.
1429
1430 Default: 0
1431
Linus Torvalds1da177e2005-04-16 15:20:36 -07001432autoconf - BOOLEAN
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001433 Autoconfigure addresses using Prefix Information in Router
Linus Torvalds1da177e2005-04-16 15:20:36 -07001434 Advertisements.
1435
YOSHIFUJI Hideakic4fd30e2006-03-20 16:55:26 -08001436 Functional default: enabled if accept_ra_pinfo is enabled.
1437 disabled if accept_ra_pinfo is disabled.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001438
1439dad_transmits - INTEGER
1440 The amount of Duplicate Address Detection probes to send.
1441 Default: 1
Linus Torvalds1da177e2005-04-16 15:20:36 -07001442
Roy.Li605b91c2011-09-28 19:51:54 +00001443forwarding - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001444 Configure interface-specific Host/Router behaviour.
1445
1446 Note: It is recommended to have the same setting on all
Linus Torvalds1da177e2005-04-16 15:20:36 -07001447 interfaces; mixed router/host scenarios are rather uncommon.
1448
Thomas Grafae8abfa2010-09-03 05:47:30 +00001449 Possible values are:
1450 0 Forwarding disabled
1451 1 Forwarding enabled
Thomas Grafae8abfa2010-09-03 05:47:30 +00001452
1453 FALSE (0):
Linus Torvalds1da177e2005-04-16 15:20:36 -07001454
1455 By default, Host behaviour is assumed. This means:
1456
1457 1. IsRouter flag is not set in Neighbour Advertisements.
Tore Anderson026359b2011-08-28 23:47:33 +00001458 2. If accept_ra is TRUE (default), transmit Router
1459 Solicitations.
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001460 3. If accept_ra is TRUE (default), accept Router
Linus Torvalds1da177e2005-04-16 15:20:36 -07001461 Advertisements (and do autoconfiguration).
1462 4. If accept_redirects is TRUE (default), accept Redirects.
1463
Thomas Grafae8abfa2010-09-03 05:47:30 +00001464 TRUE (1):
Linus Torvalds1da177e2005-04-16 15:20:36 -07001465
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001466 If local forwarding is enabled, Router behaviour is assumed.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001467 This means exactly the reverse from the above:
1468
1469 1. IsRouter flag is set in Neighbour Advertisements.
Tore Anderson026359b2011-08-28 23:47:33 +00001470 2. Router Solicitations are not sent unless accept_ra is 2.
Thomas Grafae8abfa2010-09-03 05:47:30 +00001471 3. Router Advertisements are ignored unless accept_ra is 2.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001472 4. Redirects are ignored.
1473
Thomas Grafae8abfa2010-09-03 05:47:30 +00001474 Default: 0 (disabled) if global forwarding is disabled (default),
1475 otherwise 1 (enabled).
Linus Torvalds1da177e2005-04-16 15:20:36 -07001476
1477hop_limit - INTEGER
1478 Default Hop Limit to set.
1479 Default: 64
1480
1481mtu - INTEGER
1482 Default Maximum Transfer Unit
1483 Default: 1280 (IPv6 required minimum)
1484
Tom Herbert35a256f2015-07-08 16:58:22 -07001485ip_nonlocal_bind - BOOLEAN
1486 If set, allows processes to bind() to non-local IPv6 addresses,
1487 which can be quite useful - but may break some applications.
1488 Default: 0
1489
YOSHIFUJI Hideaki52e16352006-03-20 17:05:47 -08001490router_probe_interval - INTEGER
1491 Minimum interval (in seconds) between Router Probing described
1492 in RFC4191.
1493
1494 Default: 60
1495
Linus Torvalds1da177e2005-04-16 15:20:36 -07001496router_solicitation_delay - INTEGER
1497 Number of seconds to wait after interface is brought up
1498 before sending Router Solicitations.
1499 Default: 1
1500
1501router_solicitation_interval - INTEGER
1502 Number of seconds to wait between Router Solicitations.
1503 Default: 4
1504
1505router_solicitations - INTEGER
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001506 Number of Router Solicitations to send until assuming no
Linus Torvalds1da177e2005-04-16 15:20:36 -07001507 routers are present.
1508 Default: 3
1509
Erik Kline3985e8a2015-07-22 16:38:25 +09001510use_oif_addrs_only - BOOLEAN
1511 When enabled, the candidate source addresses for destinations
1512 routed via this interface are restricted to the set of addresses
1513 configured on this interface (vis. RFC 6724, section 4).
1514
1515 Default: false
1516
Linus Torvalds1da177e2005-04-16 15:20:36 -07001517use_tempaddr - INTEGER
1518 Preference for Privacy Extensions (RFC3041).
1519 <= 0 : disable Privacy Extensions
1520 == 1 : enable Privacy Extensions, but prefer public
1521 addresses over temporary addresses.
1522 > 1 : enable Privacy Extensions and prefer temporary
1523 addresses over public addresses.
1524 Default: 0 (for most devices)
1525 -1 (for point-to-point devices and loopback devices)
1526
1527temp_valid_lft - INTEGER
1528 valid lifetime (in seconds) for temporary addresses.
1529 Default: 604800 (7 days)
1530
1531temp_prefered_lft - INTEGER
1532 Preferred lifetime (in seconds) for temporary addresses.
1533 Default: 86400 (1 day)
1534
1535max_desync_factor - INTEGER
1536 Maximum value for DESYNC_FACTOR, which is a random value
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001537 that ensures that clients don't synchronize with each
Linus Torvalds1da177e2005-04-16 15:20:36 -07001538 other and generate new addresses at exactly the same time.
1539 value is in seconds.
1540 Default: 600
Jesper Dangaard Brouere18f5fe2009-02-23 04:39:04 +00001541
Linus Torvalds1da177e2005-04-16 15:20:36 -07001542regen_max_retry - INTEGER
1543 Number of attempts before give up attempting to generate
1544 valid temporary addresses.
1545 Default: 5
1546
1547max_addresses - INTEGER
Brian Haleye79dc482010-02-22 12:27:21 +00001548 Maximum number of autoconfigured addresses per interface. Setting
1549 to zero disables the limitation. It is not recommended to set this
1550 value too large (or to zero) because it would be an easy way to
1551 crash the kernel by allowing too many addresses to be created.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001552 Default: 16
1553
YOSHIFUJI Hideaki778d80b2008-06-28 14:17:11 +09001554disable_ipv6 - BOOLEAN
Brian Haley9bdd8d42009-03-18 18:22:48 -07001555 Disable IPv6 operation. If accept_dad is set to 2, this value
1556 will be dynamically set to TRUE if DAD fails for the link-local
1557 address.
YOSHIFUJI Hideaki778d80b2008-06-28 14:17:11 +09001558 Default: FALSE (enable IPv6 operation)
1559
Brian Haley56d417b2009-06-01 03:07:33 -07001560 When this value is changed from 1 to 0 (IPv6 is being enabled),
1561 it will dynamically create a link-local address on the given
1562 interface and start Duplicate Address Detection, if necessary.
1563
1564 When this value is changed from 0 to 1 (IPv6 is being disabled),
1565 it will dynamically delete all address on the given interface.
1566
YOSHIFUJI Hideaki1b34be72008-06-28 14:18:38 +09001567accept_dad - INTEGER
1568 Whether to accept DAD (Duplicate Address Detection).
1569 0: Disable DAD
1570 1: Enable DAD (default)
1571 2: Enable DAD, and disable IPv6 operation if MAC-based duplicate
1572 link-local address has been found.
1573
Octavian Purdilaf7734fd2009-10-02 11:39:15 +00001574force_tllao - BOOLEAN
1575 Enable sending the target link-layer address option even when
1576 responding to a unicast neighbor solicitation.
1577 Default: FALSE
1578
1579 Quoting from RFC 2461, section 4.4, Target link-layer address:
1580
1581 "The option MUST be included for multicast solicitations in order to
1582 avoid infinite Neighbor Solicitation "recursion" when the peer node
1583 does not have a cache entry to return a Neighbor Advertisements
1584 message. When responding to unicast solicitations, the option can be
1585 omitted since the sender of the solicitation has the correct link-
1586 layer address; otherwise it would not have be able to send the unicast
1587 solicitation in the first place. However, including the link-layer
1588 address in this case adds little overhead and eliminates a potential
1589 race condition where the sender deletes the cached link-layer address
1590 prior to receiving a response to a previous solicitation."
1591
Hannes Frederic Sowadb2b6202013-01-01 00:35:31 +00001592ndisc_notify - BOOLEAN
1593 Define mode for notification of address and device changes.
1594 0 - (default): do nothing
1595 1 - Generate unsolicited neighbour advertisements when device is brought
1596 up or hardware address changes.
1597
Hannes Frederic Sowafc4eba52013-08-14 01:03:46 +02001598mldv1_unsolicited_report_interval - INTEGER
1599 The interval in milliseconds in which the next unsolicited
1600 MLDv1 report retransmit will take place.
1601 Default: 10000 (10 seconds)
1602
1603mldv2_unsolicited_report_interval - INTEGER
1604 The interval in milliseconds in which the next unsolicited
1605 MLDv2 report retransmit will take place.
1606 Default: 1000 (1 second)
1607
Daniel Borkmannf2127812013-09-04 00:19:44 +02001608force_mld_version - INTEGER
1609 0 - (default) No enforcement of a MLD version, MLDv1 fallback allowed
1610 1 - Enforce to use MLD version 1
1611 2 - Enforce to use MLD version 2
1612
Hannes Frederic Sowab800c3b2013-08-27 01:36:51 +02001613suppress_frag_ndisc - INTEGER
1614 Control RFC 6980 (Security Implications of IPv6 Fragmentation
1615 with IPv6 Neighbor Discovery) behavior:
1616 1 - (default) discard fragmented neighbor discovery packets
1617 0 - allow fragmented neighbor discovery packets
1618
Erik Kline7fd25612014-10-28 18:11:14 +09001619optimistic_dad - BOOLEAN
1620 Whether to perform Optimistic Duplicate Address Detection (RFC 4429).
1621 0: disabled (default)
1622 1: enabled
1623
1624use_optimistic - BOOLEAN
1625 If enabled, do not classify optimistic addresses as deprecated during
1626 source address selection. Preferred addresses will still be chosen
1627 before optimistic addresses, subject to other ranking in the source
1628 address selection algorithm.
1629 0: disabled (default)
1630 1: enabled
1631
Hannes Frederic Sowa9f0761c2015-03-23 23:36:06 +01001632stable_secret - IPv6 address
1633 This IPv6 address will be used as a secret to generate IPv6
1634 addresses for link-local addresses and autoconfigured
1635 ones. All addresses generated after setting this secret will
1636 be stable privacy ones by default. This can be changed via the
1637 addrgenmode ip-link. conf/default/stable_secret is used as the
1638 secret for the namespace, the interface specific ones can
1639 overwrite that. Writes to conf/all/stable_secret are refused.
1640
1641 It is recommended to generate this secret during installation
1642 of a system and keep it stable after that.
1643
1644 By default the stable secret is unset.
1645
Linus Torvalds1da177e2005-04-16 15:20:36 -07001646icmp/*:
1647ratelimit - INTEGER
1648 Limit the maximal rates for sending ICMPv6 packets.
Stephen Hemminger6dbf4bc2008-07-01 19:29:07 -07001649 0 to disable any limiting,
1650 otherwise the minimal space between responses in milliseconds.
1651 Default: 1000
Linus Torvalds1da177e2005-04-16 15:20:36 -07001652
Alexander Duycke69948a2015-08-11 13:35:01 -07001653xfrm6_gc_thresh - INTEGER
1654 The threshold at which we will start garbage collecting for IPv6
1655 destination cache entries. At twice this value the system will
1656 refuse new allocations.
1657
Linus Torvalds1da177e2005-04-16 15:20:36 -07001658
1659IPv6 Update by:
1660Pekka Savola <pekkas@netcore.fi>
1661YOSHIFUJI Hideaki / USAGI Project <yoshfuji@linux-ipv6.org>
1662
1663
1664/proc/sys/net/bridge/* Variables:
1665
1666bridge-nf-call-arptables - BOOLEAN
1667 1 : pass bridged ARP traffic to arptables' FORWARD chain.
1668 0 : disable this.
1669 Default: 1
1670
1671bridge-nf-call-iptables - BOOLEAN
1672 1 : pass bridged IPv4 traffic to iptables' chains.
1673 0 : disable this.
1674 Default: 1
1675
1676bridge-nf-call-ip6tables - BOOLEAN
1677 1 : pass bridged IPv6 traffic to ip6tables' chains.
1678 0 : disable this.
1679 Default: 1
1680
1681bridge-nf-filter-vlan-tagged - BOOLEAN
Michael Milner516299d2007-04-12 22:14:23 -07001682 1 : pass bridged vlan-tagged ARP/IP/IPv6 traffic to {arp,ip,ip6}tables.
1683 0 : disable this.
Pablo Neira Ayuso49816822012-05-08 19:36:44 +02001684 Default: 0
Michael Milner516299d2007-04-12 22:14:23 -07001685
1686bridge-nf-filter-pppoe-tagged - BOOLEAN
1687 1 : pass bridged pppoe-tagged IP/IPv6 traffic to {ip,ip6}tables.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001688 0 : disable this.
Pablo Neira Ayuso49816822012-05-08 19:36:44 +02001689 Default: 0
Linus Torvalds1da177e2005-04-16 15:20:36 -07001690
Pablo Neira Ayuso49816822012-05-08 19:36:44 +02001691bridge-nf-pass-vlan-input-dev - BOOLEAN
1692 1: if bridge-nf-filter-vlan-tagged is enabled, try to find a vlan
1693 interface on the bridge and set the netfilter input device to the vlan.
1694 This allows use of e.g. "iptables -i br0.1" and makes the REDIRECT
1695 target work with vlan-on-top-of-bridge interfaces. When no matching
1696 vlan interface is found, or this switch is off, the input device is
1697 set to the bridge interface.
1698 0: disable bridge netfilter vlan interface lookup.
1699 Default: 0
Linus Torvalds1da177e2005-04-16 15:20:36 -07001700
Vlad Yasevich32e8d492008-07-08 16:43:29 -07001701proc/sys/net/sctp/* Variables:
1702
1703addip_enable - BOOLEAN
1704 Enable or disable extension of Dynamic Address Reconfiguration
1705 (ADD-IP) functionality specified in RFC5061. This extension provides
1706 the ability to dynamically add and remove new addresses for the SCTP
1707 associations.
1708
1709 1: Enable extension.
1710
1711 0: Disable extension.
1712
1713 Default: 0
1714
1715addip_noauth_enable - BOOLEAN
1716 Dynamic Address Reconfiguration (ADD-IP) requires the use of
1717 authentication to protect the operations of adding or removing new
1718 addresses. This requirement is mandated so that unauthorized hosts
1719 would not be able to hijack associations. However, older
1720 implementations may not have implemented this requirement while
1721 allowing the ADD-IP extension. For reasons of interoperability,
1722 we provide this variable to control the enforcement of the
1723 authentication requirement.
1724
1725 1: Allow ADD-IP extension to be used without authentication. This
1726 should only be set in a closed environment for interoperability
1727 with older implementations.
1728
1729 0: Enforce the authentication requirement
1730
1731 Default: 0
1732
1733auth_enable - BOOLEAN
1734 Enable or disable Authenticated Chunks extension. This extension
1735 provides the ability to send and receive authenticated chunks and is
1736 required for secure operation of Dynamic Address Reconfiguration
1737 (ADD-IP) extension.
1738
1739 1: Enable this extension.
1740 0: Disable this extension.
1741
1742 Default: 0
1743
1744prsctp_enable - BOOLEAN
1745 Enable or disable the Partial Reliability extension (RFC3758) which
1746 is used to notify peers that a given DATA should no longer be expected.
1747
1748 1: Enable extension
1749 0: Disable
1750
1751 Default: 1
1752
1753max_burst - INTEGER
1754 The limit of the number of new packets that can be initially sent. It
1755 controls how bursty the generated traffic can be.
1756
1757 Default: 4
1758
1759association_max_retrans - INTEGER
1760 Set the maximum number for retransmissions that an association can
1761 attempt deciding that the remote end is unreachable. If this value
1762 is exceeded, the association is terminated.
1763
1764 Default: 10
1765
1766max_init_retransmits - INTEGER
1767 The maximum number of retransmissions of INIT and COOKIE-ECHO chunks
1768 that an association will attempt before declaring the destination
1769 unreachable and terminating.
1770
1771 Default: 8
1772
1773path_max_retrans - INTEGER
1774 The maximum number of retransmissions that will be attempted on a given
1775 path. Once this threshold is exceeded, the path is considered
1776 unreachable, and new traffic will use a different path when the
1777 association is multihomed.
1778
1779 Default: 5
1780
Neil Horman5aa93bc2012-07-21 07:56:07 +00001781pf_retrans - INTEGER
1782 The number of retransmissions that will be attempted on a given path
1783 before traffic is redirected to an alternate transport (should one
1784 exist). Note this is distinct from path_max_retrans, as a path that
1785 passes the pf_retrans threshold can still be used. Its only
1786 deprioritized when a transmission path is selected by the stack. This
1787 setting is primarily used to enable fast failover mechanisms without
1788 having to reduce path_max_retrans to a very low value. See:
1789 http://www.ietf.org/id/draft-nishida-tsvwg-sctp-failover-05.txt
1790 for details. Note also that a value of pf_retrans > path_max_retrans
1791 disables this feature
1792
1793 Default: 0
1794
Vlad Yasevich32e8d492008-07-08 16:43:29 -07001795rto_initial - INTEGER
1796 The initial round trip timeout value in milliseconds that will be used
1797 in calculating round trip times. This is the initial time interval
1798 for retransmissions.
1799
1800 Default: 3000
1801
1802rto_max - INTEGER
1803 The maximum value (in milliseconds) of the round trip timeout. This
1804 is the largest time interval that can elapse between retransmissions.
1805
1806 Default: 60000
1807
1808rto_min - INTEGER
1809 The minimum value (in milliseconds) of the round trip timeout. This
1810 is the smallest time interval the can elapse between retransmissions.
1811
1812 Default: 1000
1813
1814hb_interval - INTEGER
1815 The interval (in milliseconds) between HEARTBEAT chunks. These chunks
1816 are sent at the specified interval on idle paths to probe the state of
1817 a given path between 2 associations.
1818
1819 Default: 30000
1820
1821sack_timeout - INTEGER
1822 The amount of time (in milliseconds) that the implementation will wait
1823 to send a SACK.
1824
1825 Default: 200
1826
1827valid_cookie_life - INTEGER
1828 The default lifetime of the SCTP cookie (in milliseconds). The cookie
1829 is used during association establishment.
1830
1831 Default: 60000
1832
1833cookie_preserve_enable - BOOLEAN
1834 Enable or disable the ability to extend the lifetime of the SCTP cookie
1835 that is used during the establishment phase of SCTP association
1836
1837 1: Enable cookie lifetime extension.
1838 0: Disable
1839
1840 Default: 1
1841
Neil Horman3c681982012-10-24 09:20:03 +00001842cookie_hmac_alg - STRING
1843 Select the hmac algorithm used when generating the cookie value sent by
1844 a listening sctp socket to a connecting client in the INIT-ACK chunk.
1845 Valid values are:
1846 * md5
1847 * sha1
1848 * none
1849 Ability to assign md5 or sha1 as the selected alg is predicated on the
stephen hemminger3b09adc2013-01-03 07:50:29 +00001850 configuration of those algorithms at build time (CONFIG_CRYPTO_MD5 and
Neil Horman3c681982012-10-24 09:20:03 +00001851 CONFIG_CRYPTO_SHA1).
1852
1853 Default: Dependent on configuration. MD5 if available, else SHA1 if
1854 available, else none.
1855
Vlad Yasevich32e8d492008-07-08 16:43:29 -07001856rcvbuf_policy - INTEGER
1857 Determines if the receive buffer is attributed to the socket or to
1858 association. SCTP supports the capability to create multiple
1859 associations on a single socket. When using this capability, it is
1860 possible that a single stalled association that's buffering a lot
1861 of data may block other associations from delivering their data by
1862 consuming all of the receive buffer space. To work around this,
1863 the rcvbuf_policy could be set to attribute the receiver buffer space
1864 to each association instead of the socket. This prevents the described
1865 blocking.
1866
1867 1: rcvbuf space is per association
stephen hemminger3b09adc2013-01-03 07:50:29 +00001868 0: rcvbuf space is per socket
Vlad Yasevich32e8d492008-07-08 16:43:29 -07001869
1870 Default: 0
1871
1872sndbuf_policy - INTEGER
1873 Similar to rcvbuf_policy above, this applies to send buffer space.
1874
1875 1: Send buffer is tracked per association
1876 0: Send buffer is tracked per socket.
1877
1878 Default: 0
1879
1880sctp_mem - vector of 3 INTEGERs: min, pressure, max
1881 Number of pages allowed for queueing by all SCTP sockets.
1882
1883 min: Below this number of pages SCTP is not bothered about its
1884 memory appetite. When amount of memory allocated by SCTP exceeds
1885 this number, SCTP starts to moderate memory usage.
1886
1887 pressure: This value was introduced to follow format of tcp_mem.
1888
1889 max: Number of pages allowed for queueing by all SCTP sockets.
1890
1891 Default is calculated at boot time from amount of available memory.
1892
1893sctp_rmem - vector of 3 INTEGERs: min, default, max
Max Matveeva6e12042011-06-19 22:08:10 +00001894 Only the first value ("min") is used, "default" and "max" are
1895 ignored.
1896
1897 min: Minimal size of receive buffer used by SCTP socket.
1898 It is guaranteed to each SCTP socket (but not association) even
1899 under moderate memory pressure.
1900
1901 Default: 1 page
Vlad Yasevich32e8d492008-07-08 16:43:29 -07001902
1903sctp_wmem - vector of 3 INTEGERs: min, default, max
Max Matveeva6e12042011-06-19 22:08:10 +00001904 Currently this tunable has no effect.
Vlad Yasevich32e8d492008-07-08 16:43:29 -07001905
Bhaskar Dutta72388432009-09-03 17:25:47 +05301906addr_scope_policy - INTEGER
1907 Control IPv4 address scoping - draft-stewart-tsvwg-sctp-ipv4-00
1908
1909 0 - Disable IPv4 address scoping
1910 1 - Enable IPv4 address scoping
1911 2 - Follow draft but allow IPv4 private addresses
1912 3 - Follow draft but allow IPv4 link local addresses
1913
1914 Default: 1
1915
Linus Torvalds1da177e2005-04-16 15:20:36 -07001916
Stephen Hemminger4edc2f32008-07-10 16:50:26 -07001917/proc/sys/net/core/*
Shan Weic60f6aa2012-04-26 16:52:52 +00001918 Please see: Documentation/sysctl/net.txt for descriptions of these entries.
Wang Tinggong705efc32009-05-14 22:49:36 +00001919
Linus Torvalds1da177e2005-04-16 15:20:36 -07001920
Stephen Hemminger4edc2f32008-07-10 16:50:26 -07001921/proc/sys/net/unix/*
Wang Tinggong705efc32009-05-14 22:49:36 +00001922max_dgram_qlen - INTEGER
1923 The maximum length of dgram socket receive queue
1924
1925 Default: 10
1926
1927
1928UNDOCUMENTED:
Stephen Hemminger4edc2f32008-07-10 16:50:26 -07001929
1930/proc/sys/net/irda/*
1931 fast_poll_increase FIXME
1932 warn_noreply_time FIXME
1933 discovery_slots FIXME
1934 slot_timeout FIXME
1935 max_baud_rate FIXME
1936 discovery_timeout FIXME
1937 lap_keepalive_time FIXME
1938 max_noreply_time FIXME
1939 max_tx_data_size FIXME
1940 max_tx_window FIXME
1941 min_tx_turn_time FIXME