← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/programs/Xserver/hw/xfree86/doc/README.LynxOS

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/programs/Xserver/hw/xfree86/doc/README.LynxOS
 
1
                     README for XFree86 4.3.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.3.0 are available by anonymous ftp from:
 
17
 
 
18
ftp://ftp.XFree86.org/pub/XFree86/4.3.0
 
19
 
 
20
Binaries of XFree86 for LynxOS x86 are available from:
 
21
 
 
22
ftp://ftp.XFree86.org/pub/XFree86/4.3.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.3.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.3.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.3.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
 
 
269
$XFree86: xc/programs/Xserver/hw/xfree86/doc/README.LynxOS,v 3.35 2003/02/24 04:03:21 dawes Exp $