This optional parameter allows you to define a Perl hook that
runs when a cached reply is about to be returned to the NAS because of
CachePasswords.
The hook code is compiled by Perl when Radiator
starts up. Compilation errors in your hook code will be reported to the
log file at start-up time. Runtime errors in your hook will also be
reported to the log file when your hook executes. Multiline hooks (i.e.
with trailing backslashes (\)) are parsed by Radiator into one long line.
Therefore you should not use trailing comments in your hook.
The
hook can be an arbitrarily complicated Perl function, that might run
external processes, consult databases, change or set up environment
variables, umasks etc.
The arguments passed to the hook are:
- Argument 0 is the object handle for this AuthBy object.
- Argument 1 is the user name being authenticated.
- Argument 2 is the received request packet.
- Argument 3 is the cached reply packet that is about to be returned
to the NAS.
