WHATMAPS(1)

📦
version 0.0.14 · 4 versions
, in debian trixie, ubuntu questing

okay so bestie, welcome to WHATMAPS(1) — it lives in the User Contributed Perl Documentation section, and it's genuinely one of those lil tools that saves your whole entire night 🌙✨ pull up a chair, we're doing this together.

🎀 NAME 🎀

whatmaps — find and restart services after library upgrades 💅

🌸 SYNOPSIS 🌸

=encoding utf8
whatmaps [--restart] [--print-cmds=FILE] pkg1 [pkg2 pkg3 ...]

yeah that =encoding utf8 is just chilling in there, we keep it exactly as-is, no touching, that's the law 🫶

✨ DESCRIPTION ✨

so here's the vibe: you upgraded a library and now a bunch of services are still running with the old version mapped into their memory, which is giving stale and chaotic. whatmaps is here to find those services for you, bestie 💖

it does this by extracting a list of shared objects from the packages you hand it on the command line. then it looks at the list of running processes to find the ones that map those shared objects, and it uses your distribution's package manager to figure out which packages ship them. then — the moment you've been waiting for — it prints out a list of services in those packages that likely need to be restarted. iconic behaviour honestly 🌈

by default it assumes that all services in the found packages need a restart 😳 but it also keeps an internal, distribution-specific list of exceptions, so it's not just out here restarting everything willy-nilly, she's got ✨standards✨

now, the flags, and yes there are only two but they're important:

  • --restart — the services get restarted without any prompting. no confirmation, no "are you sure", she just goes 🔥
  • --prind-cmds — with this one the restart commands are written to a file for later execution 📝 (yes, the manpage literally spells it --prind-cmds, we do not edit, we do not correct, we simply report 🫡)
also on Debian systems, whatmaps can be run automatically by apt-get 👀 check /usr/share/doc/whatmaps/README for the details. automation?? we love her.

👀 SEE ALSO 👀

the latest version is available at <https://honk.sigxcpu.org/piki/projects/whatmaps/> — go look, she's cute 🌸

👑 AUTHOR 👑

Guido Günther <agx@sigxcpu.org> — the mastermind, the moment, the main character 💜

and that's a wrap, bestie 🎀 this page is perl v5.38.2, dated 2024-07-06, and it is of course WHATMAPS(1) — go restart some services, you've got this 💅✨🦋

📦 where this page comes from