نام (NAME)

snmptrap, snmpinform - ارسال پیام‌های اطلاع‌رسانی TRAP یا INFORM به یک مدیر در پروتکل SNMP

خلاصه دستور (SYNOPSIS)

snmptrap -v 1 [COMMON OPTIONS] AGENT enterprise-oid agent generic-trap specific-trap uptime [OID TYPE VALUE]...

snmptrap -v [2c|3] [COMMON OPTIONS] [-Ci] AGENT uptime trap-oid [OID TYPE VALUE]...

snmpinform -v [2c|3] [COMMON OPTIONS] AGENT uptime trap-oid [OID TYPE VALUE]...

توضیحات (DESCRIPTION)

snmptrap یک برنامه کاربردی SNMP است که از عملیات SNMP TRAP برای ارسال اطلاعات به یک مدیر شبکه استفاده می‌کند. می‌توان یک یا چند شناسه شیء (OID) را به عنوان آرگومان در خط فرمان مشخص کرد. یک نوع و یک مقدار باید همراه هر شناسه شیء ارائه شود. هر نام متغیر در قالبی مشخص‌شده در variables(5) تعیین می‌شود.

هنگامی که به عنوان snmpinform فراخوانی شود، یا هنگامی که گزینه -Ci به گزینه‌های خط فرمان snmptrap اضافه شود، یک INFORM-PDU ارسال می‌کند، منتظر دریافت پاسخ از دریافت‌کننده trap می‌ماند و در صورت نیاز پیام را دوباره ارسال می‌کند. در غیر این صورت یک TRAP-PDU یا TRAP2-PDU ارسال می‌کند.

اگر هر یک از پارامترهای الزامی نسخه ۱، شامل enterprise-oid، agent و uptime به صورت خالی مشخص شوند، به ترتیب به صورت پیش‌فرض روی 1.3.6.1.4.1.3.1.1 (enterprises.cmu.1.1)، hostname و host-uptime تنظیم می‌شوند.

پارامتر TYPE یک تک‌کاراکتر و یکی از موارد زیر است:

i: INTEGER
u: UNSIGNED
c: COUNTER32
s: STRING
x: HEX STRING
d: DECIMAL STRING
n: NULLOBJ
o: OBJID
t: TIMETICKS
a: IPADDRESS
b: BITS

که دقیقاً به همان روش دستور snmpset مدیریت می‌شوند.

آرگومان AGENT تنها در SNMP TRAP PDU گنجانده می‌شود و در SNMP INFORM PDU قرار نمی‌گیرد. اگر AGENT یک رشته خالی نباشد، باید یک آدرس IPv4 باشد. این محدودیت از RFC 1157 سرچشمه می‌گیرد که در آن فیلد آدرس عامل به صورت زیر تعریف شده است:

agent-addr NetworkAddress, -- address of object generating trap

از RFC 1155:

NetworkAddress ::=
    CHOICE {
        internet IpAddress
    }
[ ... ]
IpAddress ::=
    [APPLICATION 0]          -- in network-byte order
        IMPLICIT OCTET STRING (SIZE (4))

مثالی از نحوه استفاده از snmptrap:

snmptrap -v 1 -c public manager enterprises.spider test-hub 3 0 '' interfaces.iftable.ifentry.ifindex.1 i 1

یک trap عمومی linkUp برای رابط ۱ به manager ارسال خواهد کرد.

گزینه‌ها (OPTIONS)

دستور snmptrap علاوه بر گزینه -Ci که در بالا شرح داده شد، گزینه‌های عمومی توضیح داده شده در صفحه راهنمای snmpcmd(1) را نیز می‌پذیرد. توجه داشته باشید که snmptrap همان‌طور که در آنجا شرح داده شده است، به یک آرگومان برای مشخص کردن عامل مورد نظر نیاز دارد.

همچنین ببینید (SEE ALSO)

snmpcmd(1)، snmpset(1)، variables(5).