نام (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).