                         README for X11R7.2 on OpenBSD

            -------------------------------------------------------

   Table of Contents

   [1]What and Where is X11R77.2?

   [2]Bug Reports for This Document

   [3]New OS dependent features

   [4]Configuring X for Your Hardware

   [5]Running X

   [6]Kernel Support for X

   [7]Rebuilding the X Distribution You should configure the distribution by
   editing xc/config/cf/host.def before compiling. To compile the sources,
   invoke ``make World'' in the xc directory.

   [8]Thanks

What and Where is X11R77.2?

   The X.Org Foundation X11R77.2 is an Open Source version of the X Window
   System that supports several UNIX(R) and UNIX-like operating systems (such
   as Linux, the BSDs and Solaris x86) on Intel and other platforms.

   See the [9]Copyright Notice.

   The sources for X11R77.2 are available from [10]http://wiki.x.org

   X11R77.2 builds on most architectures supported by OpenBSD. See section
   [11]Building on other architectures for details.

   --------------------------------------------------------------------------

Bug Reports for This Document

   Use the X.Org Bugzilla at [12]http://bugs.freedesktop.org to submit
   comments or suggestions about this file, using the xorg product.

   --------------------------------------------------------------------------

New OS dependent features

   See the [13]Release Notes for non-OS dependent new features in X11R77.2.



     * Switch the the Xinput-aware kbd driver for keyboard input



   --------------------------------------------------------------------------

  New OS related features in X.Org 6.8



     * Support for Propolice in modules.

     * Server support for OpenBSD/amd64.



   --------------------------------------------------------------------------

Configuring X for Your Hardware

   The /etc/X11/xorg.conf 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.

   You'll need info on your hardware:

     * Your mouse type, baud rate and its /dev entry.

     * The video card's chipset (e.g. ATI Radeon, nVidia GeForce 4/MX etc).

     * Your monitor's sync frequencies.



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

   For details about the xorg.conf file format, refer to the [14]xorg.conf(5)
   manual page.

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

   --------------------------------------------------------------------------

  About mouse configuration

   X11R77.2 has support for the mouse driver included in the new wscons
   console driver. Specify ``wsmouse'' as the protocol and ``/dev/wsmouse''
   as the device in /etc/X11/xorg.conf with a PS/2 or USB mouse.

   See [15]README.mouse for general instruction on mouse configuration.

   --------------------------------------------------------------------------

Running X

  Starting xdm, the display manager

   To start the display manager, log in as root on the console and type:
   ``xdm -nodaemon''.

   You can start xdm automatically on bootup by adding the line:

   xdm_flags=""            # for normal use: xdm_flags=""

   in /etc/rc.conf.local.

   --------------------------------------------------------------------------

  Running X without the display manager

   The easiest way for new users to start X windows is to type: ``startx >&
   startx.log''. Error messages are lost unless you redirect them because the
   server takes over the screen.

   To get out of X windows, type: ``exit'' in the console xterm. You can
   customize your X by creating .xinitrc, .xserverrc, and .twmrc files in
   your home directory as described in the xinit and startx man pages.

   --------------------------------------------------------------------------

Kernel Support for X

   OpenBSD's GENERIC kernels have all support for running X enabled.

   --------------------------------------------------------------------------

  Console drivers

   The server supports wscons, the standard OpenBSD/i386 console driver.

   --------------------------------------------------------------------------

  Aperture Driver

   By default OpenBSD includes the BSD 4.4 kernel security feature that
   disables access to the /dev/mem device when in multi-user mode. But the X
   server requires linear access to the display memory in most cases.

   OpenBSD requires the aperture driver to be enabled for all X servers,
   because the aperture driver also controls access to the I/O ports of the
   video boards.

   To enable the aperture driver, once included in the kernel, set

   machdep.allowaperture=2

   in /etc/sysctl.conf. See the [16]xf86(4) manual page for details.

   Another (less recommended) way to enable linear memory and I/O ports
   access is to disable the kernel security feature by initializing
   securelevel to -1 in /etc/rc.securelevel.

   "Caveat: the aperture driver only allows one access at a time (so that the
   system is in the same security state once X is launched). This means that
   if you run multiple servers on multiple virtual terminals, only the first
   one will have linear memory access. Set securelevel to -1 if you need more
   that one X server at a time."

   --------------------------------------------------------------------------

  MIT-SHM

   OpenBSD supports System V shared memory. If X detects this support in your
   kernel, it will support the MIT-SHM extension.

   --------------------------------------------------------------------------

Rebuilding the X Distribution You should configure the distribution by editing
xc/config/cf/host.def before compiling. To compile the sources, invoke ``make
World'' in the xc directory.

   Note that OpenBSD project now has its own source tree, with some local
   modifications. You may want to start with this tree to rebuild from
   sources. The OpenBSD XF4 source tree is available by anoncvs from all
   OpenBSD anoncvs servers. See [17]http://www.openbsd.org/anoncvs.html for
   details on anoncvs.

   X11R77.2 compiles on most OpenBSD architectures. The X.Org X server builds
   and run on the following systems. On other architectures supported by
   OpenBSD, only client side libraries and applications are supported.

   --------------------------------------------------------------------------

  OpenBSD/alpha

   The X server is known to work on some VGA cards in alpha machines that
   support BWX I/O, with OpenBSD 3.2 and higher.

   The following cards have been successfully tested for now:

     * 3DLabs Permedia 2 (8, 15, 16 and 24 bits depth)

     * ATI Rage Pro (works with 'Option "NoAccel"')

     * Cirrus Logic CL5430 (works with 'Option "NoAccel"')

     * Cirrus Logic GD5446 (8, 16 and 24 bits depth)

     * Matrox MGA 2064 (8, 16 and 24 bits depth)



   Note that this version of doesn't work on TGA cards. The version shipped
   with OpenBSD 3.1 and higher includes an OS-specific driver wsfb that is
   used to support TGA cards.

   --------------------------------------------------------------------------

  OpenBSD/macppc

   The X server is currently known to work on most of the G4 Macs and iBooks
   with ATI or nVidia cards. Other machines are more or less untested.

   Use xorgconfig to build a /etc/X11/xorg.conf file before starting the
   server for the first time.

   For the Titanium Powerbook G4, you can try the following mode line in
   /etc/X11/xorg.conf to match the flat panel resolution:



   Modeline "1152x768" 64.995 1152 1213 1349 1472  768 771 777 806 -HSync -VSync



   --------------------------------------------------------------------------

  OpenBSD/sparc

   OpenBSD 3.2 on sparc switched to the wscons device driver and now uses the
   OS specific wsfb driver in the X server. This driver is not included in
   X11R77.2. Please use the version shipped with OpenBSD instead.

   --------------------------------------------------------------------------

  OpenBSD/sparc64

   This version only has support PCI based machines using ATI cards on
   OpenBSD/sparc64. Note that the version shipped with OpenBSD has support
   for the X server on both SBus and UPA (unaccelerated) based cards.

   --------------------------------------------------------------------------

Thanks

   Many thanks to all people who contributed to make X11R77.2 work on *BSD,
   in particular: David Dawes, Todd Fries, Miodrag Vallat, Rod Grimes,
   Charles Hannum, Amancio Hasty, Christoph Robitschko, Matthias Scheler,
   Michael Smith, Ignatios Souvatzis, Jack Velte, Nate Williams and Pace
   Willison.

References

   Visible links
   1. file:///tmp/html-DR3497#AEN7
   2. file:///tmp/html-DR3497#AEN16
   3. file:///tmp/html-DR3497#AEN20
   4. file:///tmp/html-DR3497#AEN36
   5. file:///tmp/html-DR3497#AEN68
   6. file:///tmp/html-DR3497#AEN86
   7. file:///tmp/html-DR3497#AEN111
   8. file:///tmp/html-DR3497#AEN152
   9. file:///tmp/COPYRIGHT.html
  10. http://wiki.x.org/
  11. file:///tmp/html-DR3497#OTHERARCH
  12. http://bugs.freedesktop.org/
  13. file:///tmp/RELNOTES.html
  14. file:///tmp/xorg.conf.5.html
  15. file:///tmp/mouse.html
  16. http://www.openbsd.org/cgi-bin/man.cgi?query=xf86&apropos=0&sektion=4&manpath=OpenBSD+Current&arch=i386&format=html
  17. http://www.openbsd.org/anoncvs.html
