README
1 Traff - Traffic Accounting Program
2 Version 0.7
3
4WHAT IS IT?
5
6 Traff is a program that attaches itself to one or more network interfaces,
7 sniffs all IP-packages passing at it and accounts each packets size. The collected
8 information can be dumped to a mysql-Database, for further processing.
9
10
11HOW DOES IT WORK?
12
13 The whole thing about Traff, is that you can specify for what IP you want to account
14 the traffic, and even for what IPs talking with which peer. This means, that if you
15 have a big up-link and you want to discover how much each or some hosts on your network
16 are using this up-link, you can do that without caring about the other IP, as other
17 programs do. So much less data will be stored at your database.
18 The program runs as a daemon and periodically will dump all information collected to the
19 database, syslog or a file.
20
21
22UPDATE
23
24 Update-information can be found in file UPDATE
25
26
27INSTALLATION / PRECONDITIONS
28
29 The script is being developed under Debian running kernel 2.6.x, but it should run on different
30 kernel versions and different distributions. You must pay attention if you compile your kernel.
31 keep in mind that the option CONFIG_PACKET must be compiled in. Generally, if tcpdump works, Traff
32 should work as well.
33 What you will need is pcap- and optionally Mysql- and PgSQL- libraries and header files to compile Traff.
34 If all preconditions are met you can begin by
35
36 1. Unpacking the sources
37 2. Run ./configure -- you may want to run ./configure --help to enable options: --enable-mysql --enable-postgresql
38 5. Type make install
39 Make install will copy binary files to /usr/local/bin. If you don like this, edit
40 the Makefile or install manually.
41 6. Change the configuration-file /etc/traff.conf to suit to your needs
42 7. Start traff.
43
44 8. -Optionally-
45 There is a initd-script for traff called traff.initd. This script was intended to run
46 on Debian systems. You my need to change it if you use another distribution. With this script
47 you can configure you system to start traff at boot-time. Please remember to start traff only
48 _after_ you set up your network.
49
50
51BUGS/UPDATES
52
53 Please report any bugs directly to me via email. Updates and new versions can be obtained
54 at the projects repository at sourceforge.net.
55
56 For the very new versions use the CVS-Versions. Information about this can also be obtained at
57 the projects repository at sourceforge.net.
58
59
60CONTRIBUTIONS
61
62 Contributions are welcome. Please sent to to us via email.
63
64TODO
65 - Test it and see if it works correctly :)
66
67COPYRIGHT
68
69 Copyright (C) 2001 - Hans Marcus Kr�ger <hanskruger@iname.com>,
70 Matthew Dormer <mdormat@users.sourceforge.com>
71
72 This program is free software; you can redistribute it and/or modify
73 it under the terms of the GNU General Public License as published by
74 the Free Software Foundation; either version 2 of the License, or
75 (at your option) any later version.
76
77 This program is distributed in the hope that it will be useful,
78 but WITHOUT ANY WARRANTY; without even the implied warranty of
79 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
80 GNU General Public License for more details.
81
82 You should have received a copy of the GNU General Public License
83 along with this program; if not, write to the Free Software
84 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
85
86 The authors can be reached via email addresses above
87
88
89