RDN(3pm) User Contributed Perl Documentation RDN(3pm)NAME
X500::RDN - handle X.500 RDNs (Relative Distinguished Names), parse and format them
SYNOPSIS
use X500::RDN;
my $rdn = new X500::RDN ('c'=>'DE');
my $c = $rdn->getAttributeValue ('c');
DESCRIPTION
This module handles X.500 RDNs (Relative Distinguished Names). This is a supporting module for X500::DN.
Methods
o $object = new X500::RDN ('type'=>'value', 'type'=>'value', ...);
Creates an RDN object from argument pairs, each pair an attribute type and value. With more than one pair as arguments, you will get a
multi-valued RDN.
o $object->isMultivalued();
Returns whether the RDN is multi-valued.
o $object->getAttributeTypes();
Returns the RDN's attribute types, a list of strings.
o $object->getAttributeValue (type);
Returns the RDN attribute's value.
o $object->getRFC2253String();
Returns the RDN as a string formatted according to RFC 2253 syntax.
o $object->getX500String();
Returns the RDN as a string formatted according to X.500 syntax. NOTE: This is a hack, there is no definition for a X.500 string
syntax!?
o $object->getOpenSSLString();
Returns the RDN as a string formatted according to one of openssl's syntaxes. Croaks on multi-valued RDNs.
EXPORT
None.
BUGS AUTHOR
Robert Joop <yaph-070708@timesink.de>
COPYRIGHT
Copyright 2002 Robert Joop. All Rights reserved. This program is free software; you can redistribute it and/or modify it under the same
terms as Perl itself.
SEE ALSO
X500::DN, perl.
perl v5.10.0 2007-07-08 RDN(3pm)
Check Out this Related Man Page
DN(3) User Contributed Perl Documentation DN(3)NAME
X500::DN - handle X.500 DNs (Distinguished Names), parse and format them
SYNOPSIS
use X500::DN;
my $dn = X500::DN->ParseRFC2253 ('cn=John Doe, o=Acme\, Inc., c=US') or die;
print $dn->getRFC2253String(), "
";
$dn = new X500::DN (new X500::RDN ('c'=>'US'), new X500::RDN ('cn'=>'John Doe'));
my $rdn0 = $dn->getRDN (0);
my $c = $rdn0->getAttributeValue ('c');
NOTE
The RFC 2253 syntax is explicitely backwards in relation to the ASN.1 SEQUENCE.
So the RFC 2253 string "cn=John Doe, c=US" has the same meaning as the X.500 string "c=US, cn=John Doe". The X500::DN objects keep the
RDNs in X.500 order!
DESCRIPTION
This module handles X.500 DNs (Distinguished Names). Currently, it parses DN strings formatted according to RFC 2253 syntax into an
internal format and produces RFC 2253 formatted string from it.
Methods
o $object = new X500::DN (rdn, rdn, ...);
Creates a DN object from zero or more arguments of type X500::RDN.
o $object = X500::DN->ParseRFC2253 ('cn=John Doe, o=Acme\, Inc., c=US');
Creates a DN object from an RFC 2253 formatted DN string notation.
o $object->getRFC2253String();
Returns the DN as a string formatted according to RFC 2253 syntax.
o $object->getOpenSSLString();
Returns the DN as a string formatted suitable for "openssl req -subj" and "openssl ca -subj".
o $object->getX500String();
Returns the DN as a string formatted according to X.500 syntax. NOTE: This is a hack, there is no definition for a X.500 string
syntax!
o $object->hasMultivaluedRDNs();
Returns whether the DN contains multi-valued RDNs.
o $object->getRDN (num);
Returns the DN's RDN at position num as an X500::RDN object. num starts with 0, which will return the first RDN in ASN.1 SEQUENCE
order.
o $object->getRDNs();
Returns the DN's RDNs, a list of objects of type X500::RDN, in ASN.1 SEQUENCE order.
EXPORT
None.
BUGS
o Due to Parse::RecDescent's greedyness, white space after attribute values gets into the parsed value. It might be possible to work
around this.
AUTHOR
Robert Joop <yaph-070708@timesink.de>
COPYRIGHT
Copyright 2002 Robert Joop. All Rights reserved. This program is free software; you can redistribute it and/or modify it under the same
terms as Perl itself.
SEE ALSO
X500::RDN, perl.
HISTORY
Early 2002: First idea, discussed on comp.lang.perl.moderated
April 2002: First public release, 0.15
perl v5.12.1 2007-07-08 DN(3)