---
name: "simph323"
section: "1"
platform: "linux"
package: "simph323"
version: "1.18.0.dfsg-10"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/simph323"
---

# simph323(1)

simple H.323 client given as an example

## 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