GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  RLM_IPPOOL_TOOL (8)

NAME

rlm_ippool_tool - dump the contents of the FreeRadius ippool database files

CONTENTS

Synopsis
Description
Options
Examples
See Also
Authors

SYNOPSIS

If an ipaddress is specified then that address is used to limit the actions or output.

rlm_ippool_tool [-a] [-c] [-o] [-v] session-db index-db [ipaddress]

Mark the entry nasIP/nasPort as having ipaddress

rlm_ippool_tool -n session-db index-db ipaddress nasIP nasPort

Update old format database to new.

rlm_ippool_tool -u session-db new-session-db

DESCRIPTION

rlm_ippool_tool dumps the contents of the FreeRADIUS ippool databases for analyses or for removal of active (stuck?) entries.

Or with the -n argument adds a usage entry to the FreeRADIUS ippool databases.

OPTIONS

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

EXAMPLES

Given the syntax in the FreeRadius radiusd.conf:
 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
 }

To see the number of active entries in this pool, use:
 $ rlm_ippool_tool -c ip-pool.db ip-index.db
 13

To see all active entries in this pool, use:
 $ 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
 [...]

To see all information about the active entries in the use, use:
 $ 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
 [...]

To see only information of one entry, use:
 $ 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

To add an IP address usage entry, use:
 $ 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

SEE ALSO

radiusd(8)

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/

Search for    or go to Top of page |  Section 8 |  Main Index


RLM_IPPOOL_TOOL (8) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.