gems-server(1) Transmit a shell session in real time.


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

gems-server -h -v


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.


IP address where connections will be accepted.
TCP port. Default: 6666.
Do not accept more than n simultaneous clients. Default: 25.
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.
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).
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.
Specifies the location of the script(1). program. Default: /usr/bin/script.
Show a short help message.
Show version information.


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.


Diego Essaya <[email protected]>

Emiliano Castagnari <[email protected]>