ITRIM(1)

💅 ITRIM(1) — the iRODS iCommand glow-up 💅

okay so bestie, you're reading the manual page for itrim, which is — say it with me — an iRODS iCommand</p>. that's the NAME section, we love a concise queen. ✨

---

🌸 SYNOPSIS 🌸

itrim [-hMrvV] [--dryrun] [-n replNum]|[-S srcResource] [-N numReplicas]
dataObj|collection ...

so you feed it a dataObj or a collection, and then ... means you can keep going, she's not gonna stop you. 🫶

---

🦋 DESCRIPTION 🦋

so what does she actually do? she reduces the number of replicas of a dataObject in iRODS by deleting some replicas. that's the whole vibe. 💅

big caveat first, no cap: nothing will be done if this is less than or equal to numCopies. like she will simply not bother. respect.

the -n and the -S options are your little targeting tools — they tell her which replicas to delete. if neither of these options are used, the replicas will be trimmed until there are numCopies left. and the oldest replicas will be trimmed first. ageism but make it storage. 💀

the rec, bestie: it's recommended that this iCommand be used as a precision tool for managing individual replicas. first, determine the replica number of the replica to delete, then target that replica for deletion. here's the usage:

itrim -n 2 /tempZone/home/alice/foo

iconic. surgical. ate. 🔥

also important: registered non-vault replicas are never deleted from the filesystem. they are unregistered and left on disk as-is. so she's not out here destroying your files, she's just... removing them from the group chat. 🙈

note that if both are used at the same time, the server will return an error if -n violates the requirements of -N. drama.

note that -S and -n are incompatible. they cannot sit with each other. pick a lane. 😭

---

🎀 OPTIONS 🎀

• -M — admin. an admin user uses this option to trim other users' files. main character admin energy, honestly. 👑
• -n replNum — the replica number of the replica to be deleted. point at her and she's gone. ✨
• -N numReplicas — minimum number of replicas to keep. the default value is 2. two is the floor, bestie, do not go below. 🫶
• -r — recursive. trim the whole subtree. she's going all the way down, no survivors. 🌈
• -S srcResource — specifies the resource of the replica(s) to be deleted. if specified, only replicas stored in this resource will be candidates for the deletion. very "only these ones, thanks." 💅
• -v — verbose. she talks a normal amount. 💖
• -V — Very verbose. she talks a LOT. capital V for capital yapping. 😭
• --dryrun — do a dry run. no replicas will be trimmed. the try-before-you-buy of it all. 🧚
• -h — this help. hi, hello, welcome. 🌸

and then she signs the options list off with iRODS Version 5.0.2 and her own little name, itrim. cute.

---

reminder fr fr: -S and -n are incompatible, and if -n violates the requirements of -N while both are used, the server returns an error. read the room before you run it. 💀

---

⭐ the sign-off ⭐

okay that's the whole page, mwah. this gem is itrim, from iRODS-5.0.2, and the date on it is January 1980 — she's vintage, she's timeless, she's still serving ITRIM(1). periodt. 💜🎀