"documentation" is "useful"

diff --git a/raddb/radiusd.conf.in b/raddb/radiusd.conf.in
index d3d1f00126c54acde6f610cc5641d71ef6b31643..726e0e38ded8f0e54ccbc089fc362b70f54d1e86 100644 (file)
--- a/raddb/radiusd.conf.in
+++ b/raddb/radiusd.conf.in
@@ -323,6 +323,60 @@ log {
        msg_denied = "You are already logged in - access denied"
 }
 
+# ENVIRONMENT VARIABLES
+#
+#  You can reference environment variables using an expansion like
+#  $ENV{PATH}.  However it is sometimes useful to be able to also set
+#  environment variables.  This section lets you do that.
+#
+#  The main purpose of this section is to allow administrators to keep
+#  RADIUS-specific configuration in the RADIUS configuration files.
+#  For example, if you need to set an environment variable which is
+#  used by a module.  You could put that variable into a shell script,
+#  but that's awkward.  Instead, just list it here.
+#
+#  Note that these environment variables are set AFTER the
+#  configuration file is loaded.  So you cannot set FOO here, and
+#  expect to reference it via $ENV{FOO} in another configuration file.
+#  You should instead just use a normal configuration variable for
+#  that.
+#
+ENV {
+
+       #
+       #  Set environment varable 'FOO' to value '/bar/baz'.
+       #
+       #  Note that you MUST use '='.  You CANNOT use '+=' to append
+       #  values.
+       #
+#      FOO = '/bar/baz'
+
+       #
+       #  Delete environment variable BAR.
+       #
+#      BAR
+
+       #
+       #  LD_PRELOAD is special.  It is normally set before the
+       #  application runs, and is interpreted by the dynamic linker.
+       #  Which means you cannot set it inside of an application, and
+       #  expect it to load libraries.
+       #
+       #  Since this functionality is useful, we extend it here.
+       #
+       #  You can set
+       #
+       #       LD_PRELOAD = /path/to/library.so
+       #
+       #  and the server will load the named libraries.  Multiple
+       #  libraries can be loaded by specificing multiple individual
+       #  LD_PRELOAD entries.
+       #
+       #
+#      LD_PRELOAD = /path/to/library1.so
+#      LD_PRELOAD = /path/to/library2.so
+}
+
 # SECURITY CONFIGURATION
 #
 #  There may be multiple methods of attacking on the server.  This