aoe-interfaces(8)

💖 aoe-interfaces — the manual page, bestie edition 💖

okay so this is the man page for aoe-interfaces, straight out of section 8 of the System Manager's Manual. it's a system manager thing, so it's admin-core. let's get into it 🫶

---

✨ NAME ✨

aoe-interfaces — restrict the aoe driver to specified network interfaces 🎀

---

✨ SYNOPSIS ✨

aoe-interfaces [dev1] [dev2 ...]
aoe-interfaces -c

---

✨ DESCRIPTION ✨

so the way aoe-interfaces works is it tells the aoe driver to ignore ATA over Ethernet (AoE) traffic on everything except the network interfaces you name. it's basically the same vibe as the aoe_iflist module load option. twins, lowkey. ✨

if you don't use the aoe_iflist module load option AND you don't use the aoe-interfaces command, then the aoe driver will just use any network interface for AoE traffic. no filter, no vibe check, nothing. 🙈

and why do you care? because limiting AoE to only trusted networks with aoe-interfaces stops that one nightmare scenario: a rogue AoE target popping up on a public network and diverting your data away from the legit AoE target. and like, that imposter target effectively corrupts the data on the legitimate target. not iconic. not slay. genuinely bad. 💀

now, if the aoe driver is a module, then calling aoe-interfaces with no arguments will show you the current interfaces list. and if it hasn't been set? the output is just blank. nothing. empty. 🫥

also, it's good to run the aoe-discover command after you set the AoE interfaces list. do it. it's the moment. 👑

---

✨ OPTIONS ✨

• -c — this flag clears the interface access list, which means any interface is allowed to be used again. full reset, no cap. 🧚

---

✨ EXAMPLE ✨

okay storytime. in this example, the root user on a host named nai loads the aoe module with only eth0 allowed for AoE traffic. then this sysadmin remembers that shelf 7 is on eth3 (classic), so they use aoe-interfaces to add eth3 to the list of allowable network interfaces, and then calls aoe-discover to ask the aoe driver to go look for new AoE devices. main character sysadmin behavior fr fr 💅

nai:~# modprobe aoe aoe_iflist="eth0"
nai:~# aoe-stat
   e10.9            eth0              up
nai:~# aoe-interfaces eth0 eth3
nai:~# aoe-discover
nai:~# aoe-stat
    e7.0            eth3              up
    e7.1            eth3              up
    e7.2            eth3              up
    e7.3            eth3              up
    e7.4            eth3              up
    e7.5            eth3              up
    e7.6            eth3              up
    e7.7            eth3              up
    e7.8            eth3              up
    e7.9            eth3              up
   e10.9            eth0              up
nai:~# aoe-interfaces
eth0 eth3

look at all those devices showing up. the way that aoe-discover pulled in the whole e7 shelf... obsessed. 🔥

---

✨ SEE ALSO ✨

aoe-discover(8), aoe-stat(8), aoetools(8).

---

✨ AUTHOR ✨

Ed L. Cashin (ecashin@coraid.com) 🫶

---

and that's the whole page, bestie!! this was aoe-interfaces(8) from the System Manager's Manual, section 8, and yes it's literally just aoe-interfaces(8) at the bottom too because that's how man pages roll. 💜🦋🌸