aoe-flush(8)

📦 version 37, in debian bookworm, debian trixie, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💅 aoe-flush(8) — bestie edition

okay so this is aoe-flush, a page from the System Manager's Manual (that's the (8) in aoe-flush(8), it's giving system-admin energy). sit down, grab a boba, we're clearing out dead devices 🫶

🌸 NAME

aoe-flush — flush the down devices out of the aoe driver

✨ SYNOPSIS

aoe-flush [-a]
aoe-flush dev1 [dev2 ...]

💖 DESCRIPTION

So the aoe-flush command literally tells the aoe driver to remove devices from the system and forget about them. bye babe 💅 normally the aoe driver will remember every single device it has ever seen, like a girl who never clears her camera roll, and it keeps all of them until the module is unloaded. iconic behavior but also messy.

By default? aoe-flush will only flush downed devices. Only the ones that have already ghosted you. But with the -a flag, all devices become candidates for removal. all of them. no notes.

🛑 bestie, important: aoe-flush will not remove devices that are in use. That includes devices in the closewait state, and also those in the process of being installed. it's respectful like that, it will not pull the rug out from under something mid-glow-up.

And here's the cute part: by specifying a series of specific aoe devices, e.g., e7.0 e3.2, it is possible to ask the aoe driver to forget those specific devices. super handy after a temporary AoE target is no longer being used — like when you're done with a situationship and you just want it gone from your phone 💀

🎀 OPTIONS

  • -a — The -a option tells the aoe driver to forget all unused devices. everyone. clear the roster. 🧹✨

🌈 EXAMPLE

ok so picture this, we're on the host nai#:

nai# aoe-stat | grep e12.0
     e12.0         0.000GB   eth1 down
nai# aoe-flush
nai# aoe-stat | grep e12.0

so first we peek at e12.0 with aoe-stat, and she's down — 0.000GB, riding on eth1, doing nothing. then aoe-flush comes through and cleans her up, and then aoe-stat | grep e12.0 returns... nothing. she's gone bestie. no cap. 😭🦋

👑 BUGS

Flushed devices may reappear when they are discovered by the periodic discovery beacon. 😳 yes fr, they can come back like an ex at 2am.

aoe-discover may be used to force this behaviour — so if you want the comeback, that's your girl.

⭐ SEE ALSO

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

🫶 AUTHOR

Sam Hopkins (sah@coraid.com)

and that's the whole page bestie!! 🌸 this was aoe-flush(8) from the System Manager's Manual, and the footer just signs off with aoe-flush(8) again because she loves a little encore. go forth, flush responsibly, and remember: downed devices only unless you say -a 💖✨🎀

📦 where this page comes from