<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Running XFree86</TITLE>
</HEAD>
<BODY BGCOLOR="#efefef" TEXT="black" LINK="blue" VLINK="#551A8B" ALINK="red">

<A HREF="LynxOS.html"><EM>README for XFree86 on LynxOS</EM></A>
 <b>:</b> <EM>Running XFree86</EM><BR>
<b>Previous:</b> <A HREF="LynxOS2.html"><EM>Installing the Binaries</EM></A><BR>
<b>Next:</b> <A HREF="LynxOS4.html"><EM>Installing XFree86 manual pages</EM></A>


<HR NOSHADE>
  <H2><A NAME="3"></A>3. Running XFree86</H2>
<p>
<A NAME="running"></A></p>
<p>This section describes the changes to the LynxOS environment 
which may be necessary to successfully run XFree86.</p>
<p>Read <A href="QuickStart.html">Quick-Start Guide  to XFree86 Setup</A> to learn more about how to configure XFree86 for
your hardware.</p>

<H3><A NAME="4"></A>3.1. System requirements</H3>
<p>A minimum of 16MB of memory is required to run X. If you want to run
real-world applications you should think of upgrading to 32MB (or more).</p>

<H3><A NAME="5"></A>3.2. System tuning</H3>

<H4><A NAME="6"></A>3.2.1. Tunable parameters</H4>
<p>To reasonably run XFree86 you may have to adjust a few system parameters.</p>
<p>On LynxOS 2.5.x and 3.0.x include a line
<pre>
  #define X_WINDOWS
</pre>
</p>
<p>in <code>/sys/lynx.os/uparam.h</code>.</p>
<p>For earlier versions you'll have to edit <code>/usr/include/param.h</code>:
<pre>
  Tunable                                           Old     New
  USR_NFDS      number of open files per process     20      64
  NPROC         number of tasks                      50     150
  NFILES        number of open files in system      100     250
  NINODES       number of incore inodes             (same value as NFILES)
  QUANTUM       clock ticks until preemption         64      20
  CACHEBLKS     number of cache memory blocks       202      &gt;= 4096
</pre>
</p>
<p>The new values are those suggested by the LynxOS documentation for
their X Window package.</p>

<H4><A NAME="7"></A>3.2.2. Adjustment for Riva 128 and Riva TNT driver&gt;If you're using the nVidia driver (Riva 128, TNT, TNT2) of the SVGA
server, you will have to increase the value of the SMEMS parameter in <code>/sys/lynx.os/uparam.h</code> from 10 to 20.
</H4>
<H4><A NAME="8"></A>3.2.3. Increase number of ptys</H4>

<p>You should also increase the number of ptys to be able run a couple
more xterms. You may replace <code>/sys/lynx.os/pty.cfg</code> with
<code>/usr/X11R6/lib/X11/etc/pty.cfg</code>.</p>

<H4><A NAME="9"></A>3.2.4. Kernel build</H4>

<p>If you plan to use PS/2 or Bus mice refer to the following section
before rebuilding the kernel, if not, you should rebuild the kernel
now: </p>
<p>
<blockquote><code>
<pre>
     # cd /sys/lynx.os
     # make install
     # reboot -N
  
</pre>
</code></blockquote>
</p>

<H3><A NAME="10"></A>3.3. Mouse support in XFree86</H3>

<p>XFree86 includes support for PnP mice (see also
<A href="mouse.html">Mouse Support in XFree86</A>). 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.</p>

<H3><A NAME="11"></A>3.4. Bus mouse drivers</H3>

<p>Starting with LynxOS AT 2.4.0 LynxOS includes a PS/2 mouse driver.
Currently this driver is not fully supported by XFree86 (you'll
probably have to specify the mouse type as <em>Microsoft</em>
regardless of real mouse type and in some cases you won't have
all mouse buttons supported).
<code>/usr/X11R6/lib/X11/etc/BM-Lynx.shar</code> contains a LynxOS port 
of the Linux bus mouse drivers. To install the drivers
unpack the shar archive</p>
<p>
<blockquote><code>
<pre>
    # cd /
    # bash /usr/X11R6/lib/X11/etc/BM-Lynx.shar
  
</pre>
</code></blockquote>
</p>
<p>and follow the notes in <code>/BMOUSE.Readme</code> for further installation and
configuration notes.</p>
<p>The XFree86 PS/2 mouse driver works also with MetroLink X 2.3.3.1 as
shipped with LynxOS AT 2.4.0 unless you have the LynxOS patch
000055-00 installed.</p>

<H3><A NAME="12"></A>3.5. ATC console driver and VT switching</H3>

<p>The XFree86 servers will only run with the default LynxOS console
driver, sorry for those of you who use the alternative vdt console
driver. Currently there is no support for virtual terminal switching
once the server has started.</p>
<p>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 <code>/etc/ttys</code>, e.g. <code>/dev/atc3</code>:</p>
<p>
<blockquote><code>
change
<pre>
       /dev/atc3:1:default:vt100at:/bin/login
  
</pre>

to
<pre>
       /dev/atc3:0:default:vt100at:/bin/login
                 ^
  
</pre>
</code></blockquote>
</p>

<H3><A NAME="13"></A>3.6. X Server debug diagnostics output and other VT peculiarities</H3>

<p>The XFree86 X servers will produce a lot of diagnostics output on
stderr during startup. This output will be lost after the server
reached a certain point in its console initialization process. You
should redirect stdout and stderr if you want to analyze the
diagnostics produced by the server.</p>
<p>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).</p>

 <HR NOSHADE>
<A HREF="LynxOS.html"><EM>README for XFree86 on LynxOS</EM></A>
 <b>:</b> <EM>Running XFree86</EM><BR>
<b>Previous:</b> <A HREF="LynxOS2.html"><EM>Installing the Binaries</EM></A><BR>
<b>Next:</b> <A HREF="LynxOS4.html"><EM>Installing XFree86 manual pages</EM></A>



</BODY>
</HTML>
