Debian Codegraph @

upstream/debian-unstable/man8/[email protected]

raw
1 '\" t
2 .TH "SYSTEMD\-BACKLIGHT@\&.SERVICE" "8" "" "systemd 261~rc3" "[email protected]"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 [email protected], systemd-backlight \- Load and save the display backlight brightness at boot and shutdown
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-backlight@\&.service
27 .PP
28 /usr/lib/systemd/systemd\-backlight
29 save [backlight|leds]:DEVICE
30 .PP
31 /usr/lib/systemd/systemd\-backlight
32 load [backlight|leds]:DEVICE
33 .SH "DESCRIPTION"
34 .PP
35 systemd\-backlight@\&.service
36 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
37 /var/lib/systemd/backlight/\&.
38 .PP
39 On restoring brightness of a display backlight device,
40 \fBsystemd\-backlight\fR
41 reads
42 \fIID_BACKLIGHT_CLAMP\fR
43 udev property, that takes a boolean value or a percentage (needs to be suffixed with
44 "%", e\&.g\&.
45 "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\&.
46 .PP
47 On restoring brightness of a LED device,
48 \fBsystemd\-backlight\fR
49 reads
50 \fIID_LEDS_CLAMP\fR
51 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\&.
52 .SH "KERNEL COMMAND LINE"
53 .PP
54 systemd\-backlight
55 understands the following kernel command line parameter:
56 .PP
57 \fIsystemd\&.restore_state=\fR
58 .RS 4
59 Takes a boolean argument\&. Defaults to
60 "1"\&. If
61 "0", does not restore the backlight settings on boot\&. However, settings will still be stored on shutdown\&.
62 .sp
63 Added in version 209\&.
64 .RE
65 .SH "SEE ALSO"
66 .PP
67 \fBsystemd\fR(1)