." -*- 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 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 SNMPTRAPD 8 "27 Apr 2014" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmptrapd \- دریافت و ثبت پیام‌های trap در پروتکل SNMP
.SH "خلاصه دستور (SYNOPSIS)"
.BR snmptrapd " [گزینه‌ها] [نشانی‌های شنود]"
.SH "توضیحات (DESCRIPTION)"
برنامه
.B snmptrapd
یک برنامه کاربردی SNMP است که پیام‌های TRAP و INFORM پروتکل SNMP را دریافت و ثبت می‌کند.
.PP
نکته: حالت پیش‌فرض، شنود روی پورت 162 پروتکل UDP بر روی تمامی رابط‌های IPv4 است.
از آنجا که ۱۶۲ یک درگاه ممتاز (نیازمند دسترسی ویژه) است،
.B snmptrapd
معمولاً باید با دسترسی مدیر سیستم (root) اجرا شود.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-a
نادیده گرفتن ترپ‌های authenticationFailure.
.TP
.B \-A
الحاق به انتهای فایل لاگ به جای بازنویسی و پاک کردن آن.

توجه داشته باشید که این گزینه باید \fIپیش از\fR هر گزینه \-Lf که قرار است بر آن اعمال شود قرار گیرد.
.TP
.BI "\-c" " FILE"
خواندن
.I FILE
به عنوان فایل پیکربندی
(یا فهرستی جداشده با کاما از فایل‌های پیکربندی).
.TP
.B \-C
نخواندن هیچ‌یک از فایل‌های پیکربندی به جز فایلی که احیاناً با گزینه
.B \-c 
مشخص شده است.
.TP
.B \-d
تخلیه بسته‌های SNMP ارسال‌شده و دریافت‌شده در مبنای ۱۶ (هگزادسیمال).
.TP
.BI \-D[TOKEN[,...]]
فعال کردن خروجی اشکال‌زدایی برای
.IR "نشانه‌(های)"
مشخص‌شده.
برای خروجی بسیار پرجزئیات،
.IR ALL
را امتحان کنید.
.TP
.B \-f
انشعاب نیافتن (fork نشدن) از پوسته فراخواننده.
.TP
.BI \-F " FORMAT"
هنگام ثبت گزارش در خروجی استاندارد، از قالب موجود در رشته
.IR FORMAT
استفاده شود.
برای جزئیات بیشتر به بخش
.B مشخصات قالب
در زیر مراجعه کنید.
.TP
.B \-h, \-\-help
نمایش پیام خلاصه نحوه استفاده و سپس خروج.
.TP
.B \-H
نمایش فهرستی از دستورالعمل‌های فایل پیکربندی که برای دیمن trap قابل فهم است و سپس خروج.
.TP
.B \-I \fI[\-]INITLIST
مشخص می‌کند کدام ماژول‌ها در هنگام راه‌اندازی snmptrapd باید مقداردهی اولیه شوند (یا نشوند). اگر فهرست جداشده با کاما به نام
.I INITLIST
با یک '\-' آغاز شود، فهرستی از ماژول‌ها است که نباید شروع شوند.
در غیر این صورت، این تنها فهرستی از ماژول‌هایی است که باید راه‌اندازی شوند.

برای دریافت فهرستی از ماژول‌های کامپایل‌شده، snmptrapd را با آرگومان‌های
.I "\-Dmib_init \-H"
اجرا کنید (با فرض اینکه پشتیبانی از اشکال‌زدایی در آن کامپایل شده باشد).
.TP
.B \-L[efos]
مشخص کردن مقصد خروجی لاگ (خطای استاندارد یا خروجی استاندارد، به یک فایل یا از طریق syslog). برای جزئیات به بخش LOGGING OPTIONS در \fIsnmpcmd(1)\fR مراجعه کنید.
.TP
.BR \-m " \fIMIBLIST"
فهرستی جداشده با دونقطه از ماژول‌های MIB برای بارگذاری در این برنامه تعیین می‌کند. این گزینه بر متغیر محیطی MIBS اولویت دارد.
برای جزئیات به \fIsnmpcmd(1)\fR مراجعه کنید.
.TP
.BR \-M " \fIDIRLIST"
فهرستی جداشده با دونقطه از دایرکتوری‌ها را برای جستجوی MIBها مشخص می‌کند.
این گزینه متغیر محیطی MIBDIRS را لغو و بازنویسی می‌کند.
برای جزئیات به \fIsnmpcmd(1)\fR مراجعه کنید.
.TP
.BR \-n
تلاش نکردن برای تبدیل نشانی‌های مبدأ بسته‌های ورودی به نام‌های میزبان.
.TP
.BI \-p " FILE"
ذخیره شناسه فرآیند (PID) دیمن trap در
.IR FILE .
.TP
.BI \-O " [abeEfnqQsStTuUvxX]"
مشخص می‌کند اشیاء MIB و سایر خروجی‌ها چگونه باید نمایش داده شوند.
برای جزئیات به بخش
.B OUTPUT OPTIONS
در صفحه راهنمای
.I snmpcmd(1)
مراجعه کنید.
.TP
.BI \-t
عدم ثبت ترپ‌ها در syslog. این گزینه گزارش‌گیری در syslog را غیرفعال می‌کند. این ویژگی زمانی مفید است که بخواهید برنامه snmptrapd
.B تنها
قلاب‌های traphandle را اجرا کند و هیچ ترپی را در هیچ مکانی لاگ نکند.
.TP
.B \-v, \-\-version
چاپ اطلاعات نسخه دیمن trap و سپس خروج.
.TP
.B \-x \fIADDRESS
اتصال به عامل اصلی AgentX در نشانی مشخص‌شده، به جای نشانی پیش‌فرض "/var/agentx/master".
برای جزئیات قالب این نشانی‌ها به \fIsnmpd(8)\fR مراجعه کنید.
.TP
.B \-X
عدم اتصال به عامل اصلی AgentX.
.TP
.BI \-\- "name"="value"
امکان مشخص کردن هر نشانه ("name") پشتیبانی‌شده در فایل
.I snmptrapd.conf
و تنظیم مقدار آن به "value". این گزینه نشانه‌ی متناظر در فایل
.I snmptrapd.conf
را بازنویسی می‌کند. برای فهرست کامل نشانه‌ها به
.I snmptrapd.conf(5)
مراجعه کنید.
.SH "مشخصات قالب (FORMAT SPECIFICATIONS)"
.PP
دستور
.B snmptrapd
رشته‌های قالب را مشابه با
.IR printf(3)
تفسیر می‌کند. دنباله‌های قالب‌بندی زیر را پشتیبانی می‌نماید:
.RS 4
.TP 4
.B %%
نویسه واقعی %
.TP
.B %a
محتوای فیلد agent\-addr در بسته PDU (تنها برای ترپ‌های v1)
.TP
.B %A
نام میزبان متناظر با محتوای فیلد agent\-addr در بسته PDU، در صورت در دسترس بودن؛ در غیر این صورت محتوای فیلد agent\-addr در PDU (تنها ترپ‌های v1).
.TP
.B %b
نشانی انتقال PDU (توجه: این نشانی الزاماً یک آدرس IPv4 نیست).
.br
چیزی شبیه به "[UDP: [172.16.10.12]:23456->[10.150.0.8]]"
.TP
.B %B
نام میزبان مبدأ PDU در صورت وجود، در غیر این صورت آدرس مبدأ PDU (به یادداشت بالا مراجعه کنید)
.TP
.B %E
شناسه موتور زمینه SNMPv3 (context engine id)
.TP
.B %h
ساعت جاری در سیستم محلی
.TP
.B %H
فیلد ساعت از متغیر \fCsysUpTime.0\fR
.TP
.B %j
دقیقه جاری در سیستم محلی
.TP
.B %J
فیلد دقیقه از متغیر \fCsysUpTime.0\fR
.TP
.B %k
ثانیه جاری در سیستم محلی
.TP
.B %K
فیلد ثانیه از متغیر \fCsysUpTime.0\fR
.TP
.B %l
روز جاری ماه در سیستم محلی
.TP
.B %L
فیلد روز ماه از متغیر \fCsysUpTime.0\fR
.TP
.B %m
ماه جاری (عددی) در سیستم محلی
.TP
.B %M
فیلد عددی ماه از متغیر \fCsysUpTime.0\fR
.TP
.B %N
رشته سازمانی (enterprise string)
.TP
.B %P
اطلاعات امنیتی از PDU (نام community برای v1/v2c، کاربر و context برای v3)
.TP
.B %q
زیرنوع ترپ (عددی، در مبنای ۱۰)
.TP
.B %s
شماره نسخه SNMP (برابر 0: v1، برابر 1: v2c، برابر 2: v3)
.TP
.B %S
شماره نسخه مدل امنیتی SNMPv3
.TP
.B %t
تعداد ثانیه‌های مبنای ۱۰ گذشته از زمان مرجع سیستم‌عامل (مطابق خروجی
.IR time(2) )
.TP
.B %T
مقدار متغیر \fCsysUpTime.0\fR بر حسب ثانیه
.TP
.B %u
نام امنیتی SNMPv3، یا نام community در v1/v2c
.TP
.B %v
فهرست متغیرهای پیوندداده‌شده از محموله اعلان.
این موارد با یک تب یا با کاما و یک فاصله در صورت درخواست فرم جایگزین جدا می‌شوند.
به %V نیز مراجعه کنید.
.TP
.B %V
جداکننده متغیرهای پیوندداده‌شده را مشخص می‌کند. این گزینه دنباله‌ای از نویسه‌ها را تا نویسه بعدی % دریافت می‌کند (برای گنجاندن یک % در رشته از \% استفاده کنید)
.TP
.B %w
نوع ترپ (عددی، در مبنای ۱۰)
.TP
.B %W
شرح ترپ
.TP
.B %y
سال جاری در سیستم محلی
.TP
.B %Y
فیلد سال از متغیر \fCsysUpTime.0\fR
.RE
.PP
علاوه بر این مقادیر، عرض و دقت فیلد نیز می‌تواند به صورت اختیاری تعیین شود، درست همانند
.IR printf(3) ،
و همچنین یک مقدار فلگ. فلگ‌های زیر پشتیبانی می‌شوند:
.RS 4 
.TP 4
.B \-
تراز به چپ
.TP
.B 0
استفاده از صفرهای ابتدایی
.TP
.B #
استفاده از فرم جایگزین
.RE
.PP
فلگ «استفاده از فرم جایگزین» رفتار دنباله‌های مختلف رشته قالب را تغییر می‌دهد:
.IP
اطلاعات زمانی بر اساس GMT نمایش داده می‌شود (به جای منطقه زمانی محلی)
.IP
متغیرهای پیوندداده‌شده فهرستی جداشده با کاما خواهند بود (به جای جداشده با تب)
.IP
زمان کارکرد سیستم (uptime) به قالبی خوانا برای انسان تبدیل می‌شود (به جای یک عدد صحیح ساده)
.SS "مثال‌ها (Examples)"
.PP
برای دریافت پیامی مانند "14:03 TRAP3.1 from humpty.ucd.edu" می‌توانید از دستوری شبیه به این استفاده کنید:
.PP
.RS
.nf
snmptrapd \-P \-F "%02.2h:%02.2j TRAP%w.%q from %A\en"
.fi
.RE
.PP
اگر همان پیام را در زمان GMT به جای ساعت محلی می‌خواهید، استفاده کنید از:
.PP
.RS
.nf
snmptrapd \-P \-F "%#02.2h:%#02.2j TRAP%w.%q from %A\en"
.fi
.RE
.SH "نشانی‌های شنود (LISTENING ADDRESSES)"
به طور پیش‌فرض،
.B snmptrapd
بسته‌های ورودی SNMP TRAP و INFORM را روی پورت 162 پروتکل UDP بر روی تمامی رابط‌های IPv4 شنود می‌کند. با این حال، می‌توان با مشخص کردن یک یا چند نشانی شنود به عنوان آرگومان‌های
.BR snmptrapd
این رفتار را تغییر داد. برای اطلاعات بیشتر پیرامون ساختار نشانی‌های شنود به صفحه راهنمای
.I snmpd(8)
مراجعه کنید.
.SH "پشتیبانی از NOTIFICATION\-LOG\-MIB (NOTIFICATION\-LOG\-MIB SUPPORT)"
از نسخه net-snmp 5.0، برنامه کاربردی snmptrapd از ماژول NOTIFICATION\-LOG\-MIB پشتیبانی می‌کند. این کار با باز کردن یک اتصال زیرعامل AgentX به عامل اصلی snmpd و ثبت جدول‌های گزارش اعلان‌ها انجام می‌شود. تا زمانی که برنامه snmpd اول راه‌اندازی شود، این برنامه به آن متصل خواهد شد و بنابراین باید بتوانید آخرین اعلان‌های ثبت‌شده را از طریق nlmLogTable و nlmLogVariableTable مشاهده کنید. برای غیرفعال کردن این پشتیبانی به فایل snmptrapd.conf و نشانه‌ی "doNotRetainNotificationLogs" مراجعه کنید. برای جزئیات بیشتر درباره خود MIB به NOTIFICATION\-LOG\-MIB مراجعه نمایید.
.SH "توسعه‌پذیری و پیکربندی (EXTENSIBILITY AND CONFIGURATION)"
صفحه راهنمای
.I snmptrapd.conf(5)
را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), snmpd(8), printf(3), snmptrapd.conf(5), syslog(8), traptoemail(1), variables(5)