aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man/adjbacklight.1
blob: 81db62d3147d8585d7113cc048cd5cde4a341239 (plain) (blame)
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
.TH ADJBACKLIGHT 1 ADJBACKLIGHT
.SH NAME
adjbacklight - Convenient method for adjusting the backlight on your portable computer
.SH SYNOPSIS
.B adjbacklight
(-c | -w | [-g | -s
.IR LEVEL
|
.IR LEVEL ]
[-a |
.IR DEVICE ...])
.SH DESCRIPTION
.B adjbacklight
can be used to fetch or set the backlight non-interactively.
If these feature is not used, it starts a interactive user
interface in the terminal.
.PP
.B adjbacklight
installs with the set-uid bit set, to enable any user to
change the backlight on the computer.
.PP
.B adjbacklight
was originally designed for small netbooks that are not running
.BR X .
However, it is still suitable for desktop computers and can
be used inside
.BR X .
In fact it seems to work for all machines with backlight, which
is not true for
.BR xbacklight (1).
.V adjbacklight
uses
.IR /sys/class/backlight .
.B adjbacklight
as been retrofitted to be convenient for use inside
.B X
on desktop computers, with commands that lets it be used
non-interactively with hotkeys set up in
.BR xbindkeys (1).
.SH OPTIONS
.TP
.BR \-c ,\  \-\-copyright ,\  \-\-copying
Display copyright information.
.TP
.BR \-w, \  \-\-warranty
Display warranty disclaimer.
.TP
.BR \-a, \  \-\-all
Run for all devices, including ACPI devices.
.TP
.BR \-g, \  \-\-get
Get average brightness on devices.
.TP
.BR \-s, \   \-\-set \ \fILEVEL\fP[%]
Set brightness on devices.
.PP
.TP
.BR \+ \fILEVEL\fP
Increase brightness on devices by actual value.
.TP
.BR \- \fILEVEL\fP
Decrease brightness on devices by actual value.
.TP
.BR \= \fILEVEL\fP
Set brightness on devices by actual value.
.br
.TP
.BR \+ \fILEVEL\fP%
Increase brightness on devices by percentage-points.
.TP
.BR \- \fILEVEL\fP%
Decrease brightness on devices by percentage-points.
.TP
.BR \= \fILEVEL\fP%
Set brightness on devices by percentage-points.
.br
.TP
.BR \+ \fILEVEL\fP%%
Increase brightness on devices by percentage.
.TP
.BR \- \fILEVEL\fP%%
Decrease brightness on devices by percentage.
.TP
.BR \= \fILEVEL\fP%%
Set brightness on devices by percentage.
.SH "SEE ALSO"
.BR xbindkeys (1),
.BR xbacklight (1)
.PP
Full documentation available locally via: info \(aq(adjbacklight)\(aq
.SH AUTHORS
Principal author, Mattias Andrée.  See the COPYING file for the full
list of authors.
.SH LICENSE
Copyright \(co 2012, 2013, 2014, 2015  Mattias Andrée
.br
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
.br
There is NO WARRANTY, to the extent permitted by law.
.SH BUGS
Please report bugs to https://github.com/maandree/adjbacklight/issues or to
maandree@member.fsf.org