This chapter details the way to install X Window system for Linux. This version of X Window for Linux, called XFree86 Version 3.1.2, is an enhanced version of the X Window System Version 11 Release 6 with support for many versions of UNIX, including
Linux. XFree86 supports considerably more hardware than the video hardware supported by the MIT standard release of X Window.
Please read this entire chapter before starting XFree86. If you are not careful, you could damage your hardware. Most important:
XFree86 comes without a warranty of any kind. If you damage anything, even after reading these instructions, you are on your own.
Please note that even though I try to cover all the bases for installing X11 on your Linux system, I cannot cover all the hardware out there for PCs. In other words, this whole chapter is moot if you happen to have that one video card this version of
XFree86 on Linux will smoke! So read all the items here carefully and see how they apply to your hardware. You could also check Chapter 2, "Types of Linux Available," for the listing of the hardware supported by this
version of Linux. Check the HOWTO files for Hardware and Xfree86 for more up-to-date information.
You can use the terms X, XFree86, X11, and X Window interchangeably, if you do not care about legal issues. Actually, however, XFree86 refers to the product of The XFree86 Project, Inc.
You can also look at the installation documentation files and other manuals that come with XFree86 in your /usr/X11R6/lib/X11/etc directory. The main directory path is /usr/X11R6 for access to this tree, so that we are compatible with UNIX
installations of X11R6.
To read these documents, you need a working man program, as well as the groff package for formatting documents. Note that groff is required often to read man pages, so you should install the groff package, even though some distributions regard the
groff package as optional.
This chapter covers the following:
How to install X Window on Linux
A brief introduction to XFree86
Working with XF86Config and the XConfig file
Running X Window system
Introduction to X applications packages and compiling programs that use X
I also cover ways of finding information on X and XFree86 on the Internet and the ways to upgrade in the future. I discuss some of the problems you might have during installation, in addition to a list of the supported hardware.
Introduction to XFree86 and X11
X11 is a windowing system for UNIX clone operating systems. The X Window System with source code was issued by the MIT Consortium along with a set of original Copy notices. The X11 release on which XFree18.104.22.168 (or greater) is based is X11 Release
The MIT Consortium's work is continued by the X Consortium, which just released an updated X called X11R6. Most commercial releases of Linux already include X11R6.
Some XFree86 servers are partly derived from X386 1.2, which was the X server distributed with X11R5. However, many servers have been developed in the past few years. Although the source and installation trees retain the X386 namesimplifying
maintenance of the source treesthere is no connection between XFree86 and the commercial X386 product sold by SGCS. The XFree86 Project maintains technical contacts in an effort to keep changes that affect the user from diverging too radically from
the workings of the products. Neither group is involved directly in the workings of the other.
The XFree86 Project, Incorporated
In the past, the XFree86 development team had several problems because it was not a legal organization, which made it impossible to become a member of the X Consortium, Inc. Not being a member was detrimental because new releases are provided only for
members by the X Consortium before the official release date. This reason, along with several others, led to the founding of The XFree86 Project, Inc.
Xfree86 can be installed from the Red Hat CD-ROM using the RPM tool. The release is located in the /RedHat/SRPMS directory and is approximately 35MB. Installation from the CD-ROM or a hard drive is the only practical approach.
If you are downloading XFree from the Internet, the major files needed are listed in Table 21.1.
Table 21.1. Some distribution files for XFree86 available for FTP.
Server for 8514-based boards.
Server for AGX-based boards.
Server for Mach32-based boards.
Server for Mach8-based boards.
Server for monochrome video modes.
Server for P9000-based boards.
Server for S3-based boards.
Server for Super VGA-based boards.
Server for VGA/EGA-based boards.
Server for ET4000/W32-based boards.
The rest of the X11R6 binaries.
Config files for xdm, xinit, and fs.
Documentation and manpages.
Shared X libraries and support files.
Selected contrib programs.
Extra XFree86 servers and binaries.
Server linkkit for customization.
75-dpi screen fonts.
100-dpi screen fonts.
Large Kanji and other fonts.
Scaled fonts (Speedo, Type1).
PEX binaries, includes, and libraries.
Static X libraries and support files.
You can find the most recent versions on most Linux sites. You can find the C library (libc) and the dynamic loader (ld.so) in the GCC directory on the same Linux sites.
You can get the binary distributions of XFree86 for Linux via anonymous FTP from
The files have names of the form X(ver)(name).tar.gz (version 3.1.2) or XF86-name .tar.gz where ver is the XFree86 version and name is the name of the package. If you already know which server you need to run, you should not get the *-svr* files. The
filename form is XF86 servername.tar.gz, where servername is the name of the server to run.
The XFree86 distribution consists of several large gzipped tar files. You need the following setup to run XFree86. You have to have at least these versions.
Your computer needs main memory of at least 8MB and virtual memory of at least 16MB (that is, main memory plus swap memory). It is possible to run X on a 4MB machine if you take some precautions with memory usage.
In any event, your computer should have 16MB of virtual memory to run X Window. If you have 4MB of physical RAM, you should have 12MB of swap memory.
Because swapping is quite slow, you should have installed at least 8MB of RAM in your computer. With only 4MB of physical RAM, your X programs will run terribly slowly. If you want to run memory-hog programs from within X (for example, the C compiler
gcc), you should have at least 16MB of main memory and another 16MB of swap memory.
The XFree86 distribution takes up about 17MB to 37MB of disk space depending on how many servers you install. You can save several megabytes of disk space by removing the X servers you do not need. However, if you plan to install more window managers
than normal, you can expect to use about 35MB of disk space.
Before installing XFree86, you should make a backup of all files that you changed. They may not be usable, but they still hold a lot of information you might want to preserve. (Your old XConfig file will not be deleted, but it's always better to have a
backup of this file.)
Do not use XFree86 3.1.x or earlier. From the Internet, you can get a copy of a version later than 3.1.1. Version 3.1.2 is on this guide's CD-ROM.
There are two ways to install XFree86 on your machine: by using the setup utility or by using the manual procedure. The setup utility is the same menu-driven utility that you used in the original installation. The manual procedure is a bit more
involved. It also requires attention to detail but enables you to have more control over every step. This procedure offers you the ability to stop and repeat steps instead of going through the complete installation process in the menu-driven option.
To avoid headaches, and get to sleep early, use the setup program and menus to do the installation process. If you really are in a foul mood, proceed with the following manual method.
To install the binary distribution manually, perform the following steps:
Log in as root or become root if you already are logged in.
Copy all the release's tar files to floppies or the hard drive, or know their location on the CD-ROM. If the CD-ROM or hard drive is not mounted, mount it now and ensure that you can get to the files from within Linux. Determine from Table 21.2 the
name of the server type you need. For example, if you are using a color VGA monitor, you would want to use the XF86_SVGA server; for monochrome monitors including some EGA monitors (Do people still use them?), you might try XF86_Mono. You do not have to
choose the server this minute, but realize that you can use only one of these servers.
Create the directory /usr/X11R6 (don't worry if it's already there).
Change your current working directory to /usr/X11R6 (cd /usr/X11R6).
Run umask 022 to make sure all the files are writable.
Run the following command on each *.tgz file to unzip and install its contents:
gzip -rc tarfilename | tar xvof -
Table 21.2. Types of servers in XFree86.
Type of server
Color SVGA server
16-color (S)VGA server
S3 accelerated server
8514/A accelerated server
Mach8 accelerated server
Mach32 accelerated server
Mach64 accelerated server
ET4000/W32 accelerated server
The flag (-r) for the gzip command tells it to recursively create all names and paths for the files in the tar file. The -c option will send the contents out to the standard output from where it will be piped to the tar command. The flags for
the tar command tell tar to extract (x), be verbose (v), all files while preserving original ownership (o), from the file , designated by the standard input (-).
Repeat this step for all the tar files you have in your distribution.
The preceding step will overwrite all files from an older XFree86 version.
This step will not affect the XF86Config file, but the XF86Config.eg file will be overwritten. Most files in the distribution set will be overwritten. I repeat: Before installing XFree86, back up every file you changed.
After you finish installing XFree86, you have to configure it to match your system.
Setting Up Your XFree86 System
This section covers another one of the more difficult, time-consuming, and frustrating parts of installing XFree86: setting up a XF86Config file.
If you have XFree86 3.1.2 and your graphic card is listed in the Hardware-HOWTO file (see Chapter 1, "Introduction to Linux"), you should use the XF86Config program to do your configuration. This XF86Config program is a
comfortable and safe way to set up your system. If your graphics card is not listed, you have some work ahead of you.
Your XConfig file is called XF86Config.eg and is in the /usr/lib/x11 directory.
For more information, check the section called "The XF86Config File" in Chapter 22, "Configuring X Window on Linux."
One final check that you should do is to follow the link of /usr/lib/X11/X to the correct server. If you have an SVGA card, this link should be set, via an intermediate link if any, to /usr/bin/X11/XF86_SVGA. If the link does not point to the right
server, make it point to the correct server in /usr/bin/X11.
At this point, you should be able to type xinit at the prompt and have X Window on your monitor. You have two options in starting X: Use the xinit program or use the startx shell script. The advantage to using the xinit program is that you can easily
start X Window. The advantage to the startx script is that you can make modifications to how the environment variables are treated in bringing up X. With xinit, you are stuck with the defaults. In most cases, the defaults are what you want anyway. The
xinit program executes statements in the order they are found in the .xinitrc file.
Once you have set up an XF86Config file, you probably want to run X. This is not done by running X, but by running startx. When running it for the first time, use the command
$ startx 2>&1 > Xstartup.log
This command gets a log file of the X startup by redirecting all output from stdout and stderr to a log file, Xstartup.log. If you encounter problems, the information in this file will help you get a clue as to what happened.
If you encounter any problems, please look at the XFree86 documentation files in /usr/X11R6/lib/X11/doc. These files provide a lot of information on what to do if problems occur. For more information, also look in the FAQs that are mentioned in those
Once you are in the environment of the window manager you chose in the .xinitrc file, you have to conform X Windows System's way of moving around. Please see the next few chapters to learn how to work with windows with three window managers: mwm, olwm,
To stop X and get back to the text-based console, you have to list the last application that was in the .xinitrc file. This last application could be the window manager, an xterm, or just about any application. When you quit X Window by stopping this
application, you return to your character- or text-based terminal.
Another way to kill the window manager (and X) is to use the Ctrl-Alt-Backspace combination. This is not the preferred way of doing things because a more graceful way is to have the window manager be the last program started in the .xinitrc file, and
exit from it to stop X and get back to console.
X Applications Packages
Several packages are related to X. I have mentioned the first two by name because they have a great influence on the look and feel of X.
XView. This package is included on the CD-ROM as part of the Slackware distribution. If you are installing from another source, you may want to read the next few paragraphs; otherwise skip to the next item.
The xview3L5.1.tar.gz package is a port to Linux of SUN's xview3.2 package by Kenneth Osterberg. It includes the xview toolkit, a set of extensions to X. The xview3L5.1.tar.gz gives you the look and feel of the OPEN LOOK extension to X (many recognize
that from Open Windows from SUN). You can get it in the /pub/Linux/libs/X/Xview directory on sunsite.unc.edu.
To install XView, as root untar the tar file in any directory (/usr/src for example), read the documentation that comes with it (most importantly, the README), and run the INSTALL script. Note that you need about 25MB of free disk space to install
XView completely (with examples). Some files are duplicated on this distribution. After running the INSTALL script and removing the xview3L5.1 directory, you need about 11MB. This would include all examples, which take about 2MB of disk space, along with
2.5MB for development libraries and files. If you do not want to compile any XView programs, you can spare this 4.5MB by removing the static (*.a) and stub (*.sa) libraries, as well as the examples.
To run XView, you need at least 8MB of RAM, or even better, 16MB.
Do not remove any shared (*.so) libraries while pruning the XView tree! Other applications may need these libraries in the future.
Motif. This is commercial software, so you will have to pay for it. You can find an advertisement from Metrolink (a company that provides a port to Linux) on tsx-11:/pub/linux/advertisements. There are companies other than Metrolink that sell Motif;
every now and then advertisements will appear in the newsgroup comp.os.linux.announce.
Other Window managers. Both Motif and OPEN LOOK packages provide window managers different from the standard twm that comes with XFree86. XFree86 also includes the selection fvwm, a free window manager you may fall in love with. Many people do not like
the twm window manager, so better window managers have been developed for XFree86. There are many X Window system managers available that run on Linux. A selection of these can be found on sunsite in the directory /pub/Linux/X11/window-managers.
Additional libraries. Sometimes you need additional libraries to run binary distributions or to compile an application. If the former is the case, you should find a pointer to that library in the README file of that package. If you do not have a
pointer, you should look at the /pub/Linux/libs hierarchy at sunsite. Most libraries that work on Linux can be found there. If you cannot find it there and you have Internet access, follow the instructions on getting information in Appendix A, "Linux FTP Sites and Newsgroups."
Other X11 applications. There are many programs and applications available for X, way too many to list here. Look through the /pub/Linux/X11 hierarchy on sunsite.unc.edu for ports with many Linux packages. Most
programs need no changes to run on Linux, so look at the generic X11 program archives, as well as at the Linux-specific sites. One of the largest X11 sites is ftp.x.org. In the /R5contrib directory you can find many programs
Compiling Programs That Use X
Please read the GCC-FAQ file. This is on the F series of the installation disks and CD-ROM. This file can also be found in the /pub/Linux/docs/faqs directories of sunsite before compiling any programs. Many questions on compiling programs with Linux are
answered in this FAQ. Many Linux distributions include the most relevant FAQs in the directory /usr/doc, so you might look there first.
If you have the source code for a program that uses X11, it usually is shipped with an Imakefile instead of a Makefile.
Imakefiles are files that create Makefiles for your system. Discussing Imakefiles is beyond the scope of this guide; however, you have to work with Imakefiles if you work at all with X sources. Just remember the shell script xmkmf, and you should be
The xmkmf shell script actually runs the imake command with a set of arguments. The most common argument is the -DUseInstalled argument. If you examine xmkmf, (look in /usr/bin/X11/imake), you will see that the xmkmf script is a basic wrapper around
a call to imake. It's very tempting to use imake on a command line by itself. Do not do so. Run the imake command with the -DUseInstalled argument if you must run imake on the command line. If you do not use this argument, imake will behave as if it were
re-creating the X Window system on your current directory.
Of course, before ever running xmkmf, you should have read the documentation that usually comes with such packages.
Run xmkmf in the directory that contains the Imakefile. If there is a hierarchy of directories with Imakefiles, you usually only have to run xmkmf in the root directory of that hierarchy.
The xmkmf command builds the Makefiles in all directories in the hierarchy.
Then you should run the make command with an argument to let make resolve its dependencies with the following command:
$ make depend
Don't be afraid if include files such as stddef.h, varargs.h, and so on, are not found. They are gcc proprietary header files and therefore not in the standard include directories.
After that, you can make the program by running make, and you can install your new utility (usually in /usr/X11R6/bin) by running
$ make install
The installation of the man pages is done by running
$ make install.man
Finding Information on X and XFree86 on the Net
There is an excellent document about XFree86 on the Internet by Matt Welsh, called "The Linux XFree86 HOWTO" document. This document will make an excellent resource for you as you install XFree86.
For general X questions, you should read the FAQ and the FAQ-Xt. You can get these from ftp.x.org in the directory /R5contrib. Many Linux distributions include most relevant FAQs in the directory /usr/doc. Look on the
CD-ROM for this directory.
If you have questions about the XFree86 package and cannot find an answer in the documentation files (XFree86, XF86Config, XF86_* manpages, or the README files in /usr/X11R6/lib/X11/doc), you may want to post a question to a newsgroup. The appropriate
newsgroup for that purpose is comp.windows.x.i386unix. This newsgroup is dedicated to the XFree86 system. If you have a problem with the server and want to post a question to this newsgroup, you should provide
enough information for those that want to help you. Here are some things that should be included in all postings concerning server problems:
The operating system and which release you are running.
Hardware you have (at least bus type [ISA/EISA/VLB/PCI], your graphic card including chip set, video RAM type #[D/VRAM], size, and speed).
A concise description of the problem.
A printout of the server startup (you can generate that by running startx 2>1 > Xerror.log or startx >& Xerror.log depending on whether you use a Bourne shell or C shell derivative.
The used parts of the XF86Config. (It is not a good idea to include all lines commented out by a leading #.) This would be the largest part of your post, and most people will already know the Copy statements.
A list of fixes you have already attempted.
Bug reports or questions on XFree86 can be sent directly to XFree86@Xfree86.org. This is the contact address of The XFree86 Project.
There are some other newsgroups that cover X-related topics:
Note that most of these groups have FAQ lists that are posted regularly to these groups. As always with regular postings, these can be obtained from rtfm.mit.edu via anonymous FTP.
Some Common Problems
Here are some of the problems you might see when you work with XFree86.
No windows. All you get is a gray background and no windows. This is due to running without a window manager. Running X only starts the X server, not the window manager. You should use a script shown earlier in startx.
Your Logitech serial mouse does not work. The keyword Logitech is reserved for older Logitech serial mice. Use the keyword MouseMan (or Microsoft) for newer mice. Logitech serial mice plugged into a PS/2 port require the keyword PS/2.
You get errors about not finding any font files. First check the XF86Config file to see whether the directories in the font path are named correctly and contain fonts. If they are, run mkfontdir in each of those directories to set them up for use with
After leaving X, your screen fonts are not restored. This is a known bug with some servers. There are utilities called runx or restoretext coming with svgalib that can help you in most cases. You can get them from sunsite.unc.edu in the file
You will have some problems with the Diamond, Compaq AVGA, and S3 cards. This is what you have to live with when you are dealing with freeware.
The server dies with the message Cannot find a free VT. XFree86 needs a free virtual terminal (VT) on which to run. So if you have put a getty process on every virtual console in your /etc/inittab, XFree86 is not able to start. The common practice is
to leave /dev/tty8 (for kernel messages) and /dev/tty7 (for XFree86) free of a getty process.
This is not an exhaustive list. Please read the HOWTO documents in /doc/HOWTO on the CD-ROM for more information about other video card problems that are too specific to list here.
Currently, XFree86 Version 3.1.2 supports the following chip sets in the XF86_SVGA server. The list will be much much longer by the time this guide hits the stands, so use the following list as a guideline:
Nonaccelerated chip sets:
Tseng ET3000, ET4000AX, ET4000/W32
Western Digital/Paradise PVGA1, WD90C00, WD90C10, WD90C11, WD90C24, and WD90C30
Cirrus CLGD5420, CLGD5422, CLGD5424, CLGD5426, and CLGD5428 chip sets
Western Digital WD90C31 chip sets
These chip sets are all supported in 256-color (XF86_SVGA) and in monochrome mode (XF86_Mono) with the exception of the Cirrus chip sets, which are only supported in 256-color mode.
If you have a grayscale display, you have to run the color server because grayscale behaves just like color, not like monochrome.
The monochrome server also supports generic VGA cards (using 64KB of the video memory as a single bank), the Hercules card, and the Hyundai HGC-1280. These drivers are not part of the XF86_Mono server by default. If you want to use these, you have to
reconfigure your XF86_Mono server using the LinkKit, or of course, the source distributionbut the LinkKit needs less disk space and a shorter compile time.
XFree86 supports at least the following accelerated chip sets with separate servers:
S3 86C911, 86C924, 86C801, 86C805, and 86C928 supported by the XF86_S3 server
ATI mach8 supported by the XF86_Mach8 server
ATI mach32 supported by the XF86_Mach32 server
ATI Mach64 supported by the XF86_Mach64 server
ET4000/W32 supported by the XF86_W32 server
IBM 8514/a and true clones supported by the XF86_8514 server
S3 Vision864 and Vision964.
The hardware that is not currently supported is:
TIGA. TIGA will never be supported because it requires licensing materials from TI and may disallow source distributions.
Microfield boards. Microfield boards will never be supported because they use proprietary and undocumented custom microcode interfaces.
MGA chip sets (Matrox cards).
For some of these chip sets there are specific README files to be found in /usr/X11R6/lib/X11/doc. If there is one for the chip set you use, read it! In these READMEs, the specific options that can be used to configure the server are explained.
Currently, there are special READMEs for ATI, Trident, Tseng, Western Digital, Cirrus, and manufacturer-specific chip sets.
More information on the servers can be found in their man pages. Another place to check is the XFree86-HOWTO file in the sunsite and tsx-11 archives. The HOWTO document will generally be more up-to-date than any printed matter.
This section covered one of the hardest things you will have to do when installing a package on Linuxinstalling XFree86. Naturally, all of the possible problems you will face while installing this are too long to list here. After reading this
chapter, though, you should have an idea of what you are getting yourself into and the general steps you have to take.
Do not despair if things don't work out just as the instructions say they will. You should be able to look at the configuration files to determine where the problem is and what might be done to fix it. If nothing works despite your best efforts, you
have the recourse of knowing where to look for answers in FAQs, newsgroups, and FTP sites on the Internet for HOWTO and other documents on Linux.