Mercurial > backlight
diff INSTALL.md @ 6:77ea2359f3e4
misc: refactor
author | David Demelier <markand@malikania.fr> |
---|---|
date | Mon, 16 Sep 2019 15:08:21 +0200 |
parents | |
children | 0de3886f98ad |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/INSTALL.md Mon Sep 16 15:08:21 2019 +0200 @@ -0,0 +1,49 @@ +backlight INSTALL +================= + +Supported systems +----------------- + +- Linux: requires video ACPI module, +- FreeBSD: requires the `acpi_video(4)` loaded. + +Installation on Linux +--------------------- + +First, build the program: + + make + +On Linux, adjusting the brightness can be done as normal user if you have write +access to the appropriate files which are usually under */sys*. + +The recommandation is to install the udev rule which change the ownership of the +brightness file to `video` group and writable by users in this group. Use the +`install-udev` for that purpose. Then don't forget to check if you are part of +the video group. + + make install + make install-udev + +Otherwise, as alternative you can simply install the binary as setuid if you +don't run udev. + + make install-setuid + +Installation on FreeBSD +----------------------- + +In FreeBSD, it's required to have the tool in setuid as there is no way to +change sysctl values from a regular user. + +Also, you will need the ACPI video module, add the following to your +*/boot/loader.conf*: + + acpi_video_load=YES + +Alternatively, you can compile this module into the kernel. + +Then install using: + + make + make install-setuid