1RLM_IPPOOL_TOOL(8)          System Manager's Manual         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       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

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

SEE ALSO

103       radiusd(8)
104

AUTHORS

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)
Impressum