Provided by: freeradius-common_2.1.10+dfsg-3_all bug

NAME

       radiusd.conf - configuration file for the FreeRADIUS server

DESCRIPTION

       The  radiusd.conf  file  resides  in  the radius database directory, by
       default /etc/raddb.   It  defines  the  global  configuration  for  the
       FreeRADIUS RADIUS server.

CONTENTS

       There  are  a  large number of configuration parameters for the server.
       Most are  documented  in  the  file  itself  as  comments.   This  page
       documents  only  the  format of the file.  Please read the radiusd.conf
       file itself for more information.

       The  configuration  file  parser   is   independent   of   the   server
       configuration.   This  means  that you can put almost anything into the
       configuration file.  So long as it is properly  formatted,  the  server
       will start.

       When  the server parses the configuration file, it looks only for those
       configurations it understands.  Extra configuration items are  ignored.
       This "feature" can be (ab)used in certain interesting ways.

FILE FORMAT

       The  file  format  is  line-based,  like  many other Unix configuration
       files.  Each entry in the file must be placed  on  a  line  by  itself,
       although continuations are supported.

       The  file  consists  of  configuration  items (variable = value pairs),
       sections, and comments.

       Variables
              Variables can be set via:

                   name = value

              Single and double-quoted strings are permitted:

                   string1 = "hello world"
                   string2 = 'hello mom'

       Sections
              A section begins with a section name, followed on the same  line
              by  an  open  bracket  '{'.  Section may contain other sections,
              comments, or variables.  Sections may be nested  to  any  depth,
              limited  only  by available memory.  A section ends with a close
              bracket '}', on a line by itself.

                   section {
                        ...
                   }

              Sections can sometimes have a second name  following  the  first
              one.   The situations where this is legal depend on the context.
              See the examples and comments in the radiusd.conf file for  more
              information.

                   section foo {
                        ...
                   }

       Comments
              Any  line beginning with a (#) is deemed to be a comment, and is
              ignored.  Comments  can  appear  after  a  variable  or  section
              definitions.

                   # comment
                   foo = bar # set variable 'foo' to value 'bar'
                   section { # start of section
                   ...
                   }         # end of section

       Continuations
              Long  lines can be broken up via continuations, using '\' as the
              last character of the line.  For example, the following entry:

                   foo = "blah \
                   blah \
                   blah"

              will set the value of the variable "foo" to  "blah  blah  blah".
              Any  CR  or  LF  is  not  turned  into  a  space,  but all other
              whitespace is preserved in the final value.

REFERENCES

       The  value  of  a  variable  can  reference  another  variable.   These
       references  are  evaluated when the configuration file is loaded, which
       means that there is  no  run-time  cost  associated  with  them.   This
       feature  is  most useful for turning long, repeated pieces of text into
       short ones.

       Variables are referenced  by  ${variable_name},  as  in  the  following
       examples.

            foo = bar       # set variable 'foo' to value 'bar'
            who = ${foo}    # sets variable 'who' to value of variable 'foo'
            my = "${foo} a" # sets variable 'my' to "bar a"

       If the variable exists in a section or subsection, it can be referenced
       as ${section.subsection.variable}.  Forward references are not allowed.
       Relative  references  are  allowed, by pre-pending the name with one or
       more period.

            blogs = ${.foo}

       Will set variable blogs to the value of variable foo, from the  current
       section.

            blogs = ${..foo}

       Will  set variable blogs to the value of variable foo, from the section
       which contains the current section.

            blogs = ${modules.detail.detailfile}

       Will set variable blogs to the value of  variable  detailfile,  of  the
       detail  module,  which  is  in the modules section of the configuration
       file.

FILES

       /etc/raddb/radiusd.conf

SEE ALSO

       radiusd(8) unlang(5)

AUTHOR

       Alan DeKok <aland@freeradius.org>

                                  12 Jun 2007                  radiusd.conf(5)