SNMPTRANSLATE(1) Net-SNMP SNMPTRANSLATE(1) نام (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 در دسترس هستند: -TB چاپ تمام اشیاء منطبق بر جستجوی عبارت منظم (regex). -Td چاپ جزئیات کامل OID مشخص‌شده. -Tp چاپ یک درخت گرافیکی با ریشه در OID مشخص‌شده. -Ta تخلیه (dump) MIB بارگذاری‌شده در یک قالب ساده. -Tl تخلیه قالب برچسب‌دار تمام اشیاء. -To تخلیه قالب عددی تمام اشیاء. -Ts تخلیه قالب نمادین تمام اشیاء. -Tt تخلیه ساختار درختی MIBهای بارگذاری‌شده (بیشتر برای اشکال‌زدایی مفید است). -Tz تخلیه قالب عددی و برچسب‌دار تمام اشیاء (سازگار با قالب MIB2SCHEMA). -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. V5.9.5.2 13 Nov 2013 SNMPTRANSLATE(1)