.\" -*- 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 SNMPGET 1 "18 Jun 2007" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmpget \- برقراری ارتباط با یک موجودیت شبکه با استفاده از درخواست‌های SNMP GET
.SH "خلاصه دستور (SYNOPSIS)"
.B snmpget
[COMMON OPTIONS] [\-Cf] AGENT OID [OID]...
.SH "توضیحات (DESCRIPTION)"
.B snmpget
یک برنامهٔ کاربردی SNMP است که از درخواست‌های SNMP GET برای پرس‌وجوی اطلاعات از یک موجودیت شبکه استفاده می‌کند. یک یا چند شناسهٔ شیء (OID) را می‌توان به عنوان آرگومان در خط فرمان وارد کرد. نام هر متغیر در قالبی که در
.IR variables(5)
مشخص شده است، داده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-Cf
اگر
.B \-Cf
مشخص
.I نشود،
برخی برنامه‌ها
.RB ( snmpdelta "، " snmpget "، " snmpgetnext " و " snmpstatus )
تلاش خواهند کرد تا خطاهای بازگردانده شده توسط کارگزاری (agent) که با آن ارتباط برقرار کرده‌اید را اصلاح کرده و درخواست را مجدداً ارسال کنند. تنها زمانی استفاده از این قابلیت واقعاً مفید است که در درخواست خود یک OID مشخص کرده باشید که وجود ندارد و از SNMPv1 استفاده می‌کنید که به درخواست‌های نوع «همه یا هیچ» نیاز دارد.
.PP
علاوه بر این گزینه،
.B snmpget
از گزینه‌های عمومی شرح‌داده‌شده در صفحهٔ راهنمای
.I snmpcmd(1)
پشتیبانی می‌کند.
توجه داشته باشید که همان‌طور که در آنجا توضیح داده شده است،
.B snmpget
به یک آرگومان برای تعیین agent مورد پرس‌وجو و حداقل یک آرگومان OID نیاز دارد.
.SH "مثال‌ها (EXAMPLES)"
دستور:
.PP
    snmpget \-c public zeus system.sysDescr.0
.PP
متغیر system.sysDescr.0 را از میزبان
.B zeus
با استفاده از رشتهٔ انجمن (community string)
.B public
دریافت می‌کند:
.PP
    system.sysDescr.0 = "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"
.PP
اگر موجودیت شبکه در پردازش بستهٔ درخواست با خطایی مواجه شود، یک بستهٔ خطا بازگردانده شده و پیامی نمایش داده می‌شود که به شناسایی نحوهٔ نادرست بودن درخواست کمک می‌کند. اگر متغیرهای دیگری در درخواست وجود داشته باشند، درخواست بدون متغیر نامعتبر مجدداً ارسال خواهد شد.
.PP
در اینجا مثال دیگری آورده شده است. گزینه‌های \-c و \-v در صفحهٔ راهنمای
.I snmpcmd(1)
تعریف شده‌اند. (توجه داشته باشید که system.sysUpTime یک OID ناقص است، زیرا نیاز است اندیس 0. به انتهای آن افزوده شود):
.PP
.nf
    snmpget \-v1 \-Cf \-c public localhost system.sysUpTime system.sysContact.0
.fi
.PP
این مثال موارد زیر را بازمی‌گرداند:
.PP
.nf
    Error in packet
    Reason: (noSuchName) There is no such variable name in this MIB.
    This name doesn't exist: system.sysUpTime
.fi
.PP
به طور مشابه، دستور:
.nf
    snmpget \-v1 \-c public localhost system.sysUpTime system.sysContact.0
.fi
.PP
پاسخ زیر را بازمی‌گرداند:
.PP
.nf
    Error in packet
    Reason: (noSuchName) There is no such variable name in this MIB.
    This name doesn't exist: system.sysUpTime

    system.sysContact.0 = STRING: root@localhost
.fi
.PP
با مشخص کردن پرچم
.B \-Cf
برنامه تلاشی برای اصلاح PDU برای شما انجام نخواهد داد.
.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), snmpwalk(1), variables(5).