NAME
snmptranslate - translate MIB OID names between numeric and textual forms
SYNOPSIS
snmptranslate [OPTIONS] OID [OID]...
DESCRIPTION
snmptranslate is an application that translates one or more SNMP object identifier values from their symbolic (textual) forms into their numerical forms (or vice versa).
OID is either a numeric or textual object identifier.
OPTIONS
-D TOKEN[,...] | |||||||||||||||||
Turn on debugging output for the given TOKEN(s). Try ALL for extremely verbose output. | |||||||||||||||||
-h | Display a brief usage message and then exit. | ||||||||||||||||
-m MIBLIST | |||||||||||||||||
Specifies a colon separated list of MIB modules to load for this application. This overrides the environment variable MIBS. | |||||||||||||||||
The special keyword ALL is used to specify all modules in all directories when searching for MIB files. Every file whose name does not begin with "." will be parsed as if it were a MIB file. | |||||||||||||||||
-M DIRLIST | |||||||||||||||||
Specifies a colon separated list of directories to search for MIBs. This overrides the environment variable MIBDIRS. | |||||||||||||||||
-T TRANSOPTS | |||||||||||||||||
Provides control over the translation of the OID values. The
following
TRANSOPTS are available:
| |||||||||||||||||
-V | Display version information for the application and then exit. | ||||||||||||||||
-w WIDTH | |||||||||||||||||
Specifies the width of -Tp and -Td output. The default is very large. | |||||||||||||||||
EXAMPLES
o | snmptranslate -On -IR sysDescr will translate "sysDescr" to a more qualified form: |
system.sysDescr | |
o | snmptranslate -Onf -IR sysDescr will translate "sysDecr" to: |
.iso.org.dod.internet.mgmt.mib-2.system.sysDescr | |
o | snmptranslate -Td -OS system.sysDescr will translate "sysDecr" into: |
SNMPv2-MIB::sysDescr sysDescr OBJECT-TYPE -- FROM SNMPv2-MIB -- TEXTUAL CONVENTION DisplayString SYNTAX OCTET STRING (0..255) DISPLAY-HINT "255a" MAX-ACCESS read-only STATUS current DESCRIPTION "A textual description of the entity. This value should include the full name and version identification of the systems hardware type, software operating-system, and networking software." ::= { iso(1) org(3) dod(6) internet(1) mgmt(2) mib-2(1) system(1) 1 } | |
o | snmptranslate -Tp -OS system will print the following tree: |
+--system(1)
|
+-- -R-- String sysDescr(1)
| Textual Convention: DisplayString
| Size: 0..255
+-- -R-- ObjID sysObjectID(2)
+-- -R-- TimeTicks sysUpTime(3)
+-- -RW- String sysContact(4)
| Textual Convention: DisplayString
| Size: 0..255
+-- -RW- String sysName(5)
| Textual Convention: DisplayString
| Size: 0..255
+-- -RW- String sysLocation(6)
| Textual Convention: DisplayString
| Size: 0..255
+-- -R-- Integer sysServices(7)
+-- -R-- TimeTicks sysORLastChange(8)
| Textual Convention: TimeStamp
|
+--sysORTable(9)
|
+--sysOREntry(1)
|
+-- ---- Integer sysORIndex(1)
+-- -R-- ObjID sysORID(2)
+-- -R-- String sysORDescr(3)
| Textual Convention: DisplayString
| Size: 0..255
+-- -R-- TimeTicks sysORUpTime(4)
Textual Convention: TimeStamp
| |
o | snmptranslate -Ta | head will produce the following dump: |
dump DEFINITIONS ::= BEGIN org ::= { iso 3 } dod ::= { org 6 } internet ::= { dod 1 } directory ::= { internet 1 } mgmt ::= { internet 2 } experimental ::= { internet 3 } private ::= { internet 4 } security ::= { internet 5 } snmpV2 ::= { internet 6 } | |
o | snmptranslate -Tl | head will produce the following dump: |
.iso(1).org(3) .iso(1).org(3).dod(6) .iso(1).org(3).dod(6).internet(1) .iso(1).org(3).dod(6).internet(1).directory(1) .iso(1).org(3).dod(6).internet(1).mgmt(2) .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1) .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1) .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1).sysDescr(1) .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1).sysObjectID(2) .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1).sysUpTime(3) | |
o | snmptranslate -To | head will produce the following dump |
.1.3 .1.3.6 .1.3.6.1 .1.3.6.1.1 .1.3.6.1.2 .1.3.6.1.2.1 .1.3.6.1.2.1.1 .1.3.6.1.2.1.1.1 .1.3.6.1.2.1.1.2 .1.3.6.1.2.1.1.3 | |
o | snmptranslate -Ts | head will produce the following dump |
.iso.org .iso.org.dod .iso.org.dod.internet .iso.org.dod.internet.directory .iso.org.dod.internet.mgmt .iso.org.dod.internet.mgmt.mib-2 .iso.org.dod.internet.mgmt.mib-2.system .iso.org.dod.internet.mgmt.mib-2.system.sysDescr .iso.org.dod.internet.mgmt.mib-2.system.sysObjectID .iso.org.dod.internet.mgmt.mib-2.system.sysUpTime | |
o | snmptranslate -Tt | head will produce the following dump |
org(3) type=0 dod(6) type=0 internet(1) type=0 directory(1) type=0 mgmt(2) type=0 mib-2(1) type=0 system(1) type=0 sysDescr(1) type=2 tc=4 hint=255a sysObjectID(2) type=1 sysUpTime(3) type=8 | |
SEE ALSO
snmpcmd(1), variables(5), RFC 2578-2580.