Changeset f7a5feb9 for general/sysutils/acpid.xml

Timestamp:

09/02/2023 08:28:02 PM (9 months ago)

Author:

Thomas Trepl <thomas@…>

Branches:

lazarus

Children:

3e86dee

Parents:

03ecbc8a (diff), 642d7af (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge branch 'trunk' into lazarus

File:

• general/sysutils/acpid.xml (modified) (3 diffs)

general/sysutils/acpid.xml

@@ -35 +35 @@
     </para>
 
+    <note>
+      <para>
+        Some other packages may handle some ACPI events as well and they
+        may conflict with this package.  For example, &logind;
+        (read the documentation for <option>Handle*=</option> in
+        <filename>logind.conf(5)</filename> for details) and
+        <xref linkend='upower'/> (used by many desktop environments such as
+        GNOME, KDE, and XFCE for handling ACPI events).  If you've installed
+        such a package and it's enough for your use case, this package is
+        probably not needed.  If you really need this package, you must be
+        careful configuring it and the other packages handling ACPI events
+        to avoid conflicts.  Notably, &logind; handles some ACPI events
+        by default, so the handling of these events by &logind; should be
+        disabled first if handling these events with acpid
+        (again, read <filename>logind.conf(5)</filename> for details).
+      </para>
+    </note>
+
     &lfs120_checked;
 
@@ -112 +130 @@
 
     <para>
-      The following brief example will suspend the system when the laptop lid
-      is closed (it requires <xref linkend="pm-utils"/>):
-    </para>
-
-    <!-- TODO: Move from pm-suspend to systemctl suspend for systemd -->
-<screen role="root"><userinput>cat &gt; /etc/acpi/events/lid &lt;&lt; "EOF"
+      The following brief example will suspend the system when the laptop
+      lid is closed<phrase revision='sysv'> (it requires
+      <xref linkend="pm-utils"/>)</phrase>.  The example also disables
+      the default handling of the lid close event by &logind; when the
+      system is on battery and not connected to any external monitor,
+      in order to avoid a conflict:
+    </para>
+
+<screen revision='sysv' role="nodump"><userinput>cat &gt; /etc/acpi/events/lid &lt;&lt; "EOF"
 <literal>event=button/lid
 action=/etc/acpi/lid.sh</literal>
@@ -127 +148 @@
 /usr/sbin/pm-suspend</literal>
 EOF
-chmod +x /etc/acpi/lid.sh</userinput></screen>
-
-    <para>
-      Unfortunately, not every computer labels ACPI events in the same way. To
-      determine how your buttons are recognized, use the
+chmod +x /etc/acpi/lid.sh
+
+mkdir -pv /etc/elogind/logind.conf.d
+echo <literal>HandleLidSwitch=ignore</literal> &gt; /etc/elogind/logind.conf.d/acpi.conf</userinput></screen>
+
+<screen revision='systemd' role="nodump"><userinput>cat &gt; /etc/acpi/events/lid &lt;&lt; "EOF"
+<literal>event=button/lid
+action=/etc/acpi/lid.sh</literal>
+EOF
+
+cat &gt; /etc/acpi/lid.sh &lt;&lt; "EOF"
+<literal>#!/bin/sh
+/bin/grep -q open /proc/acpi/button/lid/LID/state &amp;&amp; exit 0
+/usr/bin/systemctl suspend</literal>
+EOF
+chmod +x /etc/acpi/lid.sh
+
+mkdir -pv /etc/systemd/logind.conf.d
+echo <literal>HandleLidSwitch=ignore</literal> &gt; /etc/systemd/logind.conf.d/acpi.conf</userinput></screen>
+
+    <para>
+      Unfortunately, not every computer labels ACPI events in the same way
+      (for example, the lid may be recognized as <filename>LID0</filename>
+      instead of <filename>LID</filename>).
+      To determine how your buttons are recognized, use the
       <command>acpi_listen</command> tool. Also, look in the <filename
       class="directory">samples</filename> directory under <filename