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. Mun~oz <luismunoz@cpan.org> contributed the VSA code.

SEE ALSO

       Net::Radius::Packet