home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 45 / cda45.iso / Linux / XFree86-4.0 / doc / README.NetBSD < prev    next >
Encoding:
Text File  |  2000-03-09  |  10.9 KB  |  323 lines
  1.                       README for XFree86 4.0 on NetBSD
  2.  
  3. Rich  Murphey, David Dawes, Marc  Wandschneider, Mark  Weaver, 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 are available by anonymous ftp from:
  17.  
  18. ftp://ftp.XFree86.org/pub/XFree86/4.0
  19.  
  20. Binaries for NetBSD 1.3 and later are available from:
  21. ftp://ftp.XFree86.org/pub/XFree86/4.0/binaries/NetBSD
  22.  
  23. A list of mirror sites is provided by ftp://ftp.XFree86.org/pub/XFree86/MIR-
  24. RORS
  25.  
  26. XFree86 also builds on other NetBSD architectures. See section Building on
  27. other architectures (section , page ) for details.
  28.  
  29. XFree86 also supports NetBSD on PC98 machines.
  30.  
  31. 2.  Bug Reports for This Document
  32.  
  33. Send email to <herrb@XFree86.Org> (Matthieu Herrb) or <XFree86@XFree86.org>
  34. if you have comments or suggestions about this file and we'll revise it.
  35.  
  36. 3.  New OS dependent features
  37.  
  38. See the Release Notes for non-OS dependent new features in XFree86 4.0.
  39.  
  40. 3.1  New OS dependent features in 4.0
  41.  
  42.    o Preliminary APM support.
  43.  
  44. 3.2  New OS dependent features in 3.9.18
  45.  
  46.    o Soft-booting secondary cards through the int10 BIOS interface is now
  47.      possible using the x86emu real mode emulator.
  48.  
  49. 3.3  New OS dependent features in 3.9.17
  50.  
  51.    o Support for silken mouse with the wsmouse protocol has been added.
  52.  
  53.    o A new version of the XFree86 Aperture driver which provides MTRR support
  54.      is included.
  55.  
  56. 4.  Installing the Binaries
  57.  
  58. Refer to the Installation Document for detailed installation instructions.
  59.  
  60. 5.  Configuring X for Your Hardware
  61.  
  62. The /etc/XF86Config file tells the X server what kind of monitor, video card
  63. and mouse you have.  You must create it to tell the server what specific
  64. hardware you have.
  65.  
  66. You'll need info on your hardware:
  67.  
  68.    o Your mouse type, baud rate and its /dev entry.
  69.  
  70.    o The video card's chipset (e.g. ET4000, S3, etc).
  71.  
  72.    o Your monitor's sync frequencies.
  73.  
  74. For details about the XF86Config file format, refer to the XF86Config(5) man-
  75. ual page.
  76.  
  77. Once you've set up a XF86Config file, you can fine tune the video modes with
  78. the xvidtune utility.
  79.  
  80. 5.1  About mouse configuration
  81.  
  82. The NetBSD pms mouse driver handles PS/2 style mice as Busmouse. Specify the
  83. protocol as ``busmouse'' in the mouse section of your XF86Config file if
  84. you're using a PS/2 mouse.
  85.  
  86. Only standard PS/2 mice are supported by this driver. Newest PS/2 mice that
  87. send more than three bytes at a time (especially Intellimouse, or MouseMan+
  88. with a ``3D'' roller) are not supported yet.
  89.  
  90. XFree86 4.0 also has support for the mouse driver included in the new wscons
  91. console driver introduced by NetBSD 1.4. Specify ``wsmouse'' as the protocol
  92. and ``/dev/wsmouse0'' as the device in /etc/XF86Config if you're using NetBSD
  93. 1.4 with wscons.
  94.  
  95. See README.mouse  for general instruction on mouse configuration in XFree86.
  96.  
  97. 6.  Running X
  98.  
  99. The easiest way for new users to start X windows is to type:
  100.  
  101.      startx >& startx.log
  102.  
  103. Error messages are lost unless you redirect them because the server takes
  104. over the screen.
  105.  
  106. To get out of X windows, type: ``exit'' in the console xterm.  You can cus-
  107. tomize your X by creating .xinitrc, .xserverrc, and .twmrc files in your home
  108. directory as described in the xinit and startx man pages.
  109.  
  110. 6.1  Starting Xdm, the display manager
  111.  
  112. To start the display manager, log in as root on the console and type: ``xdm
  113. -nodaemon''.
  114.  
  115. You can start xdm automatically on bootup by changing the line
  116.  
  117.      xdm=NO              xdm_flags=""            # x11 display manager
  118.  
  119. to:
  120.  
  121.      xdm=YES             xdm_flags=""            # x11 display manager
  122.  
  123. in /etc/rc.conf.
  124.  
  125. Under NetBSD 1.4 with the wscons console driver, you must enable a virtual
  126. console for the X server first. To do this follow these steps:
  127.  
  128.    o Make sure the device file exists. If not, ``cd /dev ; ./MAKEDEV
  129.      wscons''.
  130.  
  131.    o Next, make sure your kernel wants to do wscons. (see below (section ,
  132.      page )).
  133.  
  134.    o Next, make sure ``wscons=YES'' in /etc/rc.conf.
  135.  
  136.    o Next, make sure /etc/wscons.conf exists. The relevant bits:
  137.  
  138.           #screen   0    -    vt100
  139.           screen    1    -    vt100
  140.           screen    2    -    vt100
  141.           screen    3    -    vt100
  142.           screen    4    -    -
  143.           screen    5    -    vt100
  144.  
  145. (Thanks to Mason Loring Bliss <mason@acheron.middleboro.ma.us> for this
  146. explanation)
  147.  
  148. Note that the binary distributions of XFree86 for NetBSD don't include sup-
  149. port for the XDM-AUTHORIZATION-1 protocol.
  150.  
  151. 7.  Kernel Support for X
  152.  
  153. To make sure X support is enabled under NetBSD, the following line must be in
  154. your config file in /sys/arch/i386/conf:
  155.  
  156.      options XSERVER, UCONSOLE
  157.  
  158. 7.1  Console drivers
  159.  
  160. The server supports the standard NetBSD/i386 console drivers: pccons, pcvt
  161. and wscons (in pcvt compatibility mode). They are detected at runtime and no
  162. configuration of the server itself is required.
  163.  
  164. The pccons driver is the most widely tested and is the console driver con-
  165. tained in the NetBSD binary distribution's kernels.
  166.  
  167. The pcvt console driver is bundled with NetBSD. The pcvt X mode is compatible
  168. with the pccons driver X mode. It offers several virtual consoles and inter-
  169. national keyboard support. In order to use this driver, change the line:
  170.  
  171.      device          pc0     at isa? port "IO_KBD" irq 1
  172.  
  173. to
  174.  
  175.      device         vt0     at isa? port "IO_KBD" irq 1
  176.  
  177. in your kernel config file, and rebuild and install your kernel.
  178.  
  179. XFree86 will also run with the wscons console driver in NetBSD 1.4. For now,
  180. it uses the pcvt compatibility mode, so be sure to have the lines:
  181.  
  182.      options         WSDISPLAY_COMPAT_PCVT           # emulate some ioctls
  183.      options         WSDISPLAY_COMPAT_SYSCONS        # emulate some ioctls
  184.      options         WSDISPLAY_COMPAT_USL         # VT handling
  185.      options         WSDISPLAY_COMPAT_RAWKBD         # can get raw scancodes
  186.  
  187. in your kernel configuration file if you're using wscons. Refer to the
  188. wscons(4) and wsmouse(4) manual pages for informations on how to configure
  189. wscons into the kernel.
  190.  
  191. 7.2  Aperture Driver
  192.  
  193. By default NetBSD include the BSD 4.4 kernel security feature that disable
  194. access to the /dev/mem device when in multi-users mode. But XFree86 servers
  195. can take advantage (or require) linear access to the display memory.
  196.  
  197. Most XFree86 4.0 card drivers require linear memory access.  There are two
  198. ways to allow XFree86 to access linear memory:
  199.  
  200. The first way is to disable the kernel security feature by adding ``option
  201. INSECURE'' in the kernel configuration file and build a new kernel.
  202.  
  203. The second way is to install the aperture driver, included in source form in
  204. xc/programs/Xserver/hw/xfree86/etc/apNetBSD.shar in the XFree86 4.0 source
  205. distribution. Unpack it in a new directory of your choice by running:
  206.  
  207.        sh apNetBSD.shar
  208.  
  209. By default the aperture driver will be installed in /usr/local/aperture. You
  210. can change this default directory by editing Makefile.inc before building it.
  211.  
  212. Then run ``make build'' as root to install it. To enable it, add the follow-
  213. ing line to  /etc/lkm.conf:
  214.  
  215.      /usr/local/aperture/lkm/xf86.o  -  - /usr/local/aperture/lkm/xf86_mod_install - -
  216.  
  217. and set ``lkm=YES'' in /etc/rc.conf
  218.  
  219. Reboot your system. XFree86 will auto-detect the aperture driver if avail-
  220. able.
  221.  
  222. Warning 1: if you boot another kernel than /netbsd, loadable kernel modules
  223. can crash your system. Always boot in single user mode when you want to run
  224. another kernel.
  225.  
  226. Warning 2: the  aperture driver only allows one access at a time (so that the
  227. system is in the same security state once X is launched). This means that if
  228. you run multiple servers on multiples VT, only the first one will have linear
  229. memory access.  Use ``option INSECURE'' if you need more that one X server at
  230. a time.
  231.  
  232. Starting with XFree86 3.9.17, the XFree86 aperture driver also supports MTRR
  233. write combining on Pentiums II and AMD K6 class processors.
  234.  
  235. 7.3  MIT-SHM
  236.  
  237. NetBSD 1.0 and later supports System V shared memory. If XFree86 detects this
  238. support in your kernel, it will support the MIT-SHM extension.
  239.  
  240. To add support for system V shared memory to your kernel add the lines:
  241.  
  242.       # System V-like IPC
  243.       options         SYSVMSG
  244.       options         SYSVSEM
  245.       options         SYSVSHM
  246.  
  247. to your kernel config file.
  248.  
  249. 8.  Rebuilding the XFree86 Distribution
  250.  
  251. You should configure the distribution by editing xc/config/cf/host.def
  252. before compiling.  To compile the sources, invoke ``make World'' in the xc
  253. directory.
  254.  
  255. 8.1  Aperture driver
  256.  
  257. To build the XFree86 server with the Aperture driver enabled, you should
  258. unpack apNetBSD.shar and install it first.
  259.  
  260. Then edit xc/config/cf/host.def and add the line
  261.  
  262.      #define HasNetBSDApertureDriver    YES
  263.  
  264. to it.
  265.  
  266. And finally run make World in the xc directory.
  267.  
  268. 8.2  Console drivers
  269.  
  270. XFree86 has a configuration option to select the console drivers to use in
  271. xf86site.def:
  272.  
  273.    o  if you're using pccons put:
  274.  
  275.            #define XFree86ConsoleDefines -DPCCONS_SUPPORT
  276.  
  277.    o if you're using pcvt put:
  278.  
  279.            #define XFree86ConsoleDefines -DPCVT_SUPPORT
  280.  
  281. If you don't define XFree86ConsoleDefines in xf86site.def the pccons and pcvt
  282. drivers will be supported by default.
  283.  
  284. 8.3  Building on other architectures
  285.  
  286. Note that the NetBSD project has now its own source tree, based on the
  287. XFree86 source tree, with some local modifications. You may want to start
  288. with this tree to rebuild from sources.  The NetBSD xsrc source tree is
  289. available at: ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/xsrc/
  290.  
  291. 9.  Building New X Clients
  292.  
  293. The easiest way to build a new client (X application) is to use xmkmf if an
  294. Imakefile is included in the sources.  Type ``xmkmf -a'' to create the Make-
  295. files, check the configuration if necessary and type ``make''.  Whenever you
  296. install additional man pages you should update whatis.db by running ``make-
  297. whatis /usr/X11R6/man''.
  298.  
  299. When porting clients to *BSD systems, make use of the symbol BSD for code
  300. which is truly BSD-specific.  The value of the symbol can be used to distin-
  301. guish different BSD releases.  For example, code specific to the Net-2 and
  302. later releases can use:
  303.  
  304.      #if (BSD >= 199103)
  305.  
  306. To ensure that this symbol is correctly defined, include <sys/param.h> in the
  307. source that requires it.  Note that the symbol CSRG_BASED is defined for *BSD
  308. systems in XFree86 3.1.1 and later.  This should be used to protect the
  309. inclusion of <sys/param.h>.
  310.  
  311. For code that really is specific to a particular i386 BSD port, use
  312. __FreeBSD__ for FreeBSD, __NetBSD__ for NetBSD, __OpenBSD__ for OpenBSD, and
  313. __bsdi__ for BSD/386.
  314.  
  315. 10.  Thanks
  316.  
  317. Many thanks to all people who contributed to make XFree86 work on *BSD, in
  318. particular, David Dawes, Pace Willison, Amancio Hasty, Christoph Robitschko,
  319. Nate Williams, Rod Grimes, Jack Velte and Michael Smith.
  320.  
  321.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/NetBSD.sgml,v 3.55 2000/03/03 21:28:09 dawes Exp $
  322.  
  323.