نام (NAME)

snmptranslate - ترجمه نام‌های MIB OID بین قالب‌های عددی و متنی

خلاصه دستور (SYNOPSIS)

snmptranslate [OPTIONS] OID [OID]...
snmptranslate [OPTIONS] -

توضیحات (DESCRIPTION)

دستور snmptranslate برنامه‌ای است که یک یا چند مقدار شناسه شیء (OID) در SNMP را از قالب نمادین (متنی) به قالب عددی (یا برعکس) ترجمه می‌کند.

شناسه OID می‌تواند یک شناسه شیء عددی یا متنی باشد.

آرگومان ویژه - برای ترجمه چندین شناسه شیء در یک بار اجرا استفاده می‌شود. ورودی از stdin خوانده شده و خروجی در stdout نوشته می‌شود. قالب ورودی می‌تواند شامل یک شناسه شیء در هر خط، یا خروجی دستورهای snmpwalk یا snmpget باشد.

گزینه‌ها (OPTIONS)

-D[TOKEN[,...]]

فعال کردن خروجی اشکال‌زدایی برای TOKEN(های) داده‌شده. برای خروجی بسیار مفصل از ALL استفاده کنید.

-h

نمایش پیام کوتاه راهنمای استفاده و سپس خروج.

-m MIBLIST

فهرستی از ماژول‌های MIB جداشده با دونقطه (:) را برای بارگذاری در این برنامه مشخص می‌کند. این گزینه متغیر محیطی MIBS را بازنویسی می‌کند.

کلیدواژه ویژه ALL برای تعیین تمام ماژول‌ها در تمامی دایرکتوری‌ها هنگام جستجوی فایل‌های MIB به کار می‌رود. هر فایلی که نام آن با «.» شروع نشود به‌گونه‌ای تجزیه می‌شود که گویی یک فایل MIB است.

-M DIRLIST

فهرستی از دایرکتوری‌های جداشده با دونقطه (:) را برای جستجوی MIBها مشخص می‌کند. این گزینه متغیر محیطی MIBDIRS را بازنویسی می‌کند.

-T TRANSOPTS

امکان کنترل نحوه ترجمه مقادیر OID را فراهم می‌کند. گزینه‌های زیر برای TRANSOPTS در دسترس هستند:

-V

نمایش اطلاعات نسخه برنامه و سپس خروج.

-w WIDTH

عرض خروجی -Tp و -Td را مشخص می‌کند. مقدار پیش‌فرض بسیار بزرگ است.

علاوه بر گزینه‌های فوق، snmptranslate گزینه‌های ورودی OID (-I)، تجزیه MIB (-M) و خروجی OID (-O) را که در بخش‌های INPUT OPTIONS، MIB PARSING OPTIONS و OUTPUT OPTIONS صفحه راهنمای snmpcmd(1) شرح داده شده‌اند، می‌پذیرد.

مثال‌ها (EXAMPLES)

•

snmptranslate -On -IR sysDescr
عبارت "sysDescr" را به یک قالب کامل‌تر ترجمه می‌کند:

system.sysDescr

•

snmptranslate -Onf -IR sysDescr
عبارت "sysDecr" را به شکل زیر ترجمه می‌کند:

.iso.org.dod.internet.mgmt.mib-2.system.sysDescr

•

snmptranslate -Td -OS system.sysDescr
عبارت "sysDecr" را به شکل زیر ترجمه می‌کند:

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
درخت زیر را چاپ می‌کند:

+--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
خروجی (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
خروجی (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
خروجی زیر را تولید خواهد کرد:

.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
خروجی زیر را تولید خواهد کرد:

.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
خروجی زیر را تولید خواهد کرد:

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 -
با ورودی زیر:

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

خروجی زیر را تولید خواهد کرد:

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.