MIREDO-SERVER(8)

📦
version 1.2.6 · 3 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute

🎀 miredo-server(8) 🎀

System Manager's Manual · MIREDO-SERVER(8)

okay so bestie, you opened the manual for miredo-server and I'm here to make it make sense 💖 this is the Teredo server situation for Unix, and honestly? it's giving infrastructure royalty. let's get into it 👑

✨ NAME ✨

miredo-server — Teredo server for Unix 🌈

🦋 SYNOPSIS 🦋

miredo-server [-c config_file] [-f] [-u user] [server_name]

that's the whole handshake, bestie. look at it, so clean 🫶

📝 DESCRIPTON 📝

(no, that's not a typo of mine — that's literally how the source spells it, and we respect the heritage 💅)

miredo-server is a Unix daemon program that implements a Teredo server, exactly as specified by the "Teredo: Tunneling IPv6 over UDP through NATs" Internet proposed standard, aka RFC 4380 📜✨

and like, why do you even need one? because a Teredo server is required for Teredo clients to set up their IPv6 connectivity through Teredo. no server, no vibes. that's the whole thing 🌸

🚨 real talk: a Teredo server must have two global static subsequent IPv4 addresses. two. not one. that's non-negotiable bestie 😭

it receives packets from Teredo clients and Teredo relays on UDP port 3544 📡

💅 OPTIONS 💅

  • -c config_file, --config config_file — point Miredo at a different config file instead of the default one, /etc/miredo/miredo-server.conf 🗂️
  • -f, --foreground — do not detach from the console. run the program in the foreground, right there in front of you, main character energy 👀
  • -h, --help — show some help and exit. short, sweet, helpful 🎀
  • -u username, --user username — override the user the program will run as. by default it runs as nobody 🙈
  • -V, --version — display program version and license, then exit. the receipts, basically 🧾✨

🔐 SECURITY 🔐

okay this part is the serious one, pay attention bestie 🫶

miredo-server requires root privileges to create open a raw IPv6 socket, which is used to emit ICMPv6 Echo Request packets.

but here's the glow-up: once its initialization is complete, it will setgid, chroot into an empty directory, and ultimately setuid (see option -u), all so it can decrease the system's exposure to potential security issues 🛡️✨

like, it gets in, does the job, and then locks itself in a tiny empty room so nothing sketchy can reach it. iconic behavior honestly 👑

📶 SIGNALS 📶

  • SIGHUP — force a reload of the daemon 🔄
  • SIGINT, SIGTERM — shutdown the daemon. bye bestie, it was real 💀
  • SIGUSR1, SIGUSR2 — do nothing. might be used in future versions 👀 (currently they're just standing there, menacingly, doing absolutely nothing)

🗂️ FILES 🗂️

  • /etc/miredo/miredo-server.conf — the default configuration file ⭐
  • /var/run/miredo-server.pid — the process-id file 🪪

👀 SEE ALSO 👀

miredo-server.conf(5), miredo(8), ipv6(7)

go read those too, iykyk 📚

🌸 AUTHOR 🌸

Rémi Denis-Courmont <remi at remlab dot net>

http://www.remlab.net/miredo/

and that's the whole page bestie!! you ate this. go run a Teredo server, you absolute legend 💖

miredo · February 2008 · MIREDO-SERVER(8) — mwah, xoxo 💋🦋

📦 where this page comes from