.\" @(#) $Id: arpsnmp.8.in 1508 2019-12-01 19:01:07Z leres $ (LBL)
.\"
.\" Copyright (c) 1996, 1997, 1999, 2000, 2009, 2012, 2013, 2016, 2019
.\" The Regents of the University of California. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions are met:
.\"     * Redistributions of source code must retain the above copyright
.\"       notice, this list of conditions and the following disclaimer.
.\"     * Redistributions in binary form must reproduce the above copyright
.\"       notice, this list of conditions and the following disclaimer in the
.\"       documentation and/or other materials provided with the distribution.
.\"     * Neither the name of the University nor the names of its contributors
.\"       may be used to endorse or promote products derived from this software
.\"       without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd 1 December 2019
.Dt ARPSNMP 8
.Os
.Sh "نام (NAME)"
.Nm arpsnmp
.Nd ردیابی و نظارت بر ارتباط آدرس‌های اترنت و IP
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl dqs
.Op Fl D Ar arpdir
.Op Fl f Ar datafile
.Op Fl w Ar watcher@email
.Op Fl W Ar watchee@email
.Ar file ...
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm
ارتباط و نگاشت آدرس‌های اترنت/IP را ردیابی و نظارت می‌کند. این ابزار فعالیت‌ها را در گزارش‌های سیستمی (syslog) ثبت کرده و تغییرات مشخصی را از طریق ایمیل گزارش می‌دهد.
.Nm
اطلاعات را از یک فایل (که معمولاً توسط
.Xr snmpwalk 3
تولید می‌شود) می‌خواند.
.Pp
فرمت فایل ورودی مشابه
.Ar arp.dat
است؛ آدرس مک (mac address)، آدرس IP، برچسب زمانی اختیاری (timestamp) و نام ساده و اختیاری میزبان (hostname). اگر برچسب زمانی وجود نداشته باشد، از تاریخ فعلی استفاده می‌شود.
.Pp
دستور
.Nm
همچنین می‌تواند برای ادغام فایل‌های
.Ar arp.dat
به کار رود. اگر یک جفت آدرس اترنت/IP مشابه در بیش از یک فایل وجود داشته باشد، برچسب زمانی آخرین مورد مشاهده‌شده ذخیره می‌شود.
.Pp
گزینه
.Fl C
باعث استفاده از آدرس‌های اترنت فشرده‌شده با پدینگ (compact padded) در
.Ar arp.dat
می‌شود، مانند 0:8:e1:1:2:d6.
.Pp
گزینه
.Fl d
برای فعال‌سازی حالت اشکال‌زدایی (debugging) استفاده می‌شود. این گزینه همچنین از ارسال گزارش‌ها از طریق ایمیل جلوگیری می‌کند؛ در عوض، گزارش‌ها به
.Ar stderr
ارسال می‌شوند.
.Pp
گزینه
.Fl D
برای تعیین دایرکتوری کاری
.Nm arpwatch
استفاده می‌شود. مقدار پیش‌فرض آن
.Ar /usr/local/arpwatch
است.
.Pp
گزینه
.Fl f
برای تعیین نام فایل پایگاه‌داده آدرس‌های اترنت/IP به کار می‌رود. مقدار پیش‌فرض آن
.Ar arp.dat
است.
.Pp
توجه داشته باشید که پیش از نخستین اجرای
.Nm arpsnmp
باید یک فایل خالی
.Ar arp.dat
ایجاد شده باشد.
.Pp
گزینه
.Fl q
از ثبت گزارش‌ها در لاگ یا چاپ آن‌ها در
.Ar stderr
جلوگیری می‌کند.
.Pp
گزینه
.Fl s
ارسال گزارش‌ها از طریق ایمیل را متوقف و غیرفعال می‌کند.
.Pp
گزینه
.Fl w
برای تعیین آدرس ایمیل مقصد جهت ارسال گزارش‌ها استفاده می‌شود. مقدار پیش‌فرض آن
.Ar root
است.
.Pp
گزینه
.Fl W
آدرس ایمیل فرستنده (From) را برای ارسال گزارش‌ها مشخص می‌کند. مقدار پیش‌فرض آن
.Ar root
است.
.Pp
گزینه
.Fl Z
باعث استفاده از آدرس‌های اترنت دارای صفر در ابتدای هر بخش (zero padded) در
.Ar arp.dat
می‌شود، مانند 00:08:e1:01:02:d6.
.Pp
.Sh "پیام‌های گزارش (REPORT MESSAGES)"
برای جزئیات بیشتر درباره پیام‌های گزارش تولیدشده توسط
.Xr arpsnmp 8
صفحه راهنمای
.Xr arpwatch 8
را ببینید.
.Sh "فایل‌ها (FILES)"
.Bl -tag -width ".Pa /usr/local/arpwatch" -compact
.It Pa /usr/local/arpwatch
دایرکتوری پیش‌فرض
.It Pa arp.dat
پایگاه‌داده پیش‌فرض آدرس‌های اترنت/IP
.It Pa ethercodes.dat
فهرست بلوک‌های اترنت شرکت‌های سازنده (vendor)
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr arpwatch 8 ,
.Xr snmpwalk 8 ,
.Xr arp 8
.Sh "نویسندگان (AUTHORS)"
.An Craig Leres
از گروه پژوهشی شبکه آزمایشگاه ملی لارنس برکلی (Lawrence Berkeley National Laboratory Network Research Group)،
دانشگاه کالیفرنیا، برکلی.
.Pp
نسخه فعلی از طریق FTP ناشناس در دسترس است:
.Pp
.Dl Ar ftp://ftp.ee.lbl.gov/arpwatch.tar.gz
.Sh "اشکالات (BUGS)"
لطفاً گزارش‌های اشکال را به
.Aq arpwatch@ee.lbl.gov
ارسال کنید.
.Pp
دادن فایل
.Ar arp.dat
به عنوان ورودی به
.Nm
هیچ فایده و مفهومی ندارد.
.Pp
تلاش‌هایی برای متوقف کردن و نادیده گرفتن flip flopهای DECnet انجام شده است اما همیشه موفقیت‌آمیز نیستند.