.\" Portions of this file are subject to the following copyright. See .\" the Net-SNMP's COPYING file for more details and other copyrights .\" that may apply: .\" /*********************************************************** .\" Copyright 1988, 1989 by Carnegie Mellon University .\" .\" All Rights Reserved .\" .\" Permission to use, copy, modify, and distribute this software and its .\" documentation for any purpose and without fee is hereby granted, .\" provided that the above copyright notice appear in all copies and that .\" both that copyright notice and this permission notice appear in .\" supporting documentation, and that the name of CMU not be .\" used in advertising or publicity pertaining to distribution of the .\" software without specific, written prior permission. .\" .\" CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING .\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL .\" CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, .\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" ******************************************************************/ .\" Portions of this file are copyrighted by: .\" Copyright Copyright 2003 Sun Microsystems, Inc. All rights reserved. .\" Use is subject to license terms specified in the COPYING file .\" distributed with the Net-SNMP package. .\" ******************************************************************/ .TH SNMPTRANSLATE 1 "13 Nov 2013" V5.9.5.2 "Net-SNMP" .SH "نام (NAME)" snmptranslate \- ترجمه نام‌های MIB OID بین قالب‌های عددی و متنی .SH "خلاصه دستور (SYNOPSIS)" .B snmptranslate [OPTIONS] OID [OID]... .br .B snmptranslate [OPTIONS] - .SH "توضیحات (DESCRIPTION)" دستور .B snmptranslate برنامه‌ای است که یک یا چند مقدار شناسه شیء (OID) در SNMP را از قالب نمادین (متنی) به قالب عددی (یا برعکس) ترجمه می‌کند. .PP شناسه OID می‌تواند یک شناسه شیء عددی یا متنی باشد. .PP آرگومان ویژه .B \- برای ترجمه چندین شناسه شیء در یک بار اجرا استفاده می‌شود. ورودی از stdin خوانده شده و خروجی در stdout نوشته می‌شود. قالب ورودی می‌تواند شامل یک شناسه شیء در هر خط، یا خروجی دستورهای .B snmpwalk یا .B snmpget باشد. .SH "گزینه‌ها (OPTIONS)" .TP 8 .B \-D\fI[TOKEN[,...]] فعال کردن خروجی اشکال‌زدایی برای .IR "TOKEN" "(های)" داده‌شده. برای خروجی بسیار مفصل از .IR ALL استفاده کنید. .TP .B \-h نمایش پیام کوتاه راهنمای استفاده و سپس خروج. .TP .BI \-m " MIBLIST" فهرستی از ماژول‌های MIB جداشده با دونقطه (:) را برای بارگذاری در این برنامه مشخص می‌کند. این گزینه متغیر محیطی MIBS را بازنویسی می‌کند. .IP کلیدواژه ویژه .I ALL برای تعیین تمام ماژول‌ها در تمامی دایرکتوری‌ها هنگام جستجوی فایل‌های MIB به کار می‌رود. هر فایلی که نام آن با «.» شروع نشود به‌گونه‌ای تجزیه می‌شود که گویی یک فایل MIB است. .TP .BI \-M " DIRLIST" فهرستی از دایرکتوری‌های جداشده با دونقطه (:) را برای جستجوی MIBها مشخص می‌کند. این گزینه متغیر محیطی MIBDIRS را بازنویسی می‌کند. .TP .BI \-T " TRANSOPTS" امکان کنترل نحوه ترجمه مقادیر OID را فراهم می‌کند. گزینه‌های زیر برای .I TRANSOPTS در دسترس هستند: .RS .TP 6 .B \-TB چاپ تمام اشیاء منطبق بر جستجوی عبارت منظم (regex). .TP .B \-Td چاپ جزئیات کامل OID مشخص‌شده. .TP .B \-Tp چاپ یک درخت گرافیکی با ریشه در OID مشخص‌شده. .TP .B \-Ta تخلیه (dump) MIB بارگذاری‌شده در یک قالب ساده. .TP .B \-Tl تخلیه قالب برچسب‌دار تمام اشیاء. .TP .B \-To تخلیه قالب عددی تمام اشیاء. .TP .B \-Ts تخلیه قالب نمادین تمام اشیاء. .TP .B \-Tt تخلیه ساختار درختی MIBهای بارگذاری‌شده (بیشتر برای اشکال‌زدایی مفید است). .TP .B \-Tz تخلیه قالب عددی و برچسب‌دار تمام اشیاء (سازگار با قالب MIB2SCHEMA). .RE .TP .B \-V نمایش اطلاعات نسخه برنامه و سپس خروج. .TP .BI \-w " WIDTH" عرض خروجی .B \-Tp و .B \-Td را مشخص می‌کند. مقدار پیش‌فرض بسیار بزرگ است. .PP علاوه بر گزینه‌های فوق، .B snmptranslate گزینه‌های ورودی OID .RB ( \-I )، تجزیه MIB .RB ( \-M ) و خروجی OID .RB ( \-O ) را که در بخش‌های .BR "INPUT OPTIONS" "، " "MIB PARSING OPTIONS" " و " "OUTPUT OPTIONS" صفحه راهنمای .I snmpcmd(1) شرح داده شده‌اند، می‌پذیرد. .SH "مثال‌ها (EXAMPLES)" .IP \(bu 4 snmptranslate \-On \-IR sysDescr .br عبارت "sysDescr" را به یک قالب کامل‌تر ترجمه می‌کند: .IP system.sysDescr .IP \(bu 4 snmptranslate \-Onf \-IR sysDescr .br عبارت "sysDecr" را به شکل زیر ترجمه می‌کند: .IP .RI .iso.org.dod.internet.mgmt.mib\-2.system.sysDescr .IP \(bu 4 snmptranslate \-Td \-OS system.sysDescr .br عبارت "sysDecr" را به شکل زیر ترجمه می‌کند: .IP .nf 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 } .fi .IP \(bu 4 snmptranslate \-Tp \-OS system .br درخت زیر را چاپ می‌کند: .IP .nf +--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 .fi .PP .IP \(bu 4 snmptranslate \-Ta | head .br خروجی (dump) زیر را تولید می‌کند: .IP .nf 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 } .fi .PP .IP \(bu 4 snmptranslate \-Tl | head .br خروجی (dump) زیر را تولید می‌کند: .IP .nf .RI .iso(1).org(3) .RI .iso(1).org(3).dod(6) .RI .iso(1).org(3).dod(6).internet(1) .RI .iso(1).org(3).dod(6).internet(1).directory(1) .RI .iso(1).org(3).dod(6).internet(1).mgmt(2) .RI .iso(1).org(3).dod(6).internet(1).mgmt(2).mib\-2(1) .RI .iso(1).org(3).dod(6).internet(1).mgmt(2).mib\-2(1).system(1) .RI .iso(1).org(3).dod(6).internet(1).mgmt(2).mib\-2(1).system(1).sysDescr(1) .RI .iso(1).org(3).dod(6).internet(1).mgmt(2).mib\-2(1).system(1).sysObjectID(2) .RI .iso(1).org(3).dod(6).internet(1).mgmt(2).mib\-2(1).system(1).sysUpTime(3) .fi .PP .IP \(bu 4 snmptranslate \-To | head .br خروجی زیر را تولید خواهد کرد: .IP .nf .RI .1.3 .RI .1.3.6 .RI .1.3.6.1 .RI .1.3.6.1.1 .RI .1.3.6.1.2 .RI .1.3.6.1.2.1 .RI .1.3.6.1.2.1.1 .RI .1.3.6.1.2.1.1.1 .RI .1.3.6.1.2.1.1.2 .RI .1.3.6.1.2.1.1.3 .fi .PP .IP \(bu 4 snmptranslate \-Ts | head .br خروجی زیر را تولید خواهد کرد: .IP .nf .RI .iso.org .RI .iso.org.dod .RI .iso.org.dod.internet .RI .iso.org.dod.internet.directory .RI .iso.org.dod.internet.mgmt .RI .iso.org.dod.internet.mgmt.mib\-2 .RI .iso.org.dod.internet.mgmt.mib\-2.system .RI .iso.org.dod.internet.mgmt.mib\-2.system.sysDescr .RI .iso.org.dod.internet.mgmt.mib\-2.system.sysObjectID .RI .iso.org.dod.internet.mgmt.mib\-2.system.sysUpTime .fi .PP .IP \(bu 4 snmptranslate \-Tt | head .br خروجی زیر را تولید خواهد کرد: .IP .nf 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 .fi .PP .IP \(bu 4 snmptranslate -OX - .br با ورودی زیر: .IP .nf 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 .fi .IP خروجی زیر را تولید خواهد کرد: .IP .nf OSPF-MIB::ospfRouterId.0 = IpAddress: 192.0.2.1 OSPF-MIB::ospfAdminStat.0 = INTEGER: 1 OSPF-MIB::ospfVersionNumber.0 = INTEGER: 2 .fi .SH "همچنین ببینید (SEE ALSO)" snmpcmd(1), variables(5), RFC 2578-2580.