#include <src/BER.h>

Inheritance diagram for SNMP::BER:

Collaboration diagram for SNMP::BER:

Public Member Functions
	BER (const unsigned int type)
	Creates a BER object.

virtual	~BER ()
	BER destructor.

virtual void	encode (Stream &stream)
	Encodes BER type and length to stream.

template<typename T>
void	encodeNumeric (T value, Stream &stream)
	Encodes BER numeric value to stream.

virtual void	decode (Stream &stream, const uint8_t flag=Flag::None)
	Decodes BER type and length from stream.

template<typename T>
void	decodeNumeric (T *value, Stream &stream, const uint8_t flag=Flag::None)
	Decodes BER numeric value from stream.

virtual uint8_t *	encode (uint8_t *buffer)
	Encodes BER type and length to memory buffer.

template<typename T>
uint8_t *	encodeNumeric (T value, uint8_t *buffer)
	Encodes BER numeric value to memory buffer.

virtual uint8_t *	decode (uint8_t *buffer)
	Decodes BER type and length from memory buffer.

template<typename T>
uint8_t *	decodeNumeric (T value, uint8_t buffer, const uint8_t flag=Flag::None)
	Decodes BER numeric value from memory buffer.

template<typename T>
void	setNegative (T value)
	Computes BER length of a negative integer.

template<typename T>
void	setPositive (T value)
	Computes BER length of a positive integer.

const unsigned int	getType () const
	Gets the BER type.

const unsigned int	getLength () const
	Gets the BER length.

virtual const unsigned int	getSize (const bool refresh=false)
	Gets the size of the BER.

Public Member Functions inherited from SNMP::Base
void	encode7bits (uint32_t value, uint8_t *buffer, const uint8_t size)
	Encodes integer value to memory buffer.

Protected Member Functions
BER *	create (const Type &type)
	Creates a BER of given type.

Protected Attributes
Length	_length

Type	_type

Protected Attributes inherited from SNMP::Base
unsigned int	_size = 0

Additional Inherited Members
Static Public Member Functions inherited from SNMP::Base
static void	encode7bits (uint32_t value, Stream &stream, const uint8_t size)
	Encodes integer value to stream.

Detailed Description

BER object.

This class is the base class of all the BER objects.

A BER object uses the TLV format. TLV is an acronym for type, length and value.

Type is the type of the object.
Length is the length of the value of the object.
Value is the value of the object.

Definition at line 793 of file BER.h.

Constructor & Destructor Documentation

◆ BER()

SNMP::BER::BER ( const unsigned int type )

inline

Creates a BER object.

Parameters

type BER type.

Definition at line 800 of file BER.h.

References _length, and _type.

Referenced by SNMP::ArrayBER::add(), SNMP::ArrayBER::ArrayBER(), SNMP::BooleanBER::BooleanBER(), create(), SNMP::ArrayBER::decode(), SNMP::ArrayBER::decode(), SNMP::FloatBER::FloatBER(), SNMP::OpaqueBER::getBER(), SNMP::IntegerBER::IntegerBER(), SNMP::NullBER::NullBER(), SNMP::ObjectIdentifierBER::ObjectIdentifierBER(), SNMP::OctetStringBER::OctetStringBER(), SNMP::OpaqueBER::OpaqueBER(), SNMP::ArrayBER::operator[](), and SNMP::UIntegerBER< T >::UIntegerBER().

◆ ~BER()

virtual SNMP::BER::~BER ( )

inlinevirtual

BER destructor.

Definition at line 809 of file BER.h.

Member Function Documentation

◆ create()

BER * SNMP::BER::create ( const Type & type )

protected

Creates a BER of given type.

Parameters

type BER type.

Returns: Pointer to created BER or nullptr if the type is unknown.

Definition at line 15 of file BER.cpp.

