---
name: "gems-server"
section: "1"
platform: "linux"
package: "gems"
version: "1.1.1-2+b2"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/gems-server"
---

# gems-server(1)

Transmit a shell session in real time.

## 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)](/gems-client/1.md) 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)](/syslogd/8.md)), \`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)](/script/1.md) 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)](/script/1.md). 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)](/gems-client/1.md), [**script**(1)](/script/1.md), [**syslogd**(8)](/syslogd/8.md)