NAME

       portslave - terminal server program.

SYNOPSIS

       portslave [+config-file] port|-

DESCRIPTION

       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.

OPTIONS

       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 -

AUTHOR

       This  man  page  was written by Russell Coker <russell@coker.com.au>.  May be freely used and distributed
       without restriction.

SEE ALSO

       pslave.conf(5), pppd(8), ctlportslave(1) http://doc.coker.com.au/projects/portslave/

Russell Coker <russell@coker.com.au>               2010.03.30                                       portslave(8)