1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
|
README for XFree86 3.1.2 on FreeBSD 2.1
Rich Murphey, David Dawes
20 January 1995
[Last Updated: 14 October 1995]
1. What and Where is XFree86?
------------------------------
XFree86 is a port of X11R6 that supports several versions of Intel-
based Unix. It is 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. The release
is available as source patches against the X Consortium X11R6 code, as
well as binary distributions for many architectures.
See the Copyright Notice (COPYRIGHT.html).
The sources for XFree86 are available as part of the FreeBSD 2.1
distribution, or by anonymous ftp from:
ftp.XFree86.org:/pub/XFree86/current
(ftp://ftp.XFree86.org/pub/XFree86/current)
Binaries for XFree86 on FreeBSD are also available as part of
2.1 or from:
ftp.XFree86.org:/pub/XFree86/current/binaries/FreeBSD-2.0
(ftp://ftp.XFree86.org/pub/XFree86/current/binaries/FreeBSD-2.0)
XFree86.cdrom.com:/pub/XFree86/current/binaries/FreeBSD-2.0
(ftp://XFree86.cdrom.com/pub/XFree86/current/binaries/FreeBSD-2.0)
Send email to Rich-Murphey@Rice.edu or XFree86@XFree86.org if you have
comments or suggestions about this file and we'll revise it.
2. Installing the Binaries
---------------------------
In the FreeBSD 2.1 distribution, XFree86 comes in 3 major sections:
"basic" distributions, fonts and servers. At the minimum, you will
need the binaries and libraries from the basic distribution, the
"misc" fonts collection and at least one server. The smallest usable
distribution is around 9MB.
If you can't decide what to pick and you have 52Mb of disk
space, it's safe to unpack everything.
What follows is a description of the various distribution files
comprising XFree86. If you are installing this as part of FreeBSD 2.1
then there's no need to use these files directly: You may simply check
the desired components off the installation menus provided for that
purpose. If you're installing this manually, then the following
information should prove useful:
Required (6.7Mb):
X312bin.tgz
all the executable X client applications and shared libs
X312fnts.tgz
the misc and 75 dpi fonts
X312lib.tgz
data files needed at runtime
Required unless you have already customized your configuration
files:
X312xicf.tgz
customizable xinit runtime configuration file
X312xdcf.tgz
customizable xdm runtime configuration file
Choose at least one server ( 2.3Mb):
X3128514.tgz
8-bit color for IBM 8514 and true compatibles.
X312AGX.tgz
8-bit color for AGX boards.
X312Mch3.tgz
8 and 16-bit color for ATI Mach32 boards.
X312Mch8.tgz
8-bit color for ATI Mach8 boards.
X312Mono.tgz
1-bit monochrome for VGA, Super-VGA, Hercules, and others.
X312P9K.tgz
8, 16, and 24-bit color for Weitek P9000 boards (Diamond
Viper).
X312S3.tgz
8, 16 and 24-bit color for S3 boards (#9 GXE, Actix GE32,
SPEA Mercury, STB Pegasus)
X312SVGA.tgz
8-bit color for Super-VGA cards.
X312VG16.tgz
4-bit color for VGA and Super-VGA cards
X312W32.tgz
8-bit Color for ET4000/W32, /W32i and /W32p cards.
X312nest.tgz
A nested server running as a client window on another
display.
Optional:
X312doc.tgz
(.5Mb) READMEs and XFree86 specific man pages
X312man.tgz
(1.7Mb) man pages except XFree86 specific ones in etc archive
X312ctrb.tgz
(1.0Mb) Contributed clients like ico, xeyes, etc.
X312f100.tgz
(1.8Mb) 100dpi fonts
X312fcyr.tgz
(1.8Mb) Cyrillic fonts
X312fscl.tgz
(1.6Mb) Speedo and Type1 fonts
X312fnon.tgz
(3.3Mb) Japanese, Chinese and other non-English fonts
X312fsrv.tgz
(.3Mb) the font server and it's man page
X312prog.tgz
(3.9Mb) config, lib*.a and *.h files needed only for
compiling
X312link.tgz
(7.8Mb) X server reconfiguration kit
X312pex.tgz
(.5Mb) PEX fonts and shared libs needed by PEX applications.
X312lbx.tgz
(.2Mb) low bandwidth X proxy server and libraries.
Note that there is no longer a separate xdm archive. FreeBSD 2.0
and later handles this in shared libraries now, so that the xdm
binary does not itself contain des and there is no more need for
us to provide separate tar balls.
2.1. Full Install:
-------------------
[ Note: Unless you're installing XFree86 3.1.2 manually, that is
to say not as part of the FreeBSD 2.1 installation, you may skip
to section 2.3 ]
1. You must be logged in as root to unpack the archives because
several executables are set-user-id. Otherwise the server may
abort if you unpack it as an ordinary user. You must also use a
``umask'' value of 022 because the X server requires special
permissions.
% su
# umask 022
2. If you have 52Mb free in the /usr partition ``cd /usr'' and skip
to no. 3. Otherwise, create a directory on another partition
and sym link it into /usr:
# cd /usr/local
# mkdir X11R6
# ln -s /usr/local/X11R6 /usr/X11R6
3. Unpack everything:
If you are using sh (as root usually does):
# for i in X312*.tgz; do
# tar -xzf $i
# done
Else, if you are using csh:
% foreach i (X312*.tgz)
% tar -xzf $i
% end
4. Create a symbolic link ``X'' that points to the server that
matches your video card. The XF86_* man pages list which vga
chip sets are supported by each server. For example, if you
have an ET4000 based card you will use the XF86_SVGA server:
# cd /usr/X11R6/bin; rm X; ln -s XF86_SVGA X
2.2. Minimal Install:
----------------------
First do numbers 1 and 2 above. Then unpack the required archives:
# for i in bin fnts lib xicf; do
# tar -xzf X312$i.tgz
# done
Then unpack a server archive corresponding to your vga card. The
server man pages, X11R6/man/man1/XF86_*, list the vga chip sets
supported by each server. For example, if you have an ET4000 based
card you will use the XF86_SVGA server:
# tar -xzf X312SVGA.tgz
# cd /usr/X11R6/bin; rm X; ln -s XF86_SVGA X
2.3. After either Full or Minimal Install above:
-------------------------------------------------
Add /usr/X11R6/bin to the default path for sh in /etc/profile and for
csh in /etc/csh.login if they are not already there:
# echo 'set path = ($path /usr/X11R6/bin)' >>/etc/csh.login
# echo 'PATH=$PATH:/usr/X11R6/bin' >>/etc/profile
Or make sure all who use X put /usr/X11R6/bin in their shell's
``path'' variable.
Next either reboot or invoke ldconfig as root to put the shared
libraries in ld.so's cache:
# ldconfig /usr/lib /usr/local/lib /usr/X11R6/lib
If you had already configured X11R6/lib/X11/xinit/xinitrc or
X11R6/lib/X11/xdm/* omit the xinit-config or xdm-config archive or
unpack it separately and merge in your customizations.
The fscl and f100 archives are optional and can be omitted if you are
short on space. The optional link archive allows you to reconfigure
and customize a X server binary. The optional prog archive is needed
only for writing or compiling X applications. The optional pex
archive contains pex clients and libraries for building 3D graphics
applications.
NOTE: You don't need to uncompress the font files, but if
you uncompress them anyway you must run mkfontdir in the
corresponding font directory; otherwise your server will
abort with the message ``could not open default font
'fixed'''.
3. Installing The Display Manager (xdm)
----------------------------------------
The display manager makes your PC look like an X terminal. That is,
it presents you with a login screen that runs under X.
The easiest way to automatically start the display manager on boot is
to add a line in /etc/ttys to start it on one of the unoccupied
virtual terminals:
ttyv4 "/usr/X11R6/bin/xdm -nodaemon" xterm on secure
You should also make sure that /usr/X11R6/bin/X is a symbolic link to
the Xserver that matches your video card or edit the file Xservers in
/usr/X11R6/lib/X11/xdm to specify the pathname of the X server.
The change to /etc/ttys won't take effect until you either reboot or
``kill -HUP 1'' to force initd to reread /etc/ttys. You can also test
the display manager manually by loging in as root on the console and
typing ``xdm -nodaemon''.
4. Configuring X for Your Hardware
-----------------------------------
The XF86Config file tells the X server what kind of monitor, video
card and mouse you have. You must create it to tell the server what
specific hardware you have.
If you are installing XFree86 as part of FreeBSD 2.1, you may invoke
XF86Config automatically from the FreeBSD configuration menu. You
should still read this document first, however, as it contains
valuable information on mouse and VGA card selection below.
XFree86 3.1 uses a new configuration file format. Consult the
XF86Config man page and the general INSTALL (INSTALL.html) file for
instructions.
If you have a Xconfig file for XFree86 2.x, use reconfig to translate
part of it into the new format:
# reconfig <Xconfig >XF86Config
and complete the rest according to the XF86Config man page and the
XF86Config.sample file as a template.
In order to protect your hardware from damage, the server no longer
will read XF86Config files from a user's home directory, but requires
that it be in /etc/XF86Config, /usr/X11R6/lib/X11/XF86Config.hostname
or /usr/X11R6/lib/X11/XF86Config.
You'll need info on your hardware:
o Your mouse type, baud rate and it's /dev entry.
o The video card's chipset (e.g. ET4000, S3, etc).
o Your monitor's sync frequencies.
Bus Mice:
In FreeBSD, the bus mouse is generally found on /dev/mse0. Specify
/dev/mse0 when asked, and in case of failure ensure that your Bus
mouse was indeed "probed" when the system was booted. To make
sure of this, type:
% dmesg | grep mse
If you do not see something like this:
mse0 at 0x23c irq 5 on isa
then it means that your bus mouse was not detected properly and you
should reboot with the `-c' flag and verify that the device entry for
mse0 matches your bus mouse settings.
If the mouse is probed properly but still fails to function then you
might double check that the /dev entry for the bus mouse exists. Use
the script /dev/MAKEDEV to create the entry if it doesn't already
exist, e.g:
% cd /dev
% sh MAKEDEV mse0
Serial Mice:
The easiest way to find which port your mouse is plugged into is to
use ``cat'' or ``kermit'' to look at the output of the mouse. Connect
to it and just make sure that it generates output when the mouse is
moved or clicked. If your mouse is plugged into the first serial port
(COM1), for example, you could do this:
% cat < /dev/cuaa0
Where /dev/cuaa0 represents the first serial port, /dev/cuaa1 the
second, /dev/cuaa2 the third and so on.
If you can't find the right mouse port then use ``dmesg | grep sio''
to get a list of serial devices that were detected at boot time:
% dmesg|grep sio
sio0 at 0x3f8-0x3ff irq 4 on isa
The presence of sio0 will indicate that COM1 was found. If you see
sio1, sio2 or sio3 then it means that a serial port was found at one
of the other com addresses and you should use the appropriate
/dev/cuaa<n> device entry to talk to it.
If things still aren't working then double check that the /dev entries
corresponding to these devices exist. Use the script /dev/MAKEDEV to
create entries if they don't already exist, e.g:
% cd /dev
% sh MAKEDEV cuaa0 [cuaa1, cuaa2, etc..]
If you plan to fine tune the screen size or position on your monitor
you'll need the specs for sync frequencies from your monitor's manual.
5. Running X
-------------
8mb of memory is a recommended minimum for running X. The server,
window manager, display manager and an xterm take about 8Mb of virtual
memory themselves. Even if their resident set size is smaller, on a
8Mb system that leaves very space for other applications such as gcc
that expect a few meg free. The R6 X servers may work with 4Mb of
memory, but in practice compilation while running X can take 5 or 10
times as long due to constant paging.
The easiest way for new users to start X windows is to type ``startx
>& startx.log''. Error messages are lost unless you redirect them
because the server takes over the screen.
To get out of X windows, type: ``exit'' in the console xterm. You can
customize your X by creating .xinitrc, .xserverrc, and .twmrc files in
your home directory as described in the xinit and startx man pages.
6. Rebuilding Kernels for X
----------------------------
The GENERIC FreeBSD 2.x kernel supports XFree86 without any
modifications required. You do not need to make any changes to the
GENERIC kernel or any kernel configuration which is a superset.
For a general description of BSD kernel configuration get
smm.02.config.ps.Z
(ftp://gatekeeper.dec.com/pub/BSD/manuals/smm.02.config.ps.Z). It is
a ready-to-print postscript copy of the kernel configuration chapter
from the system maintainers manual.
Alternatively, you can read the kernel configuration section of the
FreeBSD handbook (http://www.freebsd.org/handbook).
If you do decide to reduce your kernel configuration file, do not
remove the two lines below (in /sys/arch/i386/conf). They are both
required for X support:
options XSERVER #Xserver
options UCONSOLE #X Console support
The generic FreeBSD 2.x kernel is configured by default with the
syscons driver. To configure your kernel similarly, it should have a
line like this in /usr/src/sys/i386/conf/GENERIC:
device sc0 at isa? port "IO_KBD" tty irq 1 vector scintr
The maximum number of virtual consoles can be set using the MAXCONS
option:
options "MAXCONS=4" #4 virtual consoles
Otherwise, the default without a line like this is 12. You must have
more VTs than gettys as described in the end of section 3, and 4 is a
reasonable minimum.
The server supports several console drivers: pccons, syscons and pcvt.
The syscons driver is the default in FreeBSD 1.1.5 and higher. They
are detected at runtime and no configuration of the server itself is
required.
The pcvt console driver is bundled into FreeBSD and may be enabled
by changing the `sc0' line in your kernel configuration file to
`vt0'. See /sys/i386/conf/LINT for more details.
The XFree86 servers include support for the MIT-SHM extension. The
GENERIC kernel does not support this, so if you want to make use of
this, you will need a kernel configured with SYSV shared memory
support. To do this, add the following line to your kernel config
file:
options SYSVSHM # System V shared memory
options SYSVSEM # System V semaphores
options SYSVMSG # System V message queues
If you are using a SoundBlaster 16 on IRQ 2 (9), then you need a patch
for sb16_dsp.c. Otherwise a kernel configured with the SoundBlaster
driver will claim interrupt 9 doesn't exist and X server will lock up.
S3 cards and serial port COM 4 cannot be installed together on a
system because the I/O port addresses overlap.
7. Rebuilding XFree86
----------------------
The server link kit allows you to build an X server using a minimum
amount of disk space. Just unpack it, make the appropriate changes to
site.def, type ``./mkmf' and ``make'' to link the server. See
README.LinkKit (LinkKit.html) for more info.
The source tree takes about 114Mb before compiling and an additional
100Mb after ``make World''. You should configure the distribution by
editing xf86site.def and site.def in xc/config/cf before compiling.
By default, the config files are set up to build shared libraries. If
you are running a version of FreeBSD that doesn't include shared
library support, add the following line to site.def:
#define BuildBsdSharedLibs NO
If your system doesn't have support or SYSV shared memory (for
example, if you don't have the <sys/shm.h> header), you should disable
the MIT-SHM extension by adding the following line to site.def:
#define HasShm NO
To compile the sources on FreeBSD 1.1 and later, type:
make World
8. Building Other X Clients
----------------------------
The easiest way to build a new client (X application) is to use xmkmf
if an Imakefile is included with it. Type ``xmkmf -a'' to create the
Makefiles, then type ``make''. Whenever you install additional man
pages you should update whatis.db by running ``makewhatis
/usr/X11R6/man''.
Note: Starting with XFree86 2.1 and FreeBSD 1.1, the symbol __386BSD__
no longer gets defined either by the compiler or via the X config
files for FreeBSD systems. When porting clients to BSD systems, make
use of the symbol BSD for code which is truly BSD-specific. The value
of the symbol can be used to distinguish different BSD releases. For
example, code specific to the Net-2 and later releases can use:
#if (BSD >= 199103)
To ensure that this symbol is correctly defined, include <sys/param.h>
in the source that requires it. Note that the symbol CSRG_BASED is
defined for *BSD systems in XFree86 3.1.1 and later. This should be
used to protect the inclusion of <sys/param.h>.
For code that really is specific to a particular i386 BSD port, use
__FreeBSD__ for FreeBSD, __NetBSD__ for NetBSD, __386BSD__ for 386BSD,
and __bsdi__ for BSD/386.
9. Thanks
----------
Many thanks to:
o Pace Willison for providing initial *BSD support.
o Amancio Hasty for 386BSD kernel and S3 chipset support.
o David Greenman, Nate Williams, Jordan Hubbard for FreeBSD kernel
support.
o Rod Grimes, Jordan Hubbard and Jack Velte for the use of Walnut
Creek Cdrom's hardware.
o Orest Zborowski, Simon Cooper and Dirk Hohndel for ideas from
the Linux distribution.
$XConsortium: FreeBSD.sgml,v 1.3 95/01/23 15:34:41 kaleb Exp $
Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/FreeBSD.sgml,v 3.10 1995/01/28 16:01:28 dawes Exp $
$XFree86: xc/programs/Xserver/hw/xfree86/doc/READ.FreeBSD,v 3.12 1995/01/28 16:19:37 dawes Exp $
|