Remove mentions of Auth-Type = System from docs
[freeradius.git] / man / man5 / users.5
index ee536b5..4c63366 100644 (file)
@@ -1,11 +1,23 @@
+.\"     # DS - begin display
+.de DS
+.RS
+.nf
+.sp
+..
+.\"     # DE - end display
+.de DE
+.fi
+.RE
+.sp
+..
 .TH USERS 5 "04 Jan 2004" "" "FreeRADIUS user authorization file"
 .SH NAME
 users \- user authorization file for the FreeRADIUS server
 .SH DESCRIPTION
-The \fBusers\fP file resides in the RADIUS database directory, by
-default \fB/etc/raddb\fP.  It contains a series of configuration
-directives which are used by the \fIfiles\fP module to decide how to
-authorize and authenticate each user request.
+The \fBusers\fP files reside in the files module configuration directory,
+by default \fB/etc/raddb/mods-config/files/\fP.  It contains a series
+of configuration directives which are used by the \fIfiles\fP 
+module to decide how to authorize and authenticate each user request.
 
 Every line starting with a hash sign
 .RB (' # ')
@@ -16,7 +28,7 @@ empty) list of check items, all on one line.  The next line begins
 with a tab, and a (possibly empty) list of reply items.  Each item in
 the check or reply item list is an attribute of the form \fBname =
 value\fP.  Multiple items may be placed on one line, in which case
-they must be seperated by commas.  The reply items may be specified
+they must be separated by commas.  The reply items may be specified
 over multiple lines, in which case each line must end with a comma,
 and the last line of the reply items must not end with a comma.
 
@@ -30,7 +42,7 @@ If the incoming request matches NO entry, then the request is
 rejected.
 
 .SH CAVEATS
-The special username \fBDEFAULT\fP matches any usernames.
+The special keyword \fBDEFAULT\fP matches any usernames.
 
 The entries are processed in order, from the top of the \fBusers\fP file,
 on down.  If an entry contains the special item \fBFall-Through =
@@ -131,22 +143,6 @@ a value less than, or equal to the one given.
 Not allowed as a reply item.
 
 .TP 0.5i
-.B "Attribute =~ Expression"
-As a check item, it matches if the request contains an attribute which
-matches the given regular expression.  This operator may only be
-applied to string attributes.
-.br
-Not allowed as a reply item.
-
-.TP 0.5i
-.B "Attribute !~ Expression"
-As a check item, it matches if the request contains an attribute which
-does not match the given regular expression.  This operator may only be
-applied to string attributes.
-.br
-Not allowed as a reply item.
-
-.TP 0.5i
 .B "Attribute =* Value"
 As a check item, it matches if the request contains the named
 attribute, no matter what the value is.
@@ -163,25 +159,13 @@ Not allowed as a reply item.
 .SH EXAMPLES
 
 .DS
-bob    User-Password == "bob"
+bob    Cleartext-Password := "hello"
 
 .DE
 .RS
 Requests containing the User-Name attribute, with value "bob", will be
-authenticated using the password "bob".  There are no reply items, so
-the reply will be empty.
-.RE
-
-.DS
-DEFAULT        Auth-Type = System
-.br
-       Fall-Through = Yes
-
-.DE
-.RS
-For all users reaching this entry, perform authentication against the
-system, unless Auth-Type has already been set.  Also, process any
-following entries which may match.
+authenticated using the "known good" password "hello".  There are no
+reply items, so the reply will be empty.
 .RE
 
 .DS
@@ -226,12 +210,11 @@ next.  Any DEFAULT entries should usually come last, except as fall-through
 entries that set reply attributes.
 
 .SH FILES
-/etc/raddb/users
+/etc/raddb/mods-config/files/
 .SH "SEE ALSO"
 .BR radclient (1),
 .BR radiusd (8),
 .BR dictionary (5),
-.BR naslist (5)
 
 .SH AUTHOR
 The FreeRADIUS team.