home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 August - Disc 2 / chip_20018102_hu.iso / linux / X-4.1.0 / doc / README.LynxOS < prev    next >
Encoding:
Text File  |  2001-06-27  |  8.9 KB  |  268 lines
  1.                      README for XFree86 4.1.0 on LynxOS
  2.  
  3.                                Thomas Mueller
  4.  
  5.                               25 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.1.0 are available by anonymous ftp from:
  17.  
  18. ftp://ftp.XFree86.org/pub/XFree86/4.1.0
  19.  
  20. Binaries of XFree86 for LynxOS x86 are available from:
  21.  
  22. ftp://ftp.XFree86.org/pub/XFree86/4.1.0/binaries/LynxOS
  23.  
  24. A list of mirror sites is provided by ftp://ftp.XFree86.org/pub/XFree86/MIR-
  25. RORS
  26.  
  27. The binaries on the FTP site were built on the latest released LynxOS version
  28. at the time XFree86 4.1.0 was released. In this case it is `LynxOS x86
  29. 3.0.1'. Because of changes made to the object format they don't run on LynxOS
  30. versions earlier than 3.0.0.
  31.  
  32. Building of this XFree86 version has never been tested on LynxOS versions
  33. earlier than 2.5.1.
  34.  
  35. This release contains preliminary build support for `LynxOS 3.1.0'.  Since
  36. this OS release was not available long enough for serious testing `LynxOS
  37. 3.1.0' support has to be considered to be in `alpha state'.  Initial tests
  38. were performed on LynxOS x86 only!
  39.  
  40. XFree86 4.1.0 supports LynxOS on the x86 and on the PowerPC platform. X
  41. servers are currently available only on the x86 platform. The X server may
  42. work with some PowerPC platforms supported by LynxOS though this has not
  43. (yet) been thoroughly tested.
  44.  
  45. If you need binaries for other platforms than the one on the XFree86 FTP
  46. server or if you have comments or suggestions about this document contact me
  47. (<tmueller@sysgo.de>).
  48.  
  49. 2.  Installing the Binaries
  50.  
  51. Please refer to the Installation Document for detailed installation instruc-
  52. tions.
  53.  
  54. It may be necessary to increase the process stack limit in order to run
  55. XFree86 on your system. Edit /etc/startab and reboot your system to make the
  56. changes active before you begin the installation.
  57.  
  58. Also, be sure to include /usr/X11R6/bin in your PATH environment variable.
  59.  
  60. Refer to the next section Running XFree86 (section 3., page 1) for further
  61. information on necessary configuration steps before running XFree86 on
  62. LynxOS.
  63.  
  64. 2.1  Accessing XFree86 manual pages
  65.  
  66. Include /usr/X11R6/man in the MANPATH environment variable or add the direc-
  67. tory /usr/X11R6/man to /usr/Lib/man.config
  68.  
  69. 3.  Running XFree86
  70.  
  71. This section describes the changes to the LynxOS environment which may be
  72. necessary to successfully run XFree86.
  73.  
  74. 3.1  System tuning
  75.  
  76. 3.1.1  Tunable parameters
  77.  
  78. To reasonably run XFree86 you may have to adjust a few system parameters.
  79.  
  80. On LynxOS 2.5.x and 3.0.x include a line
  81.  
  82.      #define X_WINDOWS
  83.  
  84. in /sys/lynx.os/uparam.h.
  85.  
  86. 3.1.2  Adjustment for "nv" driver for NVidia graphics cards
  87.  
  88. If you're using the "nv" driver (Riva 128, nVidia TNT, TNT2, GeForce), you
  89. will have to increase the value of the SMEMS parameter in
  90. /sys/lynx.os/uparam.h from 10 to 20.
  91.  
  92. 3.1.3  Increase number of ptys
  93.  
  94. You should also increase the number of ptys to be able run a couple more
  95. xterms. You may replace /sys/cfg/pty.cfg with /usr/X11R6/lib/X11/etc/pty.cfg.
  96.  
  97. 3.1.4  MTRR device driver
  98.  
  99. If you're using an Intel PentiumPRO or Pentium II (or higher) class CPU you
  100. might want to install the MTRR device driver. This driver enables the XFree86
  101. X server to manipulate the CPU memory type range registers which may improve
  102. performance on certain systems.
  103.  
  104. To install the driver (on LynxOS x86 2.5.0 systems an higher) follow these
  105. steps:
  106.  
  107.        # cd /
  108.        # bash /usr/X11R6/lib/X11/etc/MTRR-Lynx.shar
  109.        # cd sys/drivers/mtrr
  110.        # make install
  111.  
  112. Then add a line
  113.  
  114.        I:../drivers/mtrr/mtrr.cfg
  115.  
  116. to /sys/lynx.os/CONFIG.TBL and rebuild the kernel (see next section).
  117.  
  118. 3.1.5  Kernel build
  119.  
  120. If you plan to use a PS/2 mouse to the following sections before rebuilding
  121. the kernel, if not, you should rebuild the kernel now:
  122.  
  123.           # cd /sys/lynx.os
  124.           # make install
  125.           # reboot -N
  126.  
  127. 3.2  Mouse support in XFree86
  128.  
  129. XFree86 includes support for PnP mice (see also Mouse Support in XFree86).
  130. The current LynxOS TTY device driver doesn't allow the necessary manipulation
  131. of the RTS line and therefore the support for PnP mice has been disabled for
  132. LynxOS.
  133.  
  134. 3.3  PS/2 mouse drivers
  135.  
  136. LynxOS x86 comes with a PS/2 mouse driver. If it is not currently installed
  137. on your system install it with /usr/bin/Install.ps2mouse. Older versions of
  138. this driver contained code to translate the PS/2 mouse protocol to the format
  139. of a serial mouse, thus you'll have to specify "Microsoft" as the mouse pro-
  140. tocol format. The mouse driver contained in LynxOS x86 patchlevel 015 (and
  141. higher) does no longer perform the protocol translation an therefore can be
  142. defined as "PS/2" protocol format.
  143.  
  144. 3.4  ATC console driver and VT switching
  145.  
  146. Currently there is no support for virtual terminal switching once the server
  147. has started. Support for this feature may be added in future versions (it
  148. requires a patch to the vt100 LynxOS terminal driver).
  149.  
  150. You will need a free console which the X server will use for keyboard input.
  151. You must disable login on at least one of the four virtual terminals in
  152. /etc/ttys, e.g. /dev/atc3:
  153.  
  154. change
  155.  
  156.             /dev/atc3:1:default:vt100at:/bin/login
  157.  
  158. to
  159.  
  160.             /dev/atc3:0:default:vt100at:/bin/login
  161.                       ^
  162.  
  163. 3.5  X Server debug diagnostics output and other VT peculiarities
  164.  
  165. Output made by the XFree86 X on its stdout or stderr will be lost after the
  166. server switches to graphics mode. The XFree86 4.1.0 server stores its output
  167. in /usr/adm/XFree86.n.log (where n is the screen number).
  168.  
  169. When the X server is running output made to other consoles will be lost.
  170. After server shutdown the screen contents of other consoles may be inconsis-
  171. tent with what one would expect (i.e. random).
  172.  
  173. 4.  Compiling the XFree86 Distribution
  174.  
  175. The next sections contain LynxOS specific notes with respect to the build
  176. process.
  177.  
  178. 4.1  Disk space requirements
  179.  
  180. Currently there is no support for shared libraries in the LynxOS XFree86
  181. port. A complete binary installation along with manual pages will require
  182. approximately 100 MBytes of disk space. To compile the system you will need
  183. at least 250 MBytes of free disk space.
  184.  
  185. 4.2  Changes to system environment (LynxOS x86)
  186.  
  187. Before compiling the XFree86 distribution you will have to make a few little
  188. adjustments to your system:
  189.  
  190.    o If not already installed on your system create a shell script named
  191.      /lib/cpp as follows:
  192.  
  193.             #!/bin/sh
  194.             /usr/lib/gcc-lib/i386-unknown-lynxos2.5/2.7-96q1/cpp \
  195.                -traditional "$@"
  196.  
  197.      On other platforms than the x86 the paths for the compiler support pro-
  198.      grams are different. You may use
  199.  
  200.             gcc -v
  201.  
  202.      to find out the correct path. Set the file mode of /lib/cpp with
  203.  
  204.             # chown root /lib/cpp
  205.             # chmod 755 /lib/cpp
  206.  
  207.    o Modify /lib/liblynx.a. The X servers need the smem_create() system call
  208.      to map the frame buffer into their address space. The system call is in
  209.      liblynx library along with other Lynx proprietary calls which (unfortu-
  210.      nately) overlap with calls in libc. To reduce confusion you should mod-
  211.      ify liblynx as follows:
  212.  
  213.             # mv /lib/liblynx.a /lib/liblynx.a.ORG
  214.             # mkdir /tmp/xx; cd /tmp/xx
  215.             # ar xv /lib/liblynx.a.ORG
  216.             # ar rv /lib/liblynx.a *smem*
  217.             # ranlib /lib/liblynx.a
  218.  
  219. 4.3  make World
  220.  
  221. If you have the MTRR device driver installed, add a line
  222.  
  223.          #define HasMTRRSupport YES
  224.  
  225. to the config/cf/host.def file.
  226.  
  227. You may then issue a
  228.  
  229.           make World
  230.  
  231. to compile XFree86. After a few hours (and hopefully a successful build of
  232. the XFree86 system) you can install the software using
  233.  
  234.           make install
  235.  
  236. You must be logged in as super-user (root) when you invoke `make install'.
  237.  
  238. On LynxOS x86 2.5.0 you may encounter problems with make in deeply nested
  239. subdirectories (eg core dumps, hangups). In this case update to GNU make ver-
  240. sion 3.75 or higher.
  241.  
  242. 4.4  Installing XFree86 manual pages
  243.  
  244. LynxOS uses cat-able manual pages, and because a doc preparation system is
  245. definitely not a vital component of a real-time operating system you must
  246. first install groff-1.09 (or newer).
  247.  
  248. XFree86 manual pages may be installed using
  249.  
  250.           make install.man
  251.  
  252. The index and whatis database for the XFree86 manual pages will be created
  253. automatically. If you already have a whatis database or index file in the
  254. destination directories you should perform a sort/uniq operation to remove
  255. duplicate entries:
  256.  
  257.           for i in 1 3 5
  258.           do
  259.             rm -f /tmp/tmpfile
  260.             sort /usr/X11R6/man/cat$i/LIST$i | uniq > /tmp/tmpfile
  261.             mv /tmp/tmpfile /usr/X11R6/man/cat$i/LIST$i
  262.           done
  263.           sort /usr/X11R6/man/whatis | uniq > /tmp/tmpfile
  264.           mv /tmp/tmpfile /usr/X11R6/man/whatis
  265.  
  266.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/LynxOS.sgml,v 3.20 2000/06/17 00:27:32 dawes Exp $
  267.  
  268.