.\" -*- nroff -*-
.\" Portions of this file are subject to the following copyright.  See
.\" the Net-SNMP 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.
.\" ******************************************************************/
.TH SNMPBULKWALK 1 "01 May 2002" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmpbulkwalk \- بازیابی یک زیردرخت از مقادیر مدیریتی با استفاده از درخواست‌های SNMP GETBULK
.SH "خلاصه دستور (SYNOPSIS)"
.B snmpbulkwalk
[APPLICATION OPTIONS] [COMMON OPTIONS] AGENT [OID]
.SH "توضیحات (DESCRIPTION)"
دستور
.B snmpbulkwalk
یک برنامهٔ SNMP است که از درخواست‌های SNMP GETBULK برای پرس‌وجوی کارآمد یک موجودیت شبکه جهت دریافت درختی از اطلاعات استفاده می‌کند.
.PP
می‌توان یک شناسه شیء (OID) را در خط فرمان مشخص کرد. این OID تعیین می‌کند که کدام بخش از فضای شناسه‌های اشیاء با استفاده از درخواست‌های GETBULK جستجو شود. تمام متغیرهای موجود در زیردرختِ زیر OID داده‌شده مورد پرس‌وجو قرار می‌گیرند و مقادیر آن‌ها به کاربر نمایش داده می‌شود. نام هر متغیر در قالبی که در
.IR variables(5)
مشخص شده است، ارائه می‌گردد. اگر هیچ آرگومان OID مشخص نشده باشد،
.B snmpbulkwalk
پایگاه اطلاعاتی MIB\-2 را جستجو خواهد کرد.
.PP
اگر موجودیت شبکه در پردازش بستهٔ درخواست با خطایی مواجه شود، یک بستهٔ خطا بازگردانده شده و پیامی نشان داده می‌شود که به تعیین دقیق دلیل معیوب بودن درخواست کمک می‌کند.
.PP
اگر جستجوی درخت باعث شود تلاشی برای جستجو فراتر از انتهای MIB صورت گیرد، پیام "End of MIB" نمایش داده خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-Cc
بررسی صعودی بودن OIDهای بازگردانده‌شده را انجام نده. برخی کارگزارها (مانند پرینترهای LaserJet) OIDها را بدون ترتیب بازمی‌گردانند، اما با این وجود می‌توانند پیمایش را کامل کنند. سایر کارگزارها OIDهایی نامرتب بازمی‌گردانند که می‌تواند باعث شود
.B snmpbulkwalk
در یک حلقهٔ بی‌پایان بیفتد. به‌طور پیش‌فرض،
.B snmpbulkwalk
تلاش می‌کند این رفتار را شناسایی کرده و هنگام برخورد با کارگزاری با عملکرد غیرمجاز، به شما هشدار دهد. از
.B \-Cc
برای غیرفعال کردن این رفتار استفاده کنید.
.TP
.B \-Ci
شامل کردن OID داده‌شده در محدودهٔ جستجو. در حالت عادی،
.B snmpbulkwalk
از درخواست‌های GETBULK با شروع از OID مشخص‌شده توسط شما استفاده می‌کند و تمام نتایج موجود در درخت MIB پس از آن OID را بازمی‌گرداند. گاهی ممکن است بخواهید OID مشخص‌شده در خط فرمان را نیز در صورت معتبر بودن در خود درخت، در نتایج چاپ‌شده بگنجانید. این گزینه امکان انجام این کار را به شما می‌دهد.
.TP
.BI \-Cn <NUM>
تنظیم فیلد
.I non-repeaters
در PDUهای GETBULK. این فیلد تعداد متغیرهای ارائه‌شده‌ای را تعیین می‌کند که نباید روی آن‌ها تکرار انجام شود. مقدار پیش‌فرض 0 است.
.TP
.B \-Cp
پس از اتمام پیمایش، تعداد متغیرهای یافت‌شده را چاپ کن.
.TP
.BI \-Cr <NUM>
تنظیم فیلد
.I max-repetitions
در PDUهای GETBULK. این فیلد بیشینهٔ تعداد تکرارها بر روی متغیرهای تکرارشونده را تعیین می‌کند. مقدار پیش‌فرض 10 است.
.PP
علاوه بر این گزینه‌ها،
.B snmpbulkwalk
گزینه‌های عمومی شرح‌داده‌شده در صفحهٔ راهنمای
.I snmpcmd(1)
را نیز می‌پذیرد.
توجه داشته باشید که
.B snmpbulkget
همان‌طور که در بالا شرح داده شد، نیازمند یک آرگومان برای تعیین کارگزار مورد پرس‌وجو و حداکثر یک آرگومان OID است.
.SH "مثال‌ها (EXAMPLES)"
دستور:
.PP
snmpbulkwalk \-v2c \-Os \-c public zeus system
.PP
تمام متغیرهای زیرمجموعهٔ system را بازیابی می‌کند:
.PP
sysDescr.0 = STRING: "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"
.br
sysObjectID.0 = OID: enterprises.hp.nm.hpsystem.10.1.1
.br
sysUpTime.0 = Timeticks: (155274552) 17 days, 23:19:05
.br
sysContact.0 = STRING: ""
.br
sysName.0 = STRING: "zeus.net.cmu.edu"
.br
sysLocation.0 = STRING: ""
.br
sysServices.0 = INTEGER: 72
.PP
برخلاف
.BR snmpwalk ،
این اطلاعات معمولاً در یک تراکنش منفرد با کارگزار جمع‌آوری می‌شود، نه به ازای هر متغیرِ یافت‌شده یک تراکنش. بنابراین
.B snmpbulkwalk
از نظر استفاده از شبکه کارآمدتر است، که این امر به‌ویژه هنگام بازیابی جدول‌های بزرگ حائز اهمیت خواهد بود.
.SH "نکته (NOTE)"
همان‌طور که از نام آن پیداست،
.B snmpbulkwalk
از پیام SNMP GETBULK استفاده می‌کند که در SNMP v1 موجود نیست.
.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), variables(5).