SNMP 必备工具 ：snmptranslate
NAME
snmptranslate - translate MIB OID names between numeric and textual
forms
# 注释 ：snmptranslate 命令可以在 MIB OID 在数字和文字名称之间进行转换
--------------------------------------------------------------------------------
SYNOPSIS
snmptranslate [OPTIONS] OID [OID]...
# 注释 ：snmptranslate 命令的格式是 snmptranslate [options] OID [oid]
# 注释 ：从上面的格式可以看出，snmptranslate 一次可以转换多个 OID
--------------------------------------------------------------------------------
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.
# 注释 ：snmptranslate 是一个将一个或者多个 SNMP OID 从文字名称格式转换为数字格式的程序
# [oid] 可以是数字格式或者文字格式。
# 注意！snmptranslate 可以直接将数字格式的 oid 转换为名称格式，
# 但要把名称格式的 oid 转换为数字格式的 oid ，需要 -I 选项的配合。（参考 snmpcmd 和最后部分的例子）
--------------------------------------------------------------------------------
OPTIONS
-D TOKEN[,...]
Turn on debugging output for the given TOKEN(s). Try ALL for extremely
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
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 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 following
TRANSOPTS are available:
# 注释 ：-T 选项用于控制转换的输出
-Td
Print full details of the specified OID.
# 注释 ：-Td 表示输出该对象的详细定义，也就是在 MIB 中的定义，包括文字名称、所属
MIB、类型、状态、读写权限、描述信息，数字格式的 OID
vstone
发表于 2008-6-9 01:34
-Tp
Print a graphical tree, rooted at the specified OID.
# 注释 ：-Tp 用于打印从指定 OID 开始一直到该 OID 所属的 MIB 子树末端的树型结构信息
# 该选项很有用，如果要知道某个 MIB 或者某个表有什么内容，可以该选项
--------------------------------------------------------------------------------
-Ta
Dump the loaded MIB in a trivial form.
# 注释 ：-Ta 表示导出所有已经加载的 MIB 的数据，每个对象一行
# 默认情况下是导出所有已经加载的对象。
# 如果只想导出某个 MIB ，可以使用如 snmptranslate -Ta -M MTA-MIB 这样就只导出
MTA-MIB 下的信息
# 注释 ：该选项其实和 -Tp 很像，只不过 -Tp 是树型结构的形式，而 -Ta 是一行一行的格式。
# 而且 -Tp 后面可以加 -m 或者某个 oid ，但 -Ta 后面加
没有用
--------------------------------------------------------------------------------
-Tl
Dump a labeled form of all objects.
# 注释 ：-Tl 导出所有已经加载的 MIB 的对象，并且输出完整的 oid 路径，也是很有用的一个选项。
# 和 -Ta 相比，-Ta 只输出对象名，类型，值，而没有 OID 。而 -Tl 则除了这些外，还输出了完整的文字格式
OID 和 数字格式的 oid
--------------------------------------------------------------------------------
-To
Dump a numeric form of all objects.
# 注释 ：-To 则是导出已经加载的所有 MIB 的数字格式的 oid ，不含值和类型，仅仅有 oid 而已
--------------------------------------------------------------------------------
-Ts
Dump a symbolic form of all objects.
# 注释 : -Ts 和 -To 相反，只输出文字格式的 OID 名称而已
# 以上两个选项，如果在只想知道某个 MIB 下有什么内容，而不关心具体的值时比较有用
--------------------------------------------------------------------------------
-Tt
Dump a tree form of the loaded MIBs (mostly useful for debugging).
# 注释 ：-Tt 和 -Tp 比较像，但相比 -Tp 来说不够清楚
--------------------------------------------------------------------------------
-Tz
Dump a numeric and labeled form of all objects (compatible with
MIB2SCHEMA format).
# 注释 ；-Tz 同时导出已经加载的 MIB 的所有对象的文字格式和数字格式的 OID
# 这也是一个比较有用的选项。
--------------------------------------------------------------------------------
-V
Display version information for the application and then exit.
# 注释 ：-V 选项显示版本信息并退出
--------------------------------------------------------------------------------
-w WIDTH
Specifies the width of -Tp and -Td output. The default is very
large.
# 注释 ：-w 限制 -Tp 和 -Td 输出的最大宽度
--------------------------------------------------------------------------------
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) manual page.
--------------------------------------------------------------------------------
EXAMPLES
*
snmptranslate -On -IR sysDescr will translate "sysDescr" to a more
qualified form:
system.sysDescr
# 注释 ：如果要使 snmptranslate 把 symbol 格式的oid 转换为 numberic 格式的 oid ，需要使用
-IR 和 -On
# -IR 允许“随机”访问 MIB ，由 snmp 从 mib 库中查找和所给出的对象名匹配的 oid ，所以上面的例子可以直接写
sysDescr ，而不用写全路径
# 至于 -On 是输出数字格式的 oid ，这样就实现了把 symbol 格式的 oid 转换为 numberic 格式的 oid
*
snmptranslate -Onf -IR sysDescr will translate "sysDecr" to:
.iso.org.dod.internet.mgmt.mib-2.system.sysDescr
# 注释 ：如果只是想找出 sysDescr 的 symbol 格式的 oid ，用 -Of
*
snmptranslate -Td -OS system.sysDescr will translate "sysDecr" into:
SNMPv2-MIB::sysDescrsysDescr 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 ::= BEGINorg ::= { 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
SEE ALSO
snmpcmd(1), variables(5), RFC 2578-2580.
阅读(4819) | 评论(0) | 转发(0) |
