doc: add manpage for libxt_osf

Signed-off-by: Jan Engelhardt <jengelh@medozas.de>

diff --git a/extensions/libxt_osf.c b/extensions/libxt_osf.c
index 3c0ea2dd542d94c4f49f8e041da60092a0a2ae4d..07b86e40433956cf67c16ae680792b4f721e72e9 100644 (file)
--- a/extensions/libxt_osf.c
+++ b/extensions/libxt_osf.c
@@ -40,8 +40,8 @@
 static void osf_help(void)
 {
        printf("OS fingerprint match options:\n"
-               "--genre [!] string         Match a OS genre by passive fingerprinting.\n"
-               "--ttl                  Use some TTL check extensions to determine OS:\n"
+               "[!] --genre string     Match a OS genre by passive fingerprinting.\n"
+               "--ttl level            Use some TTL check extensions to determine OS:\n"
                "       0                       true ip and fingerprint TTL comparison. Works for LAN.\n"
                "       1                       check if ip TTL is less than fingerprint one. Works for global addresses.\n"
                "       2                       do not compare TTL at all. Allows to detect NMAP, but can produce false results.\n"

diff --git a/extensions/libxt_osf.man b/extensions/libxt_osf.man
new file mode 100644 (file)
index 0000000..ea616a9
--- /dev/null
+++ b/extensions/libxt_osf.man
@@ -0,0 +1,45 @@
+The osf module does passive operating system fingerprinting. This modules
+compares some data (Window Size, MSS, options and their order, TTL, DF,
+and others) from packets with the SYN bit set. 
+.TP
+[\fB!\fP] \fB\-\-genre\fP \fIstring\fP
+Match an operating system genre by using a passive fingerprinting.
+.TP
+\fB\-\-ttl\fP \fIlevel\fP
+Do additional TTL checks on the packet to determine the operating system.
+\fIlevel\fP can be one of the following values:
+.IP \(bu 4
+0 - True IP address and fingerprint TTL comparison. This generally works for
+LANs.
+.IP \(bu 4
+1 - Check if the IP header's TTL is less than the fingerprint one. Works for
+globally-routable addresses.
+.IP \(bu 4
+2 - Do not compare the TTL at all.
+.TP
+\fB\-\-log\fP \fIlevel\fP
+Log determined genres into dmesg even if they do not match the desired one.
+\fIlevel\fP can be one of the following values:
+.IP \(bu 4
+0 - Log all matched or unknown signatures
+.IP \(bu 4
+1 - Log only the first one
+.IP \(bu 4
+2 - Log all known matched signatures
+.PP
+You may find something like this in syslog:
+.PP
+Windows [2000:SP3:Windows XP Pro SP1, 2000 SP3]: 11.22.33.55:4024 ->
+11.22.33.44:139 hops=3 Linux [2.5-2.6:] : 1.2.3.4:42624 -> 1.2.3.5:22 hops=4
+.PP
+OS fingerprints are loadable using the \fBnfnl_osf\fP program. To load
+fingerprints from a file, use:
+.PP
+\fBnfnl_osf -f ./pf.os\fP
+.PP
+To remove them again,
+.PP
+\fBnfnl_osf -f ./pf.os -d\fP
+.PP
+The fingerprint database can be downlaoded from
+http://www.openbsd.org/cgi-bin/cvsweb/src/etc/pf.os .