نام (NAME)

snmpbulkwalk - بازیابی یک زیردرخت از مقادیر مدیریتی با استفاده از درخواست‌های SNMP GETBULK

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

snmpbulkwalk [APPLICATION OPTIONS] [COMMON OPTIONS] AGENT [OID]

توضیحات (DESCRIPTION)

دستور snmpbulkwalk یک برنامهٔ SNMP است که از درخواست‌های SNMP GETBULK برای پرس‌وجوی کارآمد یک موجودیت شبکه جهت دریافت درختی از اطلاعات استفاده می‌کند.

می‌توان یک شناسه شیء (OID) را در خط فرمان مشخص کرد. این OID تعیین می‌کند که کدام بخش از فضای شناسه‌های اشیاء با استفاده از درخواست‌های GETBULK جستجو شود. تمام متغیرهای موجود در زیردرختِ زیر OID داده‌شده مورد پرس‌وجو قرار می‌گیرند و مقادیر آن‌ها به کاربر نمایش داده می‌شود. نام هر متغیر در قالبی که در variables(5) مشخص شده است، ارائه می‌گردد. اگر هیچ آرگومان OID مشخص نشده باشد، snmpbulkwalk پایگاه اطلاعاتی MIB-2 را جستجو خواهد کرد.

اگر موجودیت شبکه در پردازش بستهٔ درخواست با خطایی مواجه شود، یک بستهٔ خطا بازگردانده شده و پیامی نشان داده می‌شود که به تعیین دقیق دلیل معیوب بودن درخواست کمک می‌کند.

اگر جستجوی درخت باعث شود تلاشی برای جستجو فراتر از انتهای MIB صورت گیرد، پیام "End of MIB" نمایش داده خواهد شد.

گزینه‌ها (OPTIONS)

-Cc

بررسی صعودی بودن OIDهای بازگردانده‌شده را انجام نده. برخی کارگزارها (مانند پرینترهای LaserJet) OIDها را بدون ترتیب بازمی‌گردانند، اما با این وجود می‌توانند پیمایش را کامل کنند. سایر کارگزارها OIDهایی نامرتب بازمی‌گردانند که می‌تواند باعث شود snmpbulkwalk در یک حلقهٔ بی‌پایان بیفتد. به‌طور پیش‌فرض، snmpbulkwalk تلاش می‌کند این رفتار را شناسایی کرده و هنگام برخورد با کارگزاری با عملکرد غیرمجاز، به شما هشدار دهد. از -Cc برای غیرفعال کردن این رفتار استفاده کنید.

-Ci

شامل کردن OID داده‌شده در محدودهٔ جستجو. در حالت عادی، snmpbulkwalk از درخواست‌های GETBULK با شروع از OID مشخص‌شده توسط شما استفاده می‌کند و تمام نتایج موجود در درخت MIB پس از آن OID را بازمی‌گرداند. گاهی ممکن است بخواهید OID مشخص‌شده در خط فرمان را نیز در صورت معتبر بودن در خود درخت، در نتایج چاپ‌شده بگنجانید. این گزینه امکان انجام این کار را به شما می‌دهد.

-Cn<NUM>

تنظیم فیلد non-repeaters در PDUهای GETBULK. این فیلد تعداد متغیرهای ارائه‌شده‌ای را تعیین می‌کند که نباید روی آن‌ها تکرار انجام شود. مقدار پیش‌فرض 0 است.

-Cp

پس از اتمام پیمایش، تعداد متغیرهای یافت‌شده را چاپ کن.

-Cr<NUM>

تنظیم فیلد max-repetitions در PDUهای GETBULK. این فیلد بیشینهٔ تعداد تکرارها بر روی متغیرهای تکرارشونده را تعیین می‌کند. مقدار پیش‌فرض 10 است.

علاوه بر این گزینه‌ها، snmpbulkwalk گزینه‌های عمومی شرح‌داده‌شده در صفحهٔ راهنمای snmpcmd(1) را نیز می‌پذیرد. توجه داشته باشید که snmpbulkget همان‌طور که در بالا شرح داده شد، نیازمند یک آرگومان برای تعیین کارگزار مورد پرس‌وجو و حداکثر یک آرگومان OID است.

مثال‌ها (EXAMPLES)

دستور:

snmpbulkwalk -v2c -Os -c public zeus system

تمام متغیرهای زیرمجموعهٔ system را بازیابی می‌کند:

sysDescr.0 = STRING: "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"
sysObjectID.0 = OID: enterprises.hp.nm.hpsystem.10.1.1
sysUpTime.0 = Timeticks: (155274552) 17 days, 23:19:05
sysContact.0 = STRING: ""
sysName.0 = STRING: "zeus.net.cmu.edu"
sysLocation.0 = STRING: ""
sysServices.0 = INTEGER: 72

برخلاف snmpwalk، این اطلاعات معمولاً در یک تراکنش منفرد با کارگزار جمع‌آوری می‌شود، نه به ازای هر متغیرِ یافت‌شده یک تراکنش. بنابراین snmpbulkwalk از نظر استفاده از شبکه کارآمدتر است، که این امر به‌ویژه هنگام بازیابی جدول‌های بزرگ حائز اهمیت خواهد بود.

نکته (NOTE)

همان‌طور که از نام آن پیداست، snmpbulkwalk از پیام SNMP GETBULK استفاده می‌کند که در SNMP v1 موجود نیست.

همچنین ببینید (SEE ALSO)

snmpcmd(1), variables(5).