RT-VALIDATOR(1)

💖 rt-validator — like, RT's database's personal hype-woman-slash-bouncer 💖

okay bestie, this is a page from the User Contributed Perl Documentation crew, and it's about a little script called rt-validator. it lives in section 1 of the manual (that's the <italic>1</italic> in rt-validator(1), iykyk). and literally all it does is:

check and correct validity of records in RT's database 👑

---

✨ NAME ✨

rt-validator — check and correct validity of records in RT's database

like. that's the whole name. it validates. it's an RT validator. we love a self-explanatory queen 🫶

---

🌸 SYNOPSIS 🌸

here's how you actually call her:

rt-validator --check
rt-validator --check --verbose
rt-validator --check --verbose --resolve
rt-validator --check --verbose --resolve --force

see how it's giving "escalating trust levels"? first you just look 👀, then you look and talk, then you look and fix stuff, then you look, fix stuff, and stop asking anybody's permission. main character energy, honestly.

---

💅 DESCRIPTION 💅

okay so. this script checks integrity of records in RT's DB. that's the vibe check. 🔍

and it's not just a looky-loo either — it may delete some invalid records or resurrect accidentally deleted ones. yes literally. it can bring them back from the dead. resurrection era. 🧟‍♀️✨

not me casually letting a script delete rows and un-delete rows in production. be normal about this. run it with --check first, bestie, fr fr. 💀

---

🎀 OPTIONS 🎀

here's the whole roster, no skips, no cuts:

• --check, -c — mandatory. like, you literally cannot do this without it. it's equal to -c. that's the short one. iconic that the required flag also has a required-flag-sized name. 👑
• --verbose, -v — print additional info to STDOUT. it's equal to -v. so if you want the tea ☕, this is how you get the tea. without it you're getting the silent treatment. 🤫
• --resolve — enable resolver that can delete or create some records. yes, actively change your DB. it's not just reporting anymore, she's editing. ✂️➕
• --force — resolve without asking questions. no confirmation, no "are you sure", no "bestie wait" 😭. it just goes. use this one with your whole chest and also your whole backup. 🫡
• --links-only — only run the Link validation routines, useful if you changed your Organization. so if you did an org glow-up 💫 and only the Link stuff needs checking, this is your girl. nothing else gets validated. just Links.
• --cgm-only — only run the CachedGroupMembers validation routines. same energy, different table. if CachedGroupMembers is the only thing you're worried about, she can zoom right in. 🔬

---

🌈 a lil sign-off 🌈

this page was brought to you by perl v5.42.3, dated 2026-07-20, and you read the whole thing so consider this your 🍓 gold star 🍓. go run rt-validator --check before you touch literally anything else. mwah. 💋🦋