.\" /*********************************************************** .\" Copyright 1988, 1989 by Carnegie Mellon University .\" .\" All Rights Reserved .\" .\" Permission to use, copy, modify, and distribute this software and its .\" documentation for any purpose and without fee is hereby granted, .\" provided that the above copyright notice appear in all copies and that .\" both that copyright notice and this permission notice appear in .\" supporting documentation, and that the name of CMU not be .\" used in advertising or publicity pertaining to distribution of the .\" software without specific, written prior permission. .\" .\" CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING .\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL .\" CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, .\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" ******************************************************************/ .TH SNMPTRANSLATE 1 "21 Jun 2001" .UC 4 .SH NAME snmptranslate - translate SNMP objects into more useful information .SH SYNOPSIS snmptranslate [-h] [-V] [-D ] [-I ] [-O ] [-P ] [-T ] [-m ] [-M ] objectID .SH DESCRIPTION Snmptranslate is an application that translates an SNMP object (SMI value or symbolic form) into another form of information. With no other options, an SNMP object will be translated to its SMI value. .PP The options have the following meanings: .TP .B \-h Print help message .TP .B \-V Print version message and exit .TP .B \-D Enable debugging output. See the \fIsnmpcmd\fR man page for more information. .TP .B \-I See the \fIsnmpcmd\fR man page for a description of the OID input options .TP .B \-O See the \fIsnmpcmd\fR man page for a description of the OID output options .TP .B \-P See the \fIsnmpcmd\fR man page for a description of the MIB parsing options .TP .B \-T Translate an SNMP object to its symbolic form. The following TRANSOPTS are available: .TP .B \-Td print full details of the specified OID .TP .B \-Tp print a graphical tree, rooted at the specified OID .TP .B \-Ta dump the loaded MIB in a trivial form .TP .B \-Tl dump a labeled form of all objects .TP .B \-To dump a numeric form of all objects .TP .B \-Ts dump a symbolic form of all objects .TP .B \-Tt dump a tree form of the loaded mibs (mostly useful for debugging) .TP .B \-w width specify width of -Tp and -Td output. Default is very large .SH EXAMPLES .PP .I snmptranslate -On -IR sysDescr .PP will translate "sysDescr" to a more qualified form: .PP .I system.sysDescr .PP .I snmptranslate -Onf -IR sysDescr .PP will translate "sysDecr" to .PP .iso.org.dod.internet.mgmt.mib-2.system.sysDescr .PP .I snmptranslate -Td -OS system.sysDescr .PP will translate "sysDecr" into .PP .nf SNMPv2-MIB::sysDescr sysDescr OBJECT-TYPE -- FROM SNMPv2-MIB -- TEXTUAL CONVENTION DisplayString SYNTAX OCTET STRING 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 } .fi .PP .I snmptranslate -Tp -OS system .PP will print the following tree: .PP .nf +--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 .fi .PP .I snmptranslate -Ta | head .PP will produce the following dump: .PP .nf 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 } .fi .PP .I snmptranslate -Tl | head .PP will produce the following dump: .PP .nf .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) .fi .PP .I snmptranslate -To | head .PP will produce the following dump .PP .nf .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 .fi .PP .I snmptranslate -Ts | head .PP will produce the following dump .PP .nf .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 .fi .PP .I snmptranslate -Tt | head .PP will produce the following dump .PP .nf 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=0 hint=255a sysObjectID(2) type=1 sysUpTime(3) type=8 .fi .SH "SEE ALSO" snmpcmd(1), variables(5), RFC 2578-2580.