summaryrefslogtreecommitdiffstats
path: root/conntrackd.8
blob: b09c28c1c2c73020d07902c993fb47927ca6c178 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
.TH CONNTRACKD 8 "Jan 5, 2008" "" ""

.\" Man page written by Pablo Neira Ayuso <pablo@netfilter.org> (Dec 2007)

.SH NAME
conntrackd \- netfilter connection tracking userspace daemon
.SH SYNOPSIS
.BR "conntrackd [options]"
.SH DESCRIPTION
.B conntrackd
provides a userspace daemon for the netfilter connection tracking system. This daemon synchronizes connection tracking states among several replica firewalls. Thus,
.B conntrackd 
can be used to implement highly available stateful firewalls. The daemon fully supports Primary-Backup and Multiprimary setups for both symmetric and asymmetric paths. It can also be used as statistics collector.
.SH OPTIONS
The options recognized by
.B conntrackd
can be divided into several different groups.
.SS MODES
These options specify the particular operation mode in which conntrackd runs. Only one of them can be specified at any given time.
.TP
.BI "-d "
Run conntrackd in daemon mode.
.SS CLIENT COMMANDS
.B conntrackd 
can be used in client mode to request several information and operations to a running daemon
.TP
.BI "-i "
Dump the internal cache, i.e. show local states
.TP
.BI "-e "
Dump the external cache, i.e. show foreign states
.TP
.BI "-x "
Display output in XML format. This option is only valid in combination
with "-i" and "-e" parameters.
.TP
.BI "-f "
Flush the internal and the external cache
.TP
.BI "-k "
Kill the daemon
.TP
.BI "-s "
Dump statistics
.TP
.BI "-R "
Force a resync against the kernel connection tracking table
.SH DIAGNOSTICS
The exit code is 0 for correct function. Errors cause an exit code of 1.
.SH EXAMPLES
.TP
.B conntrackd \-d
Runs conntrackd in daemon and synchronization mode
.TP
.B conntrackd \-i
Dumps the states held in the internal cache, i.e. those handled by this firewall
.TP
.B conntrackd \-e
Dumps the states held in the external cache, i.e. those handled by other replica firewalls
.TP
.B conntrackd \-c
Commits the internal cache into the kernel connection tracking system. This is used to inject the state so that the connections can be recovered during the failover.
.SH DEPENDENCIES
This daemon requires a Linux kernel version >= 2.6.18. TCP window tracking support requires >= 2.6.22, otherwise you have to disable it. Helpers are fully supported since >= 2.6.25, however, if you use any previous version, depending on the protocol helper and your setup (e.g. if you setup performs NAT sequence adjustments or not), your help connection may be successfully recovered.
.TP
There are several unsupported stateful iptables matches such as recent, connbytes and the quota matches which gather internal information to operate. Since that information does not belong to the domain of the connection tracking system, connections affected by those matches may not be fully recovered during the takeover.
.SH SEE ALSO
.BR conntrack (8), iptables (8)
.br
.BR "http://people.netfilter.org/pablo/conntrack-tools/"
.SH AUTHORS
Pablo Neira Ayuso wrote and maintains the conntrackd tool
.TP
Please send bug reports to <netfilter-failover@lists.netfilter.org>. Subscription is required.
.PP
Man page written by Pablo Neira Ayuso <pablo@netfilter.org>.