README for XFree86 on NetBSD : Configuring X for Your Hardware
Previous: Installing the Binaries
Next: Running X

5. Configuring X for Your Hardware

The /etc/XF86Config file tells the X server what kind of monitor, video card and mouse you have. You must create it to tell the server what specific hardware you have.

The easiest way to create this file is to run the XF86Setup utility as root. Refer to QuickStart.doc for details about its use.

You'll need info on your hardware:

The recommended way to generate an XF86Config file is to use the XF86Setup utility. The xf86config text utility is still there for the (few) cases where XF86Setup can't be used. Also, there is a sample file installed as /usr/X11R6/lib/X11/, which can be used as a starting point.

For details about the XF86Config file format, refer to the XF86Config(5) manual page.

Once you've set up a XF86Config file, you can fine tune the video modes with the xvidtune utility.

5.1. About mouse configuration

If your serial mouse does not work try using kermit or tip to connect to the mouse serial port and verify that it does indeed generate characters.

The NetBSD pms mouse driver handles PS/2 style mice as Busmouse. Specify the protocol as ``busmouse'' in the mouse section of your XF86Config file if you're using a PS/2 mouse.

Only standard PS/2 mice are supported by this driver. Newest PS/2 mice that send more than three bytes at a time (especially Intellimouse, or MouseMan+ with a ``3D'' roller) are not supported yet.

XFree86 3.3.4 and later also have support for the mouse driver included in the new wscons console driver introduced by NetBSD 1.4. Specify ``wsmouse'' as the protocol and ``/dev/wsmouse0'' as the device in /etc/XF86Config if you're using NetBSD 1.4 with wscons.

See README.mouse for general instruction on mouse configuration in XFree86.

5.2. Other input devices

XFree86 supports the dynamic loading of drivers for external input devices using the XInput extension. Currently supported devices are:

To use a specific device, add the line

load "module"
in the Module section of XF86Config, where module is the name of the .so file corresponding to your device. You also need to set up a XInput section in XF86Config. Refer to the XF86Config(5) man page for detailed configuration instructions.

You can then change the device used to drive the X pointer with the xsetpointer(1) command.

For joystick support, you'll need to install the joystick device driver in the kernel. It is included in NetBSD 1.2. See joy(4) for details.

5.3. Configuring PEX and XIE extensions

The PEX and XIE extensions are supported as external modules. If you want to have access to these extensions, add the following lines to the Module section of XF86Config:

   load    ""
   load    ""

README for XFree86 on NetBSD : Configuring X for Your Hardware
Previous: Installing the Binaries
Next: Running X