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  -  NRSDBTOYAML (1)

.ds Aq ’

NAME

nrsdbtoyaml - Extract records from Net::Radius::Server::DBStore

CONTENTS

SYNOPSIS



    nrsdbtoyaml [--delete] [--sync] {--all|--key key|--full}
    [--frozen] [--filter regexp] [--help] -- <BerkeleyDB params>

    # or for more complicated scenarios...

    perl -MMLDBM=DB_File,Storable /usr/bin/nrsdbtoyaml --full \\
      -- MLDBM::Sync $DB_FILE



DESCRIPTION

<B>nrsdbtoyamlB> allows the extraction of either single records or complete dumps of databases created by Net::Radius::Server::DBStore(3). Its output can then be fed to billing or accounting processes that act on the collected information.

The output is a YAML file, produced by YAML::Syck(3), thus YAML 1.0 compliant, where each extracted record will be re-serialized as YAML.

Note that you must feed configuration options that match whatever was used to generate the particular database being read.

Note that this includes the name of the database file to read. Note also that you must separate <B>nrsdbtoyamlB> options from the underlying storage module options using --, as explained in Getopt::Long(3).
<B>--deleteB> After dumping each tuple, delete it from the database.
<B>--syncB> sync() the database after each deletion. This trades in performance for correctness.
<B>--fullB> Do a complete dump of the database. Probably only good for debugging.
<B>--allB> Dump all tuples stored in the database.
<B>--key keyB> Only the tuple corresponding to this key will be printed. Multiple keys can be specified.
<B>--filter regexpB> If specified, treats regexp as a Perl regular expression that must match the key in order for it to be processed. Multiple filters can be specified. In this case, all of them must match.
<B>--frozenB> Whether to use thaw() from Storable(3) on the recovered data or not.
<B>--helpB> Produces this documentation.
The program will return a true value if no errors are found. Otherwise, an error code will be returned and a suitable error will be sent to STDERR. The YAML output is sent to STDOUT.

Your local configuration might include Radius packets among the data to be stored in the database. <B>nrsdbtoyamlB> won’t decode those. Instead, the packet will be returned as a string containing the packet data that was received.

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 same terms as Perl version 5.8.6 itself.

AUTHOR

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

SEE ALSO

nrsd(1), perl(1), Getopt::Long(3), Net::Radius::Server(3), Net::Radius::Server::DBStore(3), YAML::Syck(3).

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 190: 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 NRSDBTOYAML (1) 2009-10-17

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