1RLM_IPPOOL_TOOL(8) System Manager's Manual RLM_IPPOOL_TOOL(8)
2
3
4
6 rlm_ippool_tool - dump the contents of the FreeRadius ippool database
7 files
8
10 If an ipaddress is specified then that address is used to limit the
11 actions or output.
12
13 rlm_ippool_tool [-a] [-c] [-o] [-v] session-db index-db [ipaddress]
14
15
16 Mark the entry nasIP/nasPort as having ipaddress
17
18 rlm_ippool_tool -n session-db index-db ipaddress nasIP nasPort
19
20
21 Update old format database to new.
22
23 rlm_ippool_tool -u session-db new-session-db
24
25
27 rlm_ippool_tool dumps the contents of the FreeRADIUS ippool databases
28 for analyses or for removal of active (stuck?) entries.
29
30 Or with the -n argument adds a usage entry to the FreeRADIUS ippool
31 databases.
32
33
34
36 -a Print all active entries.
37
38 -c Report number of active entries.
39
40 -r Remove active entries.
41
42 -v Verbose report of all entries.
43
44 -o Assume old database format (nas/port pair, not md5 output).
45
46 -n Mark the entry nasIP/nasPort as having ipaddress.
47
48 -u Update old format database to new.
49
50
52 Given the syntax in the FreeRadius radiusd.conf:
53
54 ippool myippool {
55 range-start = 192.0.2.0
56 range-stop = 192.0.2.255
57 [...]
58 session-db = ${raddbdir}/ip-pool.db
59 ip-index = ${raddbdir}/ip-index.db
60 }
61
62 To see the number of active entries in this pool, use:
63
64 $ rlm_ippool_tool -c ip-pool.db ip-index.db
65 13
66
67 To see all active entries in this pool, use:
68
69 $ rlm_ippool_tool -a ip-pool.db ip-index.db
70 192.0.2.5
71 192.0.2.82
72 192.0.2.244
73 192.0.2.57
74 192.0.2.120
75 192.0.2.27
76 [...]
77
78 To see all information about the active entries in the use, use:
79
80 $ rlm_ippool_tool -av ip-pool.db ip-index.db
81 NAS:172.16.1.1 port:0x2e8 - ipaddr:192.0.2.5 active:1 cli:0 num:1
82 NAS:172.16.1.1 port:0x17c - ipaddr:192.0.2.82 active:1 cli:0 num:1
83 NAS:172.16.1.1 port:0x106 - ipaddr:192.0.2.244 active:1 cli:0 num:1
84 NAS:172.16.1.1 port:0x157 - ipaddr:192.0.2.57 active:1 cli:0 num:1
85 NAS:172.16.1.1 port:0x2d8 - ipaddr:192.0.2.120 active:1 cli:0 num:1
86 NAS:172.16.1.1 port:0x162 - ipaddr:192.0.2.27 active:1 cli:0 num:1
87 [...]
88
89 To see only information of one entry, use:
90
91 $ rlm_ippool_tool -v ip-pool.db ip-index.db 192.0.2.1
92 NAS:172.16.1.1 port:0x90 - ipaddr:192.0.2.1 active:0 cli:0 num:0
93
94 To add an IP address usage entry, use:
95
96 $ rlm_ippool_tool -n ip-pool.db ip-index.db 192.0.0.1 172.16.1.1 0x90
97 rlm_ippool_tool: Allocating ip to nas/port: 172.16.1.1/144
98 rlm_ippool_tool: num: 1
99 rlm_ippool_tool: Allocated ip 192.0.2.1 to client on nas 172.16.1.1,port 144
100
101
103 radiusd(8)
104
106 Currently part of the FreeRADIUS Project (http://www.freeradius.org)
107 Originally by Edwin Groothuis, edwin@mavetju.org
108 (http://www.mavetju.org)
109
110 Mailing list details are at http://www.freeradius.org/
111
112
113
114 RLM_IPPOOL_TOOL(8)