# snmptranslate(1) - man - phpman [SNMPTRANSLATE(1)](https://www.chedong.com/phpMan.php/man/SNMPTRANSLATE/1/markdown) Net-SNMP [SNMPTRANSLATE(1)](https://www.chedong.com/phpMan.php/man/SNMPTRANSLATE/1/markdown) ## 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 Turn on debugging output for the given _TOKEN_(s). Try _ALL_ for extremely verbose out‐ put. ### -h ### -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 Specifies a colon separated list of directories to search for MIBs. This overrides the environment variable MIBDIRS. ### -T 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 for‐ mat). ### -V ### -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)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown)_ 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](https://www.chedong.com/phpMan.php/perldoc/MIB%3A%3AsysDescr/markdown) 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)](https://www.chedong.com/phpMan.php/man/iso/1/markdown) [org(3)](https://www.chedong.com/phpMan.php/man/org/3/markdown) [dod(6)](https://www.chedong.com/phpMan.php/man/dod/6/markdown) [internet(1)](https://www.chedong.com/phpMan.php/man/internet/1/markdown) [mgmt(2)](https://www.chedong.com/phpMan.php/man/mgmt/2/markdown) [mib-2(1)](https://www.chedong.com/phpMan.php/man/mib-2/1/markdown) [system(1)](https://www.chedong.com/phpMan.php/man/system/1/markdown) 1 } • snmptranslate -Tp -OS system will print the following tree: [+--system(1)](https://www.chedong.com/phpMan.php/man/%2B--system/1/markdown) | +-- -R-- String [sysDescr(1)](https://www.chedong.com/phpMan.php/man/sysDescr/1/markdown) | Textual Convention: DisplayString | Size: 0..255 +-- -R-- ObjID [sysObjectID(2)](https://www.chedong.com/phpMan.php/man/sysObjectID/2/markdown) +-- -R-- TimeTicks [sysUpTime(3)](https://www.chedong.com/phpMan.php/man/sysUpTime/3/markdown) +-- -RW- String [sysContact(4)](https://www.chedong.com/phpMan.php/man/sysContact/4/markdown) | Textual Convention: DisplayString | Size: 0..255 +-- -RW- String [sysName(5)](https://www.chedong.com/phpMan.php/man/sysName/5/markdown) | Textual Convention: DisplayString | Size: 0..255 +-- -RW- String [sysLocation(6)](https://www.chedong.com/phpMan.php/man/sysLocation/6/markdown) | Textual Convention: DisplayString | Size: 0..255 +-- -R-- Integer [sysServices(7)](https://www.chedong.com/phpMan.php/man/sysServices/7/markdown) +-- -R-- TimeTicks [sysORLastChange(8)](https://www.chedong.com/phpMan.php/man/sysORLastChange/8/markdown) | Textual Convention: TimeStamp | [+--sysORTable(9)](https://www.chedong.com/phpMan.php/man/%2B--sysORTable/9/markdown) | [+--sysOREntry(1)](https://www.chedong.com/phpMan.php/man/%2B--sysOREntry/1/markdown) | +-- ---- Integer [sysORIndex(1)](https://www.chedong.com/phpMan.php/man/sysORIndex/1/markdown) +-- -R-- ObjID [sysORID(2)](https://www.chedong.com/phpMan.php/man/sysORID/2/markdown) +-- -R-- String [sysORDescr(3)](https://www.chedong.com/phpMan.php/man/sysORDescr/3/markdown) | Textual Convention: DisplayString | Size: 0..255 +-- -R-- TimeTicks [sysORUpTime(4)](https://www.chedong.com/phpMan.php/man/sysORUpTime/4/markdown) 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)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown)[.directory(1)](https://www.chedong.com/phpMan.php/man/.directory/1/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown)[.mgmt(2)](https://www.chedong.com/phpMan.php/man/.mgmt/2/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown)[.mgmt(2)](https://www.chedong.com/phpMan.php/man/.mgmt/2/markdown)[.mib-2(1)](https://www.chedong.com/phpMan.php/man/.mib-2/1/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown)[.mgmt(2)](https://www.chedong.com/phpMan.php/man/.mgmt/2/markdown)[.mib-2(1)](https://www.chedong.com/phpMan.php/man/.mib-2/1/markdown)[.system(1)](https://www.chedong.com/phpMan.php/man/.system/1/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown)[.mgmt(2)](https://www.chedong.com/phpMan.php/man/.mgmt/2/markdown)[.mib-2(1)](https://www.chedong.com/phpMan.php/man/.mib-2/1/markdown)[.system(1)](https://www.chedong.com/phpMan.php/man/.system/1/markdown)[.sysDescr(1)](https://www.chedong.com/phpMan.php/man/.sysDescr/1/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown)[.mgmt(2)](https://www.chedong.com/phpMan.php/man/.mgmt/2/markdown)[.mib-2(1)](https://www.chedong.com/phpMan.php/man/.mib-2/1/markdown)[.system(1)](https://www.chedong.com/phpMan.php/man/.system/1/markdown)[.sysObjectID(2)](https://www.chedong.com/phpMan.php/man/.sysObjectID/2/markdown) [.iso(1)](https://www.chedong.com/phpMan.php/man/.iso/1/markdown)[.org(3)](https://www.chedong.com/phpMan.php/man/.org/3/markdown)[.dod(6)](https://www.chedong.com/phpMan.php/man/.dod/6/markdown)[.internet(1)](https://www.chedong.com/phpMan.php/man/.internet/1/markdown)[.mgmt(2)](https://www.chedong.com/phpMan.php/man/.mgmt/2/markdown)[.mib-2(1)](https://www.chedong.com/phpMan.php/man/.mib-2/1/markdown)[.system(1)](https://www.chedong.com/phpMan.php/man/.system/1/markdown)[.sysUpTime(3)](https://www.chedong.com/phpMan.php/man/.sysUpTime/3/markdown) • 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)](https://www.chedong.com/phpMan.php/man/org/3/markdown) type=0 [dod(6)](https://www.chedong.com/phpMan.php/man/dod/6/markdown) type=0 [internet(1)](https://www.chedong.com/phpMan.php/man/internet/1/markdown) type=0 [directory(1)](https://www.chedong.com/phpMan.php/man/directory/1/markdown) type=0 [mgmt(2)](https://www.chedong.com/phpMan.php/man/mgmt/2/markdown) type=0 [mib-2(1)](https://www.chedong.com/phpMan.php/man/mib-2/1/markdown) type=0 [system(1)](https://www.chedong.com/phpMan.php/man/system/1/markdown) type=0 [sysDescr(1)](https://www.chedong.com/phpMan.php/man/sysDescr/1/markdown) type=2 tc=4 hint=255a [sysObjectID(2)](https://www.chedong.com/phpMan.php/man/sysObjectID/2/markdown) type=1 [sysUpTime(3)](https://www.chedong.com/phpMan.php/man/sysUpTime/3/markdown) type=8 • snmptranslate -OX - with the following input: SNMPv2-[SMI::mib](https://www.chedong.com/phpMan.php/perldoc/SMI%3A%3Amib/markdown)-2.14.1.1.0 = IpAddress: 192.0.2.1 SNMPv2-[SMI::mib](https://www.chedong.com/phpMan.php/perldoc/SMI%3A%3Amib/markdown)-2.14.1.2.0 = INTEGER: 1 SNMPv2-[SMI::mib](https://www.chedong.com/phpMan.php/perldoc/SMI%3A%3Amib/markdown)-2.14.1.3.0 = INTEGER: 2 will produce the following output: OSPF-[MIB::ospfRouterId](https://www.chedong.com/phpMan.php/perldoc/MIB%3A%3AospfRouterId/markdown).0 = IpAddress: 192.0.2.1 OSPF-[MIB::ospfAdminStat](https://www.chedong.com/phpMan.php/perldoc/MIB%3A%3AospfAdminStat/markdown).0 = INTEGER: 1 OSPF-[MIB::ospfVersionNumber](https://www.chedong.com/phpMan.php/perldoc/MIB%3A%3AospfVersionNumber/markdown).0 = INTEGER: 2 ## SEE ALSO [snmpcmd(1)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown), [variables(5)](https://www.chedong.com/phpMan.php/man/variables/5/markdown), RFC 2578-2580. V5.9.1 13 Nov 2013 [SNMPTRANSLATE(1)](https://www.chedong.com/phpMan.php/man/SNMPTRANSLATE/1/markdown)