Enum csnmp::message::SnmpMessageError

pub enum SnmpMessageError {
    Asn1Decoding(ASN1DecodeErr),
    Asn1Encoding(ASN1EncodeErr),
    Length {
        expected: usize,
        obtained: usize,
    },
    TooShort {
        expected: usize,
        obtained: usize,
    },
    UnexpectedType {
        expected: ExpectedAsn1Type,
        obtained: ASN1Block,
    },
    IntegerPrimitiveRange {
        primitive_type: &'static str,
        obtained: ASN1Block,
    },
    IncorrectVersion {
        expected: i64,
        obtained: i64,
    },
    UnexpectedTag {
        obtained: BigUint,
    },
    UnexpectedTagClass {
        expected: Vec<ASN1Class>,
        obtained: ASN1Class,
    },
    UntaggedValue {
        obtained: ASN1Block,
    },
    EnumRange {
        enum_name: &'static str,
        obtained: ASN1Block,
    },
    OidDecode {
        oid: OID,
        error: ObjectIdentifierConversionError,
    },
    OidEncode {
        oid: ObjectIdentifier,
        error: ObjectIdentifierConversionError,
    },
}

An error that has occurred while attempting to read an SNMP message.

Variants

Asn1Decoding(ASN1DecodeErr)

An error has occurred while attempting to parse the ASN.1 message.

Asn1Encoding(ASN1EncodeErr)

An error has occurred while attempting to encode the ASN.1 message.

Length

Fields

expected: usize

obtained: usize

The message, or a part of it, has an incorrect length. A specific length is expected.

expected and obtained are in units of ASN.1 blocks.

TooShort

Fields

expected: usize

obtained: usize

The message, or a part of it, was too short. A minimum length is expected.

expected and obtained are in units of ASN.1 blocks.

UnexpectedType

Fields

expected: ExpectedAsn1Type

obtained: ASN1Block

While decoding the message, a different type was read than expected.

IntegerPrimitiveRange

Fields

primitive_type: &'static str

obtained: ASN1Block

While decoding an integer, it did not fit in the range of a primitive type.

IncorrectVersion

Fields

expected: i64

obtained: i64

The SNMP message has an incorrect version.

UnexpectedTag

Fields

obtained: BigUint

A value was tagged by an unexpected tag.

UnexpectedTagClass

Fields

expected: Vec<ASN1Class>

obtained: ASN1Class

A value was tagged by a tag of an unexpected class.

UntaggedValue

Fields

obtained: ASN1Block

A value was expected to be tagged but wasn’t.

EnumRange

Fields

enum_name: &'static str

obtained: ASN1Block

An out-of-range value has been obtained for an enumeration.

OidDecode

Fields

oid: OID

error: ObjectIdentifierConversionError

An object identifier has been encountered which is a valid ASN.1 object identifier but not a valid SNMP object identifier.

OidEncode

Fields

oid: ObjectIdentifier

error: ObjectIdentifierConversionError

An object identifier has been encountered which is a valid SNMP object identifier but not a valid ASN.1 object identifier.

Implementations

impl SnmpMessageError

pub fn check_min_length( blocks: &[ASN1Block], expected: usize ) -> Result<(), SnmpMessageError>

Checks whether the given slice of ASN1Blocks has at least the given number of elements. Returns Ok(()) if it does and Err(_) with an appropriate SnmpMessageError variant if it does not.

pub fn check_length( blocks: &[ASN1Block], expected: usize ) -> Result<(), SnmpMessageError>

Checks whether the given slice of ASN1Blocks has exactly the given number of elements. Returns Ok(()) if it does and Err(_) with an appropriate SnmpMessageError variant if it does not.

pub fn check_tag_class( obtained: ASN1Class, expected: ASN1Class ) -> Result<(), SnmpMessageError>

Checks whether the given ASN1Class has the given value. Returns Ok(()) if it does and Err(_) with an appropriate SnmpMessageError variant if it does not.

Trait Implementations

impl Clone for SnmpMessageError

fn clone(&self) -> SnmpMessageError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SnmpMessageError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for SnmpMessageError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for SnmpMessageError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<ASN1DecodeErr> for SnmpMessageError

fn from(e: ASN1DecodeErr) -> Self

Converts to this type from the input type.

impl From<ASN1EncodeErr> for SnmpMessageError

fn from(e: ASN1EncodeErr) -> Self

Converts to this type from the input type.

impl PartialEq for SnmpMessageError

fn eq(&self, other: &SnmpMessageError) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SnmpMessageError