OPENRC-SETTINGSD(8)

πŸ“¦ version 1.5.0, in alpine 3.24

πŸ’… openrc-settingsd β€” the group-chat rundown

okay so bestie, you're looking at the manual page for openrc-settingsd, the system settings D-Bus service for OpenRC. It lives in the System Manager's Manual, section 8, and honestly? It's giving quiet-but-essential. Let's get into it πŸŽ€


✨ NAME ✨

openrc-settingsd β€” a system settings D-Bus service for OpenRC. That's the whole vibe. No cap.


πŸ¦‹ SYNOPSIS πŸ¦‹

openrc-settingsd [--debug] [--syslog] [--read-only] [--ntp-service=SERVICE] [--update-rc-status]

(yeah the original wraps --ntp-service=SERVICE onto the next line, it's just being dramatic, the flags are the same πŸ’…)


🌸 DESCRIPTION 🌸

So here's the teΠ° β€” the openrc-settingsd daemon implements the standard hostnamed (that's org.freedesktop.hostname1), localed (that's org.freedesktop.locale1), and timedated (that's org.freedesktop.timedate1) D-Bus interfaces for OpenRC systems. Like, it's the translator between your desktop's settings panels and OpenRC. iconic behavior honestly πŸ‘‘

And listen β€” users and administrators should not need to launch the openrc-settingsd executable manually. It shows up on its own. Depending on the installation, it'll either be launched automatically via D-Bus activation when needed, or started by the administrator as an OpenRC service using /etc/init.d/openrc-settingsd. Either way, it's a main character that arrives on schedule ✨


πŸ’– OPTIONS πŸ’–

  • --help β€” shows the help options. The "what do I even do" button 🫢
  • --version β€” shows version information. For when you need receipts 🧾
  • --debug β€” enables debugging messages. Turn it on when things are lowkey not working and you need the lore πŸ”₯
  • --syslog β€” logs to syslog. Ship the gossip to the system journal instead of your terminal πŸ’Œ
  • --read-only β€” runs the daemon in read-only mode. It will read settings files, but will not modify them. Look, don't touch πŸ™ˆ
  • --ntp-service=SERVICE β€” specifies which OpenRC service to use as the NTP service. If you don't use this option, openrc-settingsd will attempt to autodetect an appropriate NTP implementation. Let it figure it out, it's smart like that πŸ’…
  • --update-rc-status β€” automatically sets the status of the openrc-settingsd service to started when the daemon successfully starts, and to stopped when the daemon stops. And here's the fun part: if openrc-settingsd is manually launched with this argument, the administrator will be able to stop it via /etc/init.d/openrc-settingsd stop. Full lifecycle management, we love to see it 🌈

πŸŽ€ AUTHORS πŸŽ€

Written by Alexandre Rostovtsev ⟨tetromino@gentoo.org⟩. Respect the author, always 🫑


πŸ’€ BUGS πŸ’€

Found a bug? Don't just scream into the void, bestie β€” bug reports should be submitted to the issue tracker ⟨https://gitlab.com/postmarketOS/openrc-settingsd/-/issues⟩. That's the move πŸ“


⭐ SEE ALSO ⭐

iykyk, go read those next 🌸


okay that's the whole page, you ate it up, periodt πŸ’œ This little gem comes from the System Manager's Manual and it's dated 2023-06-05 β€” page name OPENRC-SETTINGSD(8), if you were wondering. Bye bestie, go manage some settings 🧚 ✨

πŸ“¦ where this page comes from