get-oui(1)

1GET-OUI(1)                  General Commands Manual                 GET-OUI(1)
2
3
4

NAME

6       get-oui - Fetch the arp-scan OUI file from the IEEE website
7

SYNOPSIS

9       get-oui [options]
10

DESCRIPTION

12       get-oui  fetches the MAC/Vendor registry data from the IEEE website and
13       converts it to the format used by arp-scan. The contents of the follow‐
14       ing registries are downloaded and processed:
15
16
17       MA-L   24-bit   The original OUI registry
18       MA-M   28-bit   Medium address block registry
19       MA-S   36-bit   Small address block registry (OUI-36)
20       IAB    36-bit   The IAB registry (closed for new applications)
21
22       This  script creates ieee-oui.txt from the latest data on the IEEE web‐
23       site.  You can run get-oui occasionally to keep  the  OUI  file  up  to
24       date.
25
26       The  OUI  data is fetched from the URLs specified in the get-oui script
27       and the output file is saved to the file ieee-oui.txt  in  the  current
28       directory.  The output file name can be changed with the -f option.
29
30       The  ieee-oui.txt  file that is produced by this script is used by arp-
31       scan to determine the Ethernet card vendor from its hardware address.
32
33       arp-scan will first look for ieee-oui.txt in the current directory.  If
34       that  fails, it will use the system wide file /usr/share/arp-scan/ieee-
35       oui.txt.
36

OPTIONS

38       -h     Display a brief usage message and exit.
39
40       -f <fn>
41              Write the output to the specified file instead  of  the  default
42              ieee-oui.txt.
43
44       -v     Display verbose progress messages.
45

FILES

47       ieee-oui.txt
48              The default output file.
49

EXAMPLES

51       $ ./get-oui -v
52       Renaming ieee-oui.txt to ieee-oui.txt.bak
53       Opening ieee-oui.txt for output
54       Processing IEEE IAB registry data from https://standards-oui.ieee.org/iab/iab.csv
55               Downloaded 381454 bytes
56               4575 IAB entries written to ieee-oui.txt
57       Processing IEEE MAM registry data from https://standards-oui.ieee.org/oui28/mam.csv
58               Downloaded 492756 bytes
59               4477 MAM entries written to ieee-oui.txt
60       Processing IEEE OUI registry data from https://standards-oui.ieee.org/oui/oui.csv
61               Downloaded 3051812 bytes
62               32845 OUI entries written to ieee-oui.txt
63       Processing IEEE OUI36 registry data from https://standards-oui.ieee.org/oui36/oui36.csv
64               Downloaded 466151 bytes
65               5131 OUI36 entries written to ieee-oui.txt
66
67       Total of 47028 MAC/Vendor mappings written to ieee-oui.txt
68

NOTES

70       get-oui  is  implemented  in  Perl, so you need to have the Perl inter‐
71       preter installed on your system to use it.
72
73       get-oui uses the LWP::UserAgent and Text::CSV Perl modules to fetch and
74       process  the  IEEE registry data. You must have these modules installed
75       on your system for it to work. These modules are available on most dis‐
76       tributions,  often  called  libwww-perl and libtext-csv-perl.  They are
77       also available in source form from CPAN.
78
79       You can use a proxy server by defining the http_proxy environment vari‐
80       able.
81