SVSETUP(8)

📦
version 0.6 · 4 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

SVSETUP(8) 💖

okay bestie, welcome to svsetup(8) — she lives in the System Administration Utilities corner of your system, and she's about to make daemontools service setup feel like a lil treat 🎀

✨ NAME ✨

svsetup — the service setup tool for daemontools. yes that's her whole job and she's slaying it 💅

✨ SYNOPSIS ✨

svsetup [OPTION]... CMD SERVICE

that's it. options, then a command, then a service name. iconic structure, no notes 🫶

✨ DESCRIPTION ✨

Service setup tool for daemontools. literally the whole point of her existence, periodt 💜

🎀 the options 🎀

  • -u USER — pick the service user name. default is root (iykyk)
  • -l USER — pick the log user name. default is also root, girlies love consistency 💖
  • -n — do NOT set up logging with multilog. like, no logs, no vibes, just vibes-less 🙈
  • -e ETCDIR — tell her where the cfg directory is. default: /etc/sv/SERVICE
  • -L LOGDIR — tell her where the log directory is. default: /var/log/sv/SERVICE
  • -s SERVICEDIR — point at the service directory. default: automatically detected ✨ (she's got main character detection energy)
  • -d — delete the service user when the service gets removed
  • -D — delete the log user when the service gets removed
  • -h, --help — show help and dip out. classic 💅
  • -V, --version — show the version and dip out. also classic 🌸

🌈 the arguments 🌈

  • CMD — the action you want her to perform, and here are your choices:
    • CREATE — make a brand new service, fresh out the box 🦋
    • REMOVE — delete an existing service, rip boo 💀
    • ENABLE — enable the service, wake her up ⭐
    • DISABLE — disable the service, let her nap 😴
  • SERVICE — the name of the service you're talking about. specify it or she doesn't know who you mean, bestie 🎀
NOTE: if you REMOVE a service and you specified a service user (with -u) and/or a log user (with -l), those users get removed too — except root — but ONLY if you also pass -d and/or -D. and here's the unhinged part: this happens with zero confirmation requests, and those users get deleted even if they were not created by svsetup. not me warning you twice. be so careful fr fr 😭

also! if you create a new service, she makes a default run script for you. but if there's already a run script sitting in ETCDIR, then that existing runscript is the one that gets used instead. she respects the pre-existing serve 💅✨

✨ REPORTING BUGS ✨

found a bug? spill the tea to Klaus Reimer <k@ailis.de> 🐛💌

Copyright © 2000-2011 by Klaus Reimer

This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. 💜

okay that's the whole page, bestie!! go forth and set up them services 👑

svsetup 0.6 — February 2021 🌸💖 that's the version and the date, mwah, bye!! 🫶✨

📦 where this page comes from