ITOUCH(1)

💅 ITOUCH(1) — the one and only

okay so bestie, you're reading the manual page for itouch, one of the iRODS iCommands (the manual's literally called User Commands, and yes we're in the ITOUCH(1) section, ilysm for asking) 🎀

---

✨ NAME ✨

itouch — an iRODS iCommand 🦋

---

🌸 SYNOPSIS 🌸

itouch [OPTION]... LOGICAL_PATH

---

💖 DESCRIPTION 💖

itouch — Change logical path timestamp. That's the whole gig, no cap ✨

It updates the modification time of a logical path to the current time. Simple. Iconic. Slay.

So here's the tea: a LOGICAL_PATH argument that does not exist will be created as an empty data object — unless you pass -c. Don't say I didn't warn you 💅

If LOGICAL_PATH doesn't exist and you specify no options at all, the server will create a new data object and store the replica in a resource of its own choosing. Not your choice. The server's choice. It's giving main character energy, honestly 🙈

If multiple replicas exist and you didn't specify a target replica via a replica number or a leaf resource, then the latest good replica will be updated. Whoever's newest and healthiest gets the glow-up 💅

Also, irods_default_resource in irods_environment.json is ignored. Like, fully ignored. Don't @ it 😭

Mandatory arguments to long options are mandatory for short options too — fr fr, that's just how this works.

---

✨ OPTIONS ✨

• -c, --no-create — Do not create a data object. That's it, that's the whole vibe 🫶
• -n, --replica — The replica number of the replica to update. This option applies to data objects only, and it cannot be used with -R 🚫
• -R, --resource — The leaf resource that contains the replica to update. This option applies to data objects only. If the data object does not exist and you use this option, the replica will be created on the resource you specified. Cannot be used with -n 🚫
• -r, --reference=LOGICAL_PATH — Use the modification time of LOGICAL_PATH instead of the current time. Cannot be used with -s ⏰
• -s, --seconds-since-epoch=SECONDS — Use SECONDS instead of the current time. Cannot be used with -r ⏱️
• -h, --help — Display this help message and exit. Your fave, honestly 🥰
• -v, --version — Display version information and exit. Go off, king 👑

lowkey important: -n and -R are mutually exclusive, and so are -r and -s. You literally cannot pick both. The vibes will not allow it 💀

And for the record, the version banner this ships with reads:

iRODS Version 5.0.2                itouch

---

That's the whole page bestie, go touch some logical paths 🦋💜

— with love, from the iRODS iCommands girlies: itouch iRODS-5.0.2, dated January 1980, filed under ITOUCH(1). periodt 💅✨