Struct V3Message 

pub struct V3Message {
    pub global_data: MsgGlobalData,
    pub security_params: Bytes,
    pub data: V3MessageData,
}

SNMPv3 message.

Fields

global_data: MsgGlobalData

Global data (header)

security_params: Bytes

Security parameters (opaque, USM-encoded)

data: V3MessageData

Message data - either plaintext ScopedPdu or encrypted bytes

Implementations

impl V3Message

pub fn new( global_data: MsgGlobalData, security_params: Bytes, scoped_pdu: ScopedPdu, ) -> Self

Create a new V3 message with plaintext data.

pub fn new_encrypted( global_data: MsgGlobalData, security_params: Bytes, encrypted: Bytes, ) -> Self

Create a new V3 message with encrypted data.

pub fn scoped_pdu(&self) -> Option<&ScopedPdu>

Get the scoped PDU if available (plaintext only).

pub fn into_scoped_pdu(self) -> Option<ScopedPdu>

Consume and return the scoped PDU if available.

pub fn pdu(&self) -> Option<&Pdu>

Get the PDU if available (convenience method).

pub fn into_pdu(self) -> Option<Pdu>

Consume and return the PDU.

pub fn msg_id(&self) -> i32

Get the message ID.

pub fn security_level(&self) -> SecurityLevel

Get the security level.

pub fn encode(&self) -> Bytes

Encode to BER.

Note: For authenticated messages, the caller must:

1. Encode with placeholder auth params (12 zero bytes for HMAC-96)
2. Compute HMAC over the entire encoded message
3. Replace the placeholder with the actual HMAC

pub fn decode(data: Bytes) -> Result<Self>

Decode from BER.

For encrypted messages, returns V3MessageData::Encrypted with the raw ciphertext. The caller must decrypt using USM before accessing the scoped PDU.

pub fn discovery_request(msg_id: i32) -> Self

Create a discovery request message.

This is sent to discover the engine ID and time of a remote SNMP engine. Uses empty security parameters and no authentication.

Trait Implementations

impl Clone for V3Message

fn clone(&self) -> V3Message

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for V3Message

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

Formats the value using the given formatter.

impl From<V3Message> for Message

fn from(msg: V3Message) -> Self

Converts to this type from the input type.