simph323(1) simple H.323 client given as an example


simph323 -l|--listen [options]...

simph323 [options]... address


simph323 is a command line application that is given as an example of what you can do with openh323, it is a simple h323 client that can be used to listen for incoming H.323 calls, or to initiate a call to a remote host, however, if you want a real h323 client I'd suggest you check out ohphone.

simph323 includes a really simple prompt where you can pick up incoming calls or reject them as they arrive, also hang up active calls (with the h command) and exit the program (with the x command).

When used with the -l option, simph323 will wait for incoming calls. If this option is not specified, simph323 expects a hostname to be specified and will attempt to connect to a H.323 client at that address.


All of the command line options to simph323 can be specified in long form, and the most commonly used options also have single character equivalents.

-a, --auto-answer
Automatically answer incoming calls.

-b, --bandwidth bps
Limit bandwidth usage reported to gatekeeper to bps bits/second.

-D, --disable codec
Disable the specified codec (may be used multiple times).

-f, --fast-disable
Do not request H323V2 FastConnect when initiaiting a connection.

-B, --forward-busy party
Forward the call to the remote party if busy.

-g, --gatekeeper host
Upon startup, register only with the specified gatekeeper rather than attempting to find a gatekeeper by using UDP broadcast.

-T, --h245tunneldisable
Do not perform H245 tunneling when initiating a connection.

-h, --help
Show help message.

-i, --interface interface
Only bind to the specified network interface address. By default, simph323 automatically listens for incoming calls on all TCP/IP network interfaces available on the host machine. This option is useful for running multiple copies of simph323 on the same multi-homed machine, or for ensuring that only calls from the external, or internal, network will be received on a particular handset.

-j, --jitter delay
Set jitter buffer to delay ms. By default, the jitter buffer is set to 50 ms.

-l, --listen
Listen for incoming calls.

-n, --no-gatekeeper
Do not attempt to find a gatekeeper upon startup using UDP broadcast.

-o, --output filename
Write trace output (enabled with the -t option) to the specified file rather than to stderr.

-P, --prefer codec
Prefer the specified codec (may be used multiple times).

-r, --require-gatekeeper
Exit if a gatekeeper cannot be found.

-e, --silence
Disable silence detection and removal for GSM and software G.711.

-s, --sound device
Select the sound input and output device. The default value is /dev/dsp0.

--sound-in, --sound-out device
Select the sound input or output device seperately. Only needed if different sound devices are needed for input and output.

-t, --trace
Enable debug tracing, which displays messages at run-time to assist in debugging or problem identification. Specifying this option multiple time increases the amount of information displayed. simph323 has trace statements up to level 5. Use the -o option to write the trace information to a file rather than to stderr.

-u, --user name
Set local endpoint alias name. Can be used multiple times to add multiple aliases. By default, the alias list contains a single entry with the current user's login name.


simph323 -l
Find a gatekeeper on the local network, register with it, and then listen for incoming calls.

simph323 -ln
Listen for calls without registering with a gatekeeper.

simph323 -n ipaddress
Make a call directly to another endpoint without using a gatekeeper