.\" Copyright (C) Roy Hills
.\"
.\" Copying and distribution of this file, with or without modification,
.\" are permitted in any medium without royalty provided the copyright
.\" notice and this notice are preserved.
.\"
.TH GET-OUI 1 "October 28, 2022"
.SH "نام (NAME)"
get-oui \- دریافت پرونده OUI برای arp-scan از وب‌سایت IEEE
.SH "خلاصه دستور (SYNOPSIS)"
.B get-oui
.RI [ گزینه‌ها ]
.SH "توضیحات (DESCRIPTION)"
دستور
.B get-oui
داده‌های ثبت MAC/تولیدکننده (Vendor) را از وب‌سایت IEEE دریافت کرده و به قالبی که توسط arp-scan استفاده می‌شود تبدیل می‌کند. محتویات رجیستری‌های زیر بارگیری و پردازش می‌شوند:
.sp
.TS
L L L .
MA-L	24-bit	رجیستری اصلی OUI
MA-M	28-bit	رجیستری بلوک آدرس متوسط
MA-S	36-bit	رجیستری بلوک آدرس کوچک (OUI-36)
IAB	36-bit	رجیستری IAB (بسته‌شده برای درخواست‌های جدید)
.TE
.PP
این اسکریپت پرونده
.I ieee-oui.txt
را از جدیدترین داده‌های وب‌سایت IEEE ایجاد می‌کند. می‌توانید
.B get-oui
را گه‌گاه اجرا کنید تا پرونده OUI به‌روز بماند.
.PP
داده‌های OUI از نشانی‌های اینترنتی مشخص‌شده در اسکریپت \fBget-oui\fP دریافت شده و پرونده خروجی در پرونده
.I ieee-oui.txt
در شاخه جاری ذخیره می‌شود. نام پرونده خروجی را می‌توان با گزینه
.B -f
تغییر داد.
.PP
پرونده
.I ieee-oui.txt
که توسط این اسکریپت تولید می‌شود توسط
.B arp-scan
برای تعیین سازنده کارت شبکه اترنت از روی نشانی سخت‌افزاری آن به کار می‌رود.
.PP
برنامه
.B arp-scan
ابتدا به دنبال
.I ieee-oui.txt
در شاخه جاری می‌گردد. اگر ناموفق بود، از پرونده سرتاسری سیستم
\fI/usr/share/arp-scan/ieee-oui.txt\fP
استفاده خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B -h
نمایش پیام خلاصه کاربرد و خروج.
.TP
\fB-f \fI<fn>\fR
نوشتن خروجی در پرونده مشخص‌شده به جای پرونده پیش‌فرض
.I ieee-oui.txt.
.TP
.B -v
نمایش پیام‌های پیشرفت با جزئیات بیشتر (verbose).
.SH "پرونده‌ها (FILES)"
.TP
.I ieee-oui.txt
پرونده خروجی پیش‌فرض.
.SH "مثال‌ها (EXAMPLES)"
.nf
$ ./get-oui -v
Renaming ieee-oui.txt to ieee-oui.txt.bak
Opening ieee-oui.txt for output
Processing IEEE IAB registry data from https://standards-oui.ieee.org/iab/iab.csv
        Downloaded 381454 bytes
        4575 IAB entries written to ieee-oui.txt
Processing IEEE MAM registry data from https://standards-oui.ieee.org/oui28/mam.csv
        Downloaded 492756 bytes
        4477 MAM entries written to ieee-oui.txt
Processing IEEE OUI registry data from https://standards-oui.ieee.org/oui/oui.csv
        Downloaded 3051812 bytes
        32845 OUI entries written to ieee-oui.txt
Processing IEEE OUI36 registry data from https://standards-oui.ieee.org/oui36/oui36.csv
        Downloaded 466151 bytes
        5131 OUI36 entries written to ieee-oui.txt

Total of 47028 MAC/Vendor mappings written to ieee-oui.txt
.fi
.SH "نکات (NOTES)"
دستور
.B get-oui
با پرل (Perl) پیاده‌سازی شده است، بنابراین برای اجرای آن نیاز به مفسر Perl روی سامانه دارید.
.PP
دستور
.B get-oui
از ماژول‌های پرل
.I LWP::UserAgent
و
.I Text::CSV
برای دریافت و پردازش داده‌های رجیستری IEEE استفاده می‌کند. شما باید این ماژول‌ها را روی سیستم خود نصب داشته باشید تا اسکریپت کار کند. این ماژول‌ها در بیشتر توزیع‌ها معمولاً با نام‌های
.I libwww-perl
و
.I libtext-csv-perl
موجود هستند. همچنین به صورت کد منبع از طریق CPAN در دسترس می‌باشند.
.PP
می‌توانید با تعریف متغیر محیطی
.I http_proxy
از یک کارگزار پیشکار (proxy server) استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.TP
.BR arp-scan (1)
.TP
.BR arp-fingerprint (1)