File Release Notes and Changelog
Release Name: 0.4.1
Notes:
ANTEATER README
===========================================================================
$Id: README,v 0.6 2003/03/22 20:23:21 drzoom Exp $
Install:
---------------------------------------------------------------------------
Follow the instructions in the "INSTALL" File to compile and install this
Tool. It's very easy:
Type:
./configure --prefix=/usr/local
make
and as root:
make install
Documentation:
---------------------------------------------------------------------------
You will find a german html-documentation in "anteater/docs/de" in this
distribution.
For a list of new features and changes, check first the "ChangeLog"
file in the distribution. And please read the "TODO" File too.
Run:
---------------------------------------------------------------------------
To get your first analyse you need the syslog with the sendmail entrys, and
the "aliases" file from the mailserver. Virtursetable and other important
configuration-files are not implemented but have a look to the source code:
it's very simple to add new features to this tool.
In this example, the sendmail logfile is in "/home/myself/maillog" and the
aliases file is in "/home/myself/aliases". Type this:
anteater --domain=yourdomain.xxx --aliases-file=/home/myself/aliases
--analyse-all --limit=50 --filter-file=/home/myself/maillog
--report-html --report-html-file=anteater_report.html
And you get all current implemented analyses in html. If you search for
a special parameter or more features, you can use the debug Parameter...
anteater -mhtml > allparameters.html
...to get a (big) list over all modules, parameters etc. in the current
Version of anteater. Or use...
anteater -m | less
...t get the same on the console.
Have Fun!
Tobias
Known "bugs" ...
---------------------------------------------------------------------------
FreeBSD (and older systems general):
To compile Anteater make sure using a newer compiler. Don't use the
"ports" this versions are alpha releases. Some users compiled Anteater
successful with "gcc-2.95.2". To upgrade your FreeBSD installation, use
this easy steps:
as normal user:
get the archive "gcc-2.95.2.tar.gz" from a local gnu mirror.
on a console type:
tar -xvzf gcc-2.95.2.tar.gz
mkdir newgcc
cd newgcc
../gcc-2.95.2/configure --prefix=/usr/local --enable-languages=c++
make bootstrap
now switch to the root user, and go to the same directory, ...
make install
cd /usr/bin
mv gcc gcc.o
mv g++ g++.o
mv c++ c++.o
mv c++filt c++filt.o
mv cpp cpp.o
ln -s /usr/local/bin/gcc gcc
ln -s /usr/local/bin/g++ g++
ln -s /usr/local/bin/c++ c++
ln -s /usr/local/bin/c++filt c++filt
ln -s /usr/local/bin/cpp cpp
ok, leave now the root user, and go back to your work user. Please
test your installation with this commands:
gcc -v
g++ -v
c++ -v
you should get the new versionsnumber (something with 2.95.2 inside).
Version 0.3 or later should compile without warnings or errors.
Contact:
---------------------------------------------------------------------------
Bugs, Support, Ideas, Patches, New analyses, reports etc. to
Tobias Erbsland <te@profzone.ch>
Changes:
ANTEATER CHANGELOG
=============================================================================
$Id: ChangeLog,v 0.9 2003/03/22 20:23:21 drzoom Exp $
== Changes with Anteater 0.4.1: =============================================
2003/03/22 | [ac] Patched the Code for gcc 3.x
| [dz] added the commandline option "-h" and the ascii version
| of the "-m" switch.
== Changes with Anteater 0.4: ===============================================
2001/05/24 | [dz] Cleaning of the whole code from any "legacy" c++
| constructions and headers. Now the whole code is using the
| "std" namespace.
| This because i saw that the current compilers (gnu) are now
| at the necessary level.
2001/05/24 | [dz] Tested the whole code with the free STLport successful.
== Changes with Anteater 0.3.4: =============================================
2000/04/30 | [eh] Added to CVS tree.
2000/04/20 | [dz] Added a new module "virtuser". Now, anteater read your
| "virtusertable" file with this option: --virtuser-file=xxx.
| This feature is a very fast hack, but it works.
== Changes with Anteater 0.3.3: =============================================
2000/04/18 | [dz] New Options in HTML Report --html-tableborder=xxx
| --html-disable-hr and the general parameter to redirect all
| output of a report to a file: --report-html-file=xxx.
| Please generate a new parameteroverview with the special
| parameter -mhtml to see all new features.
2000/04/18 | [dz] Added file headers.
2000/04/16 | [dz] The first Version of the HTML-Report should work.
| I'm thinking now about the missing _file_ header and footer
| for the essential Tag's. I think this is a Reason to
| expand the abstract Report Class with two new functions.
2000/04/16 | [dz] Removing some lines with debuging code. At the moment
| you _must_ set the report with the parameter --report-xxx.
| xxx can be "html" or "ascii" at the moment.
== Changes with Anteater 0.3.2: =============================================
2000/01/16 | [dz] New addressfilter "lowercase" to solve the problem with
| mixedcase addresses. New flag "--lowercase-disable" (...)
2000/01/16 | [dz] Add new flag --syslog-counter to enable the linecounter
| while reading the syslog file.
== Changes with Anteater 0.3.1: =============================================
2000/01/15 | [dz] Add new short commandline flags:
| -p/-phtml Generate a list of all parameters in the commandline
| or in a configuration file. The version with "html" generate
| the list in html.
| -mhtml Generate a overview of all modules in Anteater with
| parameters and current set values.
| -v Printout only the version and exit.
| -c/xxx/file.conf read parameters from a configuration file.
| see "clp.cpp".
2000/01/08 | [dz] rewriting the the complete commandline parser.
| The maingoal is, split the parser into smaller parts and
| improve the security. Add a new feature. You can now use
| doublequotes to all parameter values with whitespaces:
| --parameter="test text"
2000/01/08 | [dz] finaly "translating" the rest of the api documentation
| to poor english.
== Changes with Anteater 0.3: ===============================================
2000/01/07 | [dz] finaly add parameter "--dateformat=xxx".
| You can choose now the format of every datestring in Anteater
| by build a string with 3 up to 5 chars.
| The 10. December 1999 in different Notations:
| --dateformat=dmy -> 10121999
| --dateformat=d.m.y -> 10.12.1999
| --dateformat=y/m/d -> 1999/12/10
| Only the chars "dmy.-/" are allowed! If something is wrong in
| the date string, the default "d.m.y" is used.
2000/01/06 | [dz] library "strstream" is horror! my first plans to use
| this for formating datestrings are obsolete. The function
| sprintf from the c std lib is not better. And the better
| version of sprintf, snprintf is not protable. sh*t...
| any ideas?
| You can choose the usage of "strstram" with the configure
| option "--enable-strstream". But this is your own risk.
2000/01/06 | [dz] read the whole documentation of "autoconf" and create
| a safer configure with checks for all headers i use,
| for namespaces, pointer to memberfunctions and for the
| way i use maps, lists and strings.
2000/01/05 | [dz] new parameter "--filter-file=xxxx". With this you can
| choose the input method. from a file, or from stdin.
| Without this parameter, anteater expect datas from stdin.
| For your attention, if you get strange (odd) errors, use an
| absolute path.
2000/01/05 | [dz] add some text to the README file. Special a new
| Section about "Known 'Bugs'", for example the Problem
| with the old gcc compiler of FreeBSD and how to solve
| this problem.
2000/01/05 | [dz] reformat the TODO list in the same style like the
| ChangeLog here.
2000/01/05 | [dz] Change and supplement the comments in various header
| and source files. Removing some german comments.
2000/01/05 | [dz] Add new Parameter "--ascii-width=xx" to set the output
| of the ascii report between 79 and 500.
2000/01/05 | [dz] Fixing some bugs in "asciifilter.cpp".
| The month is in the range 0-11, add a "+1" in line 237.
2000/01/05 | [dz] Fixing some bugs in "poa.cpp".
| Missing & before pointer to membefunctions in lines
| 133, 138, 143, 148.
2000/01/05 | [dz] Reformating the Changelog for better human _and_
| computer readablity.
== Changes with Anteater 0.2: ===============================================
2000/01/03 | [dz] Changes in the german Documentation.
2000/01/03 | [dz] Add parameter --syslog-year=xxxx to set the starting
| year of the syslog file. In class syslogFilter.
2000/01/03 | [dz] Add code to get the current year, beacause the
| syslog format contains only day and month but no year. In
| class syslogFilter.
2000/01/03 | [dz] Add parameter --aliases-scramble for screenshots.
| Scrambles all names and Email Adresses.
2000/01/03 | [dz] Fixed fatal bug in class aliasesAddrFilter.
| Convert aliases to empty strings instead of the corect
| accountname.
2000/01/03 | [dz] Remove some unused code from class syslogFilter.
== Nametable: ===============================================================
[dz] = Tobias Erbsland <dz@profzone.ch>
== Changelog starts here with Version 0.1 of Anteater. ======================
