Botan::AlgorithmIdentifier Class Reference

#include <asn1_obj.h>

Inheritance diagram for Botan::AlgorithmIdentifier:

Public Types
enum	Encoding_Option { USE_NULL_PARAM , USE_EMPTY_PARAM }

Public Member Functions
	AlgorithmIdentifier ()=default
	AlgorithmIdentifier (const OID &oid, const std::vector< uint8_t > &params)
	AlgorithmIdentifier (const OID &oid, Encoding_Option enc)
	AlgorithmIdentifier (std::string_view oid_name, const std::vector< uint8_t > &params)
	AlgorithmIdentifier (std::string_view oid_name, Encoding_Option enc)
std::vector< uint8_t >	BER_encode () const
void	decode_from (BER_Decoder &) override
bool	empty () const
void	encode_into (DER_Encoder &) const override
const OID &	get_oid () const
const std::vector< uint8_t > &	get_parameters () const
const OID &	oid () const
const std::vector< uint8_t > &	parameters () const
bool	parameters_are_empty () const
bool	parameters_are_null () const
bool	parameters_are_null_or_empty () const

Detailed Description

Algorithm Identifier

Definition at line 440 of file asn1_obj.h.

Member Enumeration Documentation

Encoding_Option

enum Botan::AlgorithmIdentifier::Encoding_Option

Enumerator
USE_NULL_PARAM
USE_EMPTY_PARAM

Definition at line 442 of file asn1_obj.h.

{ USE_NULL_PARAM, USE_EMPTY_PARAM };

Constructor & Destructor Documentation

AlgorithmIdentifier() [1/5]

Botan::AlgorithmIdentifier::AlgorithmIdentifier ( )

default

AlgorithmIdentifier() [2/5]

Botan::AlgorithmIdentifier::AlgorithmIdentifier	(	const OID &	oid,
		Encoding_Option	enc )

Definition at line 30 of file alg_id.cpp.

                                                                               : m_oid(oid), m_parameters() {
   const uint8_t DER_NULL[] = {0x05, 0x00};
 
   if(option == USE_NULL_PARAM) {
      m_parameters.assign(DER_NULL, DER_NULL + 2);
   }
}

References USE_NULL_PARAM.

AlgorithmIdentifier() [3/5]

Botan::AlgorithmIdentifier::AlgorithmIdentifier	(	std::string_view	oid_name,
		Encoding_Option	enc )

Definition at line 41 of file alg_id.cpp.

                                                                                   :
      m_oid(OID::from_string(oid)), m_parameters() {
   const uint8_t DER_NULL[] = {0x05, 0x00};
 
   if(option == USE_NULL_PARAM) {
      m_parameters.assign(DER_NULL, DER_NULL + 2);
   }
}

References USE_NULL_PARAM.

AlgorithmIdentifier() [4/5]

Botan::AlgorithmIdentifier::AlgorithmIdentifier	(	const OID &	oid,
		const std::vector< uint8_t > &	params )

Definition at line 18 of file alg_id.cpp.

                                                                                        :
      m_oid(oid), m_parameters(param) {}

AlgorithmIdentifier() [5/5]

Botan::AlgorithmIdentifier::AlgorithmIdentifier	(	std::string_view	oid_name,
		const std::vector< uint8_t > &	params )

Definition at line 24 of file alg_id.cpp.

                                                                                            :
      AlgorithmIdentifier(OID::from_string(oid), param) {}

Member Function Documentation

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 19 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::PSS_Params::decode_from(), 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::AlgorithmIdentifier::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 83 of file alg_id.cpp.

                                                        {
   codec.start_sequence().decode(m_oid).raw_bytes(m_parameters).end_cons();
}

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

empty()

bool Botan::AlgorithmIdentifier::empty ( ) const

inline

Definition at line 473 of file asn1_obj.h.

{ return m_oid.empty() && m_parameters.empty(); }

encode_into()

void Botan::AlgorithmIdentifier::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 76 of file alg_id.cpp.

                                                              {
   codec.start_sequence().encode(oid()).raw_bytes(parameters()).end_cons();
}

References Botan::DER_Encoder::encode(), Botan::DER_Encoder::end_cons(), oid(), parameters(), Botan::DER_Encoder::raw_bytes(), and Botan::DER_Encoder::start_sequence().

get_oid()

const OID & Botan::AlgorithmIdentifier::get_oid ( ) const

inline

Definition at line 461 of file asn1_obj.h.

{ return m_oid; }

get_parameters()

const std::vector< uint8_t > & Botan::AlgorithmIdentifier::get_parameters ( ) const

inline

Definition at line 465 of file asn1_obj.h.

{ return m_parameters; }

oid()

const OID & Botan::AlgorithmIdentifier::oid ( ) const

inline

Definition at line 455 of file asn1_obj.h.

{ return m_oid; }

Referenced by Botan::PKIX::check_chain(), Botan::X509::create_self_signed_cert(), encode_into(), Botan::PSS_Params::hash_function(), Botan::OCSP::CertID::is_id_for(), Botan::load_private_key(), Botan::load_public_key(), Botan::PSS_Params::mgf_function(), Botan::operator==(), Botan::pbes2_decrypt(), Botan::X509_Certificate::to_string(), and Botan::PK_Ops::Verification_with_Hash::Verification_with_Hash().

parameters()

const std::vector< uint8_t > & Botan::AlgorithmIdentifier::parameters ( ) const

inline

Definition at line 457 of file asn1_obj.h.

{ return m_parameters; }

Referenced by Botan::SphincsPlus_PublicKey::algorithm_identifier(), Botan::PSS_Params::decode_from(), Botan::EC_PrivateKey::EC_PrivateKey(), encode_into(), Botan::GOST_3410_PublicKey::GOST_3410_PublicKey(), Botan::operator==(), and Botan::pbes2_decrypt().

parameters_are_empty()

bool Botan::AlgorithmIdentifier::parameters_are_empty ( ) const

inline

Definition at line 469 of file asn1_obj.h.

{ return m_parameters.empty(); }

Referenced by Botan::PK_Ops::Verification_with_Hash::Verification_with_Hash().

parameters_are_null()

bool Botan::AlgorithmIdentifier::parameters_are_null

(

)

const

Definition at line 50 of file alg_id.cpp.

                                                    {
   return (m_parameters.size() == 2 && (m_parameters[0] == 0x05) && (m_parameters[1] == 0x00));
}

Referenced by Botan::PK_Ops::Verification_with_Hash::Verification_with_Hash().

parameters_are_null_or_empty()

bool Botan::AlgorithmIdentifier::parameters_are_null_or_empty ( ) const

inline

Definition at line 471 of file asn1_obj.h.

{ return parameters_are_empty() || parameters_are_null(); }

Referenced by Botan::operator==().

---

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

• src/lib/asn1/asn1_obj.h
• src/lib/asn1/alg_id.cpp