RLM_SQLIPPOOL_TOOL(8)       System Manager's Manual      RLM_SQLIPPOOL_TOOL(8)

<?><?><?> (NAME)
       rlm_sqlippool_tool - <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> IP <?><?> <?><?><?><?><?><?><?><?><?><?><?> SQL

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       rlm_sqlippool_tool -p pool_name -s range_start -e range_end -t
       table_name -d dialect -f raddb_dir -i instance [-c capacity] [-x
       existing_ips_file]

       rlm_sqlippool_tool -y pool_defs_yaml_file -t table_name -d dialect -f
       raddb_dir -i instance [-x existing_ips_file]


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> rlm_sqlippool_tool <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> IP <?><?> <?><?><?><?><?><?><?><?> IP
       <?><?><?><?><?><?><?><?><?><?><?> SQL <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> FreeRADIUS <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> SQL <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?> IP <?><?> <?><?><?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> SQL <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> (schemas) <?><?><?><?><?><?><?>
       ippool <?><?> FreeRADIUS <?><?><?><?><?>. <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> pool_name <?>
       framedipaddress <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       -c capacity
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> IP <?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?>.

       -d dialect
              <?><?><?><?> (dialect) <?><?><?><?><?><?><?><?><?><?><?> SQL
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       -e range_end
              <?><?><?><?><?> IP <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> IPv4 <?><?> IPv6 <?><?><?><?>
              <?><?><?>.

       -f raddb_dir
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> FreeRADIUS.
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> rlm_sqlippool_tool
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              FreeRADIUS <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

       -i instance
              <?><?><?><?><?> <?><?> <?><?><?><?><?> -f <?><?> <?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> (instance)
              <?><?><?><?><?> sql <?><?> <?><?><?><?><?><?><?><?> FreeRADIUS
              <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?> sql
              <?><?><?>.

       -p pool_name
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?> <?><?> <?><?><?><?>.

       -s range_start
              <?><?><?><?><?> IP <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> IPv4 <?><?> IPv6 <?><?><?><?>
              <?><?><?>.

       -t table_name
              <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?>.

       -x existing_ips_file
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> IP
              <?><?><?><?><?> <?><?> <?><?><?><?><?>. <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> (sparse) <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

       -y pool_defs_yaml_file
              <?><?><?><?><?> <?><?> <?><?><?><?> YAML <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> SQL <?><?> <?><?><?><?>
       MySQL <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> local <?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> 10.0.0.1 <?><?> 10.0.0.199 <?><?>
       <?><?><?> <?><?><?><?>:

              $ rlm_sqlippool_tool -p local -s 10.0.0.1 -e 10.0.0.199 \
                  -t dhcpippool -d mysql

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> SQL <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       FreeRADIUS <?><?><?> <?><?><?><?> /etc/raddb:

              $ rlm_sqlippool_tool -p local -s 10.0.0.1 -e 10.0.0.199 \
                  -t dhcpippool -f /etc/raddb

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> YAML
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?> SQL <?><?>
       <?><?><?><?> PostgreSQL:

              $ rlm_sqlippool_tool -y pools.yaml -t dhcpippool -d postgresql


<?><?><?><?> YAML (YAML FORMAT)
       <?><?> <?><?><?><?> YAML <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>:

              pool_with_a_single_contiguous_range:
                - start:    192.0.2.3
                  end:      192.0.2.250

              pool_with_a_single_sparse_range:
                - start:    10.10.10.0
                  end:      10.10.20.255
                  capacity: 200

              pool_with_multiple_ranges:
                - start:    10.10.10.1
                  end:      10.10.10.253
                - start:    10.10.100.0
                  end:      10.10.199.255
                  capacity: 1000

              v6_pool_with_contiguous_range:
                - start:    '2001:db8:1:2:3:4:5:10'
                  end:      '2001:db8:1:2:3:4:5:7f'

              v6_pool_with_sparse_range:
                - start:    '2001:db8:1:2::'
                  end:      '2001:db8:1:2:ffff:ffff:ffff:ffff'
                  capacity: 200


<?><?><?><?><?><?><?><?><?><?> (PREREQUISITES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> SQL
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> Perl
       Template::Toolkit <?><?><?><?> <?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> Perl DBI <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> Perl DBD
       <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       radiusd.conf(5), raddb/mods-available/sql

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Nick Porter <nick@portercomputing.co.uk>

                                                         RLM_SQLIPPOOL_TOOL(8)