Note that the command-line debugging option "-X" overrides this option, and forces all logging to go to stdout.

Default:

destination = files

Log File Location

If the destination == "files", then the logging messages for the server are appended to the tail of this file. Again, note that if the server is running in debugging mode, this file is NOT used.

Default:

file = ${logdir}/radius.log

Requests Log

If this configuration parameter is set, then log messages for a request go to this file. This is a log file per request, once the server has accepted the request as being from a valid client. Messages that are not associated with a request still go to radius.log defined above.

Note that not all log messages in the server core have been updated to use this new internal API. As a result, some messages will still go to radius.log. Patches are welcome to fix this behavior.

The file name is expanded dynamically. You should ONLY user server-side attributes for the filename, i.e. things you control. Using this feature MAY also slow down the server substantially, especially if you do things like SQL calls as part of the expansion of the filename.

The name of the log file should use attributes that don't change over the lifetime of a request, such as User-Name,
Virtual-Server or Packet-Src-IP-Address. Otherwise, the log messages will be distributed over multiple files.

Default (disabled):

requests = ${logdir}/radiusd-%{%{Virtual-Server}:-DEFAULT}-%Y%m%d.log

Syslog Facility

This option determines which syslog facility to use, if destination == "syslog" The exact values permitted here are OS-dependent.

Default:

syslog_facility = daemon

Log User-Name Attribute

Log the full User-Name attribute, as it was found in the request. The allowed values are: {no, yes}