|
|
ab08bb |
From 77ff3d215f2a28a9ffc9fe1943c7f2b12d5e4f69 Mon Sep 17 00:00:00 2001
|
|
|
ab08bb |
From: Phil Sutter <psutter@redhat.com>
|
|
|
ab08bb |
Date: Tue, 5 Jun 2018 14:49:54 +0200
|
|
|
ab08bb |
Subject: [PATCH 2/2] utils: Add a man page for nfnl_osf
|
|
|
ab08bb |
|
|
|
ab08bb |
Bugzilla: https://bugzilla.redhat.com/show_bug.cgi?id=1487331
|
|
|
ab08bb |
Upstream Status: iptables commit af468b6e7f35d
|
|
|
ab08bb |
|
|
|
ab08bb |
commit af468b6e7f35db09af10ae4ec65cc7803180a4b4
|
|
|
ab08bb |
Author: Phil Sutter <phil@nwl.cc>
|
|
|
ab08bb |
Date: Wed Sep 20 18:54:09 2017 +0200
|
|
|
ab08bb |
|
|
|
ab08bb |
utils: Add a man page for nfnl_osf
|
|
|
ab08bb |
|
|
|
ab08bb |
Signed-off-by: Phil Sutter <phil@nwl.cc>
|
|
|
ab08bb |
Signed-off-by: Pablo Neira Ayuso <pablo@netfilter.org>
|
|
|
ab08bb |
|
|
|
ab08bb |
Signed-off-by: Phil Sutter <psutter@redhat.com>
|
|
|
ab08bb |
---
|
|
|
ab08bb |
configure.ac | 3 +-
|
|
|
ab08bb |
utils/.gitignore | 1 +
|
|
|
ab08bb |
utils/Makefile.am | 4 +++
|
|
|
ab08bb |
utils/nfnl_osf.8.in | 67 +++++++++++++++++++++++++++++++++++++++++++++
|
|
|
ab08bb |
4 files changed, 74 insertions(+), 1 deletion(-)
|
|
|
ab08bb |
create mode 100644 utils/nfnl_osf.8.in
|
|
|
ab08bb |
|
|
|
ab08bb |
diff --git a/configure.ac b/configure.ac
|
|
|
ab08bb |
index af710cf5481c0..9046633ce5a4d 100644
|
|
|
ab08bb |
--- a/configure.ac
|
|
|
ab08bb |
+++ b/configure.ac
|
|
|
ab08bb |
@@ -173,7 +173,8 @@ AC_CONFIG_FILES([Makefile extensions/GNUmakefile include/Makefile
|
|
|
ab08bb |
libiptc/Makefile libiptc/libiptc.pc
|
|
|
ab08bb |
libiptc/libip4tc.pc libiptc/libip6tc.pc
|
|
|
ab08bb |
libxtables/Makefile utils/Makefile
|
|
|
ab08bb |
- include/xtables-version.h include/iptables/internal.h])
|
|
|
ab08bb |
+ include/xtables-version.h include/iptables/internal.h
|
|
|
ab08bb |
+ utils/nfnl_osf.8])
|
|
|
ab08bb |
AC_OUTPUT
|
|
|
ab08bb |
|
|
|
ab08bb |
|
|
|
ab08bb |
diff --git a/utils/.gitignore b/utils/.gitignore
|
|
|
ab08bb |
index 216d1e4a621ed..7c6afbf4e6a52 100644
|
|
|
ab08bb |
--- a/utils/.gitignore
|
|
|
ab08bb |
+++ b/utils/.gitignore
|
|
|
ab08bb |
@@ -1,2 +1,3 @@
|
|
|
ab08bb |
/nfnl_osf
|
|
|
ab08bb |
+/nfnl_osf.8
|
|
|
ab08bb |
/nfbpf_compile
|
|
|
ab08bb |
diff --git a/utils/Makefile.am b/utils/Makefile.am
|
|
|
ab08bb |
index c4192a9e73688..80029e303ff3b 100644
|
|
|
ab08bb |
--- a/utils/Makefile.am
|
|
|
ab08bb |
+++ b/utils/Makefile.am
|
|
|
ab08bb |
@@ -6,8 +6,10 @@ AM_CPPFLAGS = ${regular_CPPFLAGS} -I${top_builddir}/include \
|
|
|
ab08bb |
|
|
|
ab08bb |
sbin_PROGRAMS =
|
|
|
ab08bb |
pkgdata_DATA =
|
|
|
ab08bb |
+man_MANS =
|
|
|
ab08bb |
|
|
|
ab08bb |
if HAVE_LIBNFNETLINK
|
|
|
ab08bb |
+man_MANS += nfnl_osf.8
|
|
|
ab08bb |
sbin_PROGRAMS += nfnl_osf
|
|
|
ab08bb |
pkgdata_DATA += pf.os
|
|
|
ab08bb |
|
|
|
ab08bb |
@@ -23,3 +25,5 @@ if ENABLE_SYNCONF
|
|
|
ab08bb |
sbin_PROGRAMS += nfsynproxy
|
|
|
ab08bb |
nfsynproxy_LDADD = -lpcap
|
|
|
ab08bb |
endif
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+CLEANFILES = nfnl_osf.8
|
|
|
ab08bb |
diff --git a/utils/nfnl_osf.8.in b/utils/nfnl_osf.8.in
|
|
|
ab08bb |
new file mode 100644
|
|
|
ab08bb |
index 0000000000000..140b5c3f99a42
|
|
|
ab08bb |
--- /dev/null
|
|
|
ab08bb |
+++ b/utils/nfnl_osf.8.in
|
|
|
ab08bb |
@@ -0,0 +1,67 @@
|
|
|
ab08bb |
+.TH NFNL_OSF 8 "" "@PACKAGE_STRING@" "@PACKAGE_STRING@"
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.SH NAME
|
|
|
ab08bb |
+nfnl_osf \- OS fingerprint loader utility
|
|
|
ab08bb |
+.SH SYNOPSIS
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.ad l
|
|
|
ab08bb |
+.in +8
|
|
|
ab08bb |
+.ti -8
|
|
|
ab08bb |
+.B nfnl_osf
|
|
|
ab08bb |
+.BI -f " fingerprints"
|
|
|
ab08bb |
+[
|
|
|
ab08bb |
+.B -d
|
|
|
ab08bb |
+]
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.SH DESCRIPTION
|
|
|
ab08bb |
+The
|
|
|
ab08bb |
+.B nfnl_osf
|
|
|
ab08bb |
+utility allows to load a set of operating system signatures into the kernel for
|
|
|
ab08bb |
+later matching against using iptables'
|
|
|
ab08bb |
+.B osf
|
|
|
ab08bb |
+match.
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.SH OPTIONS
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.TP
|
|
|
ab08bb |
+.BI -f " fingerprints"
|
|
|
ab08bb |
+Read signatures from file
|
|
|
ab08bb |
+.IR fingerprints .
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.TP
|
|
|
ab08bb |
+.B -d
|
|
|
ab08bb |
+Instead of adding the signatures from
|
|
|
ab08bb |
+.I fingerprints
|
|
|
ab08bb |
+into the kernel, remove them.
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.SH EXIT STATUS
|
|
|
ab08bb |
+Exit status is 0 if command succeeded, otherwise a negative return code
|
|
|
ab08bb |
+indicates the type of error which happened:
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.TP
|
|
|
ab08bb |
+.B -1
|
|
|
ab08bb |
+Illegal arguments passed, fingerprints file not readable or failure in netlink
|
|
|
ab08bb |
+communication.
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.TP
|
|
|
ab08bb |
+.B -ENOENT
|
|
|
ab08bb |
+Fingerprints file not specified.
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.TP
|
|
|
ab08bb |
+.B -EINVAL
|
|
|
ab08bb |
+Netlink handle initialization failed or fingerprints file format invalid.
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.SH FILES
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+An up to date set of operating system signatures can be downloaded from
|
|
|
ab08bb |
+http://www.openbsd.org/cgi-bin/cvsweb/src/etc/pf.os .
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+.SH SEE ALSO
|
|
|
ab08bb |
+
|
|
|
ab08bb |
+The description of
|
|
|
ab08bb |
+.B osf
|
|
|
ab08bb |
+match in
|
|
|
ab08bb |
+.BR iptables-extensions (8)
|
|
|
ab08bb |
+contains further information about the topic as well as example
|
|
|
ab08bb |
+.B nfnl_osf
|
|
|
ab08bb |
+invocations.
|
|
|
ab08bb |
--
|
|
|
ab08bb |
2.17.0
|
|
|
ab08bb |
|