Struct RequestContext 

pub struct RequestContext {
    pub source: SocketAddr,
    pub version: Version,
    pub security_model: SecurityModel,
    pub security_name: Bytes,
    pub security_level: SecurityLevel,
    pub context_name: Bytes,
    pub request_id: i32,
    pub pdu_type: PduType,
    pub group_name: Option<Bytes>,
    pub read_view: Option<Bytes>,
    pub write_view: Option<Bytes>,
}

Request context passed to MIB handlers.

Contains information about the incoming request for authorization decisions, including VACM-resolved access control information when VACM is enabled.

Fields

The context provides:

• Request origin: Source address and request ID
• Security info: Version, model, level, and security name (community/username)
• VACM info: Group name and view names (when VACM is configured)

Example

use async_snmp::handler::{MibHandler, RequestContext, GetResult, BoxFuture};
use async_snmp::{Oid, Value, oid};

struct LoggingHandler;

impl MibHandler for LoggingHandler {
    fn get<'a>(&'a self, ctx: &'a RequestContext, oid: &'a Oid) -> BoxFuture<'a, GetResult> {
        Box::pin(async move {
            // Log request details
            println!(
                "GET {} from {} (user: {:?}, version: {:?})",
                oid, ctx.source, ctx.security_name, ctx.version
            );

            if oid == &oid!(1, 3, 6, 1, 4, 1, 99999, 1, 0) {
                GetResult::Value(Value::Integer(42))
            } else {
                GetResult::NoSuchObject
            }
        })
    }

    fn get_next<'a>(
        &'a self,
        _ctx: &'a RequestContext,
        _oid: &'a Oid,
    ) -> BoxFuture<'a, async_snmp::handler::GetNextResult> {
        Box::pin(async { async_snmp::handler::GetNextResult::EndOfMibView })
    }
}

Fields

source: SocketAddr

Source address of the request.

Use this for logging or additional access control beyond VACM.

version: Version

SNMP version (V1, V2c, or V3).

security_model: SecurityModel

Security model used for this request.

• V1 for SNMPv1 community-based
• V2c for SNMPv2c community-based
• Usm for SNMPv3 User-based Security Model

security_name: Bytes

Security name (community string or USM username).

For v1/v2c: the community string For v3: the USM username

security_level: SecurityLevel

Security level (v3 only, NoAuthNoPriv for v1/v2c).

Indicates whether authentication and/or privacy were used.

context_name: Bytes

Context name (v3 only, empty for v1/v2c).

SNMPv3 contexts allow partitioning MIB views.

request_id: i32

Request ID from the PDU.

Useful for correlating requests with responses in logs.

pdu_type: PduType

PDU type (GetRequest, GetNextRequest, SetRequest, etc.).

group_name: Option<Bytes>

Resolved group name (if VACM enabled).

Set when VACM successfully maps the security name to a group.

read_view: Option<Bytes>

Read view name (if VACM enabled).

The view that controls which OIDs can be read.

write_view: Option<Bytes>

Write view name (if VACM enabled).

The view that controls which OIDs can be written.

Implementations

impl RequestContext

pub fn test_context() -> Self

Create a minimal context for unit testing.

Trait Implementations

impl Clone for RequestContext

fn clone(&self) -> RequestContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestContext

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

Formats the value using the given formatter.