shield-purge(8)

📦 version 0.9.6, in debian bookworm, ubuntu jammy

💖 shield-purge(8) 💖

okay bestie, so this is a page from the System Manager's Manual, and it's all about shield-purge, the little cleanup goblin that lives in the pam_shield package 🧚

✨ NAME ✨

shield-purge — manages hosts rules for the pam_shield package 💅

🌸 SYNOPSIS 🌸

shield-purge [-hdnlf] [-c config file]

🦋 DESCRIPTION 🦋

so, what does shield-purge actually do? it deletes old entries from the database, periodt 🗑️✨

a binary for the pam-shield module, shield_purge is not intended to be invoked manually — no cap. it's a helper program for a job in crontab. it's giving background-worker energy, not main-character-you-typing-it-in-a-terminal energy 🫶

what it clears: records from the database that are older than the time specified by retention in shield.conf(5). so old stuff out, fresh stuff stays 💖

this program is part of the PAM-shield package. and now for the serious bit, bestie, because it matters: PAM-shield comes with ABSOLUTELY NO WARRANTY. it's free software, and you are welcome to redistribute it under certain conditions. see the GNU General Public Licence for details 👑

🎀 OPTIONS 🎀

  • -h, --help — display this information 🥰
  • -c, --conf=file — specify config file (default: /etc/security/shield.conf) 📁
  • -d, --debug — verbose output for debugging purposes 🔍
  • -n, --dry-run — do not perform any updates 🙈
  • -l, --list — list all database entries 📋
  • -f, --force — delete all entries, even if unexpired 💀
ngl bestie, -f is the loud one. "even if unexpired" means it does not care. it's taking everything. know what you're doing before you press enter 🔥

🌈 AUTHOR 🌈

Walter de Jong <walter@heiho.net> 💜

⭐ PROJECT LOCATION ⭐

https://github.com/jtniehof/pam_shield
Copyright (C) 2007-2011 by Walter de Jong <walter@heiho.net>
Copyright 2010 Jonathan Niehof <jtniehof@gmail.com>

okay that's the whole page, slay 💅 this was pam_shield version 0.9.6, dated 11 May 2012 — and yes, it's shield-purge(8), the System Manager's Manual one, iykyk 🎀🦋✨

📦 where this page comes from