openmcu(1)

NAME
openmcu - simple Multi Conference Unit using H.323

SYNOPSIS
openmcu [options]...

DESCRIPTION

openmcu is a simple Mutli Conference Unit using the H.323 protocol. It sets up a H.323 listener process, and then waits for incoming connections. Whenever an incoming connection is established, it adds that call to the specified conference or to the default one if none is specified. You specify one on your H.323 client when you call the OpenMCU server with address "room_name@server_name", where room_name is the conference you want to join.

OPTIONS

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

-u, --username str
    Set the local endpoint name to str.

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

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

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

-i, --interface IP
    Only bind to the specified network interface address. By default, openmcu 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 openmcu 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.

--g711frames count
    Set the number of G.711 frames in capabilities to count. Defaults to 30.

--gsmframes count
    Set the number of GSM frames in capabilities to count. Defaults to 4.

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

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

--save
    Save arguments in configuration file.

-v, --video
    Enable H261 video handling.

--videolarge
    Set the video size from normal (176x144) to large (352x288).

--videotxquality n
    Set sent video quality to n, default is 9. n has to be between 1 (good) and 31.

--videofill n
    Set the number of updated background blocks per frame to n, default is 2. n has to be between 1 and 99.

--videotxfps n
    Set maximum number of transmited video frames per seceond to n, default is 10. n has to be between 1 and 30.

--defaultroom name
    Selects the default room name that will be used for connections that don't specify one, default is room101.

--no-defaultroom
    Reject connections with no room specified.

--disable-menu
    Disable the command line menu.

-h, --help
    Display the help message.

CONFIGURATION FILE

openmcu options can be set in the ohphone configuration file ~/.pwlib_config/openmcu.ini either by edditing this file or via the --save option. Options must be located in the section prefixed with [Options]. The long form of any command line option specified above can be specified in the configuration file, in the format:

option = value

INTERNAL MENU

Unless the --disable-menu option has been specified openmcu allows the user to perform various operations whilst running. These operations are accessed via single line commands which each start with a single character identifying the function. The available commands are:

?   Print the menu help.

v   Report which connections are at each video corner.

m   Make a call, which will be added to the default room.

x   Exit.

s   Report statistics.

z   Put message in log file (for debugging).

EXAMPLES

openmcu -n
    Start the program without registering with a gatekeeper.

FILES

~/.pwlib_config/openmcu.ini

BUGS

None that I know of.

SEE ALSO
None