IUNREG(1)

📦 version 5.0.2, in nixos 26.05

✨ IUNREG(1) ✨

okay so bestie, welcome to the iunreg page — it lives in the User Commands section of the manual and honestly? it's lowkey iconic once you get it. let's get into it 💅

🎀 NAME 🎀

iunreg — an iRODS iCommand. that's the whole name, no cap.

🌸 SYNOPSIS 🌸

iunreg [-hMrvV] dataObj|collection ...

🦋 DESCRIPTION 🦋

so what does it do? it unregisters all replicas of one or more data-object or collection from iRODS space. and listen — all those replicas stay right there on disk, the entry in the catalog is the only thing that gets removed. the files are fine, they're just... uninvited from the party 😭

this usage replaces the previously supported -U option for irm. periodt.

here's the full usage, verbatim, because I'm not about to paraphrase this:

Usage: iunreg [-hMrvV] [--age age_in_minutes] [--dryrun] [-n
replNum]|[-S srcResource] [-N numCopies] dataObj|collection ...

you can also reduce the number of replicas of a dataObject in iRODS by unregistering some replicas. nothing will be done if this is less than or equal to numCopies. the -n and the -S options are what specify which replicas get unregistered.

⚠️ note that if both are used at the same time, the server will return an error if -n violates the requirements of -N. no sneaky double-dipping bestie 🙈
💀 note that -S and -n are incompatible. like, they do not vibe together. at all.

🌈 Options are: 🌈

  • -M — admin. an admin user uses this option to unregister other users' files 👑 big main character energy.
  • -n — replNum. the replica number of the replica to be unregistered. specific queen behavior 🎯
  • -N — numCopies. the minimum number of most current replicas to keep. the default value is 2.
  • -r — recursive. unregisters all data objects in the whole subtree 🌳 every last one.
  • -S — srcResource. specifies the resource of the replica to be unregistered. if specified, only replicas stored in this resource will be candidates for the unregistration ✨
  • -v — verbose. it talks more 💬
  • -V — Very verbose. it talks a LOT 🗣️🔥
  • --age age_in_minutes — the minimum age of the replica in minutes for unregistering. i.e., a replica will not be unregistered if its age is less. babies stay 🍼
  • --dryrun — do a dry run. no replica will actually be unregistered. zero consequences, pure rehearsal 💫
NOTE: option only valid when targeting specific replicas. don't push it.
  • -h — this help. hiiii 🫶

⭐ sign-off ⭐

and that's the page, bestie! this whole thing is iunreg from iRODS-5.0.2, dated January 1980 (yes really, she's vintage 💜), and it closes out as IUNREG(1) — go unregister some replicas responsibly, mwah 🎀💖🧚

📦 where this page comes from