SYNOPSIS

simph323 [options]... address

DESCRIPTION

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.

OPTIONS

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.

EXAMPLES

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