.\" manual page [] for RADIUS plugin for pppd 2.4.\" $Id: pppd-radius.8,v 1.5 2004/03/26 13:27:17 kad Exp $.\" SH section heading.\" SS subsection heading.\" LP paragraph.\" IP indented paragraph.\" TP hanging label.TH PPPD-RADIUS 8.SH NAMEradius.so \- RADIUS authentication plugin for.BR pppd (8).SH SYNOPSIS.B pppd[.I options]plugin radius.so.SH DESCRIPTION.LPThe RADIUS plugin for pppd permits pppd to perform PAP, CHAP, MS-CHAP andMS-CHAPv2 authentication against a RADIUS server instead of the usual.I /etc/ppp/pap-secretsand.I /etc/ppp/chap-secretsfiles..LPThe RADIUS plugin is built on a library called.B radiusclientwhich has its own configuration files (usually in \fI/etc/radiusclient\fR),consult those files for more information on configuring the RADIUSplugin.SH OPTIONSThe RADIUS plugin introduces one additional pppd option:.TP.BI "radius-config-file " filenameThe file.I filenameis taken as the radiusclient configuration file.  If this option is notused, then the plugin uses.I /etc/radiusclient/radiusclient.confas the configuration file..TP.BI "avpair " attribute=valueAdds an Attribute-Value pair to be passed on to the RADIUS server on each request..TP.BI map-to-ifnameSets Radius NAS-Port attribute to number equal to interface name (Default).TP.BI map-to-ttynameSets Radius NAS-Port attribute value via libradiusclient library.SH USAGETo use the plugin, simply supply the.B plugin radius.sooption to pppd, and edit.I /etc/radiusclient/radiusclient.confappropriately.  If you use the RADIUS plugin, the normal pppd authenticationschemes (login, checking the /etc/ppp/*-secrets files) are skipped.  TheRADIUS server should assign an IP address to the peer using the RADIUSFramed-IP-Address attribute..SH SEE ALSO.BR pppd (8) " pppd-radattr" (8).SH AUTHORDavid F. Skoll <dfs@roaringpenguin.com>