RC-STATUS(8)

📦
version 0.63.2 · 2 versions
, in alpine 3.22, alpine 3.23, alpine 3.24

💖 NAME 💖

okay so bestie, this is the manual page for rc-status(8) — and its whole job is literally to show status info about runlevels. That's it, that's the assignment. 🫶

✨ SYNOPSIS ✨

Three little moods, pick ur fighter:

rc-status [-C] [-f ini] [-i state] [runlevel]
rc-status [-C] [-f ini] [-a | -m | -S | -s | -u]
rc-status [-C] [-c | -l | -r]

🦋 DESCRIPTION 🦋

rc-status gathers and displays information about the status of services in different runlevels. Default behavior? It shows info about the current runlevel and any unassigned services that are not stopped — but you can quickly examine any runlevel too, no cap. 💅

If an active service is being supervised by supervise-daemon(8), the amount of time the daemon has been active along with the number of times it has been respawned in the current respawn period will be displayed. So yes, you get the daemon's little activity résumé. ✨

The options are as follows, bestie:

🎀 OPTIONS 🎀

  • -a, --all — Show all runlevels and their services.
  • -c, --crashed — List all services that have crashed (in any runlevel) in plain text format.
  • -f, --format — Select a format for the output. Currently, the only one that can be specified is ini, which outputs in *.ini format.
  • -i, --in-state — Show services in given state. Can be combined, e.g -i started -i crashed will select any services which are either in started or crashed state. Available states are: stopped, started, stopping, starting, inactive, hotplugged, failed, scheduled and crashed.
  • -l, --list — List all defined runlevels.
  • -m, --manual — Show all manually started services.
  • -r, --runlevel — Print the current runlevel name.
  • -S, --supervised — Show all supervised services.
  • -s, --servicelist — Show all services (in any runlevel).
  • -u, --unused — Show services not assigned to any runlevel.
  • -C, --nocolor — Disable color output.
  • runlevel — Show information only for the named runlevel.

💀 EXIT STATUS 💀

rc-status exits 0, except when checking for crashed services and it doesn't find any. That's the one tiny exception, bestie — otherwise it's a clean 0. 🫶

🧠 IMPLEMENTATION NOTES 🧠

rc-status tries to list services within each runlevel in the presently resolved dependency order if the dependency tree is available. So it's giving organized, dependency-aware behavior when it can. 🌈

👑 SEE ALSO 👑

🍓 AUTHORS 🍓

Roy Marples <roy@marples.name>

kisses, your OpenRC bestie 💅 — this page is from OpenRC, dated March 16, 2025. mwah! 🎀

📦 where this page comes from