Sanitized IEEE OUI Data (oui.txt)
oui.txt file has become somewhat inconsistent over the years and subsequently
requires subvention for use in network infrastructure documentation and reporting.
In response to this we have produced a
sanitized edition that is available for download in bzip2, gzip, Zip and
Our sanitizing process performs Title Case conversion of legacy all UPPERCASE OUI records, fixes for vendor name inconsistencies, spelling corrections, removal of superfluous and erroneous data artifacts that have crept into the original daily generated IEEE oui.txt over time.
The oui.txt file is located in /usr/share/misc/ on most Linux distributions.
Sanitized oui.txt.bz2 Sun, 05 Apr 2020 03:10:16 -0300 • 828.1 kB (828,121 bytes) • bzip2
Sanitized oui.txt.gz Sun, 05 Apr 2020 03:10:16 -0300 • 1.2 MB (1,152,241 bytes) • gzip
Sanitized oui.txt.zip Sun, 05 Apr 2020 03:10:16 -0300 • 1.2 MB (1,152,379 bytes) • Zip
Sanitized oui.txt Sun, 05 Apr 2020 03:10:16 -0300 • 4.1 MB (4,088,518 bytes) • ASCII
Sanitized IEEE OUI Data (oui.txt) Update Client Download
Sanitized IEEE OUI Data (oui.txt) Update Client sanitized-oui.txt-update v1.03
Tue, 09 Jul 2019 10:30:12 -0300 • 4.0 kB (4,039 bytes) • bash shell script
A juxtaposition comparison of the original and sanitized oui.txt files can be attained using sdiff from the GNU diffutils package.sdiff -Wia original_oui.txt sanitized_oui.txt | less
Nmap MAC Prefixes
We also maintain and have made available a nmap-mac-prefixes file created from the sanitized oui.txt edition with abridging vendor name logic applied.
nmap-mac-prefixes Sun, 05 Apr 2020 03:10:19 -0300 • 505.8 kB (505,846 bytes) • ASCII
Nmap MAC Address Scan
The nmap-mac-prefixes file is used by Nmap to output meaningful OUI vendor names for MAC addresses it detects by matching the three-byte prefix taken from the MAC address and looking for a match in nmap-mac-prefixes file. It's also used in other nmap features. The Nmap nmap-mac-prefixes file can typically be found in /usr/share/nmap/ on most Linux distributions.
An example of this can be seen by performing a nmap scan of a local network. In this example the 192.168.0.0/24 LAN segment is scanned using the following:nmap -n -sP -PS -PE -PP -PM 192.168.0.0/24 | grep MAC
ephor ~ # nmap -n -sP -PS -PE -PP -PM 192.168.0.0/24 | grep MAC MAC Address:
Arpwatch is an Ethernet monitor tool by Network Research Group (NRG). The ethercodes.dat distributed with the NRG Arpwatch package archive is somewhat dated, Jul 22, 2006. The format of this data file is similar enough to the nmap-mac-prefixes file that it is rather trivial to generate an updated ethercodes.dat from it.
The ethercodes.dat file can be found in /usr/share/arpwatch/ or /var/lib/arpwatch/ on most installations.
ethercodes.dat Sun, 05 Apr 2020 03:10:20 -0300 • 589.1 kB (589,141 bytes) • ASCII
The arp-scan package provides a Perl script to update it's ieee-oui.txt file. The default URL is that of the original IEEE oui.txt data. The -u parameter for get-oui can be used to specify the URL to fetch the raw OUI data from instead of the default.
Updating arp-scan ieee-oui.txt
The arp-scan ieee-oui.txt data file in /usr/share/arp-scan/ or /usr/local/share/arp-scan/ can be updated with the latest sanitized oui.txt data with the following:cd /usr/share/arp-scan/ && get-oui -u https://linuxnet.ca/ieee/oui.txt
If you've recently updated the oui.txt file on the localhost, you can update the arp-scan /usr/share/arp-scan/ieee-oui.txt file using the local oui.txt file as follows:cd /usr/share/arp-scan/ && get-oui -u file:///usr/share/misc/oui.txt
Alternative arp-scan using nmap-mac-prefixes
The arp-scan ieee-oui.txt file shares the same format as the nmap-mac-prefixes file and thus it can be used with arp-scan using the --ouifile option.arp-scan --ouifile=/usr/share/nmap/nmap-mac-prefixes -lI eth0 luger ~ # arp-scan --ouifile=/usr/share/nmap/nmap-mac-prefixes -lI eth0 Interface: eth0, datalink type: EN10MB (Ethernet) Starting arp-scan 1.9.5 with 256 hosts (https://github.com/royhills/arp-scan) 192.168.0.1