ACPICONF(8)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 ACPICONF (8) — System Manager's Manual ✨

okay so bestie, this is the page for acpiconf — the little utility that lives in section 8 of the manual, and honestly she's lowkey the main character of ACPI power management on your box 🫶

🌸 NAME 🌸

acpiconf — control ACPI power management 💖

⭐ SYNOPSIS ⭐

acpiconf [-h] [-i batt] [-k ack] [-s type]

🎀 DESCRIPTION 🎀

so the acpiconf utility literally lets you, the user, control the ACPI power management functions. think of it as the group chat between you and your hardware 🔥

the following command-line options are recognized, and yes we're going through all of them because nobody gets left behind 💅

✨ OPTIONS ✨

  • -h — displays a summary of the available options. it's giving "help me help you" energy 🙈
  • -i batt — gets the design information and the current status of the battery you specify by its number, and heads up: the numbering starts with 0 ⭐
  • -k ack — acks or aborts a pending suspend request using whatever argument you hand it. and bestie, listen — most users should not use this option directly, no cap, leave it to the system 🙈
  • -s type — enters the specified sleep mode. the recognized types are:
    1. only the CPU clock is stopped 💤
    2. not implemented on most systems, but similar to S1 😭
    3. the CPU context is lost and the memory context is preserved 🧠
    4. the CPU context is lost and the memory context is stored to disk 💾

sleep states may also be given as S1, S2, etc. — same vibes, different spelling ✨

the supported states depend on the BIOS implementation, including ACPI byte code (AML). so like, your mileage may vary based on your firmware's choices, not ours 🦋

and here's the cute part: if the /etc/rc.suspend and /etc/rc.resume scripts are executable, they will be run by devd(8) or apmd(8) before and after entering the given sleep state 🌈

those /etc/rc.suspend and /etc/rc.resume scripts use the rcorder(8) utility to call scripts in /etc/rc.d/ and the $local_startup directories that have a "suspend" or "resume" KEYWORD, respectively 👑

called scripts are supplied with a single "suspend" / "resume" command line argument — one arg, that's it, that's the whole deal 💅

see rc.conf(5) for more information about $local_startup 📖

🦋 SEE ALSO 🦋

acpi(4), rc.conf(5), acpidump(8), apm(8), apmd(8), devd(8), rcorder(8) — go read the whole friend group, they're all iconic ⭐

👑 HISTORY 👑

the acpiconf utility appeared in FreeBSD 5.0 — a whole era, fr fr 💖

💜 AUTHORS 💜

the acpiconf utility was written by Mitsuru Iwasaki <iwasaki@FreeBSD.org> 🫶

this manual page was written by Dag-Erling Smørgrav <des@FreeBSD.org> 🌸

and that's the whole page bestie!! 🎀 this Debian edition is dated June 16, 2023 — so if you're reading this, hi from the past, you're doing amazing, slay 💅✨

📦 where this page comes from