
vomit(1)		    System Reference Manual		      vomit(1)

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 an IP phone conversation into a wave file that
     can be played with ordinary sound players.	 The phone 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
     phone.dump.

ERRORS
     vomit works only for Cisco IP phones that use the skinny station protocol

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

AUTHORS
     The vomit utility has been developed by Niels Provos.

BSD Experimental		April 13, 2001				     1
