raddb/mods-available/ippool

   1 # -*- text -*-
   2 #
   3 #  $Id$
   4
   5 #  Do server side ip pool management. Should be added in
   6 #  post-auth and accounting sections.
   7 #
   8 #  The module also requires the existance of the Pool-Name
   9 #  attribute. That way the administrator can add the Pool-Name
  10 #  attribute in the user profiles and use different pools for
  11 #  different users. The Pool-Name attribute is a *check* item
  12 #  not a reply item.
  13 #
  14 #  The Pool-Name should be set to the ippool module instance
  15 #  name or to DEFAULT to match any module.
  16
  17 #
  18 # Example:
  19 # radiusd.conf: ippool students { [...] }
  20 #               ippool teachers { [...] }
  21 # users file  : DEFAULT Group == students, Pool-Name := "students"
  22 #               DEFAULT Group == teachers, Pool-Name := "teachers"
  23 #               DEFAULT Group == other, Pool-Name := "DEFAULT"
  24 #
  25 # ********* IF YOU CHANGE THE RANGE PARAMETERS YOU MUST *********
  26 # ********* THEN ERASE THE DB FILES                     *********
  27 #
  28 ippool main_pool {
  29
  30         #  range-start,range-stop:
  31         #       The start and end ip addresses for this pool.
  32         range-start = 192.168.1.1
  33         range-stop = 192.168.3.254
  34
  35         #  netmask:
  36         #       The network mask used for this pool.
  37         netmask = 255.255.255.0
  38
  39         #  cache-size:
  40         #       The gdbm cache size for the db files. Should
  41         #       be equal to the number of ip's available in
  42         #       the ip pool
  43         cache-size = 800
  44
  45         # session-db:
  46         #       The main db file used to allocate addresses.
  47         session-db = ${db_dir}/db.ippool
  48
  49         # ip-index:
  50         #       Helper db index file used in multilink
  51         ip-index = ${db_dir}/db.ipindex
  52
  53         # override:
  54         #       If set, the Framed-IP-Address already in the
  55         #       reply (if any) will be discarded, and replaced
  56         #       with a Framed-IP-Address assigned here.
  57         override = no
  58
  59         # maximum-timeout:
  60         #       Specifies the maximum time in seconds that an
  61         #       entry may be active.  If set to zero, means
  62         #       "no timeout".  The default value is 0
  63         maximum-timeout = 0
  64
  65         # key:
  66         #       The key to use for the session database (which
  67         #       holds the allocated ip's) normally it should
  68         #       just be the nas ip/port (which is the default).
  69         #
  70         #       If your NAS sends the same value of NAS-Port
  71         #       all requests, the key should be based on some
  72         #       other attribute that is in ALL requests, AND
  73         #       is unique to each machine needing an IP address.
  74         #key = "%{NAS-IP-Address} %{NAS-Port}"
  75 }