.\" -*- 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 SNMPTRAP 1 "19 Jun 2003" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmptrap, snmpinform \- ارسال پیام‌های اطلاع‌رسانی TRAP یا INFORM به یک مدیر در پروتکل SNMP
.SH "خلاصه دستور (SYNOPSIS)"
.B snmptrap \-v 1
[COMMON OPTIONS] AGENT enterprise-oid agent generic-trap specific-trap uptime [OID TYPE VALUE]...
.PP
.B snmptrap \-v [2c|3]
[COMMON OPTIONS] [\-Ci] AGENT uptime trap-oid [OID TYPE VALUE]...
.PP
.B snmpinform \-v [2c|3]
[COMMON OPTIONS] AGENT uptime trap-oid [OID TYPE VALUE]...
.SH "توضیحات (DESCRIPTION)"
.B snmptrap
یک برنامه کاربردی SNMP است که از عملیات SNMP TRAP برای ارسال اطلاعات به یک مدیر شبکه استفاده می‌کند. می‌توان یک یا چند شناسه شیء (OID) را به عنوان آرگومان در خط فرمان مشخص کرد. یک نوع و یک مقدار باید همراه هر شناسه شیء ارائه شود. هر نام متغیر در قالبی مشخص‌شده در
.IR variables(5)
تعیین می‌شود.
.PP
هنگامی که به عنوان
.B snmpinform
فراخوانی شود، یا هنگامی که گزینه
.B \-Ci
به گزینه‌های خط فرمان snmptrap اضافه شود، یک INFORM-PDU ارسال می‌کند، منتظر دریافت پاسخ از دریافت‌کننده trap می‌ماند و در صورت نیاز پیام را دوباره ارسال می‌کند. در غیر این صورت یک TRAP-PDU یا TRAP2-PDU ارسال می‌کند.
.PP
اگر هر یک از پارامترهای الزامی نسخه ۱، شامل
.IR enterprise-oid ،
.IR agent
و
.I uptime
به صورت خالی مشخص شوند، به ترتیب به صورت پیش‌فرض روی
.IR "1.3.6.1.4.1.3.1.1 (enterprises.cmu.1.1)" ،
.IR hostname
و
.I host-uptime
تنظیم می‌شوند.
.PP
پارامتر
.I TYPE
یک تک‌کاراکتر و یکی از موارد زیر است:
.RS
.PD 0
.TP 3
.B i
INTEGER
.TP 3
.B u
UNSIGNED
.TP 3
.B c
COUNTER32
.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
که دقیقاً به همان روش دستور
.B snmpset
مدیریت می‌شوند.
.PP
آرگومان
.I AGENT
تنها در SNMP TRAP PDU گنجانده می‌شود و در SNMP INFORM PDU قرار نمی‌گیرد. اگر
.I AGENT
یک رشته خالی نباشد، باید یک آدرس IPv4 باشد. این محدودیت از RFC 1157 سرچشمه می‌گیرد که در آن فیلد آدرس عامل به صورت زیر تعریف شده است:
.IP
.nf
agent-addr NetworkAddress, -- address of object generating trap
.fi
.PP
از RFC 1155:
.IP
.nf
NetworkAddress ::=
    CHOICE {
        internet IpAddress
    }
[ ... ]
IpAddress ::=
    [APPLICATION 0]          -- in network-byte order
        IMPLICIT OCTET STRING (SIZE (4))
.fi
.PP
مثالی از نحوه استفاده از
.BR snmptrap :
.PP
.nf
snmptrap \-v 1 \-c public manager enterprises.spider test\-hub 3 0 '' interfaces.iftable.ifentry.ifindex.1 i 1
.fi
.PP
یک trap عمومی linkUp برای رابط ۱ به manager ارسال خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B snmptrap
علاوه بر گزینه
.B \-Ci
که در بالا شرح داده شد، گزینه‌های عمومی توضیح داده شده در صفحه راهنمای
.IR snmpcmd(1)
را نیز می‌پذیرد.
توجه داشته باشید که
.B snmptrap
همان‌طور که در آنجا شرح داده شده است، به یک آرگومان برای مشخص کردن عامل مورد نظر نیاز دارد.
.SH "همچنین ببینید (SEE ALSO)"
.BR snmpcmd (1)،
.BR snmpset (1)،
.BR variables (5).