The snmp_dpi_get_packet structure

Format

struct dpi_get_packet {
  char                  *object_p;   /* ptr to OID string     */
  char                  *group_p;    /* ptr to subtree(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)

Parameters

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 included only for DPI Version 1 compatibility and it might be withdrawn in a later version.
group_p: A pointer to a null-terminated character string that represents the registered subtree that caused this SET request to be passed to this DPI subagent. The subtree must have a trailing period.
instance_p: A pointer to a null-terminated character string that represents the rest, which is the piece that follows the subtree part, of the object identifier of the variable instance being accessed.
Use of the term instance_p here must not be confused with an OBJECT instance because this string might 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.

Usage

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 variable instances are to be returned in a DPI RESPONSE.

Format

Parameters

Usage

Context