manpages: do not include v4-only modules in ip6tables manpage
[jleu-iptables.git] / extensions / libxt_CONNMARK.man
blob571ce3700989945cf18df58b674af7ca35cea076
1 This module sets the netfilter mark value associated with a connection.
2 .TP
3 \fB\-\-set\-xmark\fP \fIvalue\fP[\fB/\fP\fImask\fP]
4 Zero out the bits given by \fImask\fR and XOR \fIvalue\fR into the ctmark.
5 .TP
6 \fB\-\-save\-mark\fP [\fB\-\-nfmask\fP \fInfmask\fP] [\fB\-\-ctmask\fP \fIctmask\fP]
7 Copy the packet mark (nfmark) to the connection mark (ctmark) using the given
8 masks. The new nfmark value is determined as follows:
9 .IP
10 ctmark = (ctmark & ~ctmask) ^ (nfmark & nfmask)
11 .IP
12 i.e. \fIctmask\fR defines what bits to clear and \fInfmask\fR what bits of the
13 nfmark to XOR into the ctmark. \fIctmask\fR and \fInfmask\fR default to
14 0xFFFFFFFF.
15 .TP
16 \fB\-\-restore\-mark\fP [\fB\-\-nfmask\fP \fInfmask\fP] [\fB\-\-ctmask\fP \fIctmask\fP]
17 Copy the connection mark (ctmark) to the packet mark (nfmark) using the given
18 masks. The new ctmark value is determined as follows:
19 .IP
20 nfmark = (nfmark & ~\fInfmask\fR) ^ (ctmark & \fIctmask\fR);
21 .IP
22 i.e. \fInfmask\fR defines what bits to clear and \fIctmask\fR what bits of the
23 ctmark to XOR into the nfmark. \fIctmask\fR and \fInfmask\fR default to
24 0xFFFFFFFF.
25 .IP
26 \fB\-\-restore\-mark\fP is only valid in the \fBmangle\fP table.
27 .PP
28 The following mnemonics are available for \fB\-\-set\-xmark\fP:
29 .TP
30 \fB\-\-and\-mark\fP \fIbits\fP
31 Binary AND the ctmark with \fIbits\fR. (Mnemonic for \fB\-\-set\-xmark
32 0/\fR\fIinvbits\fR, where \fIinvbits\fR is the binary negation of \fIbits\fR.)
33 .TP
34 \fB\-\-or\-mark\fP \fIbits\fP
35 Binary OR the ctmark with \fIbits\fR. (Mnemonic for \fB\-\-set\-xmark\fP
36 \fIbits\fR\fB/\fR\fIbits\fR.)
37 .TP
38 \fB\-\-xor\-mark\fP \fIbits\fP
39 Binary XOR the ctmark with \fIbits\fR. (Mnemonic for \fB\-\-set\-xmark\fP
40 \fIbits\fR\fB/0\fR.)
41 .TP
42 \fB\-\-set\-mark\fP \fIvalue\fP[\fB/\fP\fImask\fP]
43 Set the connection mark. If a mask is specified then only those bits set in the
44 mask are modified.
45 .TP
46 \fB\-\-save\-mark\fP [\fB\-\-mask\fP \fImask\fP]
47 Copy the nfmark to the ctmark. If a mask is specified, only those bits are
48 copied.
49 .TP
50 \fB\-\-restore\-mark\fP [\fB\-\-mask\fP \fImask\fP]
51 Copy the ctmark to the nfmark. If a mask is specified, only those bits are
52 copied. This is only valid in the \fBmangle\fR table.