← Back to branch summary

~ubuntu-branches/ubuntu/karmic/conntrack/karmic

« back to all changes in this revision

Viewing changes to conntrackd.8

  • Committer: Bazaar Package Importer
  • Author(s): Andres Rodriguez
  • Date: 2009-06-18 18:27:31 UTC
  • mfrom: (3.1.2 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090618182731-xlunt56xusrrif92
Tags: 1:0.9.12-1ubuntu1
https://launchpad.net/bugs/380358
* Merge from debian unstable (LP: #380358), remaining changes:
  - Error on fwrite failure in src/read_config_lex.c.
  - Patch from Kees Cook to not ignore return value of chdir call.
* debian/copyright: Updated download site.

Show diffs side-by-side

added added

removed removed

Lines of Context:
conntrackd.8
1
 
.TH CONNTRACKD 8 "Jan 5, 2008" "" ""
 
1
.TH CONNTRACKD 8 "Oct 21, 2008" "" ""
2
2
 
3
3
.\" Man page written by Pablo Neira Ayuso <pablo@netfilter.org> (Dec 2007)
4
4
 
5
5
.SH NAME
6
 
conntrackd \- netfilter connection tracking userspace daemon
 
6
conntrackd \- netfilter connection tracking user-space daemon
7
7
.SH SYNOPSIS
8
8
.BR "conntrackd [options]"
9
9
.SH DESCRIPTION
10
10
.B conntrackd
11
 
provides a userspace daemon for the netfilter connection tracking system. This daemon synchronizes connection tracking states among several replica firewalls. Thus,
 
11
is the user-space daemon for the netfilter connection tracking system. This daemon synchronizes connection tracking states between several replica firewalls. Thus,
12
12
.B conntrackd 
13
 
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.
 
13
can be used to deploy highly available stateful firewalls. The daemon supports Primary-Backup and Multiprimary setups. The daemon can also be used as statistics collector.
14
14
.SH OPTIONS
15
15
The options recognized by
16
16
.B conntrackd
34
34
Display output in XML format. This option is only valid in combination
35
35
with "-i" and "-e" parameters.
36
36
.TP
37
 
.BI "-f "
38
 
Flush the internal and the external cache
 
37
.BI "-f " "[|internal|external]"
 
38
Flush the internal and/or external cache
 
39
.TP
 
40
.BI "-F "
 
41
Flush the kernel conntrack table (if you use a Linux kernel >= 2.6.29, this
 
42
option will not flush your internal and external cache).
39
43
.TP
40
44
.BI "-k "
41
45
Kill the daemon
42
46
.TP
43
 
.BI "-s "
44
 
Dump statistics
 
47
.BI "-s " "[|network|cache|runtime|link|queue]"
 
48
Dump statistics. If no parameter is passed, it displays the general statistics.
 
49
If "network" is passed as parameter it displays the networking statistics.
 
50
If "cache" is passed as parameter, it shows the extended cache statistics.
 
51
If "runtime" is passed as parameter, it shows the run-time statistics.
45
52
.TP
46
53
.BI "-R "
47
54
Force a resync against the kernel connection tracking table
 
55
.TP
 
56
.BI "-t "
 
57
Reset the in-kernel timers (See PurgeTimeout clause)
 
58
.TP
 
59
.BI "-v "
 
60
Display version information.
 
61
.TP
 
62
.BI "-h "
 
63
Display help information.
48
64
.SH DIAGNOSTICS
49
65
The exit code is 0 for correct function. Errors cause an exit code of 1.
50
66
.SH EXAMPLES
 
67
The following example are illustrative, for a real use in a firewall fail-over,
 
68
check the primary-backup.sh script that comes with the sources.
51
69
.TP
52
70
.B conntrackd \-d
53
71
Runs conntrackd in daemon and synchronization mode
64
82
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.
65
83
.TP
66
84
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.
 
85
.TP
 
86
The daemon requires a Linux kernel version >= 2.6.26 to support kernel-space event filtering. Otherwise, all the event filtering is done in userspace with the corresponding extra overhead. If you are not using the Filter clause in the configuration file, ignore this notice.
 
87
.SH INCOMPATIBILITIES
 
88
During the 0.9.9 development, some important changes in the replication message format were introduced. Therefore, conntrackd >= 0.9.9 will not work appropriately with conntrackd <= 0.9.8. This should not be a problem if you use the same
 
89
conntrackd version in all the firewall replica nodes.
67
90
.SH SEE ALSO
68
91
.BR conntrack (8), iptables (8)
69
92
.br
75
98
.SH AUTHORS
76
99
Pablo Neira Ayuso wrote and maintains the conntrackd tool
77
100
.TP
78
 
Please send bug reports to <netfilter-failover@lists.netfilter.org>. Subscription is required.
 
101
Please send bug reports to <netfilter-devel@lists.netfilter.org>. Subscription is required.
79
102
.PP
80
103
Man page written by Pablo Neira Ayuso <pablo@netfilter.org>.