The snmp_dpi_get_packet Structure

Structure Definition

struct dpi_get_packet {
  char                  *object_p;   /* ptr to OID string     */
  char                  *group_p;    /* ptr to sub-tree(group)*/
  char                  *instance_p; /* ptr to rest of OID    */
  struct dpi_get_packet *next_p;     /* ptr to next in chain  */
};
typedef struct dpi_get_packet        snmp_dpi_get_packet;
#define snmp_dpi_get_packet_NULL_p   ((snmp_dpi_get_packet *)0)

Structure Members

object_p

A pointer to a NULL terminated character string that represents the full OBJECT IDENTIFIER of the variable instance that is being accessed. It basically is a concatenation of the fields group_p and instance_p. Using this field is not recommended because it is only included for DPI Version 1 compatibility and it maybe withdrawn in a later version.
group_p
A pointer to a NULL terminated character string that represents the registered sub-tree that caused this GET request to be passed to this DPI subagent. The sub-tree must have a trailing dot.
instance_p
A pointer to a NULL terminated character string that represents the rest which is the piece following the sub-tree part of the OBJECT IDENTIFIER of the variable instance being accessed.

Use of the term instance_p here should not be confused with an OBJECT instance because this string may consist of a piece of the OBJECT IDENTIFIER plus the INSTANCE IDENTIFIER.

next_p
A pointer to a possible next snmp_dpi_get_packet structure. If this next field contains the NULL pointer, this is the end of the chain.

Description

The snmp_dpi_get_packet structure represents a parse tree for a DPI GET packet.

At the subagent side, the snmp_dpi_get_packet structure is normally created as a result of a call to pDPIpacket(). This is the case if the DPI packet is of type SNMP_DPI_GET. The snmp_dpi_hdr structure then contains a pointer to a chain of one or more snmp_dpi_get_packet structures.

The DPI subagent programmer uses this structure to find out which variables instances are to be returned in a DPI RESPONSE.

Related Information

The pDPIpacket() Function The snmp_dpi_hdr Structure

---

[Back: The snmp_dpi_close_packet Structure]
[Next: The snmp_dpi_hdr Structure]