da1bce2d26b762b7f52ac366365cf502168fb659
[iptables.git] / extensions / libipt_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).  Of course, it can only be used
4 in conjunction with
5 .BR "-p tcp" .
6 .br
7 This target is used to overcome criminally braindead ISPs or servers
8 which block ICMP Fragmentation Needed packets.  The symptoms of this
9 problem are that everything works fine from your Linux
10 firewall/router, but machines behind it can never exchange large
11 packets:
12 .PD 0
13 .RS 0.1i
14 .TP 0.3i
15 1)
16 Web browsers connect, then hang with no data received.
17 .TP
18 2)
19 Small mail works fine, but large emails hang.
20 .TP
21 3)
22 ssh works fine, but scp hangs after initial handshaking.
23 .RE
24 .PD
25 Workaround: activate this option and add a rule to your firewall
26 configuration like:
27 .nf
28  iptables -A FORWARD -p tcp --tcp-flags SYN,RST SYN \\
29              -j TCPMSS --clamp-mss-to-pmtu
30 .fi
31 .TP
32 .BI "--set-mss " "value"
33 Explicitly set MSS option to specified value.
34 .TP
35 .B "--clamp-mss-to-pmtu"
36 Automatically clamp MSS value to (path_MTU - 40).
37 .TP
38 These options are mutually exclusive.