SNMPTRANSLATE(1) Net-SNMP SNMPTRANSLATE(1)

NAME
       snmptranslate  -  translate  MIB  OID names between numeric and textual
       forms

SYNOPSIS
       ssnnmmppttrraannssllaattee [OPTIONS] OID [OID]...

DESCRIPTION
       ssnnmmppttrraannssllaattee is an application that translates one or more SNMP object
       identifier values from their symbolic (textual) forms into their numer-
       ical forms (or vice versa).

       OID is either a numeric or textual object identifier.

OOPPTTIIOONNSS
       -DD TOKEN[,...]
               Turn on debugging output for the given TOKEN(s).  Try  ALL  for
               extremely verbose output.

       -hh      Display a brief usage message and then exit.

       -mm 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.

       -MM DIRLIST
               Specifies a colon separated list of directories to  search  for
               MIBs.  This overrides the environment variable MIBDIRS.

       -TT TRANSOPTS
               Provides  control  over the translation of the OID values.  The
               following TRANSOPTS are available:

               -TTdd   Print full details of the specified OID.

               -TTpp   Print a graphical tree, rooted at the specified OID.

               -TTaa   Dump the loaded MIB in a trivial form.

               -TTll   Dump a labeled form of all objects.

               -TToo   Dump a numeric form of all objects.

               -TTss   Dump a symbolic form of all objects.

               -TTtt   Dump a tree form of the loaded MIBs  (mostly  useful  for
                     debugging).

       -VV      Display  version information for the application and then exit.

       -ww WIDTH
               Specifies the width of -TTpp and -TTdd output. The default is  very
               large.

       In  addition  to  the  above options, ssnnmmppttrraannssllaattee takes the OID input
       (-II), MIB parsing (-MM) and OID output (-OO)  options  described  in  the
       IINNPPUUTT  OOPPTTIIOONNSS,  MMIIBB PPAARRSSIINNGG OOPPTTIIOONNSS and OOUUTTPPUUTT OOPPTTIIOONNSS sections of the
       snmpcmd(1) manual page.

EEXXAAMMPPLLEESS
       +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 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 }

       +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.



4th Berkeley Distribution         25 Jul 2003                 SNMPTRANSLATE(1)