/ 
X500-DN-Parser-1.15
/ X500::DN::Parser

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