portslave - terminal server program.
portslave [+config-file] port|-
This manual page documents briefly the portslave, program.
This program is a getty replacement that will run it’s own version of
pppd, the user can specify their user-name via a login: prompt or PPP
After the username and password have been supplied the user will be
authenticated by the RADIUS protocol.
An optional first parameter is ’+config-file’ to specify an alternate
config file. The default is /etc/portslave/pslave.conf .
The next parameter is either the port number or ’-’. The value ’-’
means that portslave is to use it’s controlling tty as the serial
device and inspect the config file to find the RADIUS port number which
matches that. This was originally written for telnetd support (telnetd
puts a ’-’ as the first command line parameter) but can be used for
To run over the telnet protocol put a config entry similar to the
following in your inetd configuration:
telnet stream tcp nowait root /usr/sbin/tcpd /usr/sbin/in.telnetd -L
Then in the pslave.conf file put a series of entries specifying every
pseudo-tty device (either ptyp0, ptyp1, etc or pts/1, pts/2 etc
depending on which type of device naming you use). For the RADIUS port
numbers which are to be used for telnet connections you must specify
the initchat as an empty string.
If you want to run portslave over a clean TCP connection (no telnet
protocol) then put the following in your inetd configuration:
telnet stream tcp nowait root /usr/sbin/tcpd /usr/sbin/portslave -
This man page was written by Russell Coker <email@example.com>. May
be freely used and distributed without restriction.
pslave.conf(5), pppd(8), ctlportslave(1)
Russell Coker <firstname.lastname@example.org>010.03.30 portslave(8)