LIBVDEPLUG_AGNO(1)

💖 LIBVDEPLUG_AGNO 💖

okay bestie, gather round, because we're talking about libvdeplug_agno — a General Commands Manual situation and honestly? it's giving secret-agent energy. it's the vdeplug module that adds encryption to an ethernet link plug, and yes, we're gonna get into it. 🕵️♀️✨

---

✨ NAME ✨

libvdeplug_agno — the vdeplug module that adds encryption to an ethernet link plug. slay. 💅

---

🌈 SYNOPSIS 🌈

libvdeplug_agno.so

that's it. that's the whole synopsis. she's a shared object, she's lowkey mysterious, she contains multitudes. 🦋

---

🎀 DESCRIPTION 🎀

so this is a libvdeplug cryptographic module that implements agnostic encryption over layer 2. and what's agnostic encryption, you ask? it's an encryption method that doesn't need information about the vde network implementation. she doesn't need to know the network's whole lore to do her job. iconic behavior, no notes. 💅

this module of libvdeplug4 can be used in any program supporting vde, like:

• vde_plug
• vdens
• kvm
• qemu
• user-mode-linux
• virtualbox

the vde_plug_url syntax of this module is literally this:

agno://[/path/of/keyfile][[OPTIONS]]{vde nested url}

/path/of/keyfile, if present, must be an absolute path or a path relative to the user's home (e.g. ~/example/path). if you just… don't provide it? the default path of the keyfile is ~/.vde_agno_key. 🏠

💖 heads up bestie: the keyfile must contain a 128-bit key in hexadecimal format.

and here's the cute part: only hexadecimal characters are considered, in both uppercase and lowercase — everything else is ignored. so like, white-spaces, newline characters, non-hexadecimal letters? ignored, ignored, ignored. the keyfile can be as messy as your notes app, the hex is all that matters. ✨

---

💜 OPTIONS 💜

• ethtype=TYPE — defines the type of the Ethernet frame of the encrypted packet. and TYPE can be a hexadecimal number, OR one of these lil cuties:
  • copy — same type of the non-encrypted packet. twin behavior fr fr. 👯
  • ipv4 — ipv4 type (0x0800)
  • ipv6 — ipv6 type (0x86dd)
  • rand — random number as type. and bestie, the random number will be generated for each Ethernet packet sent. every single one. chaotic, unhinged, obsessed. 🎲

---

🌸 EXAMPLES 🌸

example one, the default keyfile era 🫶

agno://{vde:///tmp/myswitch}

agno uses the key stored in the default keyfile (~/.vde_agno_key) location to encrypt the traffic sent to the switch. the Ethernet frames have agno specific type (0xa6de) as type. she's got a signature frame type and she's not afraid to use it. 💅

example two, the custom keyfile serve 🔥

agno:///tmp/my_keyfile[ethtype=copy]{vde:///tmp/myswitch}

agno uses the key stored in file /tmp/my_keyfile to encrypt the traffic sent to the switch. the Ethernet frames will have the same type of the non-encrypted packet. blending in?? she's in her stealth mode arc. 🥷

example three, the namespace x cloud collab ⭐

vdens agno://[ethtype=rand]{vxvde://234.0.0.1}

create a nanespace connected to a vxvde local area cloud. agno uses the key stored in the default keyfile (~/.vde_agno_key) location to encrypt the traffic sent to vxvde. random frame types, cloud vibes, immaculate. ☁️✨

---

💀 NOTICE 💀

Virtual Distributed Ethernet is not related in any way with www.vde.com ("Verband der Elektrotechnik, Elektronik und Informationstechnik" i.e. the German "Association for Electrical, Electronic & Information Technologies"). different vde, bestie. same acronym, zero relation, do not conflate them, periodt. 🙈

---

👑 SEE ALSO 👑

• vde_plug(1)

go read her too, she's part of the friend group. 🫶

---

🧚 AUTHOR 🧚

VirtualSquare. Project leader: Renzo Davoli. king behavior honestly. 👑

---

and that's the whole page, bestie!! this one came from VirtualSquare, dated January 2024, and it's living in the General Commands Manual section as LIBVDEPLUG_AGNO(1) — encrypt your ethernet link, keep your 128-bit hex key cute, and go slay 💖✨🎀