.\" Portions of this file are subject to the following copyright.  See
.\" the Net-SNMP's 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.
.\" ******************************************************************/
.\" Portions of this file are copyrighted by:
.\" Copyright Copyright 2003 Sun Microsystems, Inc. All rights reserved.
.\" Use is subject to license terms specified in the COPYING file
.\" distributed with the Net-SNMP package.
.\" ******************************************************************/
.TH SNMPSTATUS 1 "25 Jul 2003" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmpstatus \- دریافت مجموعه‌ای ثابت از اطلاعات مدیریتی از یک موجودیت شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.B snmpstatus
[COMMON OPTIONS] [\-Cf] AGENT
.SH "توضیحات (DESCRIPTION)"
.B snmpstatus
یک برنامه کاربردی SNMP است که چندین آمار مهم را از یک موجودیت شبکه دریافت می‌کند.
.PP
AGENT یک عامل SNMP هدف را مشخص می‌کند که برای نظارت بر اشیاء داده‌شده پیکربندی شده است. در ساده‌ترین حالت، مشخصات AGENT شامل یک نام میزبان یا یک آدرس IPv4 خواهد بود. در این وضعیت، دستور با استفاده از UDP/IPv4 به پورت ۱۶۱ میزبان هدف داده‌شده، برای برقراری ارتباط با عامل تلاش خواهد کرد.
.PP
برای مشاهده فهرست کامل قالب‌های ممکن برای AGENT، صفحه راهنمای
.I snmpcmd(1)
را ببینید.
.PP
اطلاعات بازگردانده‌شده عبارتند از:
.IP
آدرس IP موجودیت.
.br
توضیحات متنی موجودیت (sysDescr.0)
.br
مدت‌زمان فعالیت (uptime) عامل SNMP موجودیت (sysUpTime.0)
.br
مجموع بسته‌های دریافت‌شده در تمام رابط‌ها
(ifInUCastPkts.* + ifInNUCastPkts.*)
.br
مجموع بسته‌های ارسال‌شده در تمام رابط‌ها
(ifOutUCastPkts.* + ifOutNUCastPkts.*)
.br
تعداد بسته‌های ورودی IP (ipInReceives.0)
.br
تعداد بسته‌های خروجی IP (ipOutRequests.0)
.PP
به عنوان مثال:
.PP
snmpstatus \-c public \-v 1 netdev\-kbox.cc.cmu.edu
.PP
خروجی مشابه زیر تولید خواهد کرد:
.PP
[128.2.56.220]=>[Kinetics FastPath2] Up: 1 day, 4:43:31
.br
Interfaces: 1,  Recv/Trans packets: 262874/39867 |
IP: 31603/15805
.PP
.B snmpstatus
همچنین وضعیت عملیاتی تمام رابط‌ها (ifOperStatus.*) را بررسی می‌کند و در صورت یافتن رابطی که فعال نیست، گزارشی مشابه زیر ارائه می‌دهد:
.PP
2 interfaces are down!
.PP
اگر موجودیت شبکه در پردازش بسته درخواست دچار خطا شود، یک بسته خطا بازگردانده شده و پیامی نمایش داده می‌شود که به مشخص کردن نحوه نادرست بودن درخواست کمک می‌کند.
.B snmpstatus
تلاش خواهد کرد تا درخواست خود را برای حذف متغیر معیوب اصلاح کند (مگر اینکه گزینه
.B \-Cf
داده شده باشد، به بخش گزینه‌ها مراجعه کنید)، اما این متغیر دیگر در داده‌های نمایش داده‌شده وجود نخواهد داشت.
.PP
.SH "گزینه‌ها (OPTIONS)"
.TP
.B COMMON OPTIONS
لطفاً برای مشاهده فهرست مقادیر ممکن برای COMMON OPTIONS و همچنین توضیحات آن‌ها، صفحه راهنمای
.I snmpcmd(1)
را ببینید.
.TP
.B \-Cf
به‌طور پیش‌فرض، snmpstatus تلاش می‌کند تا خطاهای بازگردانده‌شده توسط عامل را برطرف کرده و درخواست را مجدداً ارسال کند. در این وضعیت، دستور داده‌هایی را که می‌تواند نمایش می‌دهد. اگر گزینه \-Cf مشخص شده باشد، snmpstatus برای رفع خطاها تلاش نخواهد کرد و بروز خطا باعث پایان یافتن اجرای دستور می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), snmpget(1)