NAME

       Net::Radius::Dictionary - RADIUS dictionary parser

SYNOPSIS

         use Net::Radius::Dictionary;

         my $dict = new Net::Radius::Dictionary "/etc/radius/dictionary";
         $dict->readfile("/some/other/file");
         my $num = $dict->attr_num('User-Name');
         my $name = $dict->attr_name(1);
         my $vsa_num = $dict->vsattr_num(9, 'cisco-avpair');
         my $vsa_name = $dict->vsattr_name(9, 1);

DESCRIPTION

       This is a simple module that reads a RADIUS dictionary file and parses it, allowing
       conversion between dictionary names and numbers.  Vendor-Specific attributes are supported
       in a way consistent to the standards.

       A few earlier versions of this module attempted to make dictionaries case-insensitive.
       This proved to be a very bad decision. From this version on, this tendency is reverted:
       Dictionaries and its contents are to be case-sensitive to prevent random, hard to debug
       failures in production code.

   METHODS
       new($dict_file, ...)
           Returns a new instance of a Net::Radius::Dictionary object. This object will have no
           attributes defined, as expected.

           If given an (optional) list of filenames, it calls readfile for you for all of them,
           in the given order.

       ->readfile($dict_file)
           Parses a dictionary file and learns the mappings to use. It can be called multiple
           times for the same object. The result will be that new entries will override older
           ones, thus you could load a default dictionary and then have a smaller dictionary that
           override specific entries.

       ->vendor_num($vendorname)
           Return the vendor number for the given vendor name.

       ->attr_num($attrname)
           Returns the number of the named attribute.

       ->attr_type($attrname)
           Returns the type (string, integer, ipaddr, or time) of the named attribute.

       ->attr_name($attrnum)
           Returns the name of the attribute with the given number.

       ->attr_numtype($attrnum)
           Returns the type of the attribute with the given number.

       ->attr_has_val($attrnum)
           Returns a true or false value, depending on whether or not the numbered attribute has
           any known value constants.

       ->val_has_name($attrnum)
           Alternate (bad) name for attr_has_val.

       ->val_num($attrnum, $valname)
           Returns the number of the named value for the attribute number supplied.

       ->val_name($attrnum, $valnumber)
           Returns the name of the numbered value for the attribute number supplied.

       There is an equivalent family of accessor methods for Vendor-Specific attributes and its
       values. Those methods are identical to their standard attributes counterparts with two
       exceptions. Their names have a vsa prepended to the accessor name and the first argument
       to each one is the vendor code on which they apply.

CAVEATS

       This module is mostly for the internal use of Net::Radius::Packet, and may otherwise cause
       insanity and/or blindness if studied.

AUTHOR

       Christopher Masto <chris@netmonger.net>, Luis E. Muñoz <luismunoz@cpan.org> contributed
       the VSA code.

SEE ALSO

       Net::Radius::Packet