1SNMPTRANSLATE(1)                   Net-SNMP                   SNMPTRANSLATE(1)
2
3
4

NAME

6       snmptranslate  -  translate  MIB  OID names between numeric and textual
7       forms
8

SYNOPSIS

10       snmptranslate [OPTIONS] OID [OID]...
11

DESCRIPTION

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
17       OID is either a numeric or textual object identifier.
18

OPTIONS

20       -D[TOKEN[,...]]
21               Turn on debugging output for the given TOKEN(s).  Try  ALL  for
22               extremely verbose output.
23
24       -h      Display a brief usage message and then exit.
25
26       -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
31               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
36       -M DIRLIST
37               Specifies a colon separated list of directories to  search  for
38               MIBs.  This overrides the environment variable MIBDIRS.
39
40       -T TRANSOPTS
41               Provides  control  over the translation of the OID values.  The
42               following TRANSOPTS are available:
43
44               -Td   Print full details of the specified OID.
45
46               -Tp   Print a graphical tree, rooted at the specified OID.
47
48               -Ta   Dump the loaded MIB in a trivial form.
49
50               -Tl   Dump a labeled form of all objects.
51
52               -To   Dump a numeric form of all objects.
53
54               -Ts   Dump a symbolic form of all objects.
55
56               -Tt   Dump a tree form of the loaded MIBs  (mostly  useful  for
57                     debugging).
58
59               -Tz   Dump  a numeric and labeled form of all objects (compati‐
60                     ble with MIB2SCHEMA format).
61
62       -V      Display version information for the application and then exit.
63
64       -w WIDTH
65               Specifies the width of -Tp and -Td output. The default is  very
66               large.
67
68       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

EXAMPLES

74       ·   snmptranslate -On -IR sysDescr
75           will translate "sysDescr" to a more qualified form:
76
77           system.sysDescr
78
79       ·   snmptranslate -Onf -IR sysDescr
80           will translate "sysDecr" to:
81
82           .iso.org.dod.internet.mgmt.mib-2.system.sysDescr
83
84       ·   snmptranslate -Td -OS system.sysDescr
85           will translate "sysDecr" into:
86
87           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
102       ·   snmptranslate -Tp -OS system
103           will print the following tree:
104
105           +--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
137
138       ·   snmptranslate -Ta | head
139           will produce the following dump:
140
141           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
152       ·   snmptranslate -Tl | head
153           will produce the following dump:
154
155           .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
166       ·   snmptranslate -To | head
167           will produce the following dump
168
169           .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
180       ·   snmptranslate -Ts | head
181           will produce the following dump
182
183           .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
194       ·   snmptranslate -Tt | head
195           will produce the following dump
196
197             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

SEE ALSO

209       snmpcmd(1), variables(5), RFC 2578-2580.
210
211
212
213V5.7.2                            20 Jul 2010                 SNMPTRANSLATE(1)
Impressum