summaryrefslogtreecommitdiffstats
path: root/src/modules/rlm_ippool/rlm_ippool_tool.8
blob: 61383e5e75f444a5d3c3ab9a48c708a005ab589b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
.TH RLM_IPPOOL_TOOL 8
.SH NAME
rlm_ippool_tool - dump the contents of the FreeRadius ippool database files
.SH SYNOPSIS
.P
If an ipaddress is specified then that address is used to
limit the actions or output.

.B rlm_ippool_tool
.RB [ \-a ]
.RB [ \-c ]
.RB [ \-o ]
.RB [ \-v ]
\fIsession-db\fP \fIindex-db\fP [\fIipaddress\fP]

.P
Mark the entry nasIP/nasPort as having ipaddress

.B rlm_ippool_tool
\-n \fIsession-db\fP \fIindex-db\fP \fIipaddress\fP \fInasIP\fP \fInasPort\fP

.P
Update old format database to new.

.B rlm_ippool_tool
\-u \fIsession-db\fP \fInew-session-db\fP

.SH DESCRIPTION
\fBrlm_ippool_tool\fP dumps the contents of the FreeRADIUS ippool databases for
analyses or for removal of active (stuck?) entries.
.P
Or with the \fB\-n\fP argument adds a usage entry to the FreeRADIUS ippool databases.


.SH OPTIONS

.IP \-a
Print all active entries.
.IP \-c
Report number of active entries.
.IP \-r
Remove active entries.
.IP \-v
Verbose report of all entries.
.IP \-o
Assume old database format (nas/port pair, not md5 output).
.IP \-n
Mark the entry nasIP/nasPort as having ipaddress.
.IP \-u
Update old format database to new.

.SH EXAMPLES

.P
Given the syntax in the FreeRadius radiusd.conf:
.IP
.nf
 ippool myippool {
	range-start = 192.0.2.0
	range-stop = 192.0.2.255
	[...]
	session-db = ${raddbdir}/ip-pool.db
	ip-index = ${raddbdir}/ip-index.db
 }
.fi
.P
To see the number of active entries in this pool, use:
.IP
.nf
 $ rlm_ippool_tool -c ip-pool.db ip-index.db
 13
.fi
.P
To see all active entries in this pool, use:
.IP
.nf
 $ rlm_ippool_tool -a ip-pool.db ip-index.db
 192.0.2.5
 192.0.2.82
 192.0.2.244
 192.0.2.57
 192.0.2.120
 192.0.2.27
 [...]
.fi
.P
To see all information about the active entries in the use, use:
.IP
.nf
 $ rlm_ippool_tool -av ip-pool.db ip-index.db
 NAS:172.16.1.1 port:0x2e8 - ipaddr:192.0.2.5 active:1 cli:0 num:1
 NAS:172.16.1.1 port:0x17c - ipaddr:192.0.2.82 active:1 cli:0 num:1
 NAS:172.16.1.1 port:0x106 - ipaddr:192.0.2.244 active:1 cli:0 num:1
 NAS:172.16.1.1 port:0x157 - ipaddr:192.0.2.57 active:1 cli:0 num:1
 NAS:172.16.1.1 port:0x2d8 - ipaddr:192.0.2.120 active:1 cli:0 num:1
 NAS:172.16.1.1 port:0x162 - ipaddr:192.0.2.27 active:1 cli:0 num:1
 [...]
.fi
.P
To see only information of one entry, use:
.IP
.nf
 $ rlm_ippool_tool -v ip-pool.db ip-index.db 192.0.2.1
 NAS:172.16.1.1 port:0x90 - ipaddr:192.0.2.1 active:0 cli:0 num:0
.fi
.P
To add an IP address usage entry, use:
.IP
.nf
 $ rlm_ippool_tool -n ip-pool.db ip-index.db 192.0.0.1 172.16.1.1 0x90
 rlm_ippool_tool: Allocating ip to nas/port: 172.16.1.1/144
 rlm_ippool_tool: num: 1
 rlm_ippool_tool: Allocated ip 192.0.2.1 to client on nas 172.16.1.1,port 144
.fi

.SH SEE ALSO
radiusd(8)
.SH AUTHORS
Currently part of the FreeRADIUS Project (http://www.freeradius.org)
Originally by Edwin Groothuis, edwin@mavetju.org (http://www.mavetju.org)

Mailing list details are at http://www.freeradius.org/