changing trunk/trunk to trunk
[iptables.git] / extensions / libxt_TCPMSS.man
1 This target allows to alter the MSS value of TCP SYN packets, to control
2 the maximum size for that connection (usually limiting it to your
3 outgoing interface's MTU minus 40 for IPv4 or 60 for IPv6, respectively).
4 Of course, it can only be used
5 in conjunction with
6 .BR "-p tcp" .
7 It is only valid in the
8 .BR mangle
9 table.
10 .br
11 This target is used to overcome criminally braindead ISPs or servers
12 which block "ICMP Fragmentation Needed" or "ICMPv6 Packet Too Big"
13 packets.  The symptoms of this
14 problem are that everything works fine from your Linux
15 firewall/router, but machines behind it can never exchange large
16 packets:
17 .PD 0
18 .RS 0.1i
19 .TP 0.3i
20 1)
21 Web browsers connect, then hang with no data received.
22 .TP
23 2)
24 Small mail works fine, but large emails hang.
25 .TP
26 3)
27 ssh works fine, but scp hangs after initial handshaking.
28 .RE
29 .PD
30 Workaround: activate this option and add a rule to your firewall
31 configuration like:
32 .nf
33  iptables -t mangle -A FORWARD -p tcp --tcp-flags SYN,RST SYN \\
34              -j TCPMSS --clamp-mss-to-pmtu
35 .fi
36 .TP
37 .BI "--set-mss " "value"
38 Explicitly set MSS option to specified value.
39 .TP
40 .B "--clamp-mss-to-pmtu"
41 Automatically clamp MSS value to (path_MTU - 40 for IPv4; -60 for IPv6).
42 .TP
43 These options are mutually exclusive.