runsvchdir(8)

📦
version 2.3.1 · 4 versions
, in alpine 3.24, nixpkgs unstable

🦋 NAME 🦋

okay so bestie, meet runsvchdir(8) — from the System Manager's Manual, no less — and its whole thing is: change services directory of runsvdir(8). That's the name, that's the mission, that's the vibe. 💅

✨ SYNOPSIS ✨

runsvchdir dir

One command, one dir, zero mystery. 🫶

💖 DESCRIPTION 💖

dir is a services directory for use with runsvdir(8). Super simple.

If dir does not start with a slash, it gets searched in runsvchdir's working directory — and by default that working directory is /etc/runit/runsvdir/. Slashless besties go there. 🌸

🚨 tiny but iconic rule: dir must not start with a dot.

runsvchdir switches to its working directory, copies current to previous, and replaces current with a symlink pointing to dir. That's the whole glow-up: working dir → copy → symlink. ✨

Normally, /service is a symlink to current, and runsvdir(8) is running /service/. iykyk. 🌀

🌈 ENVIRONMENT 🌈

  • RUNSVDIR — the environment variable $RUNSVDIR overrides the default working directory /etc/runit/runsvdir/. Yes, it's the override queen. 👑

💀 EXIT CODES 💀

  • If something goes wrong, runsvchdir prints an error message and exits 111. Not a vibe, but very clear. 😭
  • On success, runsvchdir exits 0. Slay. ✅

🎀 FILES 🎀

/etc/runit/runsvdir/previous
/etc/runit/runsvdir/current
/etc/runit/runsvdir/current.new

🦋 SEE ALSO 🦋

Also, the link: https://smarden.org/runit/ 🌈

👑 AUTHOR 👑

Gerrit Pape <pape@smarden.org>

Source/version footer: runsvchdir(8) — and date? This copy doesn't show one, so I'm not gonna invent it, bestie. Cute sign-off complete, mwah 💖✨

📦 where this page comes from