simph323(1)

NAME
simph323 - simple H.323 client given as an example

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

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

SEE ALSO
None