MANDOS-MONITOR(8)

📦
version 1.8.19 · 3 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 MANDOS-MONITOR 💖

okay bestie, gather round, because this is mandos-monitor(8) from the Mandos Manual and she is serving text-based-GUI realness. 🎀

✨ NAME ✨

mandos-monitor — a text-based GUI to control the Mandos server. yes literally, a whole interface, right there in your terminal. it's giving retro chic and we're obsessed. 💅

🌸 SYNOPSIS 🌸

mandos-monitor

that's it. that's the whole vibe. no flags, no drama. 🦋

💜 DESCRIPTION 💜

mandos-monitor is an interactive program that lets you monitor and control what the Mandos server is doing. (peep mandos(8) for the server's own lore, iykyk.)

🎀 PURPOSE 🎀

the whole point of this beautiful little program? enabling remote and unattended rebooting of a client host computer that has an encrypted root file system. for the full tea, go read the section called "OVERVIEW" below. ☕✨

🌈 OVERVIEW 🌈

so this is all part of the Mandos system, which exists so computers can have encrypted root file systems and still be capable of remote and/or unattended reboots. iconic behavior fr fr.

here's the plot: the computers run a small client program in the initial RAM disk environment, and that client talks to a server over a network. all network communication is encrypted using TLS. 🔐

the clients are identified by the server using a TLS key — and every single client has one that's unique to it, no sharing, no borrowing, periodt.

the server then sends the clients an encrypted password. the clients decrypt that password using a separate OpenPGP key, and then that password unlocks the root file system, whereupon the computers can continue booting normally. slay. 💫

this program — the one you're reading about right now — is used to monitor and control the Mandos server. in particular, it can be used to approve Mandos clients which have been configured to require approval. it also shows all significant events reported by the Mandos server. so you never miss a thing. main character energy only. 👑

🔥 KEYS 🔥

(ngl, the original page says this exact same paragraph twice, and we are nothing if not faithful, so here it is again, bestie:)

this program is used to monitor and control the Mandos server. in particular, it can be used to approve Mandos clients which have been configured to require approval. it also shows all significant events reported by the Mandos server.

💫 Global Keys 💫

these work wherever you are in the program. your universal remote, if you will. 🫶

  • q, Q — Quit. bye bestie 👋
  • Ctrl-L — Redraw screen. when things get glitchy-looking, just refresh, it's fine ✨
  • ?, F1 — Show help. we love a girl who asks for directions 💅
  • l, D — Toggle log window. show it, hide it, she's mysterious 🌙
  • TAB — Switch window. hop on over to the next one 🦋
  • w, i — Toggle log window line wrap. long lines gonna do what long lines do
  • v — Toggle verbose logging. for when you want every single detail 📝
  • Up, Ctrl-P, k — Move up a line. ⬆️
  • Down, Ctrl-N, j — Move down a line. ⬇️
  • PageUp, Meta-V, b — Move up a page. big jump, big energy
  • PageDown, Ctrl-V, SPACE, f — Move down a page. gravity is free 🌸

👑 Client List Keys 👑

these only hit different when you're hanging out in the client list. 🌟

  • + — Enable client. wake her up ☀️
  • - — Disable client. she's napping now 😴
  • a — Approve client. let her in, she's cool ✅
  • d — Deny client. not today 🚫
  • R, _, Ctrl-K — Remove client. gone, deleted, never happened 💀
  • s — Start checker for client. begin the vibe check 🔍
  • S — Stop checker for client. that's enough checking 🛑
  • C — Force a successful check for this client. manifesting success, literally ✨

😭 BUGS 😭

this program can currently only be used to monitor and control a Mandos server with the default D-Bus bus name of se.recompile.Mandos. that's the one. no others. don't come for her, she's doing her best. 🙈

please report bugs to the Mandos development mailing list: <mandos-dev@recompile.se> (subscription required). note that this list is public. 👀

the developers can be reached privately at <mandos@recompile.se> (OpenPGP key fingerprint 153A 37F1 0BBA 0435 987F 2C4A 7223 2973 CA34 C2C4 for encrypted mail). 🔐

🌟 EXAMPLE 🌟

this program takes no options. none. zero. she needs nothing from you:

mandos-monitor

that's the whole example. go off. 💅

🛡️ SECURITY 🛡️

this program must be permitted to access the Mandos server via the D-Bus interface. this normally requires the root user, but could be configured otherwise by reconfiguring the D-Bus server. so like, it can be done another way, but you'd be messing with the D-Bus server config. proceed with intention, bestie. 🫶

🦋 SEE ALSO 🦋

go read those too, they're all part of the same friend group. 🌈

Copyright © 2010-2019 Teddy Hogeborn, Björn Påhlsson

this manual page is part of Mandos.

Mandos is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Mandos is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

you should have received a copy of the GNU General Public License along with Mandos. if not, see http://www.gnu.org/licenses/.

🎀 and that's the whole page, bestie. this was Mandos 1.8.19, dated 2019-02-10, and it's the MANDOS-MONITOR(8) manual page. ty for reading, love u, go approve some clients. 💖✨🦋

📦 where this page comes from