MASSAGEVENDOR(8)

📦
version 3.9 · 2 versions
, in epel 10, epel 9, fedora 43, fedora 44

💖 MASSAGEVENDOR(8) 💖

okay bestie, welcome to section 8 of the manual — yes, the system administration girlies. this one is literally about converting ethernet vendor codes into something arpwatch can read, and honestly? it's giving behind-the-scenes queen. ✨

🌸 NAME 🌸

massagevendor — convert the ethernet vendor codes master list to arpwatch format 🎀

🦋 SYNOPSIS 🦋

massagevendor [-CdhvZ] [--vendor] [csv]

✨ DESCRIPTION ✨

so. massagevendor is a program that takes a text file full of ethernet vendor codes and converts it into a format that arpwatch(8) and arpsnmp(8) can actually use. 🫶 the input csv is a master CSV (comma-separated-value) file containing vendor codes. the output gets sent to stdout, which, yes, means it goes straight to your terminal unless you redirect it. redirect it. trust. 💅

all ethernet devices have a unique identifier which includes a vendor code specifying the manufacturer of the device. in normal operation, arpwatch(8) and arpsnmp(8) use the file ethercodes.dat to report this vendor code. massagevendor is the one that generates the ethercodes.dat file from CSV files containing these vendor codes. it's the main character of the pipeline, fr fr. 👑

locations where an ethernet vendor codes master text file can be obtained are given below. (scroll to NOTES, bestie 💜)

here's the flag rundown, and yes, every single one of them matters:

  • the -C flag (default) uses compact padded ethernet addresses in ethercodes.dat, e.g. 0:8:e1:1:2:d6; this is the default. yes, it says default twice. it's that default. 💀
  • the -d flag is used to enable debugging. 🐛
  • the -v flag is used to enable verbose messages. she talks a lot. we love that for her. 💬
  • the -Z flag uses zero padded ethernet addresses in ethercodes.dat, e.g. 00:08:e1:01:02:d6. zeros everywhere, aesthetic. ✨
  • the -h flag shows a help message and exits. 🆘
  • the --version option shows the program version number and exits. 🌈

🎀 FILES 🎀

  • /var/lib/arpwatch — default location of the ethernet vendor list 📂
  • ethercodes.dat — file containing the list of ethernet vendor codes 🌸

🔥 SEE ALSO 🔥

💜 NOTES 💜

the ethernet vendor codes as assigned by the IEEE can be found at:

https://standards-oui.ieee.org/oui/oui.csv

like. go get your data, bestie. it's right there. 🧚

👑 AUTHORS 👑

Craig Leres of the Lawrence Berkeley National Laboratory Network Research Group, University of California, Berkeley, CA. 🎓 iconic. no cap.

the current version is available via anonymous ftp:

ftp://ftp.ee.lbl.gov/arpwatch.tar.gz

this manual page was contributed by Hugo Graumann and updated by Benjamin Beasley. shoutout to the writers of this cinematic universe. 🫶

💀 BUGS 💀

please send bug reports to ⟨arpwatch@ee.lbl.gov⟩. be nice, be specific, include the details. 💌

ok so that's the whole page, literally nothing skipped, every flag and path and email preserved exactly. vibe check: passed. 🌈

this little cutie is dated 8 November 2020 and it lives in section 8 as MASSAGEVENDOR(8) — mwah, bye bestie, go convert some vendor codes 💅💖

📦 where this page comes from