pppd/plugins/radius/pppd-radius.8

   1 .\" manual page [] for RADIUS plugin for pppd 2.4
   2 .\" $Id: pppd-radius.8,v 1.1 2002/01/22 16:03:00 dfs Exp $
   3 .\" SH section heading
   4 .\" SS subsection heading
   5 .\" LP paragraph
   6 .\" IP indented paragraph
   7 .\" TP hanging label
   8 .TH PPPD-RADIUS 8
   9 .SH NAME
  10 radius.so \- RADIUS authentication plugin for
  11 .BR pppd (8)
  12 .SH SYNOPSIS
  13 .B pppd
  14 [
  15 .I options
  16 ]
  17 plugin radius.so
  18 .SH DESCRIPTION
  19 .LP
  20 The RADIUS plugin for pppd permits pppd to perform CHAP and PAP authentication
  21 against a RADIUS server instead of the usual
  22 .I /etc/ppp/pap-secrets
  23 and
  24 .I /etc/ppp/chap-secrets
  25 files.
  26 .LP
  27 The RADIUS plugin is built on a library called
  28 .B radiusclient
  29 which has its own configuration files (usually in \fI/etc/radiusclient\fR),
  30 consult those files for more information on configuring the RADIUS
  31 plugin
  32
  33 .SH OPTIONS
  34 The RADIUS plugin introduces one additional pppd option:
  35 .TP
  36 .BI "radius-config-file " filename
  37 The file
  38 .I filename
  39 is taken as the radiusclient configuration file.  If this option is not
  40 used, then the plugin uses
  41 .I /etc/radiusclient/radiusclient.conf
  42 as the configuration file.
  43
  44 .SH USAGE
  45 To use the plugin, simply supply the
  46 .B plugin radius.so
  47 option to pppd, and edit
  48 .I /etc/radiusclient/radiusclient.conf
  49 appropriately.  If you use the RADIUS plugin, the normal pppd authentication
  50 schemes (login, checking the /etc/ppp/*-secrets files) are skipped.  The
  51 RADIUS server should assign an IP address to the peer using the RADIUS
  52 Framed-IP-Address attribute.
  53
  54 .SH SEE ALSO
  55 .BR pppd (8) " pppd-radattr" (8)
  56
  57 .SH AUTHOR
  58 David F. Skoll <dfs@roaringpenguin.com>