[English] README.TXT MATROX GRAPHICS INC. 2011.11.02 Matrox M-Series/Extio F2x08 Series Linux Display Driver v1.3.1 Preface ======= The terms "X Server config file" and "xorg.conf" are used interchangeably. The file is located in the "/etc/X11" directory. The terms "X log file" and "Xorg.0.log" are used interchangeably. The file is located in the "/var/log" directory. In the command sequence examples, the pound ('#') sign represents the command prompt and shouldn't be typed. Note that [ENTER] means pressing the 'Enter' key on your keyboard. The command sequence examples in this Readme file refer to the 32-bit package named "m9xdriver-x86_32-1.3.1.run". If you're using the 64-bit package, use "m9xdriver-x86_64-1.3.1.run". Note: On some systems you may need to enter "su - root" instead of "su root" when changing to the root user account. Some systems prevent this operation. The alternative is to use the "sudo" command at the beginning of every command that must be run as root. For more information on root user, see Appendix C. Note: Some steps of the driver installation require that you manually edit files. If you're not familiar with text editing under Linux, see Appendix C. Note: On 64-bit distributions, /usr/lib64/ should be addressed instead of /usr/lib/ Contents ======== Section 01 - What's new in this release Section 02 - Description of this release Section 03 - Installation requirements Section 04 - Driver installation and configuration Section 05 - Multi-display configuration 1 - DualHead independent 2 - DualHead merged 3 - TripleHead independent 4 - TripleHead merged 5 - QuadHead independent 6 - QuadHead merged 7 - Pivot 8 - Multiple GPU configurations Section 06 - Dynamic configuration Section 07 - Xinerama Section 08 - Troubleshooting Section 09 - Frequently asked questions Appendix A - Installer options Appendix B - Installed files Appendix C - Important preliminary information for new Linux users Section 01 - What's new in this release ======================================== - Enabled support for display resolutions with non-standard aspect ratios (as reported by the monitor). - With Xinerama, OpenGL is no longer limited to the first initialized GPU. OpenGL is now supported on all GPUs. - Added support for Extio F2208 and Expander units. Section 02 - Description of this release ======================================== This release was tested with the following: Distributions: - Red Hat Enterprise Linux 5.x to 6.0 WS - SuSE Linux Enterprise Server 10, 10.4, 11, 11.1 - Fedora Core 10, 11, 12, 13, 14, 15 - Open SuSE 11, 11.1, 11.2, 11.3, 11.4 - Ubuntu 8.10, 9.04, 9.10, 10.04, 10.10, 11.04 Graphics cards: - M9120 PCIe x16 - M9120 Plus LP PCIe x16 - M9120 Plus LP PCIe x1 - M9125 PCIe x16 - M9128 LP PCIe x16 - M9138 LP PCIe x16 - M9140 LP PCIe x16 - M9148 LP PCIe x16 - M9188 ATX PCIe x16 - Extio F2208, F2408, F2408E Expander Display configurations: - Up to 4 displays per GPU, depending on the graphics card (some graphics cards are limited to 2 displays). - Joined desktop with Xinerama to provide a larger virtual desktop. For limitations with Xinerama, see Section 06. - Single, Clone, Merged, and Independent modes. - Pivot support can be controlled for each display. Display resolutions: - Analog: up to 2048x1536 (up to 1920x1200 with a quad analog upgrade cable or with the M9140 LP PCIe x16). - Digital: up to 1920x1200 (as well as 2560x1600 for DisplayPort products, and in dual-link mode for M9125 PCIe x16). Note: The driver included in this package may be compatible with additional Linux distributions, provided the installation requirements outlined in Section 02 are met. Note: Linux kernel 3.x isn't currently supported. Section 03 - Installation requirements ====================================== - X Server (7.1.0 or later). To improve performance and to add OpenGL support, a kernel module must be compiled specifically for the targeted kernel. To compile your kernel module, the following packages must be installed on your system: - Linux kernel 2.6 with the corresponding kernel source code and header files. Note: Xen kernels aren't supported. - GCC compiler version 3.2 or later (up to 4.4). - Glibc 2.3.2 or later. - Binutils 2.13 or later. - Make 3.77 or later. Section 04 - Driver installation and configuration ================================================== The following steps will help you install the driver and start your X Server in cloned display mode: 1) Install the Matrox display driver. # su root [ENTER] # sh m9xdriver-x86_32-1.3.1.run [ENTER] or, depending on your system (like Ubuntu) # sudo sh m9xdriver-x86_32-1.3.1.run [ENTER] 2) Make sure an X Server configuration file exists: # cat /etc/X11/xorg.conf [ENTER] If you get an error message (such as "No such file or directory"), you'll need to create a new default X Server configuration file. To do this, type: # cd /root # X -configure # mv /root/xorg.conf.new /etc/X11/xorg.conf 3) Open the X Server configuration file for editing. # vi /etc/X11/xorg.conf [ENTER] For more information on how to use the 'vi' text editor, see Appendix C. 4) Select the Matrox M-Series driver. In the "Device section", replace the string "Driver "somedriver"" with "Driver "m9x"". (This isn't normally necessary since running X-configure after installing the driver creates a valid configuration with the proper driver.) For example: Replace Driver "vesa" with Driver "m9x" 5) Select the appropriate graphics card address. In the "Device" section, enter the correct BusID for your card. For example, if your BusID is 1:0.0, add the following line or edit the existing line to read: BusID "PCI:1:0:0" To obtain the BusID for your card, use the following command: # lspci -d 102b:* [Enter] You'll see the following output: 0000:01:00.0 VGA compatible controller: Matrox Graphics, Inc. Unknown device 0540 (rev 01) Ignore the first string of numbers (i.e. "0000"). In this example, the BusID is PCI:1:0:0. Note: The output of lspci is in hexadecimal, and X Server config requires it in decimal. You need to convert the numbers. 6) Specify your default display pixel depth. In the "Screen" section, replace the string "DefaultDepth" with the desired bits-per-pixel value (8/16/24). For example: Section "Screen" Identifier "screen1" Device "device1" Option "monitor-mon0" "monitor1" DefaultDepth 24 EndSection 7) Restart the system. # reboot [ENTER] After the system restarts, the X Server should start automatically using the M-Series driver. If the system restarts in a text console, log in and type: # startx [ENTER] to manually start the X Server. For more information on the "Xorg config" file format, type 'man xorg.conf' in a shell terminal to view all options available in an X Server config file. For more information, see the Web sites http://xorg.freedesktop.org/wiki/ and http://www.x.org for X.org. Section 05 - Multi-display configuration ======================================== The following explains how to manually modify your X Server configuration file to configure your driver in one of the multi-display configurations supported by your Matrox driver. The configurations are based on the RandR 1.2 specification. For more information, see its documentation found on the Web or in "man xorg.conf". In RandR, each display must have a name. For the m9x driver, the names are respectively "mon0", "mon1", "mon2", and "mon3". These names must be used in the "Screen" section of the xorg.conf to describe the configuration. For independent configurations without Xinerama, each "Device" section must specify the Option "Independent". You can copy and paste any of the statements below that apply to the configuration you want to enable. Note: X Server supports keywords "Below", "RightOf", "LeftOf", and "Above". However, when using a multi-display configuration we recommend using only "Below" and "RightOf" in the ServerLayout section. Since X Server counts screens starting at the upper left corner, desktops positioned "LeftOf" and "Above" get negative coordinates and may be misplaced. If you must use "LeftOf" and "Above" to position your independent desktops, we recommend using numeric values instead. For more information, see the main page of xorg.conf. ============ XPLANATION TMP ========== You must know your display resolution in pixels. For example, if your resolution is 1680x1050, and you want to configure 4 screens in a 2x2 setup (2 screens high, 2 screens wide), the ServerLayout section will have the following entries: Screen 0 "Screen0" 1680 1050 (positioning first (primary) screen in the lower right corner of the setup) Screen 1 "Screen1" 0 1050 (positioning second screen to the left of the primary screen) Screen 2 "Screen2" 1680 0 (positioning third screen on top of the primary screen) Screen 3 "Screen3" 0 0 (positioning the fourth screen on top of the second screen) ====================================== This doesn't refer to merged setups with a single desktop made up of 4 outputs on the same GPU. In the Monitor section of config, options 'LeftOf' and 'Above' were tested and passed with no issues. 1 - DualHead independent ------------------------ While using DualHead independent mode, each display can have different refresh rates and resolutions. Each display uses a different frame buffer. The following is a partial sample of an X Server config section: Section "Monitor" Identifier "monitor1" EndSection Section "Monitor" Identifier "monitor2" EndSection Section "Device" Identifier "device1" Driver "m9x" BusID "PCI:1:0:0" Screen 0 Option "Independent" EndSection Section "Device" Identifier "device2" Driver "m9x" BusID "PCI:1:0:0" Screen 1 Option "Independent" EndSection Section "Screen" Identifier "screen1" Device "device1" Option "monitor-mon0" "monitor1" DefaultDepth 24 EndSection Section "Screen" Identifier "screen2" Device "device2" Option "monitor-mon1" "monitor2" DefaultDepth 24 EndSection Section "ServerLayout" Identifier "X.org Configured" Screen "screen1" Screen "screen2" RightOf "screen1" EndSection 2 - DualHead merged ------------------- While using DualHead merged mode, all displays use the same frame buffer. The following is a partial sample of an X Server config section: Section "Monitor" Identifier "monitor1" EndSection Section "Monitor" Identifier "monitor2" Option "RightOf" "monitor1" EndSection Section "Device" Identifier "device1" Driver "m9x" BusID "PCI:1:0:0" Screen 0 EndSection Section "Screen" Identifier "screen1" Device "device1" Option "monitor-mon0" "monitor1" Option "monitor-mon1" "monitor2" DefaultDepth 24 EndSection 3 - TripleHead independent -------------------------- TripleHead independent mode is similar to DualHead independent mode. It needs additional "Monitor", "Device", and "Screen" sections. The new "Screen" section is added to the server layout section with the desired relative position. The following is a partial sample of an X Server config section: Section "Monitor" Identifier "monitor1" EndSection Section "Monitor" Identifier "monitor2" EndSection Section "Monitor" Identifier "monitor3" EndSection Section "Device" Identifier "device1" Driver "m9x" BusID "PCI:1:0:0" Screen 0 Option "Independent" EndSection Section "Device" Identifier "device2" Driver "m9x" BusID "PCI:1:0:0" Screen 1 Option "Independent" EndSection Section "Device" Identifier "device3" Driver "m9x" BusID "PCI:1:0:0" Screen 2 Option "Independent" EndSection Section "Screen" Identifier "screen1" Device "device1" Option "monitor-mon0" "monitor1" DefaultDepth 24 EndSection Section "Screen" Identifier "screen2" Device "device2" Option "monitor-mon1" "monitor2" DefaultDepth 24 EndSection Section "Screen" Identifier "screen3" Device "device3" Option "monitor-mon2" "monitor3" DefaultDepth 24 EndSection Section "ServerLayout" Identifier "X.org Configured" Screen "screen1" Screen "screen2" RightOf "screen1" Screen "screen3" RightOf "screen2" EndSection 4 - TripleHead merged --------------------- TripleHead merged mode is similar to DualHead merged mode. It needs a third "Monitor" section with the desired relative position. This new "Monitor" section must be declared in the "Screen" section and bound to the next available output. The following is a partial sample of an X Server config section: Section "Monitor" Identifier "monitor1" EndSection Section "Monitor" Identifier "monitor2" Option "RightOf" "monitor1" EndSection Section "Monitor" Identifier "monitor3" Option "RightOf" "monitor2" EndSection Section "Device" Identifier "device1" Driver "m9x" BusID "PCI:1:0:0" Screen 0 EndSection Section "Screen" Identifier "screen1" Device "device1" Option "monitor-mon0" "monitor1" Option "monitor-mon1" "monitor2" Option "monitor-mon2" "monitor3" DefaultDepth 24 EndSection 5 - QuadHead independent ------------------------ QuadHead independent mode is similar to DualHead independent mode. It needs two additional "Monitor", "Device", and "Screen" sections. The two new "Screen" sections are added to the server layout section with the desired relative position. The following is a partial sample of an X Server config section: Section "Monitor" Identifier "monitor1" EndSection Section "Monitor" Identifier "monitor2" EndSection Section "Monitor" Identifier "monitor3" EndSection Section "Monitor" Identifier "monitor4" EndSection Section "Device" Identifier "device1" Driver "m9x" BusID "PCI:1:0:0" Screen 0 Option "Independent" EndSection Section "Device" Identifier "device2" Driver "m9x" BusID "PCI:1:0:0" Screen 1 Option "Independent" EndSection Section "Device" Identifier "device3" Driver "m9x" BusID "PCI:1:0:0" Screen 2 Option "Independent" EndSection Section "Device" Identifier "device4" Driver "m9x" BusID "PCI:1:0:0" Screen 3 Option "Independent" EndSection Section "Screen" Identifier "screen1" Device "device1" Option "monitor-mon0" "monitor1" DefaultDepth 24 EndSection Section "Screen" Identifier "screen2" Device "device2" Option "monitor-mon1" "monitor2" DefaultDepth 24 EndSection Section "Screen" Identifier "screen3" Device "device3" Option "monitor-mon2" "monitor3" DefaultDepth 24 EndSection Section "Screen" Identifier "screen4" Device "device4" Option "monitor-mon3" "monitor4" DefaultDepth 24 EndSection Section "ServerLayout" Identifier "X.org Configured" Screen "screen1" Screen "screen2" RightOf "screen1" Screen "screen3" RightOf "screen2" Screen "screen4" RightOf "screen3" EndSection 6 - QuadHead merged ------------------- QuadHead merged mode is similar to DualHead merged mode. It needs two new "Monitor" sections with the desired position. These new "Monitor" sections must be declared in the "Screen" section and bound to the next available outputs. The following is a partial sample of an X Server config section: Section "Monitor" Identifier "monitor1" EndSection Section "Monitor" Identifier "monitor2" Option "RightOf" "monitor1" EndSection Section "Monitor" Identifier "monitor3" Option "RightOf" "monitor2" EndSection Section "Monitor" Identifier "monitor4" Option "RightOf" "monitor3" EndSection Section "Device" Identifier "device1" Driver "m9x" BusID "PCI:1:0:0" Screen 0 EndSection Section "Screen" Identifier "screen1" Device "device1" Option "monitor-mon0" "monitor1" Option "monitor-mon1" "monitor2" Option "monitor-mon2" "monitor3" Option "monitor-mon3" "monitor4" DefaultDepth 24 EndSection 7 - Pivot --------- To enable display rotation, add the following option to the "Monitor" section of your X Server config file: Option "Rotate" ["normal"|"left"|"inverted"|"right"] where "right" stands for clockwise rotation, "left" for counter- clockwise rotation, and "inverted" for 180-degree rotation. The following example sets the monitor to pivot clockwise: Section "Monitor" Identifier "monitor1" Option "Rotate" "right" EndSection 8 - Multiple GPU configurations ------------------------------- The following dual-GPU configuration files (2) are designed to use 8 monitors, 4 per GPU, in a 2x4 setup (2 rows of 4 monitors each). In the following example, the second row is on top of the first. The file is a basic configuration file with only the necessary sections and lines. The first configuration creates 2 rows of 4 merged monitors each (the 4 monitors form one long desktop, one such desktop per GPU). Section "ServerLayout" Identifier "X.org Configured" Screen 0 "screen_0" Screen 1 "screen_1" Below "screen_0" # Other options are "Above", "RightOf" and "RightOf" InputDevice "Mouse0" "CorePointer" InputDevice "Keyboard0" "CoreKeyboard" EndSection Section "ServerFlags" Option "DontZap" "off" Option "Xinerama" "on" EndSection Section "InputDevice" Identifier "Keyboard0" Driver "kbd" EndSection Section "InputDevice" Identifier "Mouse0" Driver "mouse" Option "Protocol" "auto" Option "Device" "/dev/input/mice" Option "ZAxisMapping" "4 5 6 7" EndSection Section "Monitor" Identifier "monitor_0" EndSection Section "Monitor" Identifier "monitor_1" Option "RightOf" "monitor_0" EndSection Section "Monitor" Identifier "monitor_2" Option "RightOf" "monitor_1" EndSection Section "Monitor" Identifier "monitor_3" Option "RightOf" "monitor_2" EndSection Section "Monitor" Identifier "monitor_4" EndSection Section "Monitor" Identifier "monitor_5" Option "RightOf" "monitor_4" EndSection Section "Monitor" Identifier "monitor_6" Option "RightOf" "monitor_5" EndSection Section "Monitor" Identifier "monitor_7" Option "RightOf" "monitor_6" EndSection Section "Device" Identifier "device_0" Driver "m9x" BusID "PCI:1:0:0" Screen 0 EndSection Note: The screen count restarts at "0" for each GPU. Section "Device" Identifier "device_1" Driver "m9x" BusID "PCI:16:0:0" Screen 0 EndSection Section "Screen" Identifier "screen_0" Device "device_0" Option "monitor-mon0" "monitor_0" Option "monitor-mon1" "monitor_1" Option "monitor-mon2" "monitor_2" Option "monitor-mon3" "monitor_3" DefaultDepth 24 EndSection Note: The monitor count restarts at "0" for each GPU, but the count for the monitor identifier starts at "0" for the first GPU and increases across GPUs. For example, in the following sample, on "device_0", the "monitor-mon2" option is associated with "monitor_2" as its monitor identifier, but for "device_1" the "monitor-mon2" option has "monitor_6" as its monitor identifier. Section "Screen" Identifier "screen_1" Device "device_1" Option "monitor-mon0" "monitor_4" Option "monitor-mon1" "monitor_5" Option "monitor-mon2" "monitor_6" Option "monitor-mon3" "monitor_7" DefaultDepth 24 EndSection The second configuration creates 2 rows of 4 independent monitors (each monitor is a separate desktop, 4 independent desktops per GPU). Section "ServerLayout" Identifier "X.org Configured" Screen "screen_0" Screen "screen_1" RightOf "screen_0" Screen "screen_2" RightOf "screen_1" Screen "screen_3" RightOf "screen_2" Screen "screen_4" Above "screen_0" Screen "screen_5" RightOf "screen_4" Screen "screen_6" RightOf "screen_5" Screen "screen_7" RightOf "screen_6" InputDevice "Mouse0" "CorePointer" InputDevice "Keyboard0" "CoreKeyboard" EndSection Section "InputDevice" Identifier "Keyboard0" Driver "kbd" EndSection Section "InputDevice" Identifier "Mouse0" Driver "mouse" Option "Protocol" "auto" Option "Device" "/dev/input/mice" Option "ZAxisMapping" "4 5 6 7" EndSection Section "Monitor" Identifier "monitor_0" EndSection Section "Monitor" Identifier "monitor_1" EndSection Section "Monitor" Identifier "monitor_2" EndSection Section "Monitor" Identifier "monitor_3" EndSection Section "Monitor" Identifier "monitor_4" EndSection Section "Monitor" Identifier "monitor_5" EndSection Section "Monitor" Identifier "monitor_6" EndSection Section "Monitor" Identifier "monitor_7" EndSection Section "Device" Identifier "device_0" Driver "m9x" BusID "PCI:13:0:0" Option "Independent" "on" Screen 0 EndSection Section "Device" Identifier "device_1" Driver "m9x" BusID "PCI:13:0:0" Option "Independent" "on" Screen 1 EndSection Section "Device" Identifier "device_2" Driver "m9x" BusID "PCI:13:0:0" Option "Independent" "on" Screen 2 EndSection Section "Device" Identifier "device_3" Driver "m9x" BusID "PCI:13:0:0" Option "Independent" "on" Screen 3 EndSection Note: The screen count restarts at "0" for each GPU. Section "Device" Identifier "device_4" Driver "m9x" BusID "PCI:12:0:0" Option "Independent" "on" Screen 0 EndSection Section "Device" Identifier "device_5" Driver "m9x" BusID "PCI:12:0:0" Option "Independent" "on" Screen 1 EndSection Section "Device" Identifier "device_6" Driver "m9x" BusID "PCI:12:0:0" Option "Independent" "on" Screen 2 EndSection Section "Device" Identifier "device_7" Driver "m9x" BusID "PCI:12:0:0" Option "Independent" "on" Screen 3 EndSection Section "Screen" Identifier "screen_0" Device "device_0" Option "monitor-mon0" "monitor_0" DefaultDepth 24 EndSection Section "Screen" Identifier "screen_1" Device "device_1" Option "monitor-mon1" "monitor_1" DefaultDepth 24 EndSection Section "Screen" Identifier "screen_2" Device "device_2" Option "monitor-mon2" "monitor_2" DefaultDepth 24 EndSection Section "Screen" Identifier "screen_3" Device "device_3" Option "monitor-mon3" "monitor_3" DefaultDepth 24 EndSection Section "Screen" Identifier "screen_4" Device "device_4" Option "monitor-mon0" "monitor_4" DefaultDepth 24 EndSection Section "Screen" Identifier "screen_5" Device "device_5" Option "monitor-mon1" "monitor_5" DefaultDepth 24 EndSection Section "Screen" Identifier "screen_6" Device "device_6" Option "monitor-mon2" "monitor_6" DefaultDepth 24 EndSection Section "Screen" Identifier "screen_7" Device "device_7" Option "monitor-mon3" "monitor_7" DefaultDepth 24 EndSection Section 06 - Dynamic configuration ================================== To dynamically change the desktop configuration while running X Server, use the "xrandr" command-line tool or the GUI installed with the distribution if it's xrandr 1.2 compatible. Important: Some distributions don't have xrandr 1.2 (for example, Red Hat Enterprise 5.* and Suse Linux Enterprise 10.*). With xrandr versions earlier than 1.2, you can only change the resolution dynamically. Also, positioning and rotation options are available *only* through statements in the config file. For information on the monitors currently connected and the supported modes for each monitor, type the following in a shell: # xrandr [ENTER] This generates a list of all connected monitors (for example, "mon0, mon1, ...") and their supported modes. However, because X Server version 7.1.x doesn't support the xrandr 1.2 protocol, it only provides information about the first monitor. To change the resolution of a specific monitor, specify a mode from the mode list and the monitor's xrandr name. For example, to change the mode of monitor "mon0" to "1024x768", type: # xrandr --output mon0 --mode 1024x768 You can also control the pivot of a specific monitor. For example, to pivot the second monitor clockwise, type: # xrandr --output mon1 --rotate right You can also change the relative position of each monitor to combine your monitors into a larger desktop. For example, to swap the second monitor from left to right while in DualHead mode, type: # xrandr --output mon1 --right-of mon0 For more information, see the documentation for "xrandr". Section 07 - Xinerama ====================== Xinerama can be used to join the frame buffers of multiple GPUs to provide a larger virtual desktop for X Server. To use Xinerama, you must configure each GPU individually. You can do this by defining a Screen, a Device, and a Monitor section for each GPU in the config file. You must also add a ServerLayout section in the X Server config file specifying the placement of each screen relative to each other. You must also specify the Xinerama option in this section. A possible ServerLayout section with Xinerama enabled could look like this: Section "ServerLayout" Option "Xinerama" "on" Identifier "ServerLayout0" Screen "Screen0" Screen "Screen1" RightOf "Screen0" InputDevice "Mouse0" "CorePointer" InputDevice "Keyboard0" "CoreKeyboard" EndSection The following limitations apply when using Xinerama: - All "Screen" sections must use the same DefaultDepth. - The dynamic reconfiguration of the monitors using xrandr isn't supported (see Section 05). - The "Indepedent" option can't be used in the config file. That is, each GPU can only support one frame buffer at a time. Note: With Xinerama, OpenGL is no longer limited to the first initialized GPU. OpenGL is now supported on all GPUs. Section 08 - Troubleshooting ============================ Note: On 64-bit distributions, /usr/lib64/ should be addressed instead of /usr/lib/ Setup problems -------------- Problems may occur if you don't use the appropriate version of a library or if a component is missing. Make sure you have the following files: # ls -l /usr/lib/xorg/modules/drivers/m9x_drv.so [ENTER] # ls -l /lib/modules/`uname -r`/kernels/drivers/video/m9x.ko [ENTER] # ls -l /usr/lib/xorg/modules/extensions/libglx.a [ENTER] # ls -l /usr/lib/libGL.so -> /usr/lib/libGL.so.1 [ENTER] # ls -l /usr/lib/libGL.so.1 -> /usr/lib/libGL.so.2.0.0 [ENTER] # ls -l /usr/lib/libGL.so.2.0.0 [ENTER] Resolving conflicts with /usr/lib/libGL.so ------------------------------------------ If other shared libraries (files with the ".so" extension) are conflicting with Matrox libraries, "ldconfig" (the library manager) may create incorrect symlinks. We recommend you manually remove or move conflicting libraries, rerun "ldconfig", and check that correct symlinks were made. Verifying that applications are using appropriate libraries ----------------------------------------------------------- Use the 'ldd' command on a 3D application to check that it's using the appropriate libraries. For example, "ldd glxgears | grep libGL.so" should give you: libGL.so.1 => /usr/lib/libGL.so.1 [ENTER] The "/usr/lib/libGL.so.1" should be a symbolic link pointing to "/usr/share/MSeries/current/libGL.so.2.0.0". If this isn't the case, either remove the conflicting library or adjust the LD_LIBRARY_PATH environment variable. For more information, see the "ldconfig" and "ldd" man pages. Forcing digital monitors ------------------------ Digital monitors are automatically detected by your Matrox driver. If your monitor isn't automatically detected by the driver, you can force your monitor type in the "Device" section of the configuration file. Option "mon0_forcedvi" "on" Option "mon1_forcedvi" "on" Option "mon2_forcedvi" "on" or Option "mon3_forcedvi" "on" Each number in the option name corresponds respectively to the output number used by the display. Disabling/enabling a kernel module ---------------------------------- With a kernel module, the processor can share some tasks with the graphics chipset, resulting in higher performance. To enable the kernel module, it must be compiled specifically for your system. In most configurations, the installation script compiles the kernel driver if the kernel source code is installed as mentioned in Section 02. To disable the kernel module, add the following option to the X Server config file in the appropriate "Device" section: Option "UseKernelModule" "off" If no option is specified, the kernel module is enabled by default if your system supports it. The following is an example of a "Device" section disabling the kernel module: Section "Device" Identifier "device1" Driver "m9x" BusID "PCI:1:0:0" Option "UseKernelModule" "off" EndSection If you don't use use the kernel module, you won't be able to run OpenGL applications. Xorg crashes at startup when SELinux is set to enforcing ----- ------------------------------------------------- SELinux mode is controlled by config. file /etc/selinux/config. By default, in this file "SELINUX" is set to "enforcing". SELinux mode can also be controlled from the GRUB kernel line by adding SELINUX="desired mode" (enforcing, permissive or disabled without quotes) at the end of the line. SELinux in enforcing mode prevents mapping of low address memory needed by the driver. To enable mapping of low address memory, issue the following command before starting X: # setsebool -P mmap_low_allowed 1 [enter] This takes a few seconds and will stay set after the system restarts. This fixes the following error: (EE) M9X(0): Can't map Shadow BIOS Problems with video and OpenGL under Ubuntu 11.04 (and later) ------------------------------------------------------------ When using Ubuntu 11.04 and Gnome, video and OpenGL may flicker and overlap other windows. To fix this, edit the window manager config. 1) Open gconf-editor. Press to open the "Run Application" window. Type "gconf-editor", then press . 2) In gconf-editor, choose apps > metacity > general, and unset the capture_before_unmap flag on the right. 3) For the changes to take effect, log out and then log back in. You need to do this for each user. Section 09 - Frequently asked questions ======================================= Q: Do you support AIGLX extension? A: No, 3D based desktops aren't supported. Q: Why does the installer stop when I try to run it? A: Your kernel source and headers may not be properly installed or they may not be supported. Q: What determines the color of the Matrox logo screen that appears when my X Server starts? A: The color depends on whether or not the kernel module is being used. Blue = The kernel module is being used. Bus mastering is in PCI mode. Magenta = The kernel module isn't being used or isn't available. Bus mastering is in local video memory. Q: Do you support the RandR 1.2 extension? A: Yes, the RandR 1.2 extension is fully supported, except when Xinerama is used. Q: Which driver should I set when installing Linux? A: During installation of your Linux distribution, you may be asked to set or choose a graphics card or driver. The safest option is to choose the VESA driver or card. Q: I upgraded the X Server and now my configuration file no longer works. What can I do? A: When upgrading your X Server, you need to reinstall the Matrox driver package to make sure the appropriate driver components are installed. Q: After upgrading my Linux kernel, X Server no longer uses the kernel driver module and bus mastering is being done in local video memory (magenta logo screen). How do I re-enable the kernel driver? A: When upgrading your Linux kernel, you need to reinstall the Matrox driver package to make sure the appropriate kernel driver is compiled using your latest kernel. Q: My kernel module isn't loaded. A: Try to modprobe the kernel driver from a shell using the command # modprobe m9x [enter] to determine the cause of the problem. On some distributions, you may need to edit the file /etc/modprobe.d/unsupported-modules to allow the proprietary kernel module to load. Appendix A - Installer options ============================== The following are valid options supported in the command line to be passed to the installer (used without quotation marks): --extract-only Extracts the files but doesn't run the installer portion. --uninstall Uninstalls the current driver. --installxonly Installs only the X Server driver without the kernel modules. Mostly used for thin client setups and to bypass installations where the kernel module couldn't be compiled. --nobackup Forces a driver installation without the creation of a backup script. Appendix B - Installed files ============================ Note: On 64-bit distributions, /usr/lib64/ should be addressed instead of /usr/lib/. The Matrox Linux driver package consists of the following files: - An X Server driver. This driver is mainly responsible for the mode initialization and 2D acceleration. It's usually located in the following X driver path : /usr/lib/xorg/modules/drivers/m9x_drv.so - A kernel module. The kernel module adds bus mastering, memory management, and interrupts management. The kernel module is made up of two parts: a binary and an open source interface part. These parts are necessary because the kernel needs to be compiled specifically on your system. The kernel module is usually located in the following path: /lib/module//kernel/drivers/video/m9x.ko . - A GLX extension module. The GLX extension module is an interface between the OpenGL library and the X Server. The GLX extension module is usually located in the following X Server extensions path /usr/lib/xorg/modules/extensions/libglx.so . - An OpenGL library. This library allows 3D applications to use the OpenGL API. It processes the commands and sends them to the kernel module and X Server. The OpenGL library is usually located in the following software library path /usr/lib/libGL.so.2.0.0 with two symlinks to /usr/lib/libGL.so and /usr/lib/libGL.so.1 . Appendix C - Important preliminary information for new Linux users ================================================================== Text editors ------------ Configuring a Linux system often requires editing text files. The following describes some text editors available to Linux users. gedit and kate -------------- Simple to use but require a graphical environment that may not be available. mcedit and nano --------------- Run in text mode and are relatively easy to use. However, they're not installed by default in most distributions. vi -- One of the most powerful text editors available. Installed by default by most distributions, but not user friendly. What follows is a basic overview to get you started. 'vi' operates in two modes: edit and command. On startup, 'vi' is in command mode. To enter edit mode, press [i]. You can then add, modify, and remove text. To go back to command mode, press [Esc]. You can now access the type of functionality offered in a graphical application. Basic commands: i - Enter edit mode Esc - Enter command mode :w - Save :q - Quit root user --------- Once installed, most distributions set up a default administrative user with the username 'root'. Many options (such as installing the Matrox kernel driver) are available only to 'root' users. There are 3 ways to become 'root': - Log in as 'root'. - Use the substitute user command ('su') at the command prompt. This is the method used in the examples. - On some systems, use the 'sudo' utility. With this utility, you can run a specified program as 'root'. To use 'sudo', simply prefix the command you need with the 'sudo' keyword. For example: # sudo sh m9xdriver-x86_32-1.3.0.run [ENTER] We recommend you use the 'root' account only while installing your driver package. Return to your user account when the installation is completed.