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  -  RAD-BULK-MAKE (1)

.ds Aq ’

NAME

rad-bulk-make - Generate test files for rad-bulk

CONTENTS

SYNOPSIS



    rad-bulk-make --template files --sessions num --ports num
    --max-acct num --iterations num



DESCRIPTION

rad-bulk-make produces packet files suitable for using with rad-bulk(1) for testing RADIUS server configurations. It uses its own template files to build large numbers of typical RADIUS packets.

The resulting packet file will be sent to STDOUT, so that it can be redirected. It is recommended that you create a number of packet files and stick to them for testing, so that you can consistently excercise your RADIUS server.

Various classes of packets can be generated, depending on the specific configuration.
<B>--template fileB> Specifies the basenames of the templates to use for packet generation. The template is composed of three files: The session script, the port script and the packet template.
<B>The Packet TemplateB> The packet template is located in the file whose name is specified in the command line option. This file is composed of sections that are evaluated with Text::Template(3).

This file specifies what attributes should be placed on each packet.

<B>The Session ScriptB> This script resides in a file with the same name as the template file, with the extension .session appended to it. It contains Perl code that will be evaluated once at session creation, once for each Alive packet to be generated and once for the Stop packet.

It is supposed to work on $s, which is a reference to a hash — initially empty — provided by rad-bulk-make.

Note that each different session will receive its own $s, and the $p corresponding to the port where it was created.

<B>The Port ScriptB> This script resides in a file with the same name as the template file, with the extension .port appended to it. It contains Perl code that will be evaluated once at port creation.

It is supposed to work on $p, which is a reference to a hash — initially empty — provided by rad-bulk-make.

<B>--ports numB> The number of ports to be created. Each of this ports is capable of carrying a number of concurrent sessions, depending on the configuration.
<B>--sessions numB> For each port, a number between 1 and num sessions will be active at any time. A session has a 20% chance of being created during each iteration.
<B>--max-acct numB> Each session will generate between 0 and num Alive accounting packets. Start and Stop are always generated.

Each session has a 10% chance of being terminated after the Start and the randomly selected number of Alive accounting packets have been generated.

<B>--iterations numB> This controls how many iterations of the generator will be run. Each iteration is a scan through the list of ports / sessions. Defaults to 1000.
<B>--helpB> Shows basic usage information and then exit.
<B>--versionB> Show version numbers of this program and the libraries that are used.

    Template File Format

Packets are specified with a keyword (Authentication, Start, Alive or Stop) and a number of input lines, with each line specifying an attribute. Blank lines delimit packets. Lines whose first non-blank character is # are ignored as comments.

The keyword specifies which kind of packet can be generated with this template. Each fragment is interpreted as a Text::Template(3) template.

Radius attributes are as follows:



  [vendor.]attribute=value



Where <B>vendorB> and <B>attributeB> are the labels specified in the dictionary.

LICENSE AND WARRANTY

This code and all accompanying software comes with NO WARRANTY. You use it at your own risk.

This code and all accompanying software can be used freely under the terms of the GNU General Public License version 2.

AUTHOR

Luis E. Munõz <luismunoz@cpan.org>

SEE ALSO

perl(1), Getopt::Long(3), Net::Radius::Packet(3), Net::Radius::Dictionary(3), Text::Template(3).

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 329: Non-ASCII character seen before =encoding in ’Munõz’. Assuming UTF-8
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 RAD-BULK-MAKE (1) 2009-10-21

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