From 424b581b012f38597ec06088cf98273eba25e7ba Mon Sep 17 00:00:00 2001 From: Pablo Neira Ayuso Date: Sun, 10 Oct 2010 13:20:02 +0200 Subject: doc: update README file (including re-license to GPLv2+) This patch updates the README file and it includes the re-licensing of this library to make it GPLv2+. Signed-off-by: Pablo Neira Ayuso --- README | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) (limited to 'README') diff --git a/README b/README index b0065c9..f0eed70 100644 --- a/README +++ b/README @@ -1,5 +1,5 @@ libnetfilter_conntrack - userspace library for the connection tracking system -(C) 2005-2007 Pablo Neira Ayuso +(C) 2005-2010 Pablo Neira Ayuso ============================================================================= = Connection Tracking System = @@ -29,6 +29,10 @@ reference section at the bottom of this document. libnetfilter_conntrack is an userspace library that provides an interface to the in-kernel connection tracking system. += License = + +libnetfilter_conntrack is released under GPLv2 or any later at your option. + = Prerequirements for libnetfilter_conntrack = Linux kernel version >= 2.6.18 (http://www.kernel.org) and enable support for: @@ -40,21 +44,23 @@ Linux kernel version >= 2.6.18 (http://www.kernel.org) and enable support for: = Documentation = -The libnetfilter_conntrack API is well documented, however we don't have any -tool yet to automate the document generation. So, you'll have to consult the -documentation from the source code. +You can generate the doxygen-based documentation by invoking: + $ doxygen doxygen.cfg = Examples = You can find a set of handy examples on the use of libnetfilter_conntrack -under the directory utils/ distributed with this library. +under the directory utils/ distributed with this library. You can compile them +by invoking: + $ make check = Heads Up = -Currently libnetfilter_conntrack supports two different APIs: The old one that -has several limitations and the new one that solves such deficiencies. Thus, -make sure you use the new API for your new applications since the old one will -be removed soon. +libnetfilter_conntrack used to provided two different APIs: The old one had +several limitations, for that reason, it was deprecated time ago. The existing +library only provides the new API that solves former deficiencies. Thus, make +sure you use recent versions of libnetfilter_conntrack and, in case that +you are using the old API, consider porting your application to the new one. = References = -- cgit v1.2.3