Botan::X509_DN Class Reference

#include <asn1_obj.h>

Inheritance diagram for Botan::X509_DN:

List of all members.

Public Member Functions
void	add_attribute (const OID &, const std::string &)
void	add_attribute (const std::string &, const std::string &)
std::multimap< std::string, std::string >	contents () const
void	decode_from (class BER_Decoder &)
void	do_decode (const MemoryRegion< byte > &)
void	encode_into (class DER_Encoder &) const
std::vector< std::string >	get_attribute (const std::string &) const
std::multimap< OID, std::string >	get_attributes () const
MemoryVector< byte >	get_bits () const
	X509_DN (const std::multimap< std::string, std::string > &)
	X509_DN (const std::multimap< OID, std::string > &)
	X509_DN ()
Static Public Member Functions
static std::string	deref_info_field (const std::string &)

---

Detailed Description

Distinguished Name

Definition at line 88 of file asn1_obj.h.

---

Constructor & Destructor Documentation

Botan::X509_DN::X509_DN

(

)

Definition at line 20 of file asn1_dn.cpp.

   {
   }

Botan::X509_DN::X509_DN

(

const std::multimap< OID, std::string > &

args

)

Definition at line 27 of file asn1_dn.cpp.

References add_attribute().

   {
   std::multimap<OID, std::string>::const_iterator j;
   for(j = args.begin(); j != args.end(); ++j)
      add_attribute(j->first, j->second);
   }

Botan::X509_DN::X509_DN

(

const std::multimap< std::string, std::string > &

args

)

Definition at line 37 of file asn1_dn.cpp.

References add_attribute(), and Botan::OIDS::lookup().

   {
   std::multimap<std::string, std::string>::const_iterator j;
   for(j = args.begin(); j != args.end(); ++j)
      add_attribute(OIDS::lookup(j->first), j->second);
   }

---

Member Function Documentation

void Botan::X509_DN::add_attribute	(	const OID &	oid,
		const std::string &	str
	)

Definition at line 57 of file asn1_dn.cpp.

References Botan::MemoryRegion< T >::destroy(), and Botan::multimap_insert().

   {
   if(str == "")
      return;

   typedef std::multimap<OID, ASN1_String>::iterator rdn_iter;

   std::pair<rdn_iter, rdn_iter> range = dn_info.equal_range(oid);
   for(rdn_iter j = range.first; j != range.second; ++j)
      if(j->second.value() == str)
         return;

   multimap_insert(dn_info, oid, ASN1_String(str));
   dn_bits.destroy();
   }

void Botan::X509_DN::add_attribute	(	const std::string &	type,
		const std::string &	str
	)

Definition at line 47 of file asn1_dn.cpp.

References Botan::OIDS::lookup(), and oid.

Referenced by Botan::create_dn(), do_decode(), and X509_DN().

   {
   OID oid = OIDS::lookup(type);
   add_attribute(oid, str);
   }

std::multimap< std::string, std::string > Botan::X509_DN::contents

(

)

const

Definition at line 89 of file asn1_dn.cpp.

References Botan::OIDS::lookup(), and Botan::multimap_insert().

   {
   typedef std::multimap<OID, ASN1_String>::const_iterator rdn_iter;

   std::multimap<std::string, std::string> retval;
   for(rdn_iter j = dn_info.begin(); j != dn_info.end(); ++j)
      multimap_insert(retval, OIDS::lookup(j->first), j->second.value());
   return retval;
   }

void Botan::X509_DN::decode_from

(

class BER_Decoder &

from

)

[virtual]

Decode whatever this object is from from

Parameters:

from

the BER_Decoder that will be read from

Implements Botan::ASN1_Object.

Definition at line 293 of file asn1_dn.cpp.

References do_decode(), Botan::BER_Decoder::end_cons(), Botan::BER_Decoder::raw_bytes(), Botan::SEQUENCE, and Botan::BER_Decoder::start_cons().

   {
   dn_info.clear();

   source.start_cons(SEQUENCE)
      .raw_bytes(dn_bits)
   .end_cons();

   do_decode(dn_bits);
   }

std::string Botan::X509_DN::deref_info_field

(

const std::string &

info

)

[static]

Definition at line 155 of file asn1_dn.cpp.

Referenced by get_attribute(), Botan::X509_Certificate::issuer_info(), and Botan::X509_Certificate::subject_info().

   {
   if(info == "Name" || info == "CommonName") return "X520.CommonName";
   if(info == "SerialNumber")                 return "X520.SerialNumber";
   if(info == "Country")                      return "X520.Country";
   if(info == "Organization")                 return "X520.Organization";
   if(info == "Organizational Unit" || info == "OrgUnit")
      return "X520.OrganizationalUnit";
   if(info == "Locality")                     return "X520.Locality";
   if(info == "State" || info == "Province")  return "X520.State";
   if(info == "Email")                        return "RFC822";
   return info;
   }

void Botan::X509_DN::do_decode

(

const MemoryRegion< byte > &

bits

)

Definition at line 118 of file asn1_dn.cpp.

References add_attribute(), Botan::BER_Decoder::decode(), Botan::BER_Decoder::end_cons(), Botan::BER_Decoder::more_items(), oid, Botan::SEQUENCE, Botan::SET, Botan::BER_Decoder::start_cons(), Botan::ASN1_String::value(), and Botan::BER_Decoder::verify_end().

Referenced by decode_from().

   {
   BER_Decoder sequence(bits);

   while(sequence.more_items())
      {
      BER_Decoder rdn = sequence.start_cons(SET);

      while(rdn.more_items())
         {
         OID oid;
         ASN1_String str;

         rdn.start_cons(SEQUENCE)
            .decode(oid)
            .decode(str)
            .verify_end()
        .end_cons();

         add_attribute(oid, str.value());
         }
      }

   dn_bits = bits;
   }

void Botan::X509_DN::encode_into

(

class DER_Encoder &

to

)

const [virtual]

Encode whatever this object is into to

Parameters:

to

the DER_Encoder that will be written to

Implements Botan::ASN1_Object.

Definition at line 268 of file asn1_dn.cpp.

References Botan::DIRECTORY_STRING, Botan::MemoryRegion< T >::empty(), Botan::DER_Encoder::end_cons(), get_attributes(), Botan::PRINTABLE_STRING, Botan::DER_Encoder::raw_bytes(), Botan::SEQUENCE, and Botan::DER_Encoder::start_cons().

   {
   std::multimap<OID, std::string> dn_info = get_attributes();

   der.start_cons(SEQUENCE);

   if(!dn_bits.empty())
      der.raw_bytes(dn_bits);
   else
      {
      do_ava(der, dn_info, PRINTABLE_STRING, "X520.Country", true);
      do_ava(der, dn_info, DIRECTORY_STRING, "X520.State");
      do_ava(der, dn_info, DIRECTORY_STRING, "X520.Locality");
      do_ava(der, dn_info, DIRECTORY_STRING, "X520.Organization");
      do_ava(der, dn_info, DIRECTORY_STRING, "X520.OrganizationalUnit");
      do_ava(der, dn_info, DIRECTORY_STRING, "X520.CommonName", true);
      do_ava(der, dn_info, PRINTABLE_STRING, "X520.SerialNumber");
      }

   der.end_cons();
   }

std::vector< std::string > Botan::X509_DN::get_attribute

(

const std::string &

attr

)

const

Definition at line 102 of file asn1_dn.cpp.

References deref_info_field(), Botan::OIDS::lookup(), and oid.

   {
   typedef std::multimap<OID, ASN1_String>::const_iterator rdn_iter;

   const OID oid = OIDS::lookup(deref_info_field(attr));
   std::pair<rdn_iter, rdn_iter> range = dn_info.equal_range(oid);

   std::vector<std::string> values;
   for(rdn_iter j = range.first; j != range.second; ++j)
      values.push_back(j->second.value());
   return values;
   }

std::multimap< OID, std::string > Botan::X509_DN::get_attributes

(

)

const

Definition at line 76 of file asn1_dn.cpp.

References Botan::multimap_insert().

Referenced by encode_into(), Botan::operator<(), and Botan::operator==().

   {
   typedef std::multimap<OID, ASN1_String>::const_iterator rdn_iter;

   std::multimap<OID, std::string> retval;
   for(rdn_iter j = dn_info.begin(); j != dn_info.end(); ++j)
      multimap_insert(retval, j->first, j->second.value());
   return retval;
   }

MemoryVector< byte > Botan::X509_DN::get_bits

(

)

const

Definition at line 147 of file asn1_dn.cpp.

   {
   return dn_bits;
   }

---

The documentation for this class was generated from the following files:

• src/asn1/asn1_obj.h
• src/asn1/asn1_dn.cpp