document rlm_otp fd leak fix
[freeradius.git] / man / man5 / rlm_unix.5
1 .TH rlm_unix 5 "17 February 2005" "" "FreeRADIUS Module"
2 .SH NAME
3 rlm_unix \- FreeRADIUS Module
4 .SH DESCRIPTION
5 The \fIrlm_unix\fP module reads crypt(3) passwords from the system
6 password file, and allows the server to use them for authentication.
7 The module also provides FreeRADIUS an interface into a radwtmp file
8 (used by "radlast") when added to the accounting section.
9 .PP
10 The \fIrlm_unix\fP module does provides the functionality for
11 "Auth-Type = System".  The module should be listed in the
12 "authenticate" section.  Please see the default \fIradiusd.conf\fP
13 shipped with the server for an example of the correct usage of this
14 module.
15 .PP
16 As of FreeRADIUS 1.1.0, the module no longer reads, or caches
17 /etc/passwd, /etc/shadow, or /etc/group.  If you wish to cache those
18 files, see \fIrlm_passwd\fP.  Most, if not all, configurations should
19 not need those files to be cached.
20 .PP
21 The main configuration items to be aware of are:
22 .IP radwtmp
23 The path to the system wtmp file to be used for keeping the database
24 of online users as read by the 'radlast' program.
25 .SH CONFIGURATION
26 .PP
27 .DS
28 modules {
29   ...
30 .br
31   unix {
32 .br
33     radwtmp = ${logdir}/radwtmp
34 .br
35   }
36 .br
37   ...
38 .br
39 }
40 .DE
41 .PP
42 .SH SECTIONS
43 .BR authentication,
44 .BR accounting
45 .PP
46 .SH FILES
47 .I /etc/raddb/radiusd.conf,
48 .PP
49 .SH "SEE ALSO"
50 .BR radiusd (8),
51 .BR radiusd.conf (5),
52 .BR rlm_passwd (5),
53 .BR radlast (1)
54 .SH AUTHORS
55 Chris Parker, cparker@segv.org