man7.org > Linux > man-pages

Linux/UNIX system programming training

systemd-backlight@.service(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | KERNEL COMMAND LINE | SEE ALSO | COLOPHON 

SYSTEMD-....SERVICE(8) systemd-backlight@.service SYSTEMD-....SERVICE(8)

NAME         top

       systemd-backlight@.service, systemd-backlight - Load and save the
       display backlight brightness at boot and shutdown

SYNOPSIS         top

       systemd-backlight@.service

       /usr/lib/systemd/systemd-backlight save [backlight|leds]:DEVICE

       /usr/lib/systemd/systemd-backlight load [backlight|leds]:DEVICE

DESCRIPTION         top

       systemd-backlight@.service is a service that restores the
       brightness of a display backlight or LED (e.g. keyboard
       backlight) device at early boot, and saves it at shutdown. The
       brightness is stored in /var/lib/systemd/backlight/.

       On restoring brightness of a display backlight device,
       systemd-backlight reads ID_BACKLIGHT_CLAMP udev property, that
       takes a boolean value or a percentage (needs to be suffixed with
       "%", e.g.  "30%"). When a percentage is specified, the saved
       brightness is clamped to a value of at least 1 or the specified
       percentage of the maximum brightness, whichever is greater. When
       unset or set to true, the brightness is clamped in the same way
       with percentage 5%. When false, the saved brightness will not be
       clamped, and loaded as is.

       On restoring brightness of a LED device, systemd-backlight reads
       ID_LEDS_CLAMP udev property, that also takes a boolean value or a
       percentage. When a percentage is specified, the saved brightness
       is clamped to the specified percentage of the maximum brightness.
       When set to true, the brightness is clamped in the same way with
       percentage 5%. When unset or set to false, the saved brightness
       will not be clamped, and loaded as is.

KERNEL COMMAND LINE         top

       systemd-backlight understands the following kernel command line
       parameter:

       systemd.restore_state=
           Takes a boolean argument. Defaults to "1". If "0", does not
           restore the backlight settings on boot. However, settings
           will still be stored on shutdown.

           Added in version 209.

SEE ALSO         top

       systemd(1)

COLOPHON         top

       This page is part of the systemd (systemd system and service
       manager) project.  Information about the project can be found at
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have
       a bug report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-13.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

systemd 257~devel                                 SYSTEMD-....SERVICE(8)

Pages that refer to this page: kernel-command-line(7),  systemd.directives(7),  systemd.index(7)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI