VOIP program

Development Platform:
Visual C++

README.txt：Code Content
							Notes for OpenAM
----------------
Craig Southeren, 24 October 1999
1. Introduction
---------------
OpenAM is a simple answering machine using the H.323 protocol. It required the OpenH323
library - see http://www.openh323.org for more information. It is known to run on Linux
and Solaris. If you run the program successfully on another platform, then please send an
email to openh323@openh323.org
2. Features
-----------
The code contains the following features:
- requires no codec hardware to operate
- currently supports G.711 and GSM codecs
- can accept multiple connections simultaneously
- generates a call log containing full information about each call
- runs a user defined program after each call, which can be used to
automatically send the recorded message as a MIME encoded email
attachment to a known email address
- can limit the the length of recorded messages
- automatically cleans up recorded voice files
4. Operation
------------
OpenAM works by setting up a H.323 listener process, and then waiting for incoming connections.
Whenever an incoming connection is established, it plays the outgoing message (OGM) and then starts
recording any incoming audio from the remote end into a record file.
When the client hangs up, or the maximum record time is reached, the connection is broken, and
the record file is closed. The optional user program is called is with the following parameters:
  name of file containing recorded voice data
  string describing the address of the client that initiated the call
  the username of the remote party
  the duration of the call, in seconds
  a string describing the codecs used during the call
  the vendor description of the remote endpoint software
A record is then written to the call log file, and the record deleted if necessary.
If the client hangs up before the OGM is finished, then no record file is created and
the user program is not called. A call log record is still generated.
3. Command line options
-----------------------
OpenAM has the following command line options:
-d dir
--directory dir       Set the directory that record files are created in
-l secs
--limit secs          Limit recorded messages to secs duration (default 30)
-m fn
--message fn          Set outgoing message to fn
-n
--nodelete            Do not delete record files after processing
-r cmd
--run cmd             Run this command after each recorded message
-u str
--username str        Set the local endpoint name to str. Default is "OpenH323 Answering Machine vxxx"
-t
--trace               Enable debug trace, use multiple times for more detail
-o fn
--output fn           File for trace output, default is stderr
-h
--help                Display this help message
4. OGM and record file formats
------------------------------
The OGM and record files are stored as raw 8000 hz, 16-bit signed PCM data.
The easiest way to manipulate these files is by first converting them to .WAV format
using the sox package. Sox uses the extension .sw to identify this specific format, so
this is what OpenAM uses, too
To convert a 8000 hz .WAV file to .sw format, just use:
	sox sample.wav sample.sw
the reverse works to convert .sw files to .WAV
The same technique applies for .au files
5. User programs
----------------
OpenAM can be configured to call a user program after finishing the recording of any message. The
most common usage of this feature is to send the voice data as an email attachment to a known email
address. A sample shell script called "new_msg" is provided that will do this. See this script for
more information. 
In order to run this script you will need the following packages:
mimencode	part of the metamail package - ftp://thumper.bellcore.com/pub/nsb
sox		see http://home.sprynet.com/~cbagwell/sox.html
These are normally available on most Linux systems, but I had to find them and install them on my Solaris system
                              ------------------------

						