SNMP Primitive Types

[This is preliminary documentation and subject to change.]

SNMP primitive types map to CIM defined types. The following tables define the mapping where the SYNTAX clause explicitly refers to a primitive type.

Table 1: Mapping SNMPv1 Primitive Types

MIB type	Variant type	Textual convention qualifier	Encoding qualifier	Object syntax qualifier	Cimtype qualifier	Default value
INTEGER	VT_I4	INTEGER	INTEGER	INTEGER	sint32	0
OCTET STRING	VT_BSTR	OCTETSTRING	OCTETSTRING	OCTETSTRING	string
OBJECT IDENTIFIER	VT_BSTR	OBJECTIDENTIFIER	OBJECTIDENTIFIER	OBJECTIDENTIFIER	string	0.0
NULL	VT_NULL	NULL	NULL	NULL	Not supported (1)	N/A
IpAddress	VT_BSTR	IpAddress	IpAddress	IpAddress	string	0.0.0.0
Counter	VT_I4	Counter	Counter	Counter	uint	0
Gauge	VT_I4	Gauge	Gauge	Gauge	string	0
TimeTicks	VT_I4	TimeTicks	TimeTicks	TimeTicks	uint32	0
Opaque	VT_BSTR	Opaque	Opaque	Opaque	string
NetworkAddress	VT_BSTR	NetworkAddress	NetworkAddress	NetworkAddress	string	0.0.0.0

(1) When the SYNTAX clause of the OBJECT-TYPE macro refers to NULL either explicitly or through a named type assignment, that OBJECT-TYPE macro is ignored.

Table 2: Mapping SNMPv2C Primitive Types

MIB type	Variant type	Textual convention qualifier	Encoding qualifier	Object syntax qualifier	Cimtype qualifier	Default value
INTEGER	VT_I4	INTEGER	INTEGER	INTEGER	sint32	0
OCTET STRING	VT_BSTR	OCTETSTRING	OCTETSTRING	OCTETSTRING	string
OBJECT IDENTIFIER	VT_BSTR	OBJECTIDENTIFIER	OBJECTIDENTIFIER	OBJECTIDENTIFIER	string	0.0
IpAddress	VT_BSTR	IpAddress	IpAddress	IpAddress	string	0.0.0.0
Counter32	VT_I4	Counter32	Counter32	Counter32	uint32	0
Gauge32	VT_I4	Gauge32	Gauge32	Gauge32	uint32	0
Unsigned32	VT_I4	Unsigned32	Unsigned32	Unsigned32	uint32	0
Integer32	VT_I4	Integer32	Integer32	Integer32	sint32	0
Counter64	VT_BSTR	Counter64	Counter64	Counter64	uint64	0
TimeTicks	VT_I4	TimeTicks	TimeTicks	TimeTicks	uint32	0
Opaque	VT_BSTR	Opaque	Opaque	Opaque	string

The CIM named qualifier textual_convention defines the textual representation of the SYNTAX clause of the OBJECT-TYPE macro.

The CIM named qualifier object_syntax defines the named type definition present within the SYNTAX clause of the OBJECT-TYPE macro. The object_syntax is copied verbatim from the SYNTAX clause of the OBJECT-TYPE macro.

The CIM named qualifier encoding defines the SNMP type used when encoding SNMPv1 and SNMPv2C protocol frames.