   README  for X11R7.2 on LynxOSThomasMueller15 February 2007What
   and  Where  is  X11R7.2?X11R7.2  is  a  port  of  X11R6.4 that
   supports  several  versions of Intel-based Unix. It is derived
   from  XFree86  4.4  rc2 which was derived from X386 1.2, which
   was the X server distributed with X11R5. This release consists
   of  many  new features and performance improvements as well as
   many  bug  fixes.See  the  Copyright  Notice.Building  of this
   X11R7.2  version  has  been tested on `LynxOS 3.1.0a i386' and
   `LynxOS  4.0.0  i386'.Previous  releases  of X11R7.2 supported
   LynxOS  on  the  x86  and on the PowerPC platform. Building on
   PowerPC  platforms  has  not  been  tested recently.Installing
   X11R7.2Please  refer to the Installation Document for detailed
   installation  instructions.It may be necessary to increase the
   process  stack limit in order to build X11R7.2 and run X11R7.2
   on  your  system.  Edit /etc/startab and reboot your system to
   make    the    changes    active    before   you   begin   the
   installation.Also,  be  sure to include /usr/X11R6/bin in your
   PATH  environment  variable.Refer  to  the  next  section  for
   further  information  on  necessary configuration steps before
   running   X11R7.2   on   LynxOS.   Accessing   X11R7.2  manual
   pagesInclude   /usr/X11R6/man   in   the  MANPATH  environment
   variable    or    add    the   directory   /usr/X11R6/man   to
   /usr/Lib/man.configRunning  X11R7.2This  section describes the
   changes  to  the  LynxOS environment which may be necessary to
   successfully  run  X11R7.2.System  tuningTunable  parametersTo
   reasonably  run  X11R7.2  you  may have to adjust a few system
   parameters.On  LynxOS  3.1.0  and 4.0.0 include a line #define
   X_WINDOWS  in /sys/lynx.os/uparam.h.Adjustment for "nv" driver
   for NVidia graphics cardsIf you're using the "nv" driver (Riva
   128,  nVidia  TNT,  TNT2, GeForce) on LynxOS `3.1.0', you will
   have   to  increase  the  value  of  the  SMEMS  parameter  in
   /sys/lynx.os/uparam.h from 10 to 20.Increase number of ptysYou
   should  also  increase  the  number  of  ptys to be able run a
   couple  more  xterms.  You  may  replace /sys/cfg/pty.cfg with
   /usr/X11R6/lib/X11/etc/pty.cfg.MTRR   device  driverIf  you're
   using  an Intel PentiumPRO or Pentium II (or higher) class CPU
   you  might want to install the MTRR device driver. This driver
   enables the X11R7.2 X server to manipulate the CPU memory type
   range  registers  which  may  improve  performance  on certain
   systems.To  install  the  driver  follow these steps: # cd / #
   bash      /usr/X11R6/lib/X11/etc/MTRR-Lynx.shar      #      cd
   sys/drivers/mtrr    #   make   install   Then   add   a   line
   I:../drivers/mtrr/mtrr.cfg   to   /sys/lynx.os/CONFIG.TBL  and
   rebuild  the kernel (see next section).Kernel buildIf you plan
   to   use  a  PS/2  mouse  to  the  following  sections  before
   rebuilding  the  kernel, if not, you should rebuild the kernel
   now:  #  cd  /sys/lynx.os  #  make  install  # reboot -N Mouse
   support  in  X11R7.2X11R7.2 includes support for PnP mice (see
   also  Mouse Support in X11R7.2). The current LynxOS TTY device
   driver  doesn't  allow  the  necessary manipulation of the RTS
   line  and therefore the support for PnP mice has been disabled
   for  LynxOS.PS/2  mouse  driversLynxOS  x86  comes with a PS/2
   mouse driver. If it is not currently installed on your system,
   install  it  with  /usr/bin/Install.ps2mouse.  The LynxOS PS/2
   mouse  driver  is not always able to properly handle the mouse
   initialization performed by the X server. If your mouse is not
   responding  after the X server has started up, modify the PS/2
   mouse driver as follows: ---
   /sys/drivers/ps2mouse/mousedrvr.c.orig  Wed  Aug  25  09:51:02
   2004 +++ /sys/drivers/ps2mouse/mousedrvr.c Wed Aug 25 09:50:54
   2004  @@  -261,6  +261,7  @@ int mousewrite(struct statics *s,
   struct  file  *f,  char *buff, int count) { int i; + return 0;
   #ifdef DEBUG kkprintf("Mouse: write %d %x\n", count, buff[0] &
   0x0FF);  #endif  Then  rebuild  both  the mouse driver and the
   kernel:  # cd /sys/drivers/ps2mouse # make # cd /sys/lynx.os #
   make   install   #   reboot   ATC   console   driver   and  VT
   switchingCurrently  there  is  no support for virtual terminal
   switching  once  the  server  has  started.  Support  for this
   feature  may  be added in future versions (it requires a patch
   to  the  vt100  LynxOS  terminal  driver).You will need a free
   console  which  the  X server will use for keyboard input. You
   must  disable  login  on  at  least  one  of  the four virtual
   terminals     in    /etc/ttys,    e.g.    /dev/atc3:    change
   /dev/atc3:1:default:vt100at:/bin/login                      to
   /dev/atc3:0:default:vt100at:/bin/login   ^   X   Server  debug
   diagnostics  output  and  other VT peculiaritiesOutput made by
   the  X11R7.2  X on its stdout or stderr will be lost after the
   server  switches  to  graphics mode. The X11R7.2 server stores
   its  output  in  /usr/adm/Xorg.n.log  (where  n  is the screen
   number).When  the  X  server  is  running output made to other
   consoles  will  be  lost.  After  server  shutdown  the screen
   contents  of  other consoles may be inconsistent with what one
   would    expect    (i.e.    random).Compiling    the   X11R7.2
   DistributionThe  next  sections  contain LynxOS specific notes
   with    respect    to    the    build    process.Disk    space
   requirementsCurrently there is no support for shared libraries
   in  the  LynxOS  X11R7.2  port. A complete binary installation
   along  with manual pages will require approximately 250 MBytes
   of  disk  space.  To compile the system you will need at least
   350  MBytes  of  free disk space.Changes to system environment
   (LynxOS x86)Before compiling the X11R7.2 distribution you will
   have  to  make a few little adjustments to your system: If not
   already  installed,  on  your  `LynxOS 3.1.0a' system create a
   shell    script   named   /lib/cpp   as   follows:   #!/bin/sh
   /usr/lib/gcc-lib/i386-coff-lynxos/2.9-gnupro-98r2/cpp        \
   -traditional  "$@"  On  other platforms than the x86 the paths
   for  the  compiler support programs are different. You may use
   gcc  -v  to  find  out  the correct path. Set the file mode of
   /lib/cpp  with  #  chown  root  /lib/cpp  # chmod 755 /lib/cpp
   Modify  /lib/liblynx.a.  On `LynxOS 3.1.0a' the X servers need
   the  smem_create()  system  call  to map the frame buffer into
   their  address  space.  The  system call is in liblynx library
   along  with other Lynx proprietary calls which (unfortunately)
   overlap  with  calls  in  libc. To reduce confusion you should
   modify    liblynx    as    follows:    #   mv   /lib/liblynx.a
   /lib/liblynx.a.ORG  #  mkdir  /tmp/xx;  cd  /tmp/xx  #  ar  xv
   /lib/liblynx.a.ORG  #  ar  rv  /lib/liblynx.a  *smem* # ranlib
   /lib/liblynx.a  make  WorldIf  you have the MTRR device driver
   installed,  add  a  line  #define  HasMTRRSupport  YES  to the
   config/cf/host.def  file.You  may  then  issue a make World to
   compile  X11R7.2.  After some time (and hopefully a successful
   build  of  the  X11R7.2  system)  you can install the software
   using  make install You must be logged in as super-user (root)
   when  you  invoke  `make  install'.Installing  X11R7.2  manual
   pagesLynxOS  uses  cat-able  manual  pages,  and because a doc
   preparation  system  is  definitely not a vital component of a
   real-time  operating  system you must first install groff-1.09
   (or  newer).X11R7.2  manual  pages may be installed using make
   install.man  The  index  and  whatis  database for the X11R7.2
   manual  pages  will  be  created automatically. If you already
   have  a  whatis  database  or  index  file  in the destination
   directories you should perform a sort/uniq operation to remove
   duplicate  entries:  for i in 1 3 5 do rm -f /tmp/tmpfile sort
   /usr/X11R6/man/cat$i/LIST$i   |   uniq   >   /tmp/tmpfile   mv
   /tmp/tmpfile     /usr/X11R6/man/cat$i/LIST$i     done     sort
   /usr/X11R6/man/whatis  |  uniq  > /tmp/tmpfile mv /tmp/tmpfile
   /usr/X11R6/man/whatis
