initial
[backlight-adjust.git] / bl.1
blob981f141ad8dd0ceb1d9c14044ba94880dea42afe
1 .Dd 2017-02-17
2 .Dt BL 1
3 .Os
4 .Sh NAME
5 .Nm bl
6 .Nd Control backlight via
7 .Pa /sys
8 .Sh SYNOPSIS
9 .Nm
10 .Sh DESCRIPTION
11 .Nm
12 adjusts the backlight brightness via Linux's
13 .Pa /sys
14 filesystem. It is useful if you're not running X.
15 .Pp
16 Change the backlight with
17 .Em j
18 and
19 .Em k
20 keys. Use
21 .Em q
22 or 
23 .Em ^C
24 to exit.
25 .Sh FILES
26 .Nm
27 assumes that the file
28 .Pa /sys/class/backlight/backlight/brightness
29 is writable by the current user, and that
30 .Pp
31 .Bl -bullet -compact
32 .It
33 reading results in one line: an ASCII-represented integer from 0 to 128
34 representing current backlight brightness, and
35 .It
36 writing a line in the same format changes the brightness.
37 .El
38 .Sh BUGS
39 Probably.  This hasn't been tested with X, hasn't been tested on your
40 hardware, relies on Linux-specific features, etc.
41 .Sh AUTHORS
42 .An S. Gilles Aq Mt sgilles@math.umd.edu