DIRVISH-RUNALL(8)

✨ DIRVISH-RUNALL ✨

okay so bestie, welcome to dirvish-runall — section 8 of the System Manager's Manual, which is the "system administration commands" part of the library, iykyk 💅

🎀 NAME 🎀

dirvish-runall — run a set of dirvish backup jobs. that's it, that's the girl 🫶

🦋 SYNOPSIS 🦋

dirvish-runall[OPTIONS]

🌸 DESCRIPTION 🌸

She runs all the jobs that you listed in the Runall field of the dirvish master configuration file. one command, all your backups, no cap ✨

💅 OPTIONS 💅

every option can be abbreviated as long as it's unambiguous — so you don't have to type the whole thing, but don't get cute and make it confusing 💀

• --config configfile — read configfile for the Runall: field. by default dirvish-runall is gonna use the Runall: field from the master configuration file instead.

real talk: this one is only used by dirvish-runall itself, it does not get propagated down to the dirvish processes. keep that in mind bestie 🙈

see dirvish.conf(5) for more deets.

• --no-run
• --dry-run — don't actually do anything, just show you what would have happened. it's giving window shopping 🛍️✨

(--no-run and --dry-run are listed together, so they're basically besties here 💖)

• --quiet — run quietly, only report errors. normally dirvish-runall will report the dirvish commands invoked with timestamps, but with this flag she shuts up unless something goes wrong 🤫
• --version — print the version information and exit. periodt 👑

🔥 EXIT CODES 🔥

so that you can automate and integrate dirvish-runall with other tools, she provides rationalised exit codes — and these codes are range based, which is the whole point:

• the code for one specific error might change between versions, but it will stay inside its specified range. so do not test for specific exit codes, test for a range of values instead 🫶
• to the degree possible, higher value ranges mean more severe errors. the drama escalates 💀

so here's the breakdown:

• 0 — success 💖
• 1-199 — number of dirvish jobs that failed. and if more than 199 jobs failed, then 199 is gonna be the exit code (she caps it, she's not doing 400 💅)
• 200-219 — an error was encountered in loading a configuration file. 😭
• 220-254 — an error was detected in the configuration.
• 255 — incorrect usage. not me using it wrong 🙈

🗂️ FILES 🗂️

• /etc/dirvish/master.conf — alternate master configuration file.
• /etc/dirvish.conf — master configuration file.

👀 SEE ALSO 👀

• dirvish.conf(5)

💀 BUGS 💀

(no bugs listed in the original, bestie — the bugs section is literally empty, which is iconic of her honestly 👑✨)

k bye, that's the whole page — dirvish-runall, section 8, straight out of the System Manager's Manual. go run your backups, main character 💜🦋