ACPILID(4)

📦 version 11.0, in nixpkgs unstable

💖 ACPILID(4) — the Kernel Interfaces Manual girlies' edition 💖

okay so this page lives in the Kernel Interfaces Manual section, and it's all about acpilid — the ACPI Lid Switch driver, aka the little guy who knows when you close your laptop 💅

✨ NAME ✨

acpilid — ACPI Lid Switch. that's it, that's the name, she's literally the lid-switch driver 🎀

🌸 SYNOPSIS 🌸

acpilid* at acpi?

yes bestie, that's the whole config line. she attaches at acpi?, periodt ✨

🦋 DESCRIPTION 🦋

okay so the acpilid driver is the one that supports ACPI "lid switches" — like, the physical lid of your laptop, the thing you flip open and shut fifty times a day without thinking about it 🙈

you can hook the powerd(8) daemon up to it so it does stuff when the lid opens or closes. the script it runs is /etc/powerd/scripts/lid_switch, and the events it can fire are:

  • pressed — the lid was closed 🫥
  • released — the lid was opened 🫶

that's the whole vibe check. two events, one script, infinite dramatic potential 💀

🍓 EXAMPLES 🍓

the following example modifies the mentioned script in order to put the system into (S3) sleep when the lid is closed — truly the main character move of power management 👑

...

case "${2}" in
pressed)
        logger -p info "${0}: suspending..."

        # As in sleep_button, kill some daemons.
        #
        /etc/rc.d/dhcpcd stop
        /etc/rc.d/network stop
        /etc/rc.d/wpa_supplicant stop

        # Suspend.
        #
        if /sbin/sysctl hw.acpi.sleep.state >/dev/null 2>&1; then
                /sbin/sysctl -w hw.acpi.sleep.state=3
        fi

        # Waking up.
        #
        /etc/rc.d/wpa_supplicant start
        /etc/rc.d/network start
        /etc/rc.d/dhcpcd start

...

ngl this snippet ate 💅 it kills the daemons, checks hw.acpi.sleep.state exists with /sbin/sysctl hw.acpi.sleep.state >/dev/null 2>&1, sets /sbin/sysctl -w hw.acpi.sleep.state=3, then brings everything back up on the way out 🔥

🔥 SEE ALSO 🔥

go read those too bestie, iykyk 📚✨

🌈 HISTORY 🌈

the acpilid driver appeared in NetBSD 1.6 — she's been iconic since day one, no cap 💜

💌 and that's the page! sourced from Debian, dated January 9, 2011 — go close your lid, she's got it from here 🫶🦋💖
📦 where this page comes from