vomit

Langue: en

Version: 114009 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)


BSD mandoc

NAME

vomit - converts an IP phone conversation into a wave filee

SYNOPSIS

vomit [-h ] [-d dev ] [-p wavfile ] [-r file ] [filter ]

DESCRIPTION

The vomit utility converts a G.711 conversation into a wave file that can be played with ordinary sound players. G.711 is used by Cisco IP Phones and Microsoft Netmeeting. The conversation can either be played directly from the network or from a tcpdump(8) output file.

The options are as follows:

-h
Displays a short help for the command line options
-d dev
Specifies the network device from which packets should be read.
-p wavfile
Specified a wavfile that can be inserted into an ongoing phone conversation on the network. The wavfile must have a sample rate of 8 Khz and 16 bit samples.
-r file
Instead of reading packets from the network, the packets are read from a tcpdump(8) dump file.
filter
A valid pcap(3) filter that determines which packets contain a phone conversation.

The vomit utility is meant as a network debugging tool, and should be used only in accordance to your local laws. The playback is initiated by hitting return. Instead of just hitting return, it is possible to type the packets that should be skipped and the delay in milli seconds between playback packets. The values have to be comma separated.

Vomit uses libevent to simplify asynchronous event handling. You can find the source code for that library at

     http://www.monkey.org/~provos/libevent/
 

EXAMPLES

 vomit -r phone.dump | waveplay -S 8000 -B 16 -C 1
 

Plays back the phone conversation that has been captured in the dump file Fa phone.dump .

ERRORS

vomit works only for protocols that use G.711.

The public version does not support directly reading from the network or rewriting packet streams.

ACKNOWLEDGMENTS

This program contains wave file interpreting code from waveplay by Y.Sonoda, ulaw conversion code from Sun Microsystems and some pcap code from Dug Song.

AUTHORS

The vomit utility has been developed by Niels Provos.