1RLM_IPPOOL_TOOL(8)             FreeRADIUS Daemon            RLM_IPPOOL_TOOL(8)
2
3
4

NAME

6       rlm_ippool_tool - dump the contents of the FreeRadius ippool database
7       files.
8

SYNOPSIS

10       rlm_ippool_tool [options] <session-db> <index-db> [ipaddress]
11
12       rlm_ippool_tool -n <session-db> <index-db> <ipaddress> <nasIP> <nas‐
13       Port>
14

DESCRIPTION

16       rlm_ippool_tool dumps the contents of the FreeRADIUS ippool databases
17       for analyses or for removal of active (stuck?) entries.
18
19       rlm_ippool_tool -n adds a usage entry to the FreeRADIUS ippool data‐
20       bases.
21
22       Options are:
23
24       -a      Print all active entries.
25
26       -c      Report the number of active entries.
27
28       -r      Remove active entries.
29
30       -v      Verbose report of all entries
31
32       -n      Database addition mode ("New")
33

EXAMPLES

35       Given the syntax in the FreeRadius radiusd.conf:
36
37        ippool myippool {
38               range-start = 192.168.1.0
39               range-stop = 192.168.1.255
40               [...]
41               session-db = ${raddbdir}/ip-pool.db
42               ip-index = ${raddbdir}/ip-index.db
43        }
44
45       To see the number of active entries in this pool, use:
46
47        $ rlm_ippool_tool -c ip-pool.db ip-index.db
48        13
49
50       To see all active entries in this pool, use:
51
52        $ rlm_ippool_tool -a ip-pool.db ip-index.db
53        192.168.1.5
54        192.168.1.82
55        192.168.1.244
56        192.168.1.57
57        192.168.1.120
58        192.168.1.27
59        [...]
60
61       To see all information about the active entries in the use, use:
62
63        $ rlm_ippool_tool -av ip-pool.db ip-index.db
64        NAS:172.16.1.1 port:0x2e8 - ipaddr:192.168.1.5 active:1 cli:0 num:1
65        NAS:172.16.1.1 port:0x17c - ipaddr:192.168.1.82 active:1 cli:0 num:1
66        NAS:172.16.1.1 port:0x106 - ipaddr:192.168.1.244 active:1 cli:0 num:1
67        NAS:172.16.1.1 port:0x157 - ipaddr:192.168.1.57 active:1 cli:0 num:1
68        NAS:172.16.1.1 port:0x2d8 - ipaddr:192.168.1.120 active:1 cli:0 num:1
69        NAS:172.16.1.1 port:0x162 - ipaddr:192.168.1.27 active:1 cli:0 num:1
70        [...]
71
72       To see only information of one entry, use:
73
74        $ rlm_ippool_tool -v ip-pool.db ip-index.db 192.168.1.1
75        NAS:172.16.1.1 port:0x90 - ipaddr:192.168.1.1 active:0 cli:0 num:0
76
77       To add an IP address usage entry, use:
78
79        $ rlm_ippool_tool -n ip-pool.db ip-index.db 192.168.1.1 172.16.1.1 0x90
80        rlm_ippool_tool: Allocating ip to nas/port: 172.16.1.1/144
81        rlm_ippool_tool: num: 1
82        rlm_ippool_tool: Allocated ip 192.168.1.1 to client on nas 172.16.1.1,port 144
83

AUTHOR

85       Currently part of the FreeRADIUS Project (http://www.freeradius.org)
86       Originally by Edwin Groothuis, edwin@mavetju.org
87       (http://www.mavetju.org)
88
89       Mailing list details are at http://www.freeradius.org/
90

BUGS

92                               October 2nd, 2003            RLM_IPPOOL_TOOL(8)
Impressum