.\" -*- 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 SNMPSET 1 "19 Jun 2003" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmpset \- با استفاده از درخواست‌های SNMP SET با یک موجودیت شبکه ارتباط برقرار می‌کند
.SH "خلاصه دستور (SYNOPSIS)"
.B snmpset
[COMMON OPTIONS] AGENT OID TYPE VALUE [OID TYPE VALUE]...
.SH "توضیحات (DESCRIPTION)"
.B snmpset
یک برنامه کاربردی SNMP است که از درخواست SNMP SET برای تنظیم
اطلاعات روی یک موجودیت شبکه استفاده می‌کند. باید یک یا چند شناسه شیء
(OID) به عنوان آرگومان در خط فرمان مشخص شوند. همراه با هر شناسه شیء
باید یک نوع و یک مقدار برای تنظیم شدن ارائه شود. نام هر متغیر در قالبی
که در
.IR variables(5)
مشخص شده است، داده می‌شود.
.PP
پارامتر
.I TYPE
یک نویسه تک‌حرفی و یکی از موارد زیر است:
.RS
.PD 0
.TP 3
.B i
INTEGER
.TP 3
.B u
UNSIGNED
.TP 3
.B s
STRING
.TP 3
.B x
HEX STRING
.TP 3
.B d
DECIMAL STRING
.TP 3
.B n
NULLOBJ
.TP 3
.B o
OBJID
.TP 3
.B t
TIMETICKS
.TP 3
.B a
IPADDRESS
.TP 3
.B b
BITS
.PD
.RE
بیشتر این‌ها از نوع متناظر و مشخص ASN.1 استفاده خواهند کرد.
حروف \&'s'، 'x'، 'd' و 'b' همگی روش‌های متفاوتی برای مشخص کردن مقدار OCTET STRING
هستند، و نوع بدون علامت 'u' نیز برای مدیریت مقادیر Gauge32 به کار می‌رود.
.PP
اگر فایل MIB مناسب بارگذاری شده باشد، در بیشتر موارد می‌توانید نوع را
با یک علامت '=' جایگزین کنید. برای شیئی از نوع OCTET STRING، این کار رشته‌ای
مشابه نمادگذاری نوع 's' را در نظر می‌گیرد. برای انواع دیگر، «رفتار مناسب»
را انجام خواهد داد.
.PP
برای مثال:
.PP
snmpset \-c private \-v 1 test\-hub system.sysContact.0 s dpz@noc.rutgers.edu ip.ipforwarding.0 = 2
.PP
متغیرهای sysContact.0 و ipForwarding.0 را مقداردهی می‌کند:
.PP
system.sysContact.0 = STRING: "dpz@noc.rutgers.edu"
.br
ip.ipForwarding.0 = INTEGER: not\-forwarding(2)
.PP
اگر موجودیت شبکه هنگام پردازش بسته درخواست دچار خطا شود، یک بسته خطا
بازگردانده می‌شود و پیامی نمایش داده خواهد شد که به مشخص کردن نحوه معیوب بودن
درخواست کمک می‌کند.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B snmpset
گزینه‌های عمومی شرح‌داده‌شده در صفحه راهنمای
.I snmpcmd(1)
را می‌پذیرد.
توجه داشته باشید که همان‌طور که در آنجا شرح داده شده است،
.B snmpset
به یک آرگومان برای تعیین کارگزار (agent) جهت پرس‌وجو
و دست‌کم یک مجموعه از آرگومان‌های OID/TYPE/VALUE نیاز دارد.
.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), variables(5).