FreeBSD Manual Pages
SNMPTRANSLATE(1) Net-SNMP SNMPTRANSLATE(1) 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 for- mat 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 ex- tremely 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 di- rectories 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 fol- lowing 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 debug- ging). -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 OP- TIONS, 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. V5.9.5.2 13 Nov 2013 SNMPTRANSLATE(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=snmptranslate&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>