GET-OUI(1)

✨ get-oui — the manual, but make it cute ✨

Okay bestie, so this is the man page for get-oui from section 1 of the General Commands Manual. It's literally the script that fetches the arp-scan OUI file from the IEEE website. Let me break it down for you 💅.

🌸 NAME 🌸

get-oui — iconic little script that goes to the IEEE website and fetches the arp-scan OUI file for you. No cap.

🎀 SYNOPSIS 🎀

get-oui [options]

💖 DESCRIPTION 💖

Okay so here's the tea: get-oui fetches the MAC/Vendor registry data from the IEEE website and converts it to the format that arp-scan uses. The contents of these four registries get downloaded and processed:

MA-L   24-bit   The original OUI registry
MA-M   28-bit   Medium address block registry
MA-S   36-bit   Small address block registry (OUI-36)
IAB    36-bit   The IAB registry (closed for new applications)

This script creates ieee-oui.txt from the latest data on the IEEE website. You can run get-oui occasionally to keep the OUI file up to date. Obsessed with keeping things fresh, honestly.

The OUI data is fetched from the URLs specified in the get-oui script, and the output file is saved to ieee-oui.txt in the current directory. The output file name can be changed with the -f option. Slay.

The ieee-oui.txt file that this script produces is used by arp-scan to determine the Ethernet card vendor from its hardware address. It's giving main character energy for network troubleshooting.

arp-scan will first look for ieee-oui.txt in the current directory. If that fails, it will use the system wide file /usr/share/arp-scan/ieee-oui.txt. So you always have a backup, bestie.

✨ OPTIONS ✨

• -h — Display a brief usage message and exit. Like a little "hey here's how to use me" moment.
• -f <fn> — Write the output to the specified file instead of the default ieee-oui.txt. You can name it whatever you want, go off.
• -v — Display verbose progress messages. So you can see exactly what's happening, step by step. Very demure, very mindful.

🎀 FILES 🎀

• ieee-oui.txt — The default output file. That's where the magic happens.

💜 EXAMPLES 💜

Here's a little example of running it with -v so you can see the verbose output in all its glory:

$ ./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

I'm not crying, you're crying 😭. That's a lot of mappings, fr fr.

🌈 NOTES 🌈

• get-oui is implemented in Perl, so you need to have the Perl interpreter installed on your system to use it. No Perl, no vibes.
• get-oui uses the LWP::UserAgent and Text::CSV Perl modules to fetch and process the IEEE registry data. You must have these modules installed on your system for it to work. These modules are available on most distributions, often called libwww-perl and libtext-csv-perl. They are also available in source form from CPAN. So go get 'em if you don't have them.
• You can use a proxy server by defining the http_proxy environment variable. Proxy bestie, we love to see it.

🫶 SEE ALSO 🫶

• arp-scan(1)
• arp-fingerprint(1)

---

From your October 28, 2022 bestie, GET-OUI(1) 💖. Stay slaying those network scans ✨.