.\" /************************************************************
.\" 	Copyright 1997 Niels Baggesen
.\"
.\"                       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.
.\"
.\" I DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
.\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
.\" I 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 SNMPTABLE 1 "25 Jul 2003" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmptable \- واکشی و نمایش یک جدول کامل از MIB در پروتکل SNMP
.SH "خلاصه دستور (SYNOPSIS)"
.B snmptable
[گزینه‌های عمومی] [\-Cb] [\-CB] [\-Ch] [\-CH] [\-Ci] [\-Cf STRING] [\-Cw WIDTH]
AGENT TABLE\-OID
.SH "توضیحات (DESCRIPTION)"
دستور
.B snmptable
یک برنامه کاربردی SNMP است که به طور مکرر از درخواست‌های SNMP GETNEXT یا GETBULK برای پرس‌وجوی اطلاعات یک موجودیت شبکه استفاده می‌کند. پارامتر TABLE\-OID باید یک جدول SNMP را مشخص کند.
.PP
پارامتر AGENT یک عامل هدف SNMP را مشخص می‌کند که برای پایش اشیاء داده‌شده تنظیم شده است. در ساده‌ترین حالت، مقدار AGENT شامل یک نام میزبان یا یک آدرس IPv4 خواهد بود. در این وضعیت، دستور تلاش می‌کند تا با استفاده از UDP/IPv4 به درگاه ۱۶۱ میزبان هدف مورد نظر با عامل ارتباط برقرار کند. برای مشاهده فهرست کامل قالب‌های ممکن برای AGENT به
.I snmpcmd(1)
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B گزینه‌های عمومی (COMMON OPTIONS)
لطفاً برای مشاهده فهرست مقادیر ممکن برای گزینه‌های عمومی و همچنین توضیحات آن‌ها، به
.I snmpcmd(1)
مراجعه کنید.
.TP
.B \-Cb
تنها یک سربرگ خلاصه را نمایش می‌دهد. هرگونه پیشوند مشترک در نام فیلدهای جدول حذف خواهد شد.
.TP
.B \-CB
از درخواست‌های GETBULK برای واکشی داده‌ها استفاده نمی‌کند و فقط از GETNEXT استفاده می‌کند.
.TP
.BI \-Cc " CHARS"
جدول را در ستون‌هایی به پهنای
.I CHARS
نویسه چاپ می‌کند.
.TP
.BI \-Cf " STRING"
رشته
.I STRING
برای جداسازی ستون‌های جدول استفاده می‌شود. با این گزینه، هر مدخل جدول به صورت فشرده و تنها با رشته داده‌شده برای جداسازی ستون‌ها چاپ می‌شود (اگر می‌خواهید آن را در یک پایگاه‌داده وارد کنید مفید است). در غیر این صورت به صورت ستون‌های مرتب و تراز‌شده چاپ می‌شود.
.TP
.B \-Ch
.I فقط
سربرگ‌های ستون را نمایش می‌دهد.
.TP
.B \-CH
سربرگ‌های ستون را نمایش نمی‌دهد.
.TP
.B \-Ci
این گزینه نمایه (index) مدخل را به ابتدای تمام خطوط چاپ‌شده اضافه می‌کند.
.TP
.B \-Cl
داده‌ها را در هر ستون چپ‌چین می‌کند.
.TP
.BI \-Cr " REPEATERS"
برای درخواست‌های GETBULK، پارامتر
.I REPEATERS
مقدار max-repeaters مورد استفاده را تعیین می‌کند. برای درخواست‌های GETNEXT، مقدار
.I REPEATERS
تعداد مدخل‌هایی که در هر بار باید واکشی شوند را مشخص می‌کند.
.TP
.BI \-Cw " WIDTH"
عرض خطوط را هنگام چاپ جدول مشخص می‌کند. اگر خطوط طولانی‌تر باشند، جدول در بخش‌هایی با حداکثر
.I WIDTH
نویسه چاپ خواهد شد. اگر
.I WIDTH
کمتر از طول محتوای یک تک‌ستون باشد، آن تک‌ستون همچنان چاپ خواهد شد.
.PP
توجه داشته باشید که
.B snmptable
همان‌طور که در صفحه راهنمای
.I snmpcmd(1)
شرح داده شده است، به یک آرگومان برای تعیین عامل جهت پرس‌وجو و دقیقاً یک آرگومان OID نیاز دارد. این OID \fBباید\fP مربوط به یک شیء جدول MIB باشد.
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
$ snmptable \-v 2c \-c public localhost at.atTable

SNMP table: at.atTable RFC1213\-MIB::atTable

atIfIndex   atPhysAddress   atNetAddress
        1  8:0:20:20:0:ab 130.225.243.33
.fi
.PP
.nf
$ snmptable \-v 2c \-c public \-Cf + localhost at.atTable

SNMP table: at.atTable

atIfIndex+atPhysAddress+atNetAddress
1+8:0:20:20:0:ab+130.225.243.33
.fi
.PP
.nf
$ snmptable localhost \-Cl \-CB \-Ci \-OX \-Cb \-Cc 16 \-Cw 64 ifTable

SNMP table: ifTable

Index           Descr           Type            Mtu
Speed           PhysAddress     AdminStatus     OperStatus
LastChange      InOctets        InUcastPkts     InNUcastPkts
InDiscards      InErrors        InUnknownProtos OutOctets
OutUcastPkts    OutNUcastPkts   OutDiscards     OutErrors
OutQLen         Specific

index: [1]
1               lo              softwareLoopbac 16436
10000000                        up              up
?               2837283786      3052466         ?
0               0               ?               2837283786
3052466         ?               0               0
0               zeroDotZero

index: [2]
2               eth0            ethernetCsmacd  1500
10000000        0:5:5d:d1:f7:cf up              up
?               2052604234      44252973        ?
0               0               ?               149778187
65897282        ?               0               0
0               zeroDotZero
.fi
.PP
.SH "اشکالات (BUGS)"
آزمون بررسی اینکه آیا
.I TABLE\-OID
واقعاً یک جدول را مشخص می‌کند، نسبتاً اکتشافی (heuristic) است. همچنین توجه داشته باشید که این آزمون نیازمند بارگذاری فایل MIB تعریف‌کننده آن است.
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR snmpcmd (1)،
.BR variables (5).