Implement --no-lastseen
[darkstat] / darkstat.8
index c7bb03e..2a7c4b4 100644 (file)
@@ -1,6 +1,6 @@
 .\"
 .\" darkstat 3
-.\" Copyright 2001-2008, Emil Mikulic.
+.\" Copyright 2001-2009, Emil Mikulic.
 .\"
 .\" You may use, modify and redistribute this file under the terms of the
 .\" GNU General Public License version 2. (see COPYING.GPL)
@@ -28,6 +28,8 @@ darkstat \- network statistics gatherer
 ] [
 .BI \-\-no\-macs
 ] [
+.BI \-\-no\-lastseen
+] [
 .BI \-p " port"
 ] [
 .BI \-b " bindaddr"
@@ -57,6 +59,8 @@ darkstat \- network statistics gatherer
 .BI \-\-ports\-keep " count"
 ] [
 .BI \-\-highest\-port " port"
+] [
+.BI \-\-hexdump
 ]
 .\"
 .SH DESCRIPTION
@@ -127,7 +131,11 @@ as an extra process is created for DNS resolving.
 .\"
 .TP
 .BI \-\-no\-macs
-Do not display MAC addresses in hosts table.
+Do not display MAC addresses in the hosts table.
+.\"
+.TP
+.BI \-\-no\-lastseen
+Do not display the last seen time in the hosts table.
 .\"
 .TP
 .BI \-p " port"
@@ -254,6 +262,10 @@ will send SIGTERM, which will cause \fIdarkstat\fR to shut down cleanly.
 .BI \-\-hosts\-max " count"
 The maximum number of hosts that will be kept in the hosts table.
 This is used to limit how much accounting data will be kept in memory.
+The number of
+.BI \-\-hosts\-max
+must be greater than
+.BI \-\-hosts\-keep
 .\"
 .TP
 .BI \-\-hosts\-keep " count"
@@ -268,6 +280,10 @@ number of hosts, sorted by total traffic.
 .BI \-\-ports\-max " count"
 The maximum number of ports that will be tracked for each host.
 This is used to limit how much accounting data will be kept in memory.
+The number of
+.BI \-\-ports\-max
+must be greater than
+.BI \-\-ports\-keep
 .\"
 .TP
 .BI \-\-ports\-keep " count"
@@ -282,6 +298,11 @@ for.
 This can be used to hide ephemeral ports.
 By default, all ports are tracked.
 .\"
+.TP
+.BI \-\-hexdump
+Show hex dumps of received traffic.
+This is only for debugging, and implies \-\-verbose and \-\-no\-daemon.
+.\"
 .\" --------------------------------------------------------------------
 .SH USAGE EXAMPLES
 To gather statistics on the
@@ -330,6 +351,13 @@ traffic entering and leaving the local network, not just the gateway
 server (which is running \fIdarkstat\fR):
 .IP
 darkstat \-i fxp0 \-l 192.168.1.0/255.255.255.0
+.PP
+.\"
+We want to specify the local IP of the gateway manually because it
+cannot be automatically detected, e.g. \fB\-\-pppoe\fR is in use.
+Note the /32 netmask:
+.IP
+darkstat \-i fxp0 \-\-pppoe \-l 192.168.1.1/255.255.255.255
 .\"
 .SH SIGNALS
 To shut