From: Matthew Newton Date: Tue, 15 Jan 2019 10:11:27 +0000 (+0000) Subject: Clarify documentation on how hints works X-Git-Tag: release_3_0_18~82^2~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=369c29ef56c0481d0da404f2386fa18d3c600ffd;p=thirdparty%2Ffreeradius-server.git Clarify documentation on how hints works --- diff --git a/raddb/mods-config/preprocess/hints b/raddb/mods-config/preprocess/hints index f92ffb9f1e5..84d4d78d5dc 100644 --- a/raddb/mods-config/preprocess/hints +++ b/raddb/mods-config/preprocess/hints @@ -1,6 +1,7 @@ -# hints # -# The hints file. This file is used to match +# hints +# +# The hints file. This file is used to match # a request, and then add attributes to it. This # process allows a user to login as "bob.ppp" (for example), # and receive a PPP connection, even if the NAS doesn't @@ -12,10 +13,10 @@ # attributes, just like in the "users" file. # These attributes operate ONLY on the username, though. # -# Note that the attributes that are set for each -# entry are _NOT_ passed back to the terminal server. -# Instead they are added to the information that has -# been _SENT_ by the terminal server. +# Note that the attributes that are set for each entry are +# NOT added to the reply attributes passed back to the NAS. +# Instead they are added to the list of attributes in the +# request that has been SENT by the NAS. # # This extra information can be used in the users file to # match on. Usually this is done in the DEFAULT entries, @@ -28,7 +29,15 @@ # A special non-protocol name-value pair called "Hint" # can be set to match on in the "users" file. # -# The following is how most ISPs want to set this up. +# As with the "users" file, the first entry that matches the +# incoming request will cause the server to stop looking for +# more hints. If the "Fall-Through" attribute is set to +# "Yes" in an entry then the server will not stop, but +# continue to process further hints from the file. Matches +# on subsequent hints will be against the altered request +# from the previous hints, not against the original request. +# +# The following is how most dial-up ISPs want to set this up. # # Version: $Id$ #