   README for X11R7.2 on OpenBSDMatthieu HerrbLast modified on: 4
   February  2005.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  Copyright  Notice.The sources for X11R77.2
   are  available  from  http://wiki.x.orgX11R77.2 builds on most
   architectures   supported   by   OpenBSD.   See   section  for
   details.Bug Reports for This DocumentUse the X.Org Bugzilla at
   http://bugs.freedesktop.org  to submit comments or suggestions
   about  this  file,  using  the  xorg  product.New OS dependent
   featuresSee   the  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   HardwareThe
   /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  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
   configurationX11R77.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 README.mouse
   for   general   instruction   on  mouse  configuration.Running
   XStarting   xdm,  the  display  managerTo  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
   managerThe  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 XOpenBSD's GENERIC
   kernels   have  all  support  for  running  X  enabled.Console
   driversThe  server  supports wscons, the standard OpenBSD/i386
   console driver. Aperture DriverBy 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 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-SHMOpenBSD
   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
   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/alphaThe 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/macppcThe 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/sparcOpenBSD  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/sparc64This   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. ThanksMany
   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.
