SNMP-TARGET-MIB
Standards (IETF)This MIB module defines MIB objects which provide mechanisms to remotely configure the parameters used by an SNMP entity for the generation of SNMP messages. Copyright (C) The Internet Society (2002). This version of this MIB module is part of RFC 3413; see the RFC itself for full legal notices.
snmptranslate -m SNMP-TARGET-MIB -Tpsnmpwalk -v2c -c <community> -m SNMP-TARGET-MIB <host> 1.3.6.1.6.3.12Imports
| SNMP-FRAMEWORK-MIB | SnmpAdminString, SnmpMessageProcessingModel, SnmpSecurityLevel, SnmpSecurityModel |
|---|---|
| SNMPv2-CONF | MODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP |
| SNMPv2-SMI | Bits, Counter32, Integer32, IpAddress, MODULE-IDENTITY, MibIdentifier, OBJECT-IDENTITY, OBJECT-TYPE, TimeTicks, Unsigned32, iso, snmpModules |
| SNMPv2-TC | DisplayString, PhysAddress, RowStatus, StorageType, TAddress, TDomain, TEXTUAL-CONVENTION, TestAndIncr, TimeInterval |
OID tree
| Name | OID | Type | Access | Status | Example | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| IsnmpTargetMIB | 1.3.6.1.6.3.12 | ||||||||||||||||||||
identity This MIB module defines MIB objects which provide mechanisms to remotely configure the parameters used by an SNMP entity for the generation of SNMP messages. Copyright (C) The Internet Society (2002). This version of this MIB module is part of RFC 3413; see the RFC itself for full legal notices. | |||||||||||||||||||||
| NsnmpTargetObjects | 1.3.6.1.6.3.12.1 | ||||||||||||||||||||
| SsnmpTargetSpinLock | 1.3.6.1.6.3.12.1.1 | TestAndIncr | RW | 0 | |||||||||||||||||
scalar · TestAndIncr · read-write · current This object is used to facilitate modification of table
entries in the SNMP-TARGET-MIB module by multiple
managers. In particular, it is useful when modifying
the value of the snmpTargetAddrTagList object.
The procedure for modifying the snmpTargetAddrTagList
object is as follows:
1. Retrieve the value of snmpTargetSpinLock and
of snmpTargetAddrTagList.
2. Generate a new value for snmpTargetAddrTagList.
3. Set the value of snmpTargetSpinLock to the
retrieved value, and the value of
snmpTargetAddrTagList to the new value. If
the set fails for the snmpTargetSpinLock
object, go back to step 1.Example values from LibreNMS test devices
| |||||||||||||||||||||
| TsnmpTargetAddrTable | 1.3.6.1.6.3.12.1.2 | NA | |||||||||||||||||||
table · not-accessible · current A table of transport addresses to be used in the generation of SNMP messages. | |||||||||||||||||||||
| RsnmpTargetAddrEntry | 1.3.6.1.6.3.12.1.2.1 | NA | |||||||||||||||||||
row · not-accessible · current A transport address to be used in the generation of SNMP operations. Entries in the snmpTargetAddrTable are created and deleted using the snmpTargetAddrRowStatus object.
| |||||||||||||||||||||
| CsnmpTargetAddrName | 1.3.6.1.6.3.12.1.2.1.1 | SnmpAdminString (SIZE (1..32)) | NA | SNMP Destination/1 | |||||||||||||||||
column · SnmpAdminString (SIZE (1..32)) · not-accessible · current The locally arbitrary, but unique identifier associated with this snmpTargetAddrEntry. | |||||||||||||||||||||
| CsnmpTargetAddrTDomain | 1.3.6.1.6.3.12.1.2.1.2 | TDomain | RC | 0.0 | |||||||||||||||||
column · TDomain · read-create · current This object indicates the transport type of the address contained in the snmpTargetAddrTAddress object. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetAddrTAddress | 1.3.6.1.6.3.12.1.2.1.3 | TAddress | RC | unknown | |||||||||||||||||
column · TAddress · read-create · current This object contains a transport address. The format of this address depends on the value of the snmpTargetAddrTDomain object. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetAddrTimeout | 1.3.6.1.6.3.12.1.2.1.4 | TimeInterval | RC | 0 | |||||||||||||||||
column · TimeInterval · read-create · current This object should reflect the expected maximum round trip time for communicating with the transport address defined by this row. When a message is sent to this address, and a response (if one is expected) is not received within this time period, an implementation may assume that the response will not be delivered. Note that the time interval that an application waits for a response may actually be derived from the value of this object. The method for deriving the actual time interval is implementation dependent. One such method is to derive the expected round trip time based on a particular retransmission algorithm and on the number of timeouts which have occurred. The type of message may also be considered when deriving expected round trip times for retransmissions. For example, if a message is being sent with a securityLevel that indicates both authentication and privacy, the derived value may be increased to compensate for extra processing time spent during authentication and encryption processing. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetAddrRetryCount | 1.3.6.1.6.3.12.1.2.1.5 | Integer32 (0..255) | RC | 3000 | |||||||||||||||||
column · Integer32 (0..255) · read-create · current This object specifies a default number of retries to be attempted when a response is not received for a generated message. An application may provide its own retry count, in which case the value of this object is ignored. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetAddrTagList | 1.3.6.1.6.3.12.1.2.1.6 | SnmpTagList | RC | | |||||||||||||||||
column · SnmpTagList · read-create · current This object contains a list of tag values which are used to select target addresses for a particular operation. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetAddrParams | 1.3.6.1.6.3.12.1.2.1.7 | SnmpAdminString (SIZE (1..32)) | RC | | |||||||||||||||||
column · SnmpAdminString (SIZE (1..32)) · read-create · current The value of this object identifies an entry in the snmpTargetParamsTable. The identified entry contains SNMP parameters to be used when generating messages to be sent to this transport address. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetAddrStorageType | 1.3.6.1.6.3.12.1.2.1.8 | StorageType | RC | 1 | |||||||||||||||||
column · StorageType · read-create · current The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetAddrRowStatus | 1.3.6.1.6.3.12.1.2.1.9 | RowStatus | RC | 1 | |||||||||||||||||
column · RowStatus · read-create · current The status of this conceptual row.
To create a row in this table, a manager must
set this object to either createAndGo(4) or
createAndWait(5).
Until instances of all corresponding columns are
appropriately configured, the value of the
corresponding instance of the snmpTargetAddrRowStatus
column is 'notReady'.
In particular, a newly created row cannot be made
active until the corresponding instances of
snmpTargetAddrTDomain, snmpTargetAddrTAddress, and
snmpTargetAddrParams have all been set.
The following objects may not be modified while the
value of this object is active(1):
- snmpTargetAddrTDomain
- snmpTargetAddrTAddress
An attempt to set these objects while the value of
snmpTargetAddrRowStatus is active(1) will result in
an inconsistentValue error.Example values from LibreNMS test devices
| |||||||||||||||||||||
| TsnmpTargetParamsTable | 1.3.6.1.6.3.12.1.3 | NA | |||||||||||||||||||
table · not-accessible · current A table of SNMP target information to be used in the generation of SNMP messages. | |||||||||||||||||||||
| RsnmpTargetParamsEntry | 1.3.6.1.6.3.12.1.3.1 | NA | |||||||||||||||||||
row · not-accessible · current A set of SNMP target information. Entries in the snmpTargetParamsTable are created and deleted using the snmpTargetParamsRowStatus object.
| |||||||||||||||||||||
| CsnmpTargetParamsName | 1.3.6.1.6.3.12.1.3.1.1 | SnmpAdminString (SIZE (1..32)) | NA | ||||||||||||||||||
column · SnmpAdminString (SIZE (1..32)) · not-accessible · current The locally arbitrary, but unique identifier associated with this snmpTargetParamsEntry. | |||||||||||||||||||||
| CsnmpTargetParamsMPModel | 1.3.6.1.6.3.12.1.3.1.2 | SnmpMessageProcessingModel | RC | 0 | |||||||||||||||||
column · SnmpMessageProcessingModel · read-create · current The Message Processing Model to be used when generating SNMP messages using this entry. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetParamsSecurityModel | 1.3.6.1.6.3.12.1.3.1.3 | SnmpSecurityModel (1..2147483647) | RC | 1 | |||||||||||||||||
column · SnmpSecurityModel (1..2147483647) · read-create · current The Security Model to be used when generating SNMP messages using this entry. An implementation may choose to return an inconsistentValue error if an attempt is made to set this variable to a value for a security model which the implementation does not support. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetParamsSecurityName | 1.3.6.1.6.3.12.1.3.1.4 | SnmpAdminString | RC | public | |||||||||||||||||
column · SnmpAdminString · read-create · current The securityName which identifies the Principal on whose behalf SNMP messages will be generated using this entry. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetParamsSecurityLevel | 1.3.6.1.6.3.12.1.3.1.5 | SnmpSecurityLevel | RC | 1 | |||||||||||||||||
column · SnmpSecurityLevel · read-create · current The Level of Security to be used when generating SNMP messages using this entry. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetParamsStorageType | 1.3.6.1.6.3.12.1.3.1.6 | StorageType | RC | 5 | |||||||||||||||||
column · StorageType · read-create · current The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row. Example values from LibreNMS test devices
| |||||||||||||||||||||
| CsnmpTargetParamsRowStatus | 1.3.6.1.6.3.12.1.3.1.7 | RowStatus | RC | 1 | |||||||||||||||||
column · RowStatus · read-create · current The status of this conceptual row.
To create a row in this table, a manager must
set this object to either createAndGo(4) or
createAndWait(5).
Until instances of all corresponding columns are
appropriately configured, the value of the
corresponding instance of the snmpTargetParamsRowStatus
column is 'notReady'.
In particular, a newly created row cannot be made
active until the corresponding
snmpTargetParamsMPModel,
snmpTargetParamsSecurityModel,
snmpTargetParamsSecurityName,
and snmpTargetParamsSecurityLevel have all been set.
The following objects may not be modified while the
value of this object is active(1):
- snmpTargetParamsMPModel
- snmpTargetParamsSecurityModel
- snmpTargetParamsSecurityName
- snmpTargetParamsSecurityLevel
An attempt to set these objects while the value of
snmpTargetParamsRowStatus is active(1) will result in
an inconsistentValue error.Example values from LibreNMS test devices
| |||||||||||||||||||||
| SsnmpUnavailableContexts | 1.3.6.1.6.3.12.1.4 | Counter32 | RO | 0 | |||||||||||||||||
scalar · Counter32 · read-only · current The total number of packets received by the SNMP engine which were dropped because the context contained in the message was unavailable. Example values from LibreNMS test devices
| |||||||||||||||||||||
| SsnmpUnknownContexts | 1.3.6.1.6.3.12.1.5 | Counter32 | RO | 0 | |||||||||||||||||
scalar · Counter32 · read-only · current The total number of packets received by the SNMP engine which were dropped because the context contained in the message was unknown. Example values from LibreNMS test devices
| |||||||||||||||||||||
| NsnmpTargetConformance | 1.3.6.1.6.3.12.3 | ||||||||||||||||||||
| NsnmpTargetCompliances | 1.3.6.1.6.3.12.3.1 | ||||||||||||||||||||
| MsnmpTargetCommandResponderCompliance | 1.3.6.1.6.3.12.3.1.1 | ||||||||||||||||||||
compliance · current The compliance statement for SNMP entities which include a command responder application. | |||||||||||||||||||||
| NsnmpTargetGroups | 1.3.6.1.6.3.12.3.2 | ||||||||||||||||||||
| GsnmpTargetBasicGroup | 1.3.6.1.6.3.12.3.2.1 | ||||||||||||||||||||
group · current A collection of objects providing basic remote configuration of management targets.
| |||||||||||||||||||||
| GsnmpTargetResponseGroup | 1.3.6.1.6.3.12.3.2.2 | ||||||||||||||||||||
group · current A collection of objects providing remote configuration of management targets for applications which generate SNMP messages for which a response message would be expected. | |||||||||||||||||||||
| GsnmpTargetCommandResponderGroup | 1.3.6.1.6.3.12.3.2.3 | ||||||||||||||||||||
group · current A collection of objects required for command responder applications, used for counting error conditions. | |||||||||||||||||||||
Textual conventions
SnmpTagListOCTET STRING (SIZE (0..255))Display hint:
255tAn octet string containing a list of tag values. Tag values are preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 character encoding scheme described in RFC 2279. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. The use of control codes should be avoided, except as described below. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 representation is identical to the US-ASCII encoding. An object of this type contains a list of tag values which are used to select a set of entries in a table. A tag value is an arbitrary string of octets, but may not contain a delimiter character. Delimiter characters are defined to be one of the following: - An ASCII space character (0x20). - An ASCII TAB character (0x09). - An ASCII carriage return (CR) character (0x0D). - An ASCII line feed (LF) character (0x0A). Delimiter characters are used to separate tag values in a tag list. Only a single delimiter character may occur between two tag values. A tag value may not have a zero length. These constraints imply certain restrictions on the contents of this object: - There cannot be a leading or trailing delimiter character. - There cannot be multiple adjacent delimiter characters. Some examples of valid tag lists are: - '' -- an empty list - 'acme' -- list of one tag - 'host router bridge' -- list of several tags Note that although a tag value may not have a length of zero, an empty string is still valid. This indicates an empty list (i.e. there are no tag values in the list). The use of the tag list to select table entries is application and MIB specific. Typically, an application will provide one or more tag values, and any entry which contains some combination of these tag values will be selected.SnmpTagValueOCTET STRING (SIZE (0..255))Display hint:
255tAn octet string containing a tag value. Tag values are preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 character encoding scheme described in RFC 2279. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. The use of control codes should be avoided, and certain control codes are not allowed as described below. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 representation is identical to the US-ASCII encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction must be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC1905]. An object of this type contains a single tag value which is used to select a set of entries in a table. A tag value is an arbitrary string of octets, but may not contain a delimiter character. Delimiter characters are defined to be one of the following: - An ASCII space character (0x20). - An ASCII TAB character (0x09). - An ASCII carriage return (CR) character (0x0D). - An ASCII line feed (LF) character (0x0A). Delimiter characters are used to separate tag values in a tag list. An object of this type may only contain a single tag value, and so delimiter characters are not allowed in a value of this type. Note that a tag value of 0 length means that no tag is defined. In other words, a tag value of 0 length would never match anything in a tag list, and would never select any table entries. Some examples of valid tag values are: - 'acme' - 'router' - 'host' The use of a tag value to select table entries is application and MIB specific.
Groups and compliance
Used by
- CISCO-DOCS-EXT-MIB (cisco)
- CM-SYSTEM-MIB (adva)
- DISMAN-EVENT-MIB
- DOCS-IF3-MIB
- EXTREME-SNMPV3-MIB (extreme)
- HH3C-SYS-MAN-MIB (comware)
- HP-ICF-BASIC (hp)
- HUAWEI-SNMP-NOTIFICATION-MIB (huawei)
- SN-MSPS-SCX200-MIB (siemens)
- SNMP-COMMUNITY-MIB
- SNMP-NOTIFICATION-MIB
- SNMP-PROXY-MIB
- TROPIC-SYSTEM-MIB (nokia/1830)
- USM-TARGET-TAG-MIB (quanta)