Tomato 1.28
[tomato.git] / release / src / router / iptables / extensions / libipt_DNAT.man
blob366dcb77ef093c58f6a9656a07e0d85a516f48bd
1 This target is only valid in the
2 .B nat
3 table, in the
4 .B PREROUTING
5 and
6 .B OUTPUT
7 chains, and user-defined chains which are only called from those
8 chains.  It specifies that the destination address of the packet
9 should be modified (and all future packets in this connection will
10 also be mangled), and rules should cease being examined.  It takes one
11 type of option:
12 .TP
13 .BR "--to-destination " "[\fIipaddr\fP][-\fIipaddr\fP][:\fIport\fP-\fIport\fP]"
14 which can specify a single new destination IP address, an inclusive
15 range of IP addresses, and optionally, a port range (which is only
16 valid if the rule also specifies
17 .B "-p tcp"
19 .BR "-p udp" ).
20 If no port range is specified, then the destination port will never be
21 modified. If no IP address is specified then only the destination port
22 will be modified.
23 .RS
24 .PP
25 In Kernels up to 2.6.10 you can add several --to-destination options.  For
26 those kernels, if you specify more than one destination address, either via an
27 address range or multiple --to-destination options, a simple round-robin (one
28 after another in cycle) load balancing takes place between these addresses.
29 Later Kernels (>= 2.6.11-rc1) don't have the ability to NAT to multiple ranges
30 anymore.