NAME

X500::DN::Parser - Parse X500 Distinguished Names

SYNOPSIS

        use X500::DN::Parser;

        my($parser) = new X500::DN::Parser(\&errorInDN);

        my($dn, $genericDN, %RDN) =
                $parser -> parse('c=au;o=MagicWare;cn=Ron Savage',
                                'c', '[l]', 'o', '[ou]', 'cn');

DESCRIPTION

Parse DNs where the caller knows the number of RDNs.

parse()

Input Parameters:

• DN to be parsed
• A list of the expected components of the DN. Any component can be put in [] to indicate that that component is optional

Output List:

• $dn: The DN passed in
• $genericDN: A generic DN matching the given DN
• %component: The components of the DN and their values. Eg:

          If $dn = 'c=au;o=MagicWare', then these key/values appear:
          'c' => 'au',
          'o' => 'MagicWare'

INSTALLATION

You install X500::DN::Parser, as you would install any perl module library, by running these commands:

        perl Makefile.PL
        make
        make test
        make install

If you want to install a private copy of X500::DN::Parser in your home directory, then you should try to produce the initial Makefile with something like this command:

        perl Makefile.PL LIB=~/perl
                or
        perl Makefile.PL LIB=C:/Perl/Site/Lib

If, like me, you don't have permission to write man pages into unix system directories, use:

        make pure_install

instead of make install. This option is secreted in the middle of p 414 of the second edition of the dromedary book.

AUTHOR

X500::DN::Parser was written by Ron Savage <ron@savage.net.au> in 1999.

LICENCE

Australian copyright (c) 1999-2002 Ron Savage.

        All Programs of mine are 'OSI Certified Open Source Software';
        you can redistribute them and/or modify them under the terms of
        The Artistic License, a copy of which is available at:
        http://www.opensource.org/licenses/index.html