Recent changes to Installation

Installation modified by Lukas Jirkovsky

Lukas Jirkovsky — Tue, 20 May 2014 08:32:32 -0000

--- v5
+++ v6
@@ -3,12 +3,13 @@

 Requirements:
 -------------
-GNU/Linux
-C compiler
-CMake 2.8
-libusb 1.x
-C++ compiler – optional, needed for qeilin (graphical interface)
-Qt 4 – optional, needed for qeilin (graphical interface)
+
+- GNU/Linux
+- C compiler
+- CMake 2.8
+- libusb 1.x
+- C++ compiler – optional, needed for qeilin (graphical interface)
+- Qt 4 – optional, needed for qeilin (graphical interface)

 Compiling:
 ----------

Installation modified by Lukas Jirkovsky

Lukas Jirkovsky — Tue, 20 May 2014 08:30:04 -0000

--- v4
+++ v5
@@ -6,7 +6,7 @@
 GNU/Linux
 C compiler
 CMake 2.8
-libusb 1.x or libusbx
+libusb 1.x
 C++ compiler – optional, needed for qeilin (graphical interface)
 Qt 4 – optional, needed for qeilin (graphical interface)

Installation modified by Lukas Jirkovsky

Lukas Jirkovsky — Tue, 20 May 2014 08:29:34 -0000

--- v3
+++ v4
@@ -22,8 +22,8 @@

 This will install eilin to the default CMAKE_INSTALL_PREFIX (probably /usr/local) and it's configuration file into /etc.

-Running under non-root user
----------------------------
+Running under a non-root user
+-----------------------------
 eilin accesses the USB directly using the libusb. However this requires that the user
 has enough privileges to access USB. Because of that, eilin is installed with setuid
 root by default.

Installation modified by Lukas Jirkovsky

Lukas Jirkovsky — Tue, 20 May 2014 08:29:22 -0000

--- v2
+++ v3
@@ -14,9 +14,11 @@
 ----------
 eilin uses CMake build system to build binaries. The simplest way to install eilin is to run the following commands within the source directory:

+~~~~~~
 cmake .
 make
 make install
+~~~~~~

 This will install eilin to the default CMAKE_INSTALL_PREFIX (probably /usr/local) and it's configuration file into /etc.

@@ -28,11 +30,25 @@

 Other option is to use udev rule to allow non-root access to the device. To do that,
 you must do the following:
+
 1. create a group named eilin:
-    groupadd eilin
+
+~~~~~~
+groupadd eilin
+~~~~~~
+
 2. copy the supplied file "51-eizo.rules" to "/etc/udev/rules.d/"
+
 3. add all users that are allowed to control monitors to the "eilin" group
-    usermod -a -G eilin USERNAME
+
+~~~~~~
+usermod -a -G eilin USERNAME
+~~~~~~
+
 4. compile and install eilin without setuid by passing
-    -DINSTALL_SETUID=OFF
+
+~~~~~~
+-DINSTALL_SETUID=OFF
+~~~~~~
+
 to cmake

Installation modified by Lukas Jirkovsky

Lukas Jirkovsky — Tue, 20 May 2014 08:25:46 -0000

--- v1
+++ v2
@@ -20,6 +20,19 @@

 This will install eilin to the default CMAKE_INSTALL_PREFIX (probably /usr/local) and it's configuration file into /etc.

-Note on privileges
-------------------
-eilin accesses the USB directly using the libusb. However this requires that the user has enough privileges to access USB. Because of that, eilin is installed with setuid root by default. However this may pose a potential security threat, so you may want to edit udev rules accordingly. For more information see the related FAQ for [libusb](http://libusb.org/wiki/FAQ#CanIrunLinuxlibusbapplicationswithoutrootrootprivilege) and [libusbx](https://github.com/libusbx/libusbx/wiki/FAQ#wiki-Can_I_run_Linux_libusbx_applications_without_root_privilege)
+Running under non-root user
+---------------------------
+eilin accesses the USB directly using the libusb. However this requires that the user
+has enough privileges to access USB. Because of that, eilin is installed with setuid
+root by default.
+
+Other option is to use udev rule to allow non-root access to the device. To do that,
+you must do the following:
+1. create a group named eilin:
+    groupadd eilin
+2. copy the supplied file "51-eizo.rules" to "/etc/udev/rules.d/"
+3. add all users that are allowed to control monitors to the "eilin" group
+    usermod -a -G eilin USERNAME
+4. compile and install eilin without setuid by passing
+    -DINSTALL_SETUID=OFF
+to cmake

WikiPage Installation modified by Lukas Jirkovsky

Lukas Jirkovsky — Thu, 19 Jul 2012 15:00:41 -0000

Installation ============ Requirements: ------------- GNU/Linux C compiler CMake 2.8 libusb 1.x or libusbx C++ compiler – optional, needed for qeilin (graphical interface) Qt 4 – optional, needed for qeilin (graphical interface) Compiling: ---------- eilin uses CMake build system to build binaries. The simplest way to install eilin is to run the following commands within the source directory: cmake . make make install This will install eilin to the default CMAKE_INSTALL_PREFIX (probably /usr/local) and it's configuration file into /etc. Note on privileges ------------------ eilin accesses the USB directly using the libusb. However this requires that the user has enough privileges to access USB. Because of that, eilin is installed with setuid root by default. However this may pose a potential security threat, so you may want to edit udev rules accordingly. For more information see the related FAQ for [libusb](http://libusb.org/wiki/FAQ#CanIrunLinuxlibusbapplicationswithoutrootrootprivilege) and [libusbx](https://github.com/libusbx/libusbx/wiki/FAQ#wiki-Can_I_run_Linux_libusbx_applications_without_root_privilege)