.TH AGENTXTRAP 1 "20 Dec 2009" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
agentxtrap \- ارسال یک AgentX NotifyPDU به یک master agent در AgentX
.SH "خلاصه دستور (SYNOPSIS)"
.B agentxtrap
.RI [ OPTIONS ] " trap-oid " [ "OID TYPE VALUE" ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B agentxtrap
یک AgentX NotifyPDU را به یک master agent صادر می‌کند. می‌توان یک یا چند
شناسه شیء (OID) را به عنوان آرگومان در خط فرمان مشخص کرد.
هر شناسه شیء باید همراه با یک نوع (type) و یک مقدار (value) باشد.
هر نام متغیر در قالبی که در
.IR variables(5)
مشخص شده، تعیین می‌شود.
.PP
.SH "گزینه‌ها (OPTIONS)"
.PD 0
.TP 6
.BI \-c "\| contextName\^"
در صورت وجود گزینهٔ
.BR \-c ،
اعلان در زمینهٔ نام (name context) غیرپیش‌فرض ارسال می‌شود.
.TP
.BI \-U "\| uptime\^"
در صورت وجود گزینهٔ
.BR \-U ،
آن مقدار (که بر حسب صدم ثانیه تحلیل می‌شود) به عنوان فیلد sysUpTime برنامه در نظر گرفته می‌شود.
.TP
.BI \-x "\| ADDRESS\^"
در صورت وجود گزینهٔ
.BR \-x ،
به جای آدرس پیش‌فرض، با AgentX master در ADDRESS ارتباط برقرار می‌شود.
.PD
.PP
علاوه بر این، تمام گزینه‌های شرح‌داده‌شده در
.IR snmpcmd(1)
ذیل سربرگ‌های
.BR "MIB PARSING OPTIONS" "، " "LOGGING OPTIONS" " و " "INPUT OPTIONS"
و همچنین گزینه‌های
.BR \-d "، " \-D "، " \-m " و " \-M
پشتیبانی می‌شوند.
.PP
در
.I OID TYPE VALUE
نحوهٔ تحلیل فیلد
.I VALUE
توسط فیلد
.I TYPE
کنترل می‌شود. مقادیر ممکن برای فیلد
.I TYPE
یکی از نویسه‌های زیر است:
.RS
.PD 0
.TP 3
.B =
اجازه دادن به
.I OID
برای تعیین چگونگی تفسیر
.I VALUE
.TP
.B i
INTEGER
.TP
.B u
Unsigned
.TP
.B c
Counter32
.TP
.B s
یک OCTET STRING از نویسه‌ها
.TP
.B x
یک OCTET STRING، واردشده به صورت دنباله‌ای از جفت‌رقم‌های هگزادسیمال که می‌توانند با فاصله از هم جدا شوند
.TP
.B d
یک OCTET STRING، واردشده به صورت دنباله‌ای از ارقام دهدهی جداشده با فاصله در محدودهٔ ۰ تا ۲۵۵
.TP
.B n
NULL
.TP
.B o
OBJECT IDENTIFIER
.TP
.B t
TimeTicks
.TP
.B a
IpAddress
.TP
.B b
BITS
.PD
.RE
که دقیقاً به همان روش دستور
.B snmpset
مدیریت می‌شوند.
.PP
.SH "مثال‌ها (EXAMPLES)"
برای ارسال یک trap عمومی linkUp به manager برای رابط ۱، می‌توان از دستور زیر استفاده کرد:
.PP
agentxtrap netSnmp.0.3 ifindex.1 i 1
.PP
.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), snmpset(1), variables(5), RFC 2741