tool-server.rst

Server

.. program:: server

Synopsis

:samp:`rsb server {[OPTIONS]} {URI}*`

Description

Run a server which accepts and services |project| :ref:`socket <specification-socket>` :term:`transport` clients according to :samp:`{URI}s` until terminated.

The :ref:`usual commandline options <common-options>` are accepted.

Examples

• $ rsb server

  In the above example, unless the |project| :ref:`configuration` is non-default, the :program:`server` command accepts :ref:`socket <specification-socket>` connections on the default port.

• $ rsb server 'socket://localhost:0?portfile=/tmp/port.txt'

  In the above example, the :program:`server` command accepts :ref:`socket <specification-socket>` connections on an available port which is written into the file :file:`/tmp/port.txt` after it has been chosen.

  Note

  Note the use of single quotes (') to prevent the shell from interpreting syntactically relevant characters in the URI.

Implementations

Implementation Language	Project	Repository Link
Common Lisp	rsb-tools-cl	|repository_versioned_tools_cl|