Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /proc/sys/net/ipv4/* Variables: |
2 | ||
3 | ip_forward - BOOLEAN | |
4 | 0 - disabled (default) | |
5 | not 0 - enabled | |
6 | ||
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 | ||
13 | ip_default_ttl - INTEGER | |
14 | default 64 | |
15 | ||
16 | ip_no_pmtu_disc - BOOLEAN | |
17 | Disable Path MTU Discovery. | |
18 | default FALSE | |
19 | ||
20 | min_pmtu - INTEGER | |
21 | default 562 - minimum discovered Path MTU | |
22 | ||
23 | mtu_expires - INTEGER | |
24 | Time, in seconds, that cached PMTU information is kept. | |
25 | ||
26 | min_adv_mss - INTEGER | |
27 | The advertised MSS depends on the first hop route MTU, but will | |
28 | never be lower than this setting. | |
29 | ||
30 | IP Fragmentation: | |
31 | ||
32 | ipfrag_high_thresh - INTEGER | |
33 | Maximum memory used to reassemble IP fragments. When | |
34 | ipfrag_high_thresh bytes of memory is allocated for this purpose, | |
35 | the fragment handler will toss packets until ipfrag_low_thresh | |
36 | is reached. | |
37 | ||
38 | ipfrag_low_thresh - INTEGER | |
39 | See ipfrag_high_thresh | |
40 | ||
41 | ipfrag_time - INTEGER | |
42 | Time in seconds to keep an IP fragment in memory. | |
43 | ||
44 | ipfrag_secret_interval - INTEGER | |
45 | Regeneration interval (in seconds) of the hash secret (or lifetime | |
46 | for the hash secret) for IP fragments. | |
47 | Default: 600 | |
48 | ||
89cee8b1 HX |
49 | ipfrag_max_dist - INTEGER |
50 | ipfrag_max_dist is a non-negative integer value which defines the | |
51 | maximum "disorder" which is allowed among fragments which share a | |
52 | common IP source address. Note that reordering of packets is | |
53 | not unusual, but if a large number of fragments arrive from a source | |
54 | IP address while a particular fragment queue remains incomplete, it | |
55 | probably indicates that one or more fragments belonging to that queue | |
56 | have been lost. When ipfrag_max_dist is positive, an additional check | |
57 | is done on fragments before they are added to a reassembly queue - if | |
58 | ipfrag_max_dist (or more) fragments have arrived from a particular IP | |
59 | address between additions to any IP fragment queue using that source | |
60 | address, it's presumed that one or more fragments in the queue are | |
61 | lost. The existing fragment queue will be dropped, and a new one | |
62 | started. An ipfrag_max_dist value of zero disables this check. | |
63 | ||
64 | Using a very small value, e.g. 1 or 2, for ipfrag_max_dist can | |
65 | result in unnecessarily dropping fragment queues when normal | |
66 | reordering of packets occurs, which could lead to poor application | |
67 | performance. Using a very large value, e.g. 50000, increases the | |
68 | likelihood of incorrectly reassembling IP fragments that originate | |
69 | from different IP datagrams, which could result in data corruption. | |
70 | Default: 64 | |
71 | ||
1da177e4 LT |
72 | INET peer storage: |
73 | ||
74 | inet_peer_threshold - INTEGER | |
75 | The approximate size of the storage. Starting from this threshold | |
76 | entries will be thrown aggressively. This threshold also determines | |
77 | entries' time-to-live and time intervals between garbage collection | |
78 | passes. More entries, less time-to-live, less GC interval. | |
79 | ||
80 | inet_peer_minttl - INTEGER | |
81 | Minimum time-to-live of entries. Should be enough to cover fragment | |
82 | time-to-live on the reassembling side. This minimum time-to-live is | |
83 | guaranteed if the pool size is less than inet_peer_threshold. | |
84 | Measured in jiffies(1). | |
85 | ||
86 | inet_peer_maxttl - INTEGER | |
87 | Maximum time-to-live of entries. Unused entries will expire after | |
88 | this period of time if there is no memory pressure on the pool (i.e. | |
89 | when the number of entries in the pool is very small). | |
90 | Measured in jiffies(1). | |
91 | ||
92 | inet_peer_gc_mintime - INTEGER | |
93 | Minimum interval between garbage collection passes. This interval is | |
94 | in effect under high memory pressure on the pool. | |
95 | Measured in jiffies(1). | |
96 | ||
97 | inet_peer_gc_maxtime - INTEGER | |
98 | Minimum interval between garbage collection passes. This interval is | |
99 | in effect under low (or absent) memory pressure on the pool. | |
100 | Measured in jiffies(1). | |
101 | ||
102 | TCP variables: | |
103 | ||
ef56e622 SH |
104 | somaxconn - INTEGER |
105 | Limit of socket listen() backlog, known in userspace as SOMAXCONN. | |
106 | Defaults to 128. See also tcp_max_syn_backlog for additional tuning | |
107 | for TCP sockets. | |
108 | ||
9772efb9 | 109 | tcp_abc - INTEGER |
b3a8a40d SH |
110 | Controls Appropriate Byte Count (ABC) defined in RFC3465. |
111 | ABC is a way of increasing congestion window (cwnd) more slowly | |
112 | in response to partial acknowledgments. | |
113 | Possible values are: | |
114 | 0 increase cwnd once per acknowledgment (no ABC) | |
115 | 1 increase cwnd once per acknowledgment of full sized segment | |
116 | 2 allow increase cwnd by two if acknowledgment is | |
117 | of two segments to compensate for delayed acknowledgments. | |
118 | Default: 0 (off) | |
9772efb9 | 119 | |
ef56e622 SH |
120 | tcp_abort_on_overflow - BOOLEAN |
121 | If listening service is too slow to accept new connections, | |
122 | reset them. Default state is FALSE. It means that if overflow | |
123 | occurred due to a burst, connection will recover. Enable this | |
124 | option _only_ if you are really sure that listening daemon | |
125 | cannot be tuned to accept connections faster. Enabling this | |
126 | option can harm clients of your server. | |
1da177e4 | 127 | |
ef56e622 SH |
128 | tcp_adv_win_scale - INTEGER |
129 | Count buffering overhead as bytes/2^tcp_adv_win_scale | |
130 | (if tcp_adv_win_scale > 0) or bytes-bytes/2^(-tcp_adv_win_scale), | |
131 | if it is <= 0. | |
132 | Default: 2 | |
1da177e4 | 133 | |
ef56e622 SH |
134 | tcp_allowed_congestion_control - STRING |
135 | Show/set the congestion control choices available to non-privileged | |
136 | processes. The list is a subset of those listed in | |
137 | tcp_available_congestion_control. | |
138 | Default is "reno" and the default setting (tcp_congestion_control). | |
1da177e4 | 139 | |
ef56e622 SH |
140 | tcp_app_win - INTEGER |
141 | Reserve max(window/2^tcp_app_win, mss) of window for application | |
142 | buffer. Value 0 is special, it means that nothing is reserved. | |
143 | Default: 31 | |
1da177e4 | 144 | |
ef56e622 SH |
145 | tcp_available_congestion_control - STRING |
146 | Shows the available congestion control choices that are registered. | |
147 | More congestion control algorithms may be available as modules, | |
148 | but not loaded. | |
1da177e4 | 149 | |
71599cd1 JH |
150 | tcp_base_mss - INTEGER |
151 | The initial value of search_low to be used by Packetization Layer | |
152 | Path MTU Discovery (MTU probing). If MTU probing is enabled, | |
153 | this is the inital MSS used by the connection. | |
154 | ||
ef56e622 SH |
155 | tcp_congestion_control - STRING |
156 | Set the congestion control algorithm to be used for new | |
157 | connections. The algorithm "reno" is always available, but | |
158 | additional choices may be available based on kernel configuration. | |
159 | Default is set as part of kernel configuration. | |
1da177e4 | 160 | |
ef56e622 SH |
161 | tcp_dsack - BOOLEAN |
162 | Allows TCP to send "duplicate" SACKs. | |
1da177e4 | 163 | |
ef56e622 SH |
164 | tcp_ecn - BOOLEAN |
165 | Enable Explicit Congestion Notification in TCP. | |
166 | ||
167 | tcp_fack - BOOLEAN | |
168 | Enable FACK congestion avoidance and fast retransmission. | |
169 | The value is not used, if tcp_sack is not enabled. | |
1da177e4 LT |
170 | |
171 | tcp_fin_timeout - INTEGER | |
172 | Time to hold socket in state FIN-WAIT-2, if it was closed | |
173 | by our side. Peer can be broken and never close its side, | |
174 | or even died unexpectedly. Default value is 60sec. | |
175 | Usual value used in 2.2 was 180 seconds, you may restore | |
176 | it, but remember that if your machine is even underloaded WEB server, | |
177 | you risk to overflow memory with kilotons of dead sockets, | |
178 | FIN-WAIT-2 sockets are less dangerous than FIN-WAIT-1, | |
179 | because they eat maximum 1.5K of memory, but they tend | |
180 | to live longer. Cf. tcp_max_orphans. | |
181 | ||
ef56e622 SH |
182 | tcp_frto - BOOLEAN |
183 | Enables F-RTO, an enhanced recovery algorithm for TCP retransmission | |
184 | timeouts. It is particularly beneficial in wireless environments | |
185 | where packet loss is typically due to random radio interference | |
186 | rather than intermediate router congestion. | |
1da177e4 | 187 | |
ef56e622 SH |
188 | tcp_keepalive_time - INTEGER |
189 | How often TCP sends out keepalive messages when keepalive is enabled. | |
190 | Default: 2hours. | |
1da177e4 | 191 | |
ef56e622 SH |
192 | tcp_keepalive_probes - INTEGER |
193 | How many keepalive probes TCP sends out, until it decides that the | |
194 | connection is broken. Default value: 9. | |
195 | ||
196 | tcp_keepalive_intvl - INTEGER | |
197 | How frequently the probes are send out. Multiplied by | |
198 | tcp_keepalive_probes it is time to kill not responding connection, | |
199 | after probes started. Default value: 75sec i.e. connection | |
200 | will be aborted after ~11 minutes of retries. | |
201 | ||
202 | tcp_low_latency - BOOLEAN | |
203 | If set, the TCP stack makes decisions that prefer lower | |
204 | latency as opposed to higher throughput. By default, this | |
205 | option is not set meaning that higher throughput is preferred. | |
206 | An example of an application where this default should be | |
207 | changed would be a Beowulf compute cluster. | |
208 | Default: 0 | |
1da177e4 LT |
209 | |
210 | tcp_max_orphans - INTEGER | |
211 | Maximal number of TCP sockets not attached to any user file handle, | |
212 | held by system. If this number is exceeded orphaned connections are | |
213 | reset immediately and warning is printed. This limit exists | |
214 | only to prevent simple DoS attacks, you _must_ not rely on this | |
215 | or lower the limit artificially, but rather increase it | |
216 | (probably, after increasing installed memory), | |
217 | if network conditions require more than default value, | |
218 | and tune network services to linger and kill such states | |
219 | more aggressively. Let me to remind again: each orphan eats | |
220 | up to ~64K of unswappable memory. | |
221 | ||
1da177e4 LT |
222 | tcp_max_syn_backlog - INTEGER |
223 | Maximal number of remembered connection requests, which are | |
224 | still did not receive an acknowledgment from connecting client. | |
225 | Default value is 1024 for systems with more than 128Mb of memory, | |
226 | and 128 for low memory machines. If server suffers of overload, | |
227 | try to increase this number. | |
228 | ||
ef56e622 SH |
229 | tcp_max_tw_buckets - INTEGER |
230 | Maximal number of timewait sockets held by system simultaneously. | |
231 | If this number is exceeded time-wait socket is immediately destroyed | |
232 | and warning is printed. This limit exists only to prevent | |
233 | simple DoS attacks, you _must_ not lower the limit artificially, | |
234 | but rather increase it (probably, after increasing installed memory), | |
235 | if network conditions require more than default value. | |
1da177e4 | 236 | |
ef56e622 SH |
237 | tcp_mem - vector of 3 INTEGERs: min, pressure, max |
238 | min: below this number of pages TCP is not bothered about its | |
239 | memory appetite. | |
1da177e4 | 240 | |
ef56e622 SH |
241 | pressure: when amount of memory allocated by TCP exceeds this number |
242 | of pages, TCP moderates its memory consumption and enters memory | |
243 | pressure mode, which is exited when memory consumption falls | |
244 | under "min". | |
1da177e4 | 245 | |
ef56e622 | 246 | max: number of pages allowed for queueing by all TCP sockets. |
1da177e4 | 247 | |
ef56e622 SH |
248 | Defaults are calculated at boot time from amount of available |
249 | memory. | |
1da177e4 | 250 | |
71599cd1 JH |
251 | tcp_moderate_rcvbuf - BOOLEAN |
252 | If set, TCP performs receive buffer autotuning, attempting to | |
253 | automatically size the buffer (no greater than tcp_rmem[2]) to | |
254 | match the size required by the path for full throughput. Enabled by | |
255 | default. | |
256 | ||
257 | tcp_mtu_probing - INTEGER | |
258 | Controls TCP Packetization-Layer Path MTU Discovery. Takes three | |
259 | values: | |
260 | 0 - Disabled | |
261 | 1 - Disabled by default, enabled when an ICMP black hole detected | |
262 | 2 - Always enabled, use initial MSS of tcp_base_mss. | |
263 | ||
264 | tcp_no_metrics_save - BOOLEAN | |
265 | By default, TCP saves various connection metrics in the route cache | |
266 | when the connection closes, so that connections established in the | |
267 | near future can use these to set initial conditions. Usually, this | |
268 | increases overall performance, but may sometimes cause performance | |
269 | degredation. If set, TCP will not cache metrics on closing | |
270 | connections. | |
271 | ||
ef56e622 SH |
272 | tcp_orphan_retries - INTEGER |
273 | How may times to retry before killing TCP connection, closed | |
274 | by our side. Default value 7 corresponds to ~50sec-16min | |
275 | depending on RTO. If you machine is loaded WEB server, | |
276 | you should think about lowering this value, such sockets | |
277 | may consume significant resources. Cf. tcp_max_orphans. | |
1da177e4 LT |
278 | |
279 | tcp_reordering - INTEGER | |
280 | Maximal reordering of packets in a TCP stream. | |
281 | Default: 3 | |
282 | ||
283 | tcp_retrans_collapse - BOOLEAN | |
284 | Bug-to-bug compatibility with some broken printers. | |
285 | On retransmit try to send bigger packets to work around bugs in | |
286 | certain TCP stacks. | |
287 | ||
ef56e622 SH |
288 | tcp_retries1 - INTEGER |
289 | How many times to retry before deciding that something is wrong | |
290 | and it is necessary to report this suspicion to network layer. | |
291 | Minimal RFC value is 3, it is default, which corresponds | |
292 | to ~3sec-8min depending on RTO. | |
1da177e4 | 293 | |
ef56e622 SH |
294 | tcp_retries2 - INTEGER |
295 | How may times to retry before killing alive TCP connection. | |
296 | RFC1122 says that the limit should be longer than 100 sec. | |
297 | It is too small number. Default value 15 corresponds to ~13-30min | |
298 | depending on RTO. | |
1da177e4 | 299 | |
ef56e622 SH |
300 | tcp_rfc1337 - BOOLEAN |
301 | If set, the TCP stack behaves conforming to RFC1337. If unset, | |
302 | we are not conforming to RFC, but prevent TCP TIME_WAIT | |
303 | assassination. | |
304 | Default: 0 | |
1da177e4 LT |
305 | |
306 | tcp_rmem - vector of 3 INTEGERs: min, default, max | |
307 | min: Minimal size of receive buffer used by TCP sockets. | |
308 | It is guaranteed to each TCP socket, even under moderate memory | |
309 | pressure. | |
310 | Default: 8K | |
311 | ||
312 | default: default size of receive buffer used by TCP sockets. | |
313 | This value overrides net.core.rmem_default used by other protocols. | |
314 | Default: 87380 bytes. This value results in window of 65535 with | |
315 | default setting of tcp_adv_win_scale and tcp_app_win:0 and a bit | |
316 | less for default tcp_app_win. See below about these variables. | |
317 | ||
318 | max: maximal size of receive buffer allowed for automatically | |
319 | selected receiver buffers for TCP socket. This value does not override | |
320 | net.core.rmem_max, "static" selection via SO_RCVBUF does not use this. | |
321 | Default: 87380*2 bytes. | |
322 | ||
ef56e622 SH |
323 | tcp_sack - BOOLEAN |
324 | Enable select acknowledgments (SACKS). | |
1da177e4 | 325 | |
ef56e622 SH |
326 | tcp_slow_start_after_idle - BOOLEAN |
327 | If set, provide RFC2861 behavior and time out the congestion | |
328 | window after an idle period. An idle period is defined at | |
329 | the current RTO. If unset, the congestion window will not | |
330 | be timed out after an idle period. | |
331 | Default: 1 | |
1da177e4 | 332 | |
ef56e622 SH |
333 | tcp_stdurg - BOOLEAN |
334 | Use the Host requirements interpretation of the TCP urg pointer field. | |
335 | Most hosts use the older BSD interpretation, so if you turn this on | |
336 | Linux might not communicate correctly with them. | |
337 | Default: FALSE | |
1da177e4 | 338 | |
ef56e622 SH |
339 | tcp_synack_retries - INTEGER |
340 | Number of times SYNACKs for a passive TCP connection attempt will | |
341 | be retransmitted. Should not be higher than 255. Default value | |
342 | is 5, which corresponds to ~180seconds. | |
1da177e4 | 343 | |
ef56e622 SH |
344 | tcp_syncookies - BOOLEAN |
345 | Only valid when the kernel was compiled with CONFIG_SYNCOOKIES | |
346 | Send out syncookies when the syn backlog queue of a socket | |
347 | overflows. This is to prevent against the common 'syn flood attack' | |
348 | Default: FALSE | |
1da177e4 | 349 | |
ef56e622 SH |
350 | Note, that syncookies is fallback facility. |
351 | It MUST NOT be used to help highly loaded servers to stand | |
352 | against legal connection rate. If you see synflood warnings | |
353 | in your logs, but investigation shows that they occur | |
354 | because of overload with legal connections, you should tune | |
355 | another parameters until this warning disappear. | |
356 | See: tcp_max_syn_backlog, tcp_synack_retries, tcp_abort_on_overflow. | |
1da177e4 | 357 | |
ef56e622 SH |
358 | syncookies seriously violate TCP protocol, do not allow |
359 | to use TCP extensions, can result in serious degradation | |
360 | of some services (f.e. SMTP relaying), visible not by you, | |
361 | but your clients and relays, contacting you. While you see | |
362 | synflood warnings in logs not being really flooded, your server | |
363 | is seriously misconfigured. | |
1da177e4 | 364 | |
ef56e622 SH |
365 | tcp_syn_retries - INTEGER |
366 | Number of times initial SYNs for an active TCP connection attempt | |
367 | will be retransmitted. Should not be higher than 255. Default value | |
368 | is 5, which corresponds to ~180seconds. | |
369 | ||
370 | tcp_timestamps - BOOLEAN | |
371 | Enable timestamps as defined in RFC1323. | |
1da177e4 | 372 | |
1da177e4 | 373 | tcp_tso_win_divisor - INTEGER |
ef56e622 SH |
374 | This allows control over what percentage of the congestion window |
375 | can be consumed by a single TSO frame. | |
376 | The setting of this parameter is a choice between burstiness and | |
377 | building larger TSO frames. | |
378 | Default: 3 | |
1da177e4 | 379 | |
ef56e622 SH |
380 | tcp_tw_recycle - BOOLEAN |
381 | Enable fast recycling TIME-WAIT sockets. Default value is 0. | |
382 | It should not be changed without advice/request of technical | |
383 | experts. | |
1da177e4 | 384 | |
ef56e622 SH |
385 | tcp_tw_reuse - BOOLEAN |
386 | Allow to reuse TIME-WAIT sockets for new connections when it is | |
387 | safe from protocol viewpoint. Default value is 0. | |
388 | It should not be changed without advice/request of technical | |
389 | experts. | |
ce7bc3bf | 390 | |
ef56e622 SH |
391 | tcp_window_scaling - BOOLEAN |
392 | Enable window scaling as defined in RFC1323. | |
3ff825b2 | 393 | |
ef56e622 SH |
394 | tcp_wmem - vector of 3 INTEGERs: min, default, max |
395 | min: Amount of memory reserved for send buffers for TCP socket. | |
396 | Each TCP socket has rights to use it due to fact of its birth. | |
397 | Default: 4K | |
9d7bcfc6 | 398 | |
ef56e622 SH |
399 | default: Amount of memory allowed for send buffers for TCP socket |
400 | by default. This value overrides net.core.wmem_default used | |
401 | by other protocols, it is usually lower than net.core.wmem_default. | |
402 | Default: 16K | |
403 | ||
404 | max: Maximal amount of memory allowed for automatically selected | |
405 | send buffers for TCP socket. This value does not override | |
406 | net.core.wmem_max, "static" selection via SO_SNDBUF does not use this. | |
407 | Default: 128K | |
1da177e4 | 408 | |
15d99e02 RJ |
409 | tcp_workaround_signed_windows - BOOLEAN |
410 | If set, assume no receipt of a window scaling option means the | |
411 | remote TCP is broken and treats the window as a signed quantity. | |
412 | If unset, assume the remote TCP is not broken even if we do | |
413 | not receive a window scaling option from them. | |
414 | Default: 0 | |
415 | ||
8802f616 PM |
416 | CIPSOv4 Variables: |
417 | ||
418 | cipso_cache_enable - BOOLEAN | |
419 | If set, enable additions to and lookups from the CIPSO label mapping | |
420 | cache. If unset, additions are ignored and lookups always result in a | |
421 | miss. However, regardless of the setting the cache is still | |
422 | invalidated when required when means you can safely toggle this on and | |
423 | off and the cache will always be "safe". | |
424 | Default: 1 | |
425 | ||
426 | cipso_cache_bucket_size - INTEGER | |
427 | The CIPSO label cache consists of a fixed size hash table with each | |
428 | hash bucket containing a number of cache entries. This variable limits | |
429 | the number of entries in each hash bucket; the larger the value the | |
430 | more CIPSO label mappings that can be cached. When the number of | |
431 | entries in a given hash bucket reaches this limit adding new entries | |
432 | causes the oldest entry in the bucket to be removed to make room. | |
433 | Default: 10 | |
434 | ||
435 | cipso_rbm_optfmt - BOOLEAN | |
436 | Enable the "Optimized Tag 1 Format" as defined in section 3.4.2.6 of | |
437 | the CIPSO draft specification (see Documentation/netlabel for details). | |
438 | This means that when set the CIPSO tag will be padded with empty | |
439 | categories in order to make the packet data 32-bit aligned. | |
440 | Default: 0 | |
441 | ||
442 | cipso_rbm_structvalid - BOOLEAN | |
443 | If set, do a very strict check of the CIPSO option when | |
444 | ip_options_compile() is called. If unset, relax the checks done during | |
445 | ip_options_compile(). Either way is "safe" as errors are caught else | |
446 | where in the CIPSO processing code but setting this to 0 (False) should | |
447 | result in less work (i.e. it should be faster) but could cause problems | |
448 | with other implementations that require strict checking. | |
449 | Default: 0 | |
450 | ||
1da177e4 LT |
451 | IP Variables: |
452 | ||
453 | ip_local_port_range - 2 INTEGERS | |
454 | Defines the local port range that is used by TCP and UDP to | |
455 | choose the local port. The first number is the first, the | |
456 | second the last local port number. Default value depends on | |
457 | amount of memory available on the system: | |
458 | > 128Mb 32768-61000 | |
459 | < 128Mb 1024-4999 or even less. | |
460 | This number defines number of active connections, which this | |
461 | system can issue simultaneously to systems not supporting | |
462 | TCP extensions (timestamps). With tcp_tw_recycle enabled | |
463 | (i.e. by default) range 1024-4999 is enough to issue up to | |
464 | 2000 connections per second to systems supporting timestamps. | |
465 | ||
466 | ip_nonlocal_bind - BOOLEAN | |
467 | If set, allows processes to bind() to non-local IP addresses, | |
468 | which can be quite useful - but may break some applications. | |
469 | Default: 0 | |
470 | ||
471 | ip_dynaddr - BOOLEAN | |
472 | If set non-zero, enables support for dynamic addresses. | |
473 | If set to a non-zero value larger than 1, a kernel log | |
474 | message will be printed when dynamic address rewriting | |
475 | occurs. | |
476 | Default: 0 | |
477 | ||
478 | icmp_echo_ignore_all - BOOLEAN | |
7ce31246 DM |
479 | If set non-zero, then the kernel will ignore all ICMP ECHO |
480 | requests sent to it. | |
481 | Default: 0 | |
482 | ||
1da177e4 | 483 | icmp_echo_ignore_broadcasts - BOOLEAN |
7ce31246 DM |
484 | If set non-zero, then the kernel will ignore all ICMP ECHO and |
485 | TIMESTAMP requests sent to it via broadcast/multicast. | |
486 | Default: 1 | |
1da177e4 LT |
487 | |
488 | icmp_ratelimit - INTEGER | |
489 | Limit the maximal rates for sending ICMP packets whose type matches | |
490 | icmp_ratemask (see below) to specific targets. | |
491 | 0 to disable any limiting, otherwise the maximal rate in jiffies(1) | |
492 | Default: 100 | |
493 | ||
494 | icmp_ratemask - INTEGER | |
495 | Mask made of ICMP types for which rates are being limited. | |
496 | Significant bits: IHGFEDCBA9876543210 | |
497 | Default mask: 0000001100000011000 (6168) | |
498 | ||
499 | Bit definitions (see include/linux/icmp.h): | |
500 | 0 Echo Reply | |
501 | 3 Destination Unreachable * | |
502 | 4 Source Quench * | |
503 | 5 Redirect | |
504 | 8 Echo Request | |
505 | B Time Exceeded * | |
506 | C Parameter Problem * | |
507 | D Timestamp Request | |
508 | E Timestamp Reply | |
509 | F Info Request | |
510 | G Info Reply | |
511 | H Address Mask Request | |
512 | I Address Mask Reply | |
513 | ||
514 | * These are rate limited by default (see default mask above) | |
515 | ||
516 | icmp_ignore_bogus_error_responses - BOOLEAN | |
517 | Some routers violate RFC1122 by sending bogus responses to broadcast | |
518 | frames. Such violations are normally logged via a kernel warning. | |
519 | If this is set to TRUE, the kernel will not give such warnings, which | |
520 | will avoid log file clutter. | |
521 | Default: FALSE | |
522 | ||
95f7daf1 H |
523 | icmp_errors_use_inbound_ifaddr - BOOLEAN |
524 | ||
525 | If zero, icmp error messages are sent with the primary address of | |
526 | the exiting interface. | |
527 | ||
528 | If non-zero, the message will be sent with the primary address of | |
529 | the interface that received the packet that caused the icmp error. | |
530 | This is the behaviour network many administrators will expect from | |
531 | a router. And it can make debugging complicated network layouts | |
532 | much easier. | |
533 | ||
534 | Note that if no primary address exists for the interface selected, | |
535 | then the primary address of the first non-loopback interface that | |
d6bc8ac9 | 536 | has one will be used regardless of this setting. |
95f7daf1 H |
537 | |
538 | Default: 0 | |
539 | ||
1da177e4 LT |
540 | igmp_max_memberships - INTEGER |
541 | Change the maximum number of multicast groups we can subscribe to. | |
542 | Default: 20 | |
543 | ||
544 | conf/interface/* changes special settings per interface (where "interface" is | |
545 | the name of your network interface) | |
546 | conf/all/* is special, changes the settings for all interfaces | |
547 | ||
548 | ||
549 | log_martians - BOOLEAN | |
550 | Log packets with impossible addresses to kernel log. | |
551 | log_martians for the interface will be enabled if at least one of | |
552 | conf/{all,interface}/log_martians is set to TRUE, | |
553 | it will be disabled otherwise | |
554 | ||
555 | accept_redirects - BOOLEAN | |
556 | Accept ICMP redirect messages. | |
557 | accept_redirects for the interface will be enabled if: | |
558 | - both conf/{all,interface}/accept_redirects are TRUE in the case forwarding | |
559 | for the interface is enabled | |
560 | or | |
561 | - at least one of conf/{all,interface}/accept_redirects is TRUE in the case | |
562 | forwarding for the interface is disabled | |
563 | accept_redirects for the interface will be disabled otherwise | |
564 | default TRUE (host) | |
565 | FALSE (router) | |
566 | ||
567 | forwarding - BOOLEAN | |
568 | Enable IP forwarding on this interface. | |
569 | ||
570 | mc_forwarding - BOOLEAN | |
571 | Do multicast routing. The kernel needs to be compiled with CONFIG_MROUTE | |
572 | and a multicast routing daemon is required. | |
573 | conf/all/mc_forwarding must also be set to TRUE to enable multicast routing | |
574 | for the interface | |
575 | ||
576 | medium_id - INTEGER | |
577 | Integer value used to differentiate the devices by the medium they | |
578 | are attached to. Two devices can have different id values when | |
579 | the broadcast packets are received only on one of them. | |
580 | The default value 0 means that the device is the only interface | |
581 | to its medium, value of -1 means that medium is not known. | |
582 | ||
583 | Currently, it is used to change the proxy_arp behavior: | |
584 | the proxy_arp feature is enabled for packets forwarded between | |
585 | two devices attached to different media. | |
586 | ||
587 | proxy_arp - BOOLEAN | |
588 | Do proxy arp. | |
589 | proxy_arp for the interface will be enabled if at least one of | |
590 | conf/{all,interface}/proxy_arp is set to TRUE, | |
591 | it will be disabled otherwise | |
592 | ||
593 | shared_media - BOOLEAN | |
594 | Send(router) or accept(host) RFC1620 shared media redirects. | |
595 | Overrides ip_secure_redirects. | |
596 | shared_media for the interface will be enabled if at least one of | |
597 | conf/{all,interface}/shared_media is set to TRUE, | |
598 | it will be disabled otherwise | |
599 | default TRUE | |
600 | ||
601 | secure_redirects - BOOLEAN | |
602 | Accept ICMP redirect messages only for gateways, | |
603 | listed in default gateway list. | |
604 | secure_redirects for the interface will be enabled if at least one of | |
605 | conf/{all,interface}/secure_redirects is set to TRUE, | |
606 | it will be disabled otherwise | |
607 | default TRUE | |
608 | ||
609 | send_redirects - BOOLEAN | |
610 | Send redirects, if router. | |
611 | send_redirects for the interface will be enabled if at least one of | |
612 | conf/{all,interface}/send_redirects is set to TRUE, | |
613 | it will be disabled otherwise | |
614 | Default: TRUE | |
615 | ||
616 | bootp_relay - BOOLEAN | |
617 | Accept packets with source address 0.b.c.d destined | |
618 | not to this host as local ones. It is supposed, that | |
619 | BOOTP relay daemon will catch and forward such packets. | |
620 | conf/all/bootp_relay must also be set to TRUE to enable BOOTP relay | |
621 | for the interface | |
622 | default FALSE | |
623 | Not Implemented Yet. | |
624 | ||
625 | accept_source_route - BOOLEAN | |
626 | Accept packets with SRR option. | |
627 | conf/all/accept_source_route must also be set to TRUE to accept packets | |
628 | with SRR option on the interface | |
629 | default TRUE (router) | |
630 | FALSE (host) | |
631 | ||
632 | rp_filter - BOOLEAN | |
633 | 1 - do source validation by reversed path, as specified in RFC1812 | |
634 | Recommended option for single homed hosts and stub network | |
635 | routers. Could cause troubles for complicated (not loop free) | |
636 | networks running a slow unreliable protocol (sort of RIP), | |
637 | or using static routes. | |
638 | ||
639 | 0 - No source validation. | |
640 | ||
641 | conf/all/rp_filter must also be set to TRUE to do source validation | |
642 | on the interface | |
643 | ||
644 | Default value is 0. Note that some distributions enable it | |
645 | in startup scripts. | |
646 | ||
647 | arp_filter - BOOLEAN | |
648 | 1 - Allows you to have multiple network interfaces on the same | |
649 | subnet, and have the ARPs for each interface be answered | |
650 | based on whether or not the kernel would route a packet from | |
651 | the ARP'd IP out that interface (therefore you must use source | |
652 | based routing for this to work). In other words it allows control | |
653 | of which cards (usually 1) will respond to an arp request. | |
654 | ||
655 | 0 - (default) The kernel can respond to arp requests with addresses | |
656 | from other interfaces. This may seem wrong but it usually makes | |
657 | sense, because it increases the chance of successful communication. | |
658 | IP addresses are owned by the complete host on Linux, not by | |
659 | particular interfaces. Only for more complex setups like load- | |
660 | balancing, does this behaviour cause problems. | |
661 | ||
662 | arp_filter for the interface will be enabled if at least one of | |
663 | conf/{all,interface}/arp_filter is set to TRUE, | |
664 | it will be disabled otherwise | |
665 | ||
666 | arp_announce - INTEGER | |
667 | Define different restriction levels for announcing the local | |
668 | source IP address from IP packets in ARP requests sent on | |
669 | interface: | |
670 | 0 - (default) Use any local address, configured on any interface | |
671 | 1 - Try to avoid local addresses that are not in the target's | |
672 | subnet for this interface. This mode is useful when target | |
673 | hosts reachable via this interface require the source IP | |
674 | address in ARP requests to be part of their logical network | |
675 | configured on the receiving interface. When we generate the | |
676 | request we will check all our subnets that include the | |
677 | target IP and will preserve the source address if it is from | |
678 | such subnet. If there is no such subnet we select source | |
679 | address according to the rules for level 2. | |
680 | 2 - Always use the best local address for this target. | |
681 | In this mode we ignore the source address in the IP packet | |
682 | and try to select local address that we prefer for talks with | |
683 | the target host. Such local address is selected by looking | |
684 | for primary IP addresses on all our subnets on the outgoing | |
685 | interface that include the target IP address. If no suitable | |
686 | local address is found we select the first local address | |
687 | we have on the outgoing interface or on all other interfaces, | |
688 | with the hope we will receive reply for our request and | |
689 | even sometimes no matter the source IP address we announce. | |
690 | ||
691 | The max value from conf/{all,interface}/arp_announce is used. | |
692 | ||
693 | Increasing the restriction level gives more chance for | |
694 | receiving answer from the resolved target while decreasing | |
695 | the level announces more valid sender's information. | |
696 | ||
697 | arp_ignore - INTEGER | |
698 | Define different modes for sending replies in response to | |
699 | received ARP requests that resolve local target IP addresses: | |
700 | 0 - (default): reply for any local target IP address, configured | |
701 | on any interface | |
702 | 1 - reply only if the target IP address is local address | |
703 | configured on the incoming interface | |
704 | 2 - reply only if the target IP address is local address | |
705 | configured on the incoming interface and both with the | |
706 | sender's IP address are part from same subnet on this interface | |
707 | 3 - do not reply for local addresses configured with scope host, | |
708 | only resolutions for global and link addresses are replied | |
709 | 4-7 - reserved | |
710 | 8 - do not reply for all local addresses | |
711 | ||
712 | The max value from conf/{all,interface}/arp_ignore is used | |
713 | when ARP request is received on the {interface} | |
714 | ||
c1b1bce8 NH |
715 | arp_accept - BOOLEAN |
716 | Define behavior when gratuitous arp replies are received: | |
717 | 0 - drop gratuitous arp frames | |
718 | 1 - accept gratuitous arp frames | |
719 | ||
1da177e4 LT |
720 | app_solicit - INTEGER |
721 | The maximum number of probes to send to the user space ARP daemon | |
722 | via netlink before dropping back to multicast probes (see | |
723 | mcast_solicit). Defaults to 0. | |
724 | ||
725 | disable_policy - BOOLEAN | |
726 | Disable IPSEC policy (SPD) for this interface | |
727 | ||
728 | disable_xfrm - BOOLEAN | |
729 | Disable IPSEC encryption on this interface, whatever the policy | |
730 | ||
731 | ||
732 | ||
733 | tag - INTEGER | |
734 | Allows you to write a number, which can be used as required. | |
735 | Default value is 0. | |
736 | ||
737 | (1) Jiffie: internal timeunit for the kernel. On the i386 1/100s, on the | |
738 | Alpha 1/1024s. See the HZ define in /usr/include/asm/param.h for the exact | |
739 | value on your system. | |
740 | ||
741 | Alexey Kuznetsov. | |
742 | kuznet@ms2.inr.ac.ru | |
743 | ||
744 | Updated by: | |
745 | Andi Kleen | |
746 | ak@muc.de | |
747 | Nicolas Delon | |
748 | delon.nicolas@wanadoo.fr | |
749 | ||
750 | ||
751 | ||
752 | ||
753 | /proc/sys/net/ipv6/* Variables: | |
754 | ||
755 | IPv6 has no global variables such as tcp_*. tcp_* settings under ipv4/ also | |
756 | apply to IPv6 [XXX?]. | |
757 | ||
758 | bindv6only - BOOLEAN | |
759 | Default value for IPV6_V6ONLY socket option, | |
760 | which restricts use of the IPv6 socket to IPv6 communication | |
761 | only. | |
762 | TRUE: disable IPv4-mapped address feature | |
763 | FALSE: enable IPv4-mapped address feature | |
764 | ||
765 | Default: FALSE (as specified in RFC2553bis) | |
766 | ||
767 | IPv6 Fragmentation: | |
768 | ||
769 | ip6frag_high_thresh - INTEGER | |
770 | Maximum memory used to reassemble IPv6 fragments. When | |
771 | ip6frag_high_thresh bytes of memory is allocated for this purpose, | |
772 | the fragment handler will toss packets until ip6frag_low_thresh | |
773 | is reached. | |
774 | ||
775 | ip6frag_low_thresh - INTEGER | |
776 | See ip6frag_high_thresh | |
777 | ||
778 | ip6frag_time - INTEGER | |
779 | Time in seconds to keep an IPv6 fragment in memory. | |
780 | ||
781 | ip6frag_secret_interval - INTEGER | |
782 | Regeneration interval (in seconds) of the hash secret (or lifetime | |
783 | for the hash secret) for IPv6 fragments. | |
784 | Default: 600 | |
785 | ||
786 | conf/default/*: | |
787 | Change the interface-specific default settings. | |
788 | ||
789 | ||
790 | conf/all/*: | |
791 | Change all the interface-specific settings. | |
792 | ||
793 | [XXX: Other special features than forwarding?] | |
794 | ||
795 | conf/all/forwarding - BOOLEAN | |
796 | Enable global IPv6 forwarding between all interfaces. | |
797 | ||
798 | IPv4 and IPv6 work differently here; e.g. netfilter must be used | |
799 | to control which interfaces may forward packets and which not. | |
800 | ||
801 | This also sets all interfaces' Host/Router setting | |
802 | 'forwarding' to the specified value. See below for details. | |
803 | ||
804 | This referred to as global forwarding. | |
805 | ||
fbea49e1 YH |
806 | proxy_ndp - BOOLEAN |
807 | Do proxy ndp. | |
808 | ||
1da177e4 LT |
809 | conf/interface/*: |
810 | Change special settings per interface. | |
811 | ||
812 | The functional behaviour for certain settings is different | |
813 | depending on whether local forwarding is enabled or not. | |
814 | ||
815 | accept_ra - BOOLEAN | |
816 | Accept Router Advertisements; autoconfigure using them. | |
817 | ||
818 | Functional default: enabled if local forwarding is disabled. | |
819 | disabled if local forwarding is enabled. | |
820 | ||
65f5c7c1 YH |
821 | accept_ra_defrtr - BOOLEAN |
822 | Learn default router in Router Advertisement. | |
823 | ||
824 | Functional default: enabled if accept_ra is enabled. | |
825 | disabled if accept_ra is disabled. | |
826 | ||
c4fd30eb | 827 | accept_ra_pinfo - BOOLEAN |
2fe0ae78 | 828 | Learn Prefix Information in Router Advertisement. |
c4fd30eb YH |
829 | |
830 | Functional default: enabled if accept_ra is enabled. | |
831 | disabled if accept_ra is disabled. | |
832 | ||
09c884d4 YH |
833 | accept_ra_rt_info_max_plen - INTEGER |
834 | Maximum prefix length of Route Information in RA. | |
835 | ||
836 | Route Information w/ prefix larger than or equal to this | |
837 | variable shall be ignored. | |
838 | ||
839 | Functional default: 0 if accept_ra_rtr_pref is enabled. | |
840 | -1 if accept_ra_rtr_pref is disabled. | |
841 | ||
930d6ff2 YH |
842 | accept_ra_rtr_pref - BOOLEAN |
843 | Accept Router Preference in RA. | |
844 | ||
845 | Functional default: enabled if accept_ra is enabled. | |
846 | disabled if accept_ra is disabled. | |
847 | ||
1da177e4 LT |
848 | accept_redirects - BOOLEAN |
849 | Accept Redirects. | |
850 | ||
851 | Functional default: enabled if local forwarding is disabled. | |
852 | disabled if local forwarding is enabled. | |
853 | ||
854 | autoconf - BOOLEAN | |
855 | Autoconfigure addresses using Prefix Information in Router | |
856 | Advertisements. | |
857 | ||
c4fd30eb YH |
858 | Functional default: enabled if accept_ra_pinfo is enabled. |
859 | disabled if accept_ra_pinfo is disabled. | |
1da177e4 LT |
860 | |
861 | dad_transmits - INTEGER | |
862 | The amount of Duplicate Address Detection probes to send. | |
863 | Default: 1 | |
864 | ||
865 | forwarding - BOOLEAN | |
866 | Configure interface-specific Host/Router behaviour. | |
867 | ||
868 | Note: It is recommended to have the same setting on all | |
869 | interfaces; mixed router/host scenarios are rather uncommon. | |
870 | ||
871 | FALSE: | |
872 | ||
873 | By default, Host behaviour is assumed. This means: | |
874 | ||
875 | 1. IsRouter flag is not set in Neighbour Advertisements. | |
876 | 2. Router Solicitations are being sent when necessary. | |
877 | 3. If accept_ra is TRUE (default), accept Router | |
878 | Advertisements (and do autoconfiguration). | |
879 | 4. If accept_redirects is TRUE (default), accept Redirects. | |
880 | ||
881 | TRUE: | |
882 | ||
883 | If local forwarding is enabled, Router behaviour is assumed. | |
884 | This means exactly the reverse from the above: | |
885 | ||
886 | 1. IsRouter flag is set in Neighbour Advertisements. | |
887 | 2. Router Solicitations are not sent. | |
888 | 3. Router Advertisements are ignored. | |
889 | 4. Redirects are ignored. | |
890 | ||
891 | Default: FALSE if global forwarding is disabled (default), | |
892 | otherwise TRUE. | |
893 | ||
894 | hop_limit - INTEGER | |
895 | Default Hop Limit to set. | |
896 | Default: 64 | |
897 | ||
898 | mtu - INTEGER | |
899 | Default Maximum Transfer Unit | |
900 | Default: 1280 (IPv6 required minimum) | |
901 | ||
52e16356 YH |
902 | router_probe_interval - INTEGER |
903 | Minimum interval (in seconds) between Router Probing described | |
904 | in RFC4191. | |
905 | ||
906 | Default: 60 | |
907 | ||
1da177e4 LT |
908 | router_solicitation_delay - INTEGER |
909 | Number of seconds to wait after interface is brought up | |
910 | before sending Router Solicitations. | |
911 | Default: 1 | |
912 | ||
913 | router_solicitation_interval - INTEGER | |
914 | Number of seconds to wait between Router Solicitations. | |
915 | Default: 4 | |
916 | ||
917 | router_solicitations - INTEGER | |
918 | Number of Router Solicitations to send until assuming no | |
919 | routers are present. | |
920 | Default: 3 | |
921 | ||
922 | use_tempaddr - INTEGER | |
923 | Preference for Privacy Extensions (RFC3041). | |
924 | <= 0 : disable Privacy Extensions | |
925 | == 1 : enable Privacy Extensions, but prefer public | |
926 | addresses over temporary addresses. | |
927 | > 1 : enable Privacy Extensions and prefer temporary | |
928 | addresses over public addresses. | |
929 | Default: 0 (for most devices) | |
930 | -1 (for point-to-point devices and loopback devices) | |
931 | ||
932 | temp_valid_lft - INTEGER | |
933 | valid lifetime (in seconds) for temporary addresses. | |
934 | Default: 604800 (7 days) | |
935 | ||
936 | temp_prefered_lft - INTEGER | |
937 | Preferred lifetime (in seconds) for temporary addresses. | |
938 | Default: 86400 (1 day) | |
939 | ||
940 | max_desync_factor - INTEGER | |
941 | Maximum value for DESYNC_FACTOR, which is a random value | |
942 | that ensures that clients don't synchronize with each | |
943 | other and generate new addresses at exactly the same time. | |
944 | value is in seconds. | |
945 | Default: 600 | |
946 | ||
947 | regen_max_retry - INTEGER | |
948 | Number of attempts before give up attempting to generate | |
949 | valid temporary addresses. | |
950 | Default: 5 | |
951 | ||
952 | max_addresses - INTEGER | |
953 | Number of maximum addresses per interface. 0 disables limitation. | |
954 | It is recommended not set too large value (or 0) because it would | |
955 | be too easy way to crash kernel to allow to create too much of | |
956 | autoconfigured addresses. | |
957 | Default: 16 | |
958 | ||
959 | icmp/*: | |
960 | ratelimit - INTEGER | |
961 | Limit the maximal rates for sending ICMPv6 packets. | |
962 | 0 to disable any limiting, otherwise the maximal rate in jiffies(1) | |
963 | Default: 100 | |
964 | ||
965 | ||
966 | IPv6 Update by: | |
967 | Pekka Savola <pekkas@netcore.fi> | |
968 | YOSHIFUJI Hideaki / USAGI Project <yoshfuji@linux-ipv6.org> | |
969 | ||
970 | ||
971 | /proc/sys/net/bridge/* Variables: | |
972 | ||
973 | bridge-nf-call-arptables - BOOLEAN | |
974 | 1 : pass bridged ARP traffic to arptables' FORWARD chain. | |
975 | 0 : disable this. | |
976 | Default: 1 | |
977 | ||
978 | bridge-nf-call-iptables - BOOLEAN | |
979 | 1 : pass bridged IPv4 traffic to iptables' chains. | |
980 | 0 : disable this. | |
981 | Default: 1 | |
982 | ||
983 | bridge-nf-call-ip6tables - BOOLEAN | |
984 | 1 : pass bridged IPv6 traffic to ip6tables' chains. | |
985 | 0 : disable this. | |
986 | Default: 1 | |
987 | ||
988 | bridge-nf-filter-vlan-tagged - BOOLEAN | |
989 | 1 : pass bridged vlan-tagged ARP/IP traffic to arptables/iptables. | |
990 | 0 : disable this. | |
991 | Default: 1 | |
992 | ||
993 | ||
994 | UNDOCUMENTED: | |
995 | ||
996 | dev_weight FIXME | |
997 | discovery_slots FIXME | |
998 | discovery_timeout FIXME | |
999 | fast_poll_increase FIXME | |
1000 | ip6_queue_maxlen FIXME | |
1001 | lap_keepalive_time FIXME | |
1002 | lo_cong FIXME | |
1003 | max_baud_rate FIXME | |
1004 | max_dgram_qlen FIXME | |
1005 | max_noreply_time FIXME | |
1006 | max_tx_data_size FIXME | |
1007 | max_tx_window FIXME | |
1008 | min_tx_turn_time FIXME | |
1009 | mod_cong FIXME | |
1010 | no_cong FIXME | |
1011 | no_cong_thresh FIXME | |
1012 | slot_timeout FIXME | |
1013 | warn_noreply_time FIXME | |
1014 |