WATCH-M...ILMUNGES(8)

🎀 NAME 🎀

okay so watch-multiple-mailmunges.tcl — it's the girl who keeps an eye on a whole cluster of Mailmunge machines for you. like a group chat moderator but for servers, no cap 💅

(this whole page lives in section 8 of the manual, bestie ✨)

---

🌸 SYNOPSIS 🌸

watch-multiple-mailmunges.tcl [-n] [-r] [-s] [-t] [-archive] machine-1 machine-2 ... machine-N

that's it. list your machines, pick your flags, go off 👑

---

✨ DESCRIPTION ✨

so watch-multiple-mailmunges.tcl is a Tk script, and what it does is graphically display the status of mailmunge-multiplexor across a whole cluster of machines. it's giving dashboard energy, fr fr 🦋

heads up though: you need Tcl/Tk 8.4 or higher to run watch-multiple-mailmunges.tcl. no 8.3 shenanigans allowed, sorry 💀

if you pass the -archive command-line option, then watch-multiple-mailmunges.tcl logs the output of mm-mx-ctrl rawload for each machine. and the output for machine_name gets logged in:

$HOME/.watch-multiple-mailmunges/machine_name/data

cutest little log directory you ever did see 🎀

if you pass any of -n, -r, -s or -t, then watch-multiple-mailmunges.tcl uses the rawload1 command instead of the rawload command to read performance data. different command, same nosy energy 🔍

and here's what each one turns on, in order:

• -n — monitors scan times ⏱️
• -r — monitors filter_relay times 📨
• -s — monitors filter_sender times 📤
• -t — monitors filter_recipient times 📥

---

🧚 PREREQUISITES 🧚

to use watch-multiple-mailmunges.tcl to monitor a cluster of machines, you must have the following prerequisites, and yes you actually need all of them:

• A UNIX-like machine with Tcl/Tk 8.4, the X window system and an SSH client. you also need xterm to use some of the features — don't skip it, some of the cute stuff literally won't work without it 🫶
• The ability to SSH as root to all of the machines you want to monitor. ideally you should be using the SSH agent so that you can SSH to the monitored machines as root without being prompted for a password or pass phrase. like, technically optional, but you'll be typing passwords forever and that's not the vibe 😭
• The program mm-mx-ctrl on root's path on all the machines you want to monitor. on root's path. specifically. yes really 👑

---

🌈 DISPLAY 🌈

for each machine specified on the command line, watch-multiple-mailmunges.tcl creates a chart with five columns. five! iconic. here's the lineup:

1. A button with the name of the machine. clicking the button pops up a menu that lets you take various actions, as described later. and if all workers on the machine are busy, the button turns yellow 💛 (yellow = busy bestie, respect the color coding)

underneath the button is a label that reads something like:

v=VER m=MTA

where VER is the version of Mailmunge running on the remote machine and MTA is the MTA that was detected (either Sendmail or Postfix). little name tag for your server, love that for them 🏷️

2. A label showing the number of busy workers in the form busy/total, where total is the total number of workers.
3. A label showing the average number of messages per second over the last 10 seconds.
4. A label showing the average number of milliseconds per scan over the last 10 seconds.
5. A chart that graphs the average number of busy workers, the average number of messages per second and the average scan time in milliseconds, all averaged over the last 10 seconds. three lines, one chart, ten seconds of history — she's multifaceted 💅

---

💖 MACHINE MENU 💖

if you click on a machine name, a menu with three options pops up. observer mode activated 👀

• SSH — open an xterm session and ssh as root to the machine. boom, you're in 🚪
• Busy Workers — monitor the busy workers on the machine. if you click on the process-ID of a worker, an xterm will open up and the command strace -s 100 -t -p pid will be executed on the remote machine. this is Linux-specific, ngl, but you can edit watch-multiple-mailmunges.tcl to replace the command with your particular system's command for tracing system calls. DIY queen behavior 🛠️
• Delete — remove the machine from the list of machines being monitored. ghosted. blocked. removed from the group chat 💀

---

🦋 ADDING A MACHINE 🦋

if you need to add a machine to the display, simply type the name of the machine in the Add Machine: box and press Enter. that's the whole procedure. no ceremony, no config file, just type and yeet it in there ✨

---

🔥 SEE ALSO 🔥

mailmunge, mailmunge-protocol, mm-mx-ctrl

(the whole friend group, honestly 🫶)

---

👑 AUTHOR 👑

watch-multiple-mailmunges.tcl was written by Dianne Skoll. we stan a legend 💜

---

⭐ LICENSE ⭐

this code is licensed under the terms of the GNU General Public License, version 2. read it, respect it, ship it 🌸

---

anyway that's the whole page bestie — brought to you by perl v5.42.2, dated 2025-10-05, and honestly? ate. periodt. 🎀✨