1SNMPTRANSLATE(1) Net-SNMP SNMPTRANSLATE(1)
2
6 snmptranslate - translate MIB OID names between numeric and textual
7 forms
8
10 snmptranslate [OPTIONS] OID [OID]...
11
13 snmptranslate is an application that translates one or more SNMP object
14 identifier values from their symbolic (textual) forms into their numer‐
15 ical forms (or vice versa).
16 OID is either a numeric or textual object identifier.
18
20 -D TOKEN[,...]
21 Turn on debugging output for the given TOKEN(s). Try ALL for
22 extremely verbose output.
23 -h Display a brief usage message and then exit.
25 -m MIBLIST
27 Specifies a colon separated list of MIB modules to load for
28 this application. This overrides the environment variable
29 MIBS.
30 The special keyword ALL is used to specify all modules in all
32 directories when searching for MIB files. Every file whose
33 name does not begin with "." will be parsed as if it were a MIB
34 file.
35 -M DIRLIST
37 Specifies a colon separated list of directories to search for
38 MIBs. This overrides the environment variable MIBDIRS.
39 -T TRANSOPTS
41 Provides control over the translation of the OID values. The
42 following TRANSOPTS are available:
43 -Td Print full details of the specified OID.
45 -Tp Print a graphical tree, rooted at the specified OID.
47 -Ta Dump the loaded MIB in a trivial form.
49 -Tl Dump a labeled form of all objects.
51 -To Dump a numeric form of all objects.
53 -Ts Dump a symbolic form of all objects.
55 -Tt Dump a tree form of the loaded MIBs (mostly useful for
57 debugging).
58 -Tz Dump a numeric and labeled form of all objects (compati‐
60 ble with MIB2SCHEMA format).
61 -V Display version information for the application and then exit.
63 -w WIDTH
65 Specifies the width of -Tp and -Td output. The default is very
66 large.
67 In addition to the above options, snmptranslate takes the OID input
69 (-I), MIB parsing (-M) and OID output (-O) options described in the
70 INPUT OPTIONS, MIB PARSING OPTIONS and OUTPUT OPTIONS sections of the
71 snmpcmd(1) manual page.
72
74 · snmptranslate -On -IR sysDescr
75 will translate "sysDescr" to a more qualified form:
76 system.sysDescr
78 · snmptranslate -Onf -IR sysDescr
80 will translate "sysDecr" to:
81 .iso.org.dod.internet.mgmt.mib-2.system.sysDescr
83 · snmptranslate -Td -OS system.sysDescr
85 will translate "sysDecr" into:
86 SNMPv2-MIB::sysDescr
88 sysDescr OBJECT-TYPE
89 -- FROM SNMPv2-MIB
90 -- TEXTUAL CONVENTION DisplayString
91 SYNTAX OCTET STRING (0..255)
92 DISPLAY-HINT "255a"
93 MAX-ACCESS read-only
94 STATUS current
95 DESCRIPTION "A textual description of the entity. This
96 value should include the full name and
97 version identification of the system's
98 hardware type, software operating-system,
99 and networking software."
100 ::= { iso(1) org(3) dod(6) internet(1) mgmt(2) mib-2(1) system(1) 1 }
101 · snmptranslate -Tp -OS system
103 will print the following tree:
104 +--system(1)
106 |
107 +-- -R-- String sysDescr(1)
108 | Textual Convention: DisplayString
109 | Size: 0..255
110 +-- -R-- ObjID sysObjectID(2)
111 +-- -R-- TimeTicks sysUpTime(3)
112 +-- -RW- String sysContact(4)
113 | Textual Convention: DisplayString
114 | Size: 0..255
115 +-- -RW- String sysName(5)
116 | Textual Convention: DisplayString
117 | Size: 0..255
118 +-- -RW- String sysLocation(6)
119 | Textual Convention: DisplayString
120 | Size: 0..255
121 +-- -R-- Integer sysServices(7)
122 +-- -R-- TimeTicks sysORLastChange(8)
123 | Textual Convention: TimeStamp
124 |
125 +--sysORTable(9)
126 |
127 +--sysOREntry(1)
128 |
129 +-- ---- Integer sysORIndex(1)
130 +-- -R-- ObjID sysORID(2)
131 +-- -R-- String sysORDescr(3)
132 | Textual Convention: DisplayString
133 | Size: 0..255
134 +-- -R-- TimeTicks sysORUpTime(4)
135 Textual Convention: TimeStamp
136 · snmptranslate -Ta | head
139 will produce the following dump:
140 dump DEFINITIONS ::= BEGIN
142 org ::= { iso 3 }
143 dod ::= { org 6 }
144 internet ::= { dod 1 }
145 directory ::= { internet 1 }
146 mgmt ::= { internet 2 }
147 experimental ::= { internet 3 }
148 private ::= { internet 4 }
149 security ::= { internet 5 }
150 snmpV2 ::= { internet 6 }
151 · snmptranslate -Tl | head
153 will produce the following dump:
154 .iso(1).org(3)
156 .iso(1).org(3).dod(6)
157 .iso(1).org(3).dod(6).internet(1)
158 .iso(1).org(3).dod(6).internet(1).directory(1)
159 .iso(1).org(3).dod(6).internet(1).mgmt(2)
160 .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1)
161 .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1)
162 .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1).sysDescr(1)
163 .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1).sysObjectID(2)
164 .iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).system(1).sysUpTime(3)
165 · snmptranslate -To | head
167 will produce the following dump
168 .1.3
170 .1.3.6
171 .1.3.6.1
172 .1.3.6.1.1
173 .1.3.6.1.2
174 .1.3.6.1.2.1
175 .1.3.6.1.2.1.1
176 .1.3.6.1.2.1.1.1
177 .1.3.6.1.2.1.1.2
178 .1.3.6.1.2.1.1.3
179 · snmptranslate -Ts | head
181 will produce the following dump
182 .iso.org
184 .iso.org.dod
185 .iso.org.dod.internet
186 .iso.org.dod.internet.directory
187 .iso.org.dod.internet.mgmt
188 .iso.org.dod.internet.mgmt.mib-2
189 .iso.org.dod.internet.mgmt.mib-2.system
190 .iso.org.dod.internet.mgmt.mib-2.system.sysDescr
191 .iso.org.dod.internet.mgmt.mib-2.system.sysObjectID
192 .iso.org.dod.internet.mgmt.mib-2.system.sysUpTime
193 · snmptranslate -Tt | head
195 will produce the following dump
196 org(3) type=0
198 dod(6) type=0
199 internet(1) type=0
200 directory(1) type=0
201 mgmt(2) type=0
202 mib-2(1) type=0
203 system(1) type=0
204 sysDescr(1) type=2 tc=4 hint=255a
205 sysObjectID(2) type=1
206 sysUpTime(3) type=8
207
209 snmpcmd(1), variables(5), RFC 2578-2580.
2104th Berkeley Distribution 25 Jul 2003 SNMPTRANSLATE(1)