DIRVISH-LOCATE(1)

💖 DIRVISH-LOCATE 💖

okay bestie, welcome to dirvish-locate from the General Commands Manual section — she's the girl who finds your files across every dirvish image you've ever made, and she does it flawlessly. no cap. 🦋

---

✨ NAME ✨

dirvish-locate — locate file versions in dirvish images 🔍

---

🎀 SYNOPSIS 🎀

dirvish-locate vault[:branch] pattern

---

👑 DESCRIPTION 👑

Locate versions of files in a dirvish vault. literally her whole thing. 💅

The index of each image specified by vault gets searched for paths matching pattern. Every path that matches the pattern gets reported, and right after it comes a modification time for each version of that file, plus all the images that have a link to it. slay. ✨

That optional branch specification? It restricts the searching to the specified branch only. very demure, very mindful.

Images with an error status get skipped — and so do any without index files. The index file can be compressed with gzip or bzip2, she doesn't mind. See tree and index in dirvish.conf(5) for the details. 🫶

The pattern is a perl regular expression that matches the final component of the path. so if you wanna match any substring of the whole entire path, append .* to the end of the pattern, or append $ if you wanna anchor the pattern to the end of the path. See perlre(1) for details. iykyk. 🧚

Directories are excluded from matching, because otherwise they'd match every single file inside them and that's just chaos. Symlinks are excluded from matching too. 🚫

If the pattern matches too many paths, dirvish-locate will only report the paths matched and not the versions. and as a sanity check, if the number of matches is really excessive, she'll limit the number of images searched. excessive matches is a sign your pattern isn't specific enough — so use that resulting path list to compose a more specific one. bestie please be specific. 😭

---

💀 EXIT CODES 💀

To facilitate further automation and integration of dirvish-locate with other tools, she provides rationalised exit codes. they're range based. while the code for a specific error may change from one version to another, it will always remain within the specified range. so don't test for specific exit codes — test for a range of values instead. and to the degree possible, higher value ranges indicate more severe errors. 🔥

• 0 — success ✨
• 200-219 — An error was encountered in loading a configuration file.
• 220-254 — An error was detected in the configuration.
• 255 — Incorrect usage. 🙈

---

🍓 FILES 🍓

• /etc/dirvish/master.conf — alternate master configuration file.
• /etc/dirvish.conf — master configuration file.
• bank/vault/image/summary — image creation summary.
• bank/vault/image/index
• bank/vault/image/index.gz
• bank/vault/image/index.bz2 — dirvish index file.

---

🌈 SEE ALSO 🌈

• dirvish.conf(5)

---

🦋 BUGS 🦋

...and that's it. no bugs listed. she's flawless, main character energy, periodt. 💅

---

okay so that's the whole page, and the footer just signs off with DIRVISH-LOCATE(1) — same as the header up top, so we're matching, iconic, no further version or date deets given. go find ur files bestie 💖🌸