aoecfg(8)

💅 aoecfg — the manual page, but make it cute

okay bestie, sit down, hydrate, because we're about to talk about aoecfg, which lives in the System Manager's Manual and is genuinely one of the most underrated little tools in the AoE universe. its whole job? manipulating AoE configuration strings. that's it. that's the gig. 👑

---

✨ NAME ✨

aoecfg — manipulate AoE configuration strings 🎀

---

🦋 SYNOPSIS 🦋

aoecfg [-c cmd] [-s cfgstr] [-t timeout] [shelf slot] [netif]

---

🌸 DESCRIPTION 🌸

so aoecfg(8) sends AoE configuration commands, and those commands are what control the retrieval, the conditional setting, or the unconditional setting of AoE configuration strings. three moods, one tool, we love range. 💖

here's the plot twist though: configuration happens before the MAC address of the target is known, so the packet gets broadcast. it's giving "yelling into the group chat and hoping the right person answers." 📣

AoE targets that have a matching shelf and slot respond. everyone else, respectfully, stays quiet. 🙈

and the default shelf and slot? those are the wildcard values 0xffff and 0xff. which means — hear me out — if you run aoecfg(8) with no arguments at all, it will return configuration strings from all targets visible on the default interface, eth0. all of them. the whole party. no cap. 🫶

---

🔥 OPTIONS 🔥

• -c cmd — specify the AoE configuration command. the default is read. the available commands are, and I need you to pay attention because these are the whole personality of this tool:
  • read — read the server config string without performing any test and respond. just vibes, no interrogation. 💜
  • test — respond only if the specified string exactly matches the server configuration string. it's giving strict. 💀
  • prefix — respond only if the specified string is a prefix of the server configuration string. looser, chiller, more forgiving. 🌈
  • set — if the current server config string is empty, set the server config string to the argument string and respond. but if the current server config string is not empty, return a response with Flags bit E set and Error set to 4. read the room: it said no. 🙅‍♀️
  • fset — force set the server config string to the argument string and respond. no questions asked, no conditions, main character energy only. 👑
• -s cfgstr — specify the config string. 💅
• -t timeout — specify the timeout in seconds. the default is no timeout. and here's the important little detail: if neither the shelf nor the slot are specified, aoecfg(8) will exit after the first result. otherwise, aoecfg(8) will exit only after the timeout has expired, since it does not know how many responses to expect. it's not psychic, bestie, it's just patient. ⏳
• shelf slot — specify the shelf and slot used in the query. if unspecified, they default to broadcast. ✨
• netif — specify the network interface. the default is eth0. 🌐

---

⭐ SEE ALSO ⭐

go read these next, they're all in the family:

• aoe-discover(8)
• aoe-interfaces(8)
• aoe-mkdevs(8)
• aoe-mkshelf(8)
• aoe-stat(8)
• aoeping(8)
• AoE (ATA over Ethernet): http://support.coraid.com/documents/AoEr10.txt
• ATA specification

---

👑 AUTHOR 👑

Erik Quanstrom (quanstro@coraid.com) — thank you for your service, legend. 🫡

---

okay and finally, the little sign-off at the bottom of the page: this whole thing comes from the System Manager's Manual, and it's the aoecfg(8) page. no date printed down there, just the page name doing its little bow. 🎀

stay configured, bestie. 💖✨