Debian packaging of softflowd, a flow-based network traffic analyser https://github.com/irino/softflowd

Christoph Biedl 269458bcc4 softflowd 1.1.0-2 5 ヶ月 前
debian 269458bcc4 softflowd 1.1.0-2 5 ヶ月 前
.travis.yml 6b1f750107 Import upstream version 1.1.0 2 年 前
AUTHORS 6945e52043 Import upstream version 1.0.0 5 年 前
COPYING 6945e52043 Import upstream version 1.0.0 5 年 前
ChangeLog 6b1f750107 Import upstream version 1.1.0 2 年 前
INSTALL 6b1f750107 Import upstream version 1.1.0 2 年 前
LICENSE 12845c26e9 Import upstream version 0.9.8 16 年 前
Makefile.am 6b1f750107 Import upstream version 1.1.0 2 年 前
NEWS 6b1f750107 Import upstream version 1.1.0 2 年 前
README 6b1f750107 Import upstream version 1.1.0 2 年 前
TODO 1549208c07 Import upstream version 0.9.8+hg20101101.b35a000870cc 14 年 前
closefrom.c 0710298a4a Import upstream version 0.9.9 12 年 前
collector.pl 0710298a4a Import upstream version 0.9.9 12 年 前
common.h 6b1f750107 Import upstream version 1.1.0 2 年 前
configure.ac 6b1f750107 Import upstream version 1.1.0 2 年 前
convtime.c 0710298a4a Import upstream version 0.9.9 12 年 前
convtime.h 12845c26e9 Import upstream version 0.9.8 16 年 前
daemon.c 12845c26e9 Import upstream version 0.9.8 16 年 前
freelist.c 6b1f750107 Import upstream version 1.1.0 2 年 前
freelist.h 1549208c07 Import upstream version 0.9.8+hg20101101.b35a000870cc 14 年 前
ipfix.c 6b1f750107 Import upstream version 1.1.0 2 年 前
ipfix.h 6b1f750107 Import upstream version 1.1.0 2 年 前
log.c 0710298a4a Import upstream version 0.9.9 12 年 前
log.h 0710298a4a Import upstream version 0.9.9 12 年 前
netflow1.c 6945e52043 Import upstream version 1.0.0 5 年 前
netflow5.c 6945e52043 Import upstream version 1.0.0 5 年 前
netflow9.c 6b1f750107 Import upstream version 1.1.0 2 年 前
netflow9.h 6945e52043 Import upstream version 1.0.0 5 年 前
ntopng.c 6b1f750107 Import upstream version 1.1.0 2 年 前
psamp.c 6b1f750107 Import upstream version 1.1.0 2 年 前
psamp.h 6945e52043 Import upstream version 1.0.0 5 年 前
softflowctl.8 6945e52043 Import upstream version 1.0.0 5 年 前
softflowctl.c 6945e52043 Import upstream version 1.0.0 5 年 前
softflowctl.md 6b1f750107 Import upstream version 1.1.0 2 年 前
softflowd.8 6b1f750107 Import upstream version 1.1.0 2 年 前
softflowd.c 6b1f750107 Import upstream version 1.1.0 2 年 前
softflowd.h 6b1f750107 Import upstream version 1.1.0 2 年 前
softflowd.html 6b1f750107 Import upstream version 1.1.0 2 年 前
softflowd.init 0710298a4a Import upstream version 0.9.9 12 年 前
softflowd.md 6b1f750107 Import upstream version 1.1.0 2 年 前
softflowd.spec 6b1f750107 Import upstream version 1.1.0 2 年 前
softflowd.sysconfig 12845c26e9 Import upstream version 0.9.8 16 年 前
strlcat.c 0710298a4a Import upstream version 0.9.9 12 年 前
strlcpy.c 0710298a4a Import upstream version 0.9.9 12 年 前
sys-tree.h 12845c26e9 Import upstream version 0.9.8 16 年 前
treetype.h 0710298a4a Import upstream version 0.9.9 12 年 前

README

Welcome to softflowd, a flow-based network monitor.

Introduction
------------

softflowd listens promiscuously on a network interface and semi-statefully
tracks network flows. These flows can be reported using NetFlow version 1, 5
or 9 datagrams. softflowd is fully IPv6 capable: it can track IPv6 flows and
export to IPv6 hosts.

More details about softflowd's function and usage may be found in the
softflowd wiki in following URLs:
https://github.com/irino/softflowd/wiki/softflowd
https://github.com/irino/softflowd/wiki/softflowctl

PDF manpages can be built with:

man -t ./softflowd.8 | ps2pdf - softflowd.pdf
man -t ./softflowctl.8 | ps2pdf - softflowctl.pdf

HTML manpages can be built with:

groff -mandoc -Thtml softflowd.8 > softflowd.html
groff -mandoc -Thtml softflowctl.8 > softflowctl.html

Markdown manpages (which are published in wiki pages) can be built
from above HtML manpages:

pandoc -s softflowd.html -o softflowd.md
pandoc -s softflowctl.html -o softflowctl.md

You can view those pages prior to installation using:

/usr/bin/nroff -c -mandoc softflowd.8 | less
/usr/bin/nroff -c -mandoc softflowctl.8 | less

If you are in need of a NetFlow collector, you may be interested in
softflowd's companion project "flowd" (http://www.mindrot.org/projects/flowd/).
flowd is a NetFlow collector that is maintained in parallel with
softflowd and includes a few handy features, such as the ability
to filter flows it receives as well as Perl and Python APIs to its
storage format. NB. You don't have to use flowd: any NetFlow compatible
collector should work with softflowd. An example Perl collector is included
for testing purposes as collector.pl, but it doesn't yet support NetFlow v.9

Installing
----------

Building softflowd should be as simple as typing:

autoreconf -if # instead of "aclocal && autoheader && automake --add-missing && autoconf"
./configure
make
make install

Unfortunately some systems like to make life complicated. Things work
fine on the systems that I develop and test on (OpenBSD and Linux).
There is peliminary support for Solaris 9 (i.e. it compiled), but no
testing on this platform has been performed.

Licensing
---------

Softflowd is licensed under a two-term BSD license (see the source
files for details). The code in sys-tree.h is Copyright Niels Provos
and comes straight from OpenBSD CVS, convtime.c
comes is Copyright Kevin Steves and comes from OpenSSH (misc.c). Both
of these files are licensed under two-term BSD licenses too. strlcpy.c,
strlcat.c and closefrom.c also come from OpenBSD CVS and are Copyright
Todd C. Miller. Please refer to the LICENSE file for full details.

Reporting Bugs
--------------

Please report bugs in softflowd (https://github.com/irino/softflowd/)
to https://github.com/irino/softflowd/issues

Following descriptions are historical information:
Please report bugs in softflowd to http://bugzilla.mindrot.org/ If you
find a security bug, please report it directly by email. If you have any
feedback or questions, please email me:

Contributing
------------

Softflowd has an extensive TODO list of interesting features, large and
small, that are waiting to be implemented. If you are interested in
helping, please contact me.

The latest source code may be obtained from Github:
https://github.com/irino/softflowd/
(This repository was forked from http://code.google.com/p/softflowd/)

Original creator:
Damien Miller

Current maintainer:
Hitoshi Irino