References BER(), SNMP::Type::Boolean, SNMP::Type::Counter32, SNMP::Type::Counter64, SNMP::Type::EndOfMIBView, SNMP::Type::Float, SNMP::Type::Gauge32, SNMP::Type::GetBulkRequest, SNMP::Type::GetNextRequest, SNMP::Type::GetRequest, SNMP::Type::GetResponse, SNMP::Type::InformRequest, SNMP::Type::Integer, SNMP::Type::IPAddress, SNMP::Type::NoSuchInstance, SNMP::Type::NoSuchObject, SNMP::Type::Null, SNMP::Type::ObjectIdentifier, SNMP::Type::OctetString, SNMP::Type::Opaque, SNMP::Type::OpaqueFloat, SNMP::Type::Report, SNMP::Type::Sequence, SNMP::Type::SetRequest, SNMP::Type::SNMPv2Trap, SNMP::Type::TimeTicks, and SNMP::Type::Trap.

Referenced by SNMP::ArrayBER::decode(), SNMP::ArrayBER::decode(), SNMP::OpaqueBER::decode(), and SNMP::OpaqueBER::decode().

◆ decode() [1/2]

virtual void SNMP::BER::decode	(	Stream &	stream,
		const uint8_t	flag = Flag::None )

inlinevirtual

Decodes BER type and length from stream.

Warning: Must be called first by derived class in overridden functions.

Parameters

stream	Stream to read from.
flag	Decoding flag.

Reimplemented in SNMP::ArrayBER, SNMP::ArrayBER< 2 >, SNMP::ArrayBER< SNMP_CAPACITY >, SNMP::BooleanBER, SNMP::FloatBER, SNMP::IntegerBER, SNMP::ObjectIdentifierBER, SNMP::OctetStringBER, SNMP::OpaqueBER, SNMP::UIntegerBER< T >, SNMP::UIntegerBER< uint32_t >, and SNMP::UIntegerBER< uint64_t >.

Definition at line 850 of file BER.h.

References _length, _type, SNMP::Flag::None, and SNMP::Flag::Typed.

Referenced by SNMP::ArrayBER::decode(), SNMP::ArrayBER::decode(), SNMP::BooleanBER::decode(), SNMP::BooleanBER::decode(), SNMP::ObjectIdentifierBER::decode(), SNMP::ObjectIdentifierBER::decode(), SNMP::OctetStringBER::decode(), SNMP::OctetStringBER::decode(), SNMP::OpaqueBER::decode(), SNMP::OpaqueBER::decode(), decodeNumeric(), and decodeNumeric().

◆ decode() [2/2]

virtual uint8_t * SNMP::BER::decode ( uint8_t * buffer )

inlinevirtual

Decodes BER type and length from memory buffer.

Warning: Must be called first by derived class in overridden functions.

Parameters

buffer Pointer to the buffer.

Returns: Next position to be read in buffer.

Reimplemented in SNMP::ArrayBER, SNMP::ArrayBER< 2 >, SNMP::ArrayBER< SNMP_CAPACITY >, SNMP::BooleanBER, SNMP::FloatBER, SNMP::IntegerBER, SNMP::ObjectIdentifierBER, SNMP::OctetStringBER, SNMP::OpaqueBER, SNMP::UIntegerBER< T >, SNMP::UIntegerBER< uint32_t >, and SNMP::UIntegerBER< uint64_t >.

Definition at line 922 of file BER.h.

References _length, and _type.

◆ decodeNumeric() [1/2]

template<typename T>

void SNMP::BER::decodeNumeric	(	T *	value,
		Stream &	stream,
		const uint8_t	flag = Flag::None )

inline

Decodes BER numeric value from stream.

SNMP numeric values are big-endian. Most significants bytes are read first.

Template Parameters

T	C++ type of the numeric value.

Parameters

value	Numeric value to decode.
stream	Stream to read from.
flag	Decoding flag.

Definition at line 868 of file BER.h.

References _length, decode(), and SNMP::Flag::None.

Referenced by SNMP::FloatBER::decode(), SNMP::FloatBER::decode(), SNMP::IntegerBER::decode(), SNMP::IntegerBER::decode(), SNMP::UIntegerBER< T >::decode(), and SNMP::UIntegerBER< T >::decode().

