.\" -*- 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 SNMPGETNEXT 1 "04 Mar 2002" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmpgetnext \- ارتباط با یک موجودیت شبکه با استفاده از درخواست‌های SNMP GETNEXT
.SH "خلاصه دستور (SYNOPSIS)"
.B snmpgetnext
[COMMON OPTIONS] [\-Cf] AGENT OID [OID]...
.SH "توضیحات (DESCRIPTION)"
دستور
.B snmpgetnext
یک برنامهٔ SNMP است که از درخواست SNMP GETNEXT برای پرس‌وجوی اطلاعات روی یک موجودیت شبکه استفاده می‌کند. یک یا چند شناسه شیء (OID) می‌توانند به عنوان آرگومان در خط فرمان مشخص شوند. نام هر متغیر در قالبی که در
.IR variables(5)
تعیین شده، داده می‌شود. برای هر مورد، متغیری که از نظر ترتیب لغوی (lexicographically) در MIB موجودیت دوردست «بعدی» است، بازگردانده خواهد شد.
.PP
برای مثال:
.PP
snmpgetnext \-c public zeus interfaces.ifTable.ifEntry.ifType.1
.PP
متغیر interfaces.ifTable.ifEntry.ifType.2 را بازیابی خواهد کرد:
.PP
interfaces.ifTable.ifEntry.ifType.2 = softwareLoopback(24)
.PP
اگر موجودیت شبکه در پردازش بستهٔ درخواست با خطایی مواجه شود، یک پیام خطا نمایش داده خواهد شد که به مشخص کردن نحوهٔ معیوب بودن درخواست کمک می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-Cf
اگر
.B \-Cf
مشخص
.I نشود،
برخی از برنامه‌ها
.RB ( snmpdelta "، " snmpget "، " snmpgetnext " و " snmpstatus )
تلاش خواهند کرد خطاهای برگردانده‌شده توسط agent که با آن در ارتباط بودید را اصلاح کرده و درخواست را مجدداً ارسال کنند. تنها زمانی که این قابلیت واقعاً کاربردی است، وقتی است که یک OID را مشخص کرده باشید که در درخواست شما وجود نداشته باشد و در حال استفاده از SNMPv1 باشید که نیازمند نوع درخواست‌های «همه یا هیچ» (all or nothing) است.
.PP
علاوه بر این گزینه،
.B snmpgetnext
گزینه‌های عمومی توصیف‌شده در صفحهٔ راهنمای
.I snmpcmd(1)
را می‌پذیرد.
توجه داشته باشید که
.B snmpgetnext
به یک آرگومان برای تعیین agent مورد پرس‌وجو و دست‌کم یک آرگومان OID، همان‌طور که در آنجا شرح داده شده است، نیاز دارد.
.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), snmpget(1), variables(5).