Skip to content

Commit

Permalink
add README
Browse files Browse the repository at this point in the history
  • Loading branch information
Martin Vit committed May 4, 2010
1 parent 07b0017 commit 2f30d99
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 0 deletions.
1 change: 1 addition & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
* text=auto !eol
/Makefile -text
/README -text
/calltable.cpp -text
/calltable.h -text
/cdrtable.sql -text
Expand Down
44 changes: 44 additions & 0 deletions README
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
What is VoIPmonitor
-------------------

VoIPmonitor is open source live network packet sniffer which analyze SIP
and RTP protocol. It can run as daemon or analyzes already captured pcap
files. For each detected VoIP call voipmonitor calculates statistics about
loss, burstiness, latency and predicts MOS (Meaning Opinion Score) according
to ITU-T G.107 E-model. These statistics are saved to MySQL database and each
call is saved as pcap dump. Web PHP application (it is not part of open
source sniffer) filters data from database and graphs latency and loss
distribution. Voipmonitor also detects improperly terminated calls when
BYE or OK was not seen. To accuratly transform latency to loss packets,
voipmonitor simulates fixed and adaptive jitterbuffer.

Key features
------------

- Fast C++ SIP/RTP packet analyzer
- Predicts MOS-LQE score according to ITU-T G.107 E-model
- Detailed delay/loss statistics stored to MySQL
- Each call is saved as standalone pcap file

What is required
----------------

- C and C++ compiler (gcc,g++)
- libpcap-dev package (almost in every linux distribution)
- MySQL++ library from http://tangentsoft.net/mysql++/


Compile
-------

This howto is for Debian Lenny and Etch (for Debian sarge, change libmysqlclient15-dev to libmysqlclient14-dev)

apt-get install libpcap-dev libmysqlclient15-dev
wget http://tangentsoft.net/mysql++/releases/mysql++-3.0.9.tar.gz
tar xzf mysql++-3.0.9.tar.gz
cd mysql++-3.0.9
./configure
make install
cd ../voipmonitor
make
make install

0 comments on commit 2f30d99

Please sign in to comment.