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 PAP negotiation.

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 other things.

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 /usr/sbin/portslave

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 <russell@coker.com.au>. May be freely used and distributed without restriction.

pslave.conf(5), pppd(8), ctlportslave(1)