man/man5/rlm_unix.5

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