◆ decodeNumeric() [2/2]

template<typename T>

uint8_t * SNMP::BER::decodeNumeric	(	T *	value,
		uint8_t *	buffer,
		const uint8_t	flag = Flag::None )

inline

Decodes BER numeric value from memory buffer.

SNMP numeric values are big-endian. Most significants bytes are read first.

Template Parameters

T	C++ type of the numeric value.

Parameters

value	Numeric value to decode.
buffer	Pointer to the buffer.
flag	Decoding flag.

Returns: Next position to be read in buffer.

Definition at line 940 of file BER.h.

References _length, decode(), and SNMP::Flag::None.

◆ encode() [1/2]

virtual void SNMP::BER::encode ( Stream & stream )

inlinevirtual

Encodes BER type and length to stream.

Warning: Must be called first by derived class in overridden functions.

Parameters

stream Stream to write to.

Reimplemented in SNMP::ArrayBER, SNMP::ArrayBER< 2 >, SNMP::ArrayBER< SNMP_CAPACITY >, SNMP::BooleanBER, SNMP::FloatBER, SNMP::IntegerBER, SNMP::ObjectIdentifierBER, SNMP::OctetStringBER, SNMP::OpaqueBER, SNMP::UIntegerBER< T >, SNMP::UIntegerBER< uint32_t >, and SNMP::UIntegerBER< uint64_t >.

Definition at line 820 of file BER.h.

References _length, and _type.

Referenced by SNMP::ArrayBER::encode(), SNMP::ArrayBER::encode(), SNMP::BooleanBER::encode(), SNMP::BooleanBER::encode(), SNMP::ObjectIdentifierBER::encode(), SNMP::ObjectIdentifierBER::encode(), SNMP::OctetStringBER::encode(), SNMP::OctetStringBER::encode(), SNMP::OpaqueBER::encode(), SNMP::OpaqueBER::encode(), encodeNumeric(), and encodeNumeric().

◆ encode() [2/2]

virtual uint8_t * SNMP::BER::encode ( uint8_t * buffer )

inlinevirtual

Encodes BER type and length to memory buffer.

Warning: Must be called first by derived class in overridden functions.

Parameters

buffer Pointer to the buffer.

Returns: Next position to be written in buffer.

Reimplemented in SNMP::ArrayBER, SNMP::ArrayBER< 2 >, SNMP::ArrayBER< SNMP_CAPACITY >, SNMP::BooleanBER, SNMP::FloatBER, SNMP::IntegerBER, SNMP::ObjectIdentifierBER, SNMP::OctetStringBER, SNMP::OpaqueBER, SNMP::UIntegerBER< T >, SNMP::UIntegerBER< uint32_t >, and SNMP::UIntegerBER< uint64_t >.

Definition at line 889 of file BER.h.

References _length, and _type.

◆ encodeNumeric() [1/2]

template<typename T>

void SNMP::BER::encodeNumeric	(	T	value,
		Stream &	stream )

inline

Encodes BER numeric value to stream.

SNMP numeric values are big-endian. Most significants bytes are written first.

Template Parameters

T	C++ type of the integer.

Parameters

value	Integer value to encode.
stream	Stream to write to.

Definition at line 835 of file BER.h.

References _length, and encode().

Referenced by SNMP::FloatBER::encode(), SNMP::FloatBER::encode(), SNMP::IntegerBER::encode(), SNMP::IntegerBER::encode(), SNMP::UIntegerBER< T >::encode(), and SNMP::UIntegerBER< T >::encode().

◆ encodeNumeric() [2/2]

template<typename T>

uint8_t * SNMP::BER::encodeNumeric	(	T	value,
		uint8_t *	buffer )

inline

Encodes BER numeric value to memory buffer.

SNMP numeric values are big-endian. Most significants bytes are written first.

Template Parameters

T	C++ type of the numeric value.

Parameters

value	Numeric value to encode.
buffer	Pointer to the buffer.

Returns: Next position to be written in buffer.

Definition at line 906 of file BER.h.

References _length, and encode().

◆ getLength()

const unsigned int SNMP::BER::getLength ( ) const

inline

Gets the BER length.

Returns: BER length.

Definition at line 1006 of file BER.h.

References _length.

◆ getSize()

virtual const unsigned int SNMP::BER::getSize ( const bool refresh = false )

inlinevirtual

Gets the size of the BER.

The size of the BER is computed from:

Type size.
Length size.
Length.

Parameters

refresh Unused.

Returns: BER size.

Reimplemented in SNMP::ArrayBER, SNMP::ArrayBER< 2 >, SNMP::ArrayBER< SNMP_CAPACITY >, SNMP::Message, and SNMP::OpaqueBER.

Definition at line 1022 of file BER.h.

References _length, SNMP::Base::_size, and _type.

Referenced by SNMP::ArrayBER::add(), SNMP::ArrayBER::decode(), SNMP::ArrayBER::getSize(), and SNMP::OpaqueBER::getSize().

◆ getType()

const unsigned int SNMP::BER::getType ( ) const

inline

Gets the BER type.

Returns: BER type.

Definition at line 997 of file BER.h.

References _type.

Referenced by SNMP::Message::parse().

◆ setNegative()

template<typename T>

void SNMP::BER::setNegative ( T value )

inline

Computes BER length of a negative integer.

Template Parameters

T	C++ type of the integer.

Parameters

value Integer value.

Definition at line 963 of file BER.h.

References _length.

Referenced by SNMP::IntegerBER::setValue().

◆ setPositive()

template<typename T>

void SNMP::BER::setPositive ( T value )

inline

Computes BER length of a positive integer.

Template Parameters

T	C++ type of the integer.

Parameters

value Integer value.

Definition at line 981 of file BER.h.

References _length.

Referenced by SNMP::IntegerBER::setValue(), and SNMP::UIntegerBER< T >::setValue().

Member Data Documentation

◆ _length

Length SNMP::BER::_length

protected

BER length.

Definition at line 1029 of file BER.h.

Referenced by SNMP::ArrayBER::add(), SNMP::OctetStringBER::allocate(), BER(), SNMP::BooleanBER::BooleanBER(), SNMP::ArrayBER::decode(), SNMP::ArrayBER::decode(), decode(), decode(), SNMP::ObjectIdentifierBER::decode(), SNMP::ObjectIdentifierBER::decode(), SNMP::OctetStringBER::decode(), SNMP::OctetStringBER::decode(), SNMP::OpaqueBER::decode(), SNMP::OpaqueBER::decode(), decodeNumeric(), decodeNumeric(), encode(), encode(), SNMP::OctetStringBER::encode(), SNMP::OctetStringBER::encode(), encodeNumeric(), encodeNumeric(), SNMP::FloatBER::FloatBER(), getLength(), SNMP::ArrayBER::getSize(), getSize(), SNMP::OpaqueBER::getSize(), SNMP::IPAddressBER::IPAddressBER(), SNMP::OpaqueBER::OpaqueBER(), SNMP::ArrayBER::remove(), setNegative(), setPositive(), SNMP::ObjectIdentifierBER::setValue(), and SNMP::OctetStringBER::setValue().

◆ _type

Type SNMP::BER::_type

protected

BER type.

Definition at line 1031 of file BER.h.

Referenced by BER(), decode(), decode(), encode(), encode(), getSize(), and getType().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ BER()

◆ ~BER()

Member Function Documentation

◆ create()

◆ decode() [1/2]

◆ decode() [2/2]

◆ decodeNumeric() [1/2]

◆ decodeNumeric() [2/2]

◆ encode() [1/2]

◆ encode() [2/2]

◆ encodeNumeric() [1/2]

◆ encodeNumeric() [2/2]

◆ getLength()

◆ getSize()

◆ getType()

◆ setNegative()

◆ setPositive()

Member Data Documentation

◆ _length

◆ _type