forked from grembo/intel_backlight_fbsd
-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathintel_backlight.1
110 lines (110 loc) · 3.43 KB
/
intel_backlight.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
.\" SPDX-License-Identifier: MIT
.\"
.\" Copyright 2018 Mateusz Piotrowski <[email protected]>
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the "Software"),
.\" to deal in the Software without restriction, including without limitation
.\" the rights to use, copy, modify, merge, publish, distribute, sublicense,
.\" and/or sell copies of the Software, and to permit persons to whom the
.\" Software is furnished to do so, subject to the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included in
.\" all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
.\" AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
.\" DEALINGS IN THE SOFTWARE.
.Dd May 28, 2018
.Dt INTEL_BACKLIGHT 1
.Os
.Sh NAME
.Nm intel_backlight
.Nd "control backlight on various modern Intel GPUs"
.Sh SYNOPSIS
.Nm
.Op Cm decr | Cm incr | Ar n
.Sh DESCRIPTION
This utility allows to control the brightness of the backlight on certain Intel
GPUs, including i915.
.Pp
The current backlight value is reported every time the program is run.
Additionally, if the argument are invalid then a help message is shown.
.Pp
The backlight brightness levels that
.Cm decr
and
.Cm incr
operate on are as follows:
1, 2, 4, 6, 9, 12, 16, 20, 25, 30, 36, 43, 51, 60, 70, 80, 90, 100.
.Pp
The options are as follows:
.Bl -tag -width "decr"
.It Cm decr
Decrease the backlight value to the nearest brightness level.
.It Cm incr
Increase the backlight value to the nearest brightness level.
.It Ar n
Change the backlight value to
.Ar n
where
.Ar n
should be between 0 and 100. Providing any other integer results in setting the
backlight back to the default value of 100.
.El
.Sh FILES
.Bl -tag -width ""
.It Pa /usr/local/share/examples/intel-backlight/asmc_backlight.sh
An example of a script adjusting brightness automatically based on the
input of the MacBook
.Xr asmc 4
light sensor driver.
.It Pa /usr/local/share/examples/intel-backlight/isl_backlight.sh
An example of a script adjusting brightness automatically based on the
input of the
.Xr isl 4
driver, which is currently not part of standard
.Fx .
.El
.Sh EXIT STATUS
.Ex -std
.Sh DIAGNOSTICS
The command may fail for any of the following reasons:
.Bl -ohang
.It Sy "Couldn't initialize PCI system: Device not configured"
The user does not have required permissions to execute
.Nm
as it probably hasn't got the setuid bit set during installation.
The solution is either to reinstall this program or to run the command as root.
.El
.Sh COMPATIBILITY
See
.Pa intel_chipset.h
in the source distribution of
.Nm
for a list of supported chipsets.
.Sh SEE ALSO
.Xr acpi_video 4 ,
.Xr asmc 4 ,
.Xr isl 4
.Sh HISTORY
Originally ported to
.Fx
by
.An emmex
of the
.Fx
forums.
.Pp
.Nm
is based on the code that has been taken from the project developing test suite
and tools for DRM/KMS drivers, which can be found here:
.Lk http://cgit.freedesktop.org/xorg/app/intel-gpu-tools/
.Sh AUTHORS
This
manual page was written by
.An Mateusz Piotrowski Aq Mt [email protected] .