Botan::GeneralSubtree Class Reference

A single Name Constraint. More...

#include <pkix_types.h>

Inheritance diagram for Botan::GeneralSubtree:

Public Member Functions
const GeneralName &	base () const
std::vector< uint8_t >	BER_encode () const
void	decode_from (BER_Decoder &) override
void	encode_into (DER_Encoder &) const override
	GeneralSubtree ()
	GeneralSubtree (const GeneralName &base, size_t min, size_t max)
	GeneralSubtree (const std::string &str)
size_t	maximum () const
size_t	minimum () const

Detailed Description

A single Name Constraint.

The Name Constraint extension adds a minimum and maximum path length to a GeneralName to form a constraint. The length limits are currently unused.

Definition at line 256 of file pkix_types.h.

Constructor & Destructor Documentation

GeneralSubtree() [1/3]

Botan::GeneralSubtree::GeneralSubtree ( )

inline

Creates an empty name constraint.

Definition at line 262 of file pkix_types.h.

                       : m_base(), m_minimum(0), m_maximum(std::numeric_limits<std::size_t>::max())
      {}

GeneralSubtree() [2/3]

Botan::GeneralSubtree::GeneralSubtree ( const GeneralName &  base, size_t  min, size_t  max  )

inline

Definition at line 271 of file pkix_types.h.

      : m_base(base), m_minimum(min), m_maximum(max)
      {}

GeneralSubtree() [3/3]

Botan::GeneralSubtree::GeneralSubtree

(

const std::string &

str

)

Creates a new name constraint for its string format.

Parameters

str	name constraint

Definition at line 232 of file name_constraint.cpp.

                                                   : GeneralSubtree()
   {
   size_t p0, p1;
   const auto min = std::stoull(str, &p0, 10);
   const auto max = std::stoull(str.substr(p0 + 1), &p1, 10);
   GeneralName gn(str.substr(p0 + p1 + 2));
 
   if(p0 > 0 && p1 > 0)
      {
      m_minimum = static_cast<size_t>(min);
      m_maximum = static_cast<size_t>(max);
      m_base = gn;
      }
   else
      {
      throw Invalid_Argument("Failed to decode Name Constraint");
      }
   }

Member Function Documentation

base()

const GeneralName & Botan::GeneralSubtree::base ( ) const

inline

Returns

name

Definition at line 288 of file pkix_types.h.

{ return m_base; }

Referenced by Botan::operator<<().

BER_encode()

std::vector< uint8_t > Botan::ASN1_Object::BER_encode ( ) const

inherited

Return the encoding of this object. This is a convenience method when just one object needs to be serialized. Use DER_Encoder for complicated encodings.

Definition at line 16 of file asn1_obj.cpp.

   {
   std::vector<uint8_t> output;
   DER_Encoder der(output);
   this->encode_into(der);
   return output;
   }

References Botan::ASN1_Object::encode_into().

Referenced by Botan::PSSR::config_for_x509(), Botan::Certificate_Store_In_SQL::find_all_certs(), Botan::Certificate_Store_In_SQL::find_cert(), Botan::X509_Certificate::fingerprint(), Botan::Certificate_Store_In_SQL::insert_cert(), Botan::X509_Object::PEM_encode(), and Botan::Certificate_Store_In_SQL::revoke_cert().

decode_from()

void Botan::GeneralSubtree::decode_from ( BER_Decoder &  from )

overridevirtual

Decode whatever this object is from from

Parameters

from	the BER_Decoder that will be read from

Implements Botan::ASN1_Object.

Definition at line 256 of file name_constraint.cpp.

   {
   ber.start_sequence()
      .decode(m_base)
      .decode_optional(m_minimum, ASN1_Type(0), ASN1_Class::ContextSpecific, size_t(0))
   .end_cons();
 
   if(m_minimum != 0)
     throw Decoding_Error("GeneralSubtree minimum must be 0");
 
   m_maximum = std::numeric_limits<std::size_t>::max();
   }

References Botan::ContextSpecific, Botan::BER_Decoder::decode(), Botan::BER_Decoder::decode_optional(), Botan::BER_Decoder::end_cons(), and Botan::BER_Decoder::start_sequence().

encode_into()

void Botan::GeneralSubtree::encode_into ( DER_Encoder &  to ) const

overridevirtual

Encode whatever this object is into to

Parameters

to	the DER_Encoder that will be written to

Implements Botan::ASN1_Object.

Definition at line 251 of file name_constraint.cpp.

   {
   throw Not_Implemented("General Subtree encoding");
   }

maximum()

size_t Botan::GeneralSubtree::maximum ( ) const

inline

Returns

maximum path length

Definition at line 298 of file pkix_types.h.

{ return m_maximum; }

Referenced by Botan::operator<<().

minimum()

size_t Botan::GeneralSubtree::minimum ( ) const

inline

Returns

minimum path length

Definition at line 293 of file pkix_types.h.

{ return m_minimum; }

Referenced by Botan::operator<<().

---

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

• src/lib/x509/pkix_types.h
• src/lib/x509/name_constraint.cpp