نام (NAME)

snmpget - برقراری ارتباط با یک موجودیت شبکه با استفاده از درخواست‌های SNMP GET

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

snmpget [COMMON OPTIONS] [-Cf] AGENT OID [OID]...

توضیحات (DESCRIPTION)

snmpget یک برنامهٔ کاربردی SNMP است که از درخواست‌های SNMP GET برای پرس‌وجوی اطلاعات از یک موجودیت شبکه استفاده می‌کند. یک یا چند شناسهٔ شیء (OID) را می‌توان به عنوان آرگومان در خط فرمان وارد کرد. نام هر متغیر در قالبی که در variables(5) مشخص شده است، داده می‌شود.

گزینه‌ها (OPTIONS)

-Cf

اگر -Cf مشخص نشود، برخی برنامه‌ها (snmpdelta، snmpget، snmpgetnext و snmpstatus) تلاش خواهند کرد تا خطاهای بازگردانده شده توسط کارگزاری (agent) که با آن ارتباط برقرار کرده‌اید را اصلاح کرده و درخواست را مجدداً ارسال کنند. تنها زمانی استفاده از این قابلیت واقعاً مفید است که در درخواست خود یک OID مشخص کرده باشید که وجود ندارد و از SNMPv1 استفاده می‌کنید که به درخواست‌های نوع «همه یا هیچ» نیاز دارد.

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

مثال‌ها (EXAMPLES)

دستور:

snmpget -c public zeus system.sysDescr.0

متغیر system.sysDescr.0 را از میزبان zeus با استفاده از رشتهٔ انجمن (community string) public دریافت می‌کند:

system.sysDescr.0 = "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"

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

در اینجا مثال دیگری آورده شده است. گزینه‌های -c و -v در صفحهٔ راهنمای snmpcmd(1) تعریف شده‌اند. (توجه داشته باشید که system.sysUpTime یک OID ناقص است، زیرا نیاز است اندیس 0. به انتهای آن افزوده شود):

snmpget -v1 -Cf -c public localhost system.sysUpTime system.sysContact.0

این مثال موارد زیر را بازمی‌گرداند:

Error in packet
Reason: (noSuchName) There is no such variable name in this MIB.
This name doesn't exist: system.sysUpTime

به طور مشابه، دستور:

snmpget -v1 -c public localhost system.sysUpTime system.sysContact.0

پاسخ زیر را بازمی‌گرداند:

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

با مشخص کردن پرچم -Cf برنامه تلاشی برای اصلاح PDU برای شما انجام نخواهد داد.

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

snmpcmd(1), snmpwalk(1), variables(5).