GEMS-SERVER(1)

NAME
gems-server - Transmit a shell session in real time.

SYNOPSIS
gems-server [-ip ip] [-port p] [-maxconn n] [-wait m] [-log dest] [-noscript] [-script_bin script]

gems-server -h | -v

DESCRIPTION
Transmits a shell session to be shown in real time in various different computers or terminals.

gems-server transmits data in real time to clients via a network connection. Each one of these clients must run the gems-client(1) program to establish connection and receive the transmitted data. Clients can connect and disconnect at any given time, but of course they will only receive the data that is transmitted while they are connected (just like a radio transmission/reception system).

The gems system is normally used to transmit a console session and show it in various computers at the same time, but it is also possible to transmit any other kind of data.

OPTIONS

-ip IP address where connections will be accepted.

-port
    TCP port. Default: 6666.

-maxconn
    Do not accept more than n simultaneous clients. Default: 25.

-wait
    Wait until m clients are connected before starting the transmission. This is useful to ensure that the first m clients will receive all data transmitted. The default behavior is to start transmission immediately, without waiting for client connections.

-log
    By default, the server does not write log messages. This option configures the destination of logs. The dest argument can be `syslog' (to log through syslogd(8)), `stderr' (to log through standard error output), or it can be an arbitrary filename (log messages will be appended to the file, if it exists).

-noscript
    By default, the server executes the script(1) program to take terminal data and transmit it. When this option is used the server will not run script, and data will be read form standard input.

-script_bin
    Specifies the location of the script(1). program. Default: /usr/bin/script.

-h  Show a short help message.

-v  Show version information.

FILES

/var/lock/gems-server.PORT
    Lock file. gems-server creates this file on initialization and deletes it on exit. PORT is replaced by the TCP port used. gems-server will not run if this file is already present in the system.

AUTHORS
Diego Essaya <dessaya@fi.uba.ar>

Emiliano Castagnari <ecastag@fi.uba.ar>

SEE ALSO
gems-client(1), script(1), syslogd(8)