RT-SHREDDER(1)

💖 RT-SHREDDER 💖

okay bestie, so this is rt-shredder from the User Contributed Perl Documentation corner of the world — the girlies call it the utility that wipes out data from your RT database. yes. that is literally what it does. she's a deleter. a very careful, very powerful deleter. 🫶

---

✨ NAME ✨

rt-shredder — the utility that wipes out data from your RT database. she's giving "spring cleaning but make it permanent". 🌸

---

🦋 SYNOPSIS 🦋

rt-shredder --plugin list
rt-shredder --plugin help-Tickets
rt-shredder --plugin 'Tickets=query,Queue="general" and Status="deleted"'

rt-shredder --sqldump unshred.sql --plugin ...
rt-shredder --force --plugin ...

---

💅 DESCRIPTION 💅

so rt-shredder wipes out objects from your RT database. no cap. it does the thing.

this script uses an API that the RT::Shredder module adds to RT. and like, it can also be used as an example of how to use the shredder API — so if you're the kind of girl who reads source code for fun (respect), this is your moment. 📖✨

---

🌈 USAGE 🌈

you've got several options to control which objects rt-shredder should wipe out. pick your fighter. 👑

⚠️ okay this part is IMPORTANT bestie: when you're using other options, the --plugin option must be provided last. last. the end. if you put it anywhere else the vibe check fails. 💀

---

🎀 OPTIONS 🎀

🌸 --sqldump <filename>

outputs INSERT queries into a file for all shredded records. this dump can be used to restore data after wiping out. it's the receipts, it's the undo button, it's everything. 🧾💖

by default rt-shredder creates files named <ISO_date>-XXXX.sql in the current directory. cute naming convention, honestly.

💜 --no-sqldump

don't generate the SQL dump file. that's it. that's the option.

the SQL dump file provides you with a way to "undo" the removal of records from your RT database, if needed.

🚨 use this option only if you are sure you have a recent, valid database backup in case you need to recover data that may have been shredded in error. like, please. i am begging. have a backup. 🙈

🍓 --object (DEPRECATED)

option has been deprecated, use plugin "Objects" instead. she's retired. she's living her best life elsewhere. do not use her. 💀

🧚 --plugin '<plugin name>[=<arg>,<val>[;<arg>,<val>]...]'

you can use plugins to select RT objects with various conditions. see also --plugin list and --plugin help options. it's giving customizable. it's giving modular. we love her. 👑

⭐ --plugin list

output list of the available plugins. so you know who's invited to the party. 🎉

🔥 --plugin help-<plugin name>

outputs help for specified plugin. the plugin will explain itself. icon behavior. 💅

💖 --force

don't prompt with questions before shredding objects. no confirmation, no "are you sure?", just send it. use responsibly, bestie. 😭

🌸 --include-external-storage

shred externalized contents too. and when this is enabled, a separate dump file that contains commands to re-externalize objects will be generated, along with the SQL dump file, so you can fully "undo" if needed. the full package. the deluxe edition. ✨

by default this is not enabled. she's opt-in, she's exclusive.

see also "%ExternalStorage" in RT_Config.

---

👑 SEE ALSO 👑

• RT::Shredder — go read her, she's the whole reason this works 🫶

---

okay that's the whole page bestie, you're officially an rt-shredder expert, no cap. 🎀

this came to you courtesy of Perl v5.42.3 and it's dated 2026-07-20 — so go forth, wipe responsibly, keep a backup, and slay. 💖✨🦋🌸💅