Large patch from Frank Cusack <fcusack@fcusack.com> to add proper
[ppp.git] / 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>