NAME¶

snmptranslate - translate MIB OID names between numeric and textual forms

SYNOPSIS¶

snmptranslate [OPTIONS] OID [OID]...
snmptranslate [OPTIONS] -

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.

The special - argument is used to translate multiple object IDs in one run. Input is taken from stdin, and output is written to stdout. The input format can be a single object ID per line, or can be the output of snmpwalk or snmpget .

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.

In addition to the above options, snmptranslate takes the OID input (-I), MIB parsing (-M) and OID output (-O) options described in the INPUT OPTIONS, MIB PARSING OPTIONS and OUTPUT OPTIONS sections of the snmpcmd(1) manual page.

EXAMPLES¶

•

snmptranslate -On -IR sysDescr
will translate "sysDescr" to a more qualified form:

system.sysDescr

•

snmptranslate -Onf -IR sysDescr
will translate "sysDecr" to:

.iso.org.dod.internet.mgmt.mib-2.system.sysDescr

•

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 system's


               hardware type, software operating-system,


               and networking software."
::= { iso(1) org(3) dod(6) internet(1) mgmt(2) mib-2(1) system(1) 1 }

•

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
    

•

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 }

•

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)

•

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

•

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

•

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

•

snmptranslate -OX -
with the following input:

SNMPv2-SMI::mib-2.14.1.1.0 = IpAddress: 192.0.2.1
SNMPv2-SMI::mib-2.14.1.2.0 = INTEGER: 1
SNMPv2-SMI::mib-2.14.1.3.0 = INTEGER: 2

will produce the following output:

OSPF-MIB::ospfRouterId.0 = IpAddress: 192.0.2.1
OSPF-MIB::ospfAdminStat.0 = INTEGER: 1
OSPF-MIB::ospfVersionNumber.0 = INTEGER: 2

SEE ALSO¶

snmpcmd(1), variables(5), RFC 2578-2580.