EURACOM(8) GNU EURACOM(8) NAME euracom - handle incoming charging information SYNOPSIS euracom [-f] [-h] [-l log-file] [-p protocol-file] [-d level] [-u {#uid|name}] [-H db-host-name] [-D db-name] [-P db-IP-Port-number] [-R sec.] [-S sec.] [--help] [--debug[=level]] [--protocol-file=file] [--log-file=file] [--no-daemon] [--run-as-user={#uid|name}] [--db-shutdown- timeout=sec] [--db-recovery-timeout=sec] [--db-port=port] [--db-name=name] [--db-host=host] DESCRIPTION euracom is a logging tool for incoming charge advises from a PBX-device (AKA german "Telephon-Anlage"). It is written to fit the output of PBX devices manufac- tured by Ackermann, Germany. There are some clones with nearly identical firmware. So this tool is also known to work with the Quante IS-{1,2,3}. euracom takes the charge advises from the serial printer output of the PBX and enters them into a SQL-database. At the moment PostgreSQL, mSQL and MySQL DMBS are sup- ported. OPTIONS -h, --help Gives a verbose help message containing all valid program options. -f, --no-daemon Keeps euracom from detaching of the controlling tty and stays in foreground. -u, --run-as-user=#uid|name Run as user uid (or username, resp.). If euracom is started from a run-time-shell-script (eg. rc.local) it's run as super-user. This gives you the option to detach from the super-user's id to the id given in this option. -d, --debug[=level] Sets debugging level. Values are 1--10. A value of 5 is the default. -p file, --protocol-file=file Enable logging all RS232 messages. All incoming RS232 messages are put unchanged into the given file. -l file, --log-file=file File where to write log and debug messages into. This file contains all other messages from euracom except the RS232 messages. -S, --db-shutdown-timeout=sec Disconnect after sec idle seconds from the database. The default timeout is 120 seconds; it's compile-time configurable in config.h. -R, --db-recovery-timeout=sec Time to stay in recovery mode. Hold the connection to the database for sec idle seconds in recovery mode. The default timeout is 900 seconds; it's com- pile-time configurable in config.h. -P, --db-port=port Sets TCP/IP port number to the database. -D, --db-name=name Database name to connect to. By default euracom connects to a database named "isdn". This can be changed by this option with argument name . -H, --db-host=host Database host name to connect to the database is given with argument name . By default euracom con- nects to the host localhost for the DBMS server. FILES /usr/local/sbin/euracom BUGS One of the weak points of this software is the V24-related stuff. Make sure your connection to the PABX is working properly. This software is running without major problems for quite a while in my house. I've heared of several other people that it's working properly, so I don't expect any severe bugs. However, if you think something's wrong, don't hes- itate and contact me! AUTHOR Michael Bussmann Volker Schmidt , (original man-page, more annoying idea, bug-reports, gen- eral craziness) Michael Tepperis , (miniSQL support) Stefan Schorsch , (MySQL support) SEE ALSO http://www.fgan.de/~bus/personal/euracom/ (Official down- load site) Linux Serial Port Programming mini-HOWTO iX issue 1995-1 p.152 ff. http://www.PostgreSQL.org/ http://www.hughes.com.au/ MB's Telephone Tools 1998-09-08 EURACOM(8)