PsychLinuxConfiguration - aleslab/Psychtoolbox-3-aleslab-fork GitHub Wiki

PsychLinuxConfiguration([answers]) -- Optimize setup of Linux system.

This script modifies system settings and configuration files
to optimize a Linux system for use with Psychtoolbox.

Currently it modifies files to allow to run Octave or Matlab
as regular non-root user, ie. without need for root login or
the "sudo" command. It does so by changing file permissions
and resource usage limits to allow a regular user application
to switch to realtime scheduling, lock its memory, and to
access special purpose hardware like GPUs, Bits+, Datapixx and
other research equipment.

Realtime optimizations are achieved by extending the
/etc/security/limits.conf file with entries that allow
members of the Unix user group "psychtoolbox" to lock
application memory into physical RAM, eliminating/minimizing
interference from the VM subsystem, and to run with realtime
priorities up to level 50. The group "psychtoolbox" is created
if it does not already exist.

If the target system has a /etc/security/limits.d/ directory,
then a separate rule file is stored to that directory to
achieve the change without messing around with the limits.conf
file.

root-less hardware access is achieved by copying a special
psychtoolbox.rules file into the /etc/udev/rules.d/ directory.
This udev rules file contains rules to auto-detect certain
hardware at bootup or when the hw is hot-plugged and to
reconfigure this hw or access permission for root-less access
by Psychtoolbox, and for optimal performance for the kind
of typical PTB use cases.

The script also creates a /etc/X11/xorg.conf.d/ directory for
xorg.conf configuration files which are writable by members
of the 'psychtoolbox' group to allow easy reconfiguration of
the X11 display system for running experiment sessions.

The script calls into the shell via "sudo" to achieve this
setup task, which itself needs admin privileges to modify
system files etc. "sudo" will prompt the user for his admin
password to complete the tasks. This does not work on Octave
with GUI though. You will need octave --no-gui to execute this
script once if you use octave.

The script also checks if any special configuration is required
to work around Linux specific OpenGL quirks of Matlab R2014b or
later.