SNMPTRANSLATE(1) Net-SNMP SNMPTRANSLATE(1) # [NAME](#NAME) snmptranslate - translate MIB OID names between numeric and textual forms # [SYNOPSIS](#SYNOPSIS) **snmptranslate** \[OPTIONS] OID \[OID]... **snmptranslate** \[OPTIONS] - # [DESCRIPTION](#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](#OPTIONS) [**-D*\[TOKEN\[,...\]\]***](#D) Turn on debugging output for the given *TOKEN*(s). Try *ALL* for extremely verbose output. [**-h**](#h) Display a brief usage message and then exit. [**-m MIBLIST**](#m) 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**](#M) Specifies a colon separated list of directories to search for MIBs. This overrides the environment variable MIBDIRS. [**-T TRANSOPTS**](#T) Provides control over the translation of the OID values. The following *TRANSOPTS* are available: [**-TB**](#TB) Print all matching objects for a regex search. [**-Td**](#Td) Print full details of the specified OID. [**-Tp**](#Tp) Print a graphical tree, rooted at the specified OID. [**-Ta**](#Ta) Dump the loaded MIB in a trivial form. [**-Tl**](#Tl) Dump a labeled form of all objects. [**-To**](#To) Dump a numeric form of all objects. [**-Ts**](#Ts) Dump a symbolic form of all objects. [**-Tt**](#Tt) Dump a tree form of the loaded MIBs (mostly useful for debugging). [**-Tz**](#Tz) Dump a numeric and labeled form of all objects (compatible with MIB2SCHEMA format). [**-V**](#V) Display version information for the application and then exit. [**-w WIDTH**](#w) 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)*](/man/os/net-snmp/snmpcmd.1) manual page. # [EXAMPLES](#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](#SEE_ALSO) [snmpcmd(1)](/man/os/net-snmp/snmpcmd.1), [variables(5)](/man/os/net-snmp/variables.5), RFC 2578-2580. 13 Nov 2013 V5.9.5.2 --- Document: snmptranslate(1) from net-snmp 5.9.5.2-r10 (Chainguard OS) Source: https://github.com/net-snmp/net-snmp.git