SNMPTABLE(1)                       Net-SNMP                       SNMPTABLE(1)

نام (NAME)
       snmptable - واکشی و نمایش یک جدول کامل از MIB در پروتکل SNMP

خلاصه دستور (SYNOPSIS)
       snmptable [گزینه‌های عمومی] [-Cb] [-CB] [-Ch] [-CH] [-Ci] [-Cf STRING]
       [-Cw WIDTH] AGENT TABLE-OID

توضیحات (DESCRIPTION)
       دستور snmptable یک برنامه کاربردی SNMP است که به طور مکرر از درخواست‌های
       SNMP GETNEXT یا GETBULK برای پرس‌وجوی اطلاعات یک موجودیت شبکه استفاده
       می‌کند. پارامتر TABLE-OID باید یک جدول SNMP را مشخص کند.

       پارامتر AGENT یک عامل هدف SNMP را مشخص می‌کند که برای پایش اشیاء داده‌شده
       تنظیم شده است. در ساده‌ترین حالت، مقدار AGENT شامل یک نام میزبان یا یک
       آدرس IPv4 خواهد بود. در این وضعیت، دستور تلاش می‌کند تا با استفاده از
       UDP/IPv4 به درگاه ۱۶۱ میزبان هدف مورد نظر با عامل ارتباط برقرار کند.
       برای مشاهده فهرست کامل قالب‌های ممکن برای AGENT به snmpcmd(1) مراجعه
       کنید.

گزینه‌ها (OPTIONS)
       گزینه‌های عمومی (COMMON OPTIONS)
               لطفاً برای مشاهده فهرست مقادیر ممکن برای گزینه‌های عمومی و همچنین
               توضیحات آن‌ها، به snmpcmd(1) مراجعه کنید.

       -Cb     تنها یک سربرگ خلاصه را نمایش می‌دهد. هرگونه پیشوند مشترک در نام
               فیلدهای جدول حذف خواهد شد.

       -CB     از درخواست‌های GETBULK برای واکشی داده‌ها استفاده نمی‌کند و فقط از
               GETNEXT استفاده می‌کند.

       -Cc CHARS
               جدول را در ستون‌هایی به پهنای CHARS نویسه چاپ می‌کند.

       -Cf STRING
               رشته STRING برای جداسازی ستون‌های جدول استفاده می‌شود. با این
               گزینه، هر مدخل جدول به صورت فشرده و تنها با رشته داده‌شده برای
               جداسازی ستون‌ها چاپ می‌شود (اگر می‌خواهید آن را در یک پایگاه‌داده
               وارد کنید مفید است). در غیر این صورت به صورت ستون‌های مرتب و
               تراز‌شده چاپ می‌شود.

       -Ch     فقط سربرگ‌های ستون را نمایش می‌دهد.

       -CH     سربرگ‌های ستون را نمایش نمی‌دهد.

       -Ci     این گزینه نمایه (index) مدخل را به ابتدای تمام خطوط چاپ‌شده
               اضافه می‌کند.

       -Cl     داده‌ها را در هر ستون چپ‌چین می‌کند.

       -Cr REPEATERS
               برای درخواست‌های GETBULK، پارامتر REPEATERS مقدار max-repeaters
               مورد استفاده را تعیین می‌کند. برای درخواست‌های GETNEXT، مقدار
               REPEATERS تعداد مدخل‌هایی که در هر بار باید واکشی شوند را مشخص
               می‌کند.

       -Cw WIDTH
               عرض خطوط را هنگام چاپ جدول مشخص می‌کند. اگر خطوط طولانی‌تر باشند،
               جدول در بخش‌هایی با حداکثر WIDTH نویسه چاپ خواهد شد. اگر WIDTH
               کمتر از طول محتوای یک تک‌ستون باشد، آن تک‌ستون همچنان چاپ خواهد
               شد.

       توجه داشته باشید که snmptable همان‌طور که در صفحه راهنمای snmpcmd(1) شرح
       داده شده است، به یک آرگومان برای تعیین عامل جهت پرس‌وجو و دقیقاً یک
       آرگومان OID نیاز دارد. این OID باید مربوط به یک شیء جدول MIB باشد.

مثال‌ها (EXAMPLES)
       $ snmptable -v 2c -c public localhost at.atTable

       SNMP table: at.atTable RFC1213-MIB::atTable

       atIfIndex   atPhysAddress   atNetAddress
               1  8:0:20:20:0:ab 130.225.243.33

       $ snmptable -v 2c -c public -Cf + localhost at.atTable

       SNMP table: at.atTable

       atIfIndex+atPhysAddress+atNetAddress
       1+8:0:20:20:0:ab+130.225.243.33

       $ snmptable localhost -Cl -CB -Ci -OX -Cb -Cc 16 -Cw 64 ifTable

       SNMP table: ifTable

       Index           Descr           Type            Mtu
       Speed           PhysAddress     AdminStatus     OperStatus
       LastChange      InOctets        InUcastPkts     InNUcastPkts
       InDiscards      InErrors        InUnknownProtos OutOctets
       OutUcastPkts    OutNUcastPkts   OutDiscards     OutErrors
       OutQLen         Specific

       index: [1]
       1               lo              softwareLoopbac 16436
       10000000                        up              up
       ?               2837283786      3052466         ?
       0               0               ?               2837283786
       3052466         ?               0               0
       0               zeroDotZero

       index: [2]
       2               eth0            ethernetCsmacd  1500
       10000000        0:5:5d:d1:f7:cf up              up
       ?               2052604234      44252973        ?
       0               0               ?               149778187
       65897282        ?               0               0
       0               zeroDotZero

اشکالات (BUGS)
       آزمون بررسی اینکه آیا TABLE-OID واقعاً یک جدول را مشخص می‌کند، نسبتاً
       اکتشافی (heuristic) است. همچنین توجه داشته باشید که این آزمون نیازمند
       بارگذاری فایل MIB تعریف‌کننده آن است.

همچنین ببینید (SEE ALSO)
       snmpcmd(1)، variables(5).

V5.9.5.2                          25 Jul 2003                     SNMPTABLE(1)