rlm_files(5)		       FreeRADIUS Module		  rlm_files(5)



NAME
       rlm_files - FreeRADIUS Module

DESCRIPTION
       The  rlm_files module uses the 'users' file for accessing authorization
       information for users.  Additionally, it supports a 'users' file syntax
       to be applied to the accounting and pre-proxy sections.

       The main configuration items to be aware of are:

       usersfile
	      The filename of the 'users' file, which is parsed during the au-
	      thorization stage of this module.

       acctusersfile
	      The filename of the 'users' file, which is parsed during the ac-
	      counting stage of this module.

       preproxy_usersfile
	      The  filename  of  the  'users' file, which is parsed during the
	      pre_proxy stage of this module.

       compat This option allows FreeRADIUS to parse an old style Cistron syn-
	      tax.   The  default  is 'no'.  If you need to parse an old style
	      Cistron file, set this option to 'cistron'.

       key    This option lets you set the attribute to use as a key  to  find
	      entries.	  The	default  is  "%{%{Stripped-User-Name}:-%{User-
	      Name}}".	Note that the key MUST supply real data.  Dynamic  at-
	      tributes	like "Group" will not work, because the "Group" attri-
	      bute can only be used as a comparison, to see if a user is in  a
	      Unix  group.  It will not return the name of the Unix group that
	      a user is in.

       If you want to use groups as a key, see the rlm_passwd, which will cre-
       ate a real attribute that contains the group name.

       This  configuration  entry enables you to have configurations that per-
       form per-group checks, and return per-group attributes, where the group
       membership  is  dynamically defined by a previous module.  It also lets
       you do things like key off of attributes  in  the  reply,  and  express
       policies  like "when I send replies containing attribute FOO with value
       BAR, do more checks, and maybe send additional attributes".

CONFIGURATION
       modules {
	 ... stuff here ...
	 files {
	   usersfile = %{confdir}/users
	   acctusersfile = %{confdir}/acct_users
	   preproxy_usersfile = %{confdir}/preproxy_users
	   compat = no
	   key = %{%{Stripped-User-Name}:-%{User-Name}}
	 }
	 ... stuff here ...
       }

SECTIONS
       authorization, accounting, pre_proxy

FILES
       /etc/raddb/radiusd.conf,    /etc/raddb/users,	/etc/raddb/acct_users,
       /etc/raddb/preproxy_users

SEE ALSO
       radiusd(8), radiusd.conf(5), users(5)

AUTHORS
       Chris Parker, cparker@segv.org



				5 February 2004 		  rlm_files(5)