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 ** 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