home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 45 / cda45.iso / Linux / XFree86-4.0 / doc / README.OpenBSD < prev    next >
Encoding:
Text File  |  2000-03-09  |  7.7 KB  |  234 lines
  1.                       README for XFree86 4.0 on OpenBSD
  2.  
  3.                                Matthieu Herrb
  4.  
  5.                      Last modified on: 20 February 2000
  6.  
  7. 1.  What and Where is XFree86?
  8.  
  9. XFree86 is a port of X11R6.4 that supports several versions of Intel-based
  10. Unix.  It is derived from X386 1.2, which was the X server distributed with
  11. X11R5.  This release consists of many new features and performance improve-
  12. ments as well as many bug fixes.
  13.  
  14. See the Copyright Notice.
  15.  
  16. The sources for XFree86 4.0 are available by anonymous ftp from:
  17.  
  18. ftp://ftp.XFree86.org/pub/XFree86/4.0
  19.  
  20. Binaries for OpenBSD/i386 2.6 and later are available from:
  21.  
  22. ftp://ftp.XFree86.org/pub/XFree86/4.0/binaries/OpenBSD
  23.  
  24. A list of mirror sites is provided by ftp://ftp.XFree86.org/pub/XFree86/MIR-
  25. RORS
  26.  
  27. XFree86 also builds on other OpenBSD architectures. See section Building on
  28. other architectures (section , page ) for details.
  29.  
  30. 2.  Bug Reports for This Document
  31.  
  32. Send email to <herrb@xfree86.org> (Matthieu Herrb) or <XFree86@XFree86.org>
  33. if you have comments or suggestions about this file and we'll revise it.
  34.  
  35. 3.  New OS dependent features
  36.  
  37. See the Release Notes for non-OS dependent new features in XFree86 4.0.
  38.  
  39. 3.1  New OS dependent features in 4.0
  40.  
  41.    o Multi-thread safe libraries are built by default on OpenBSD 2.6 and
  42.      later,
  43.  
  44.    o Preliminary APM support.
  45.  
  46. 3.2  New OS dependent features in 3.9.18
  47.  
  48.    o Support for USB mices has been added on OpenBSD.
  49.  
  50.    o Soft-booting secondary cards through the int10 BIOS interface is now
  51.      possible using the x86emu real mode emulator.
  52.  
  53. 3.3  New OS dependent features in 3.9.17
  54.  
  55.    o Silken mouse is supported for serial mices, and, under post 2.6 OpenBSD-
  56.      current for PS/2 mices.
  57.  
  58.    o MTRR Write Combining is enabled under post 2.6 OpenBSD-current.
  59.  
  60. 4.  Installing the Binaries
  61.  
  62. Refer to the Installation Document for detailed installation instructions.
  63.  
  64. 5.  Configuring X for Your Hardware
  65.  
  66. The /etc/XF86Config file tells the X server what kind of monitor, video card
  67. and mouse you have.  You must create it to tell the server what specific
  68. hardware you have.
  69.  
  70. You'll need info on your hardware:
  71.  
  72.    o Your mouse type, baud rate and its /dev entry.
  73.  
  74.    o The video card's chipset (e.g. ET4000, S3, etc).
  75.  
  76.    o Your monitor's sync frequencies.
  77.  
  78. For details about the XF86Config file format, refer to the XF86Config(5) man-
  79. ual page.
  80.  
  81. Once you've set up a XF86Config file, you can fine tune the video modes with
  82. the xvidtune utility.
  83.  
  84. 5.1  About mouse configuration
  85.  
  86. If your serial mouse does not work try using kermit or tip to connect to the
  87. mouse serial port and verify that it does indeed generate characters.
  88.  
  89. The OpenBSD pms driver  provides both ``raw'' and ``cooked'' (translated)
  90. modes.  ``raw'' mode does not do protocol translation, so XFree86 would use
  91. the PS/2 protocol for talking to the device in that mode.  ``Cooked'' mode is
  92. the old BusMouse translation.  The driver runs in ``raw'' mode when using the
  93. /dev/psm0 device name.
  94.  
  95. See README.mouse  for general instruction on mouse configuration in XFree86.
  96.  
  97. 6.  Running X
  98.  
  99. 6.1  Starting xdm, the display manager
  100.  
  101. To start the display manager, log in as root on the console and type: ``xdm
  102. -nodaemon''.
  103.  
  104. You can start xdm automatically on bootup by changing the line
  105.  
  106.      xdm_flags=NO            # for normal use: xdm_flags=""
  107.  
  108. to:
  109.  
  110.      xdm_flags=""            # for normal use: xdm_flags=""
  111.  
  112. in /etc/rc.conf.
  113.  
  114. Note that the binary distributions of XFree86 for OpenBSD on ftp.xfree86.org
  115. and its mirrors don't include support for the XDM-AUTHORIZATION-1 protocol,
  116. because of the US export rules.
  117.  
  118. 6.2  Running X without the display manager
  119.  
  120. The easiest way for new users to start X windows is to type: ``startx >&
  121. startx.log''.  Error messages are lost unless you redirect them because the
  122. server takes over the screen.
  123.  
  124. To get out of X windows, type: ``exit'' in the console xterm.  You can cus-
  125. tomize your X by creating .xinitrc, .xserverrc, and .twmrc files in your home
  126. directory as described in the xinit and startx man pages.
  127.  
  128. 7.  Kernel Support for X
  129.  
  130. To make sure X support is enabled under  OpenBSD, the following line must be
  131. in your config file in /sys/arch/i386/conf:
  132.  
  133.      option XSERVER
  134.      option APERTURE
  135.  
  136. 7.1  Console drivers
  137.  
  138. The server supports the two standard  OpenBSD/i386 console drivers: pcvt and
  139. pccons. They are detected at runtime and no configuration of the server
  140. itself is required.
  141.  
  142. The pcvt console driver is the default in OpenBSD.  It offers several virtual
  143. consoles and international keyboard support.
  144.  
  145. 7.2  Aperture Driver
  146.  
  147. By default OpenBSD includes the BSD 4.4 kernel security feature that disable
  148. access to the /dev/mem device when in multi-users mode. But the XFree86
  149. server require linear access to the display memory in most cases.
  150.  
  151. OpenBSD now requires the aperture driver to be enabled for all X servers,
  152. because the aperture driver also controls access to the I/O ports of the
  153. video boards.
  154.  
  155. To enable the aperture driver, once included in the kernel, set
  156.  
  157.      machdep.allowaperture=1
  158.  
  159. in /etc/sysctl.conf.
  160.  
  161. Another (less recommended) way to enable linear memory and I/O ports access
  162. is to disable the kernel security feature by adding ``option INSECURE'' in
  163. your kernel configuration file and build a new kernel.  You will also need to
  164. comment out the line initializing securelevel to 1 in /etc/rc.securelevel.
  165.  
  166.      Caveat: the aperture driver only allows one access at a time (so
  167.      that the system is in the same security state once X is launched).
  168.      This means that if you run multiple servers on multiples VT, only
  169.      the first one will have linear memory access.  Use 'option INSE-
  170.      CURE' if you need more that one X server at a time.
  171.  
  172. 7.3  MIT-SHM
  173.  
  174. OpenBSD supports System V shared memory. If XFree86 detects this support in
  175. your kernel, it will support the MIT-SHM extension.
  176.  
  177. To add support for system V shared memory to your kernel add the lines:
  178.  
  179.       # System V-like IPC
  180.       options         SYSVMSG
  181.       options         SYSVSEM
  182.       options         SYSVSHM
  183.  
  184. to your kernel config file.
  185.  
  186. 8.  Rebuilding the XFree86 Distribution
  187.  
  188. The server developer's kit allow you to rebuild just the X server with a min-
  189. imum amount of disk space.  Just unpack it, make the appropriate changes to
  190. the xf86site.def, type ``./mkmf'' and ``make'' to link the server.  See
  191. /usr/X11R6/lib/Server/README for more info.
  192.  
  193. You should configure the distribution by editing xc/config/cf/host.def
  194. before compiling.  To compile the sources, invoke ``make World'' in the xc
  195. directory.
  196.  
  197. 8.1  Console drivers
  198.  
  199. XFree86 has a configuration option to select the console drivers to use in
  200. xf86site.def:
  201.  
  202.    o  if you're using pccons only put:
  203.  
  204.            #define XFree86ConsoleDefines -DPCCONS_SUPPORT
  205.  
  206.    o if you're using pcvt only put:
  207.  
  208.            #define XFree86ConsoleDefines -DPCVT_SUPPORT
  209.  
  210. If you don't define XFree86ConsoleDefines in xf86site.def the pccons and pcvt
  211. drivers will be supported.
  212.  
  213. 8.2  Building on other architectures
  214.  
  215. XFree86 should also compiles on other OpenBSD architectures. However, please
  216. note that 3.9.x snapshots have only been tested on the i386 for now.
  217.  
  218. 9.  Building New X Clients
  219.  
  220. The easiest way to build a new client (X application) is to use xmkmf if an
  221. Imakefile is included in the sources.  Type ``xmkmf -a'' to create the Make-
  222. files, check the configuration if necessary and type ``make''.  Whenever you
  223. install additional man pages you should update whatis.db by running ``make-
  224. whatis /usr/X11R6/man''.
  225.  
  226. 10.  Thanks
  227.  
  228. Many thanks to all people who contributed to make XFree86 work on *BSD, in
  229. particular, David Dawes, Pace Willison, Amancio Hasty, Christoph Robitschko,
  230. Nate Williams, Rod Grimes, Jack Velte and Michael Smith.
  231.  
  232.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OpenBSD.sgml,v 1.10 2000/03/03 21:28:10 dawes Exp $
  233.  
  234.