portslave(8)							     Portslave							      portslave(8)

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 spec-
       ify 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)