--- name: "snmptranslate" section: "1" platform: "linux" package: "net-snmp" version: "5.9.5.2-2" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/snmptranslate" --- # snmptranslate(1) translate MIB OID names between numeric and textual forms ## 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: - **-TB** Print all matching objects for a regex search. - **-Td** Print full details of the specified OID. - **-Tp** Print a graphical tree, rooted at the specified OID. - **-Ta** Dump the loaded MIB in a trivial form. - **-Tl** Dump a labeled form of all objects. - **-To** Dump a numeric form of all objects. - **-Ts** Dump a symbolic form of all objects. - **-Tt** Dump a tree form of the loaded MIBs (mostly useful for debugging). - **-Tz** Dump a numeric and labeled form of all objects (compatible with MIB2SCHEMA format). - **-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)](/snmpcmd/1.md)* 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)](/snmpcmd/1.md), [variables(5)](/variables/5.md), RFC 2578-2580.