cyclades-ser-cli(8) cyclades-ser-cli(8)
NAME
cyclades-ser-cli Serial Port Interface for Cyclades Terminal Servers
SYNOPSIS
cyclades-ser-cli [options] devname rasname physport
DESCRIPTION
The cyclades-ser-cli program connects a Unix device file 'devname' to a physical port 'physport' of a Cyclades Terminal Server 'rasname'.
cyclades-ser-cli provides the I/O interface between the device file and the physical port, running as an 'user-mode device driver'.
If 'physport' is assigned to 0, then 'rasname' is used as the IP address on an IP-based serial port addressing.
OPTIONS
cyclades-ser-cli may be started with the following options:
-u ptyiosize
Sets the internal device I/O size to ptyiosize (maximum 4096 bytes, default 1024 bytes)
-n netiosize
Sets the internal socket I/O size to netiosize (maximum 512 bytes, default 128 bytes)
-i retrydelay
Delay in seconds between connection requests (default: 60)
-r retries
Number of connection request retries before exiting. (default: infinity)
-s Use the Socket Server protocol for talking to the server, this means just piping all the data down a TCP connection with no control
information, so it's impossible to change the port speed etc. The default is to use the RFC2217 protocol.
-m modem handling
The default is 0 which means to check DCD state, 1 means to ignore DCD.
-c close mode
Last close handling; the default is 0 which means to hangup the modem, 1 means not to hangup.
-p start port
TCP base port of servers at terminal server side (defaults: 31000 for Socket server, 30000 for Remote Telnet Server). Note: if
'physport' is assigned to zero, this option has no effect, the Telnet Server standard port (23) is used.
-d debug level
The default is debug level 0 (little debugging), level 1 debugs internal state changes, level 2 debugs events, and level 3 debugs IO
calls.
-f Run in foreground, this is suitable for running from init.
-x Console mode: normally all messages are sent to syslogd (using local2 facility). With this option, all messages will be sent to std-
out and cyclades-ser-cli runs in the foreground. This implies -f
USE
Every instance of cyclades-ser-cli will have a virtual serial device which is a sym-link to a pseudo-tty. A terminal program can then talk
to the virtual serial device and it's data transfers will be redirected across the network. Each virtual serial device will be accompanied
by a Unix domain socket with the same name with the addition of ".control". So if cyclades-ser-cli provides the virtual device named
"/dev/modem" then it will have a control socket named "/dev/modem.control". There is a shared object named libcyclades-ser-cli.so which
intercepts calls to the tcsetattr() and tcsendbreak(). This shared object then sends the relevant data to the cyclades-ser-cli server via
the control socket. To recognise a virtual modem device it has to read /etc/cyclades-devices.
The libcyclades-ser-cli.so shared object can be loaded per-application through the LD_PRELOAD environment variable, or for the entire sys-
tem through the system shared object configuration (see the OS documentation). Note that the LD_PRELOAD environment variable has to have
the fully qualified path of the object, otherwise an application which changes it's current directory may fail.
BUGS
In Solaris libcyclades-ser-cli.so does not work with the stty program. stty uses a different interface to this and requires some extra
coding.
In Solaris libcyclades-ser-cli.so conflicts with some system programs such as ps for unknown reasons. Just don't load it for those pro-
grams, it has no such problems with any serial comms programs.
EXAMPLES
Start an interface between /dev/prt1 device and a serial port number 10 of a Terminal Server named pr01, without hangup at last close:
cyclades-ser-cli -c 1 /dev/prt1 pr01 10
In general use do not start cyclades-ser-cli from the command line, start it through the cyclades-serial-client script or from init.
SEE ALSO
cyclades-serial-client(1), cyclades-devices(5)
cyclades-ser-cli(8)