Installation instructions for XFree86 2.1 Linux distribution [3/18/94] ---------------------------------------------------------------------- Contents -------- The XFree86 2.1 Linux distribution is composed of the following parts: size name req/opt description 380533 XF86-2.1-8514.tar.gz R[1] Server for 8514-based boards. 395572 XF86-2.1-Mach32.tar.gz R[1] Server for Mach32-based boards. 385528 XF86-2.1-Mach8.tar.gz R[1] Server for Mach8-based boards. 338962 XF86-2.1-Mono.tar.gz R[1] Server for monochrome video modes. 423066 XF86-2.1-S3.tar.gz R[1] Server for S3-based boards. 411851 XF86-2.1-SVGA.tar.gz R[1] Server for Super VGA-based boards. 356693 XF86-2.1-VGA16.tar.gz R[1] Server for VGA/EGA-based boards. 765094 XF86-2.1-bin.tar.gz R The rest of the X11R5 binaries. 3061 XF86-2.1-cfg.tar.gz R[2] Config files for xdm, xinit and fs. 128913 XF86-2.1-doc.tar.gz R XFree86 documentation and manpages. 174986 XF86-2.1-inc.tar.gz R Include files. 533019 XF86-2.1-lib.tar.gz R Shared X libraries and support files. 487359 XF86-2.1-fnt.tar.gz R Basic fonts. 1371769 XF86-2.1-fnt75.tar.gz O 75-dpi screen fonts. 1670093 XF86-2.1-fnt100.tar.gz O 100-dpi screen fonts. 1761394 XF86-2.1-fntbig.tar.gz O Large Kanji and other fonts. 366282 XF86-2.1-fntscl.tar.gz O Scaled fonts (Speedo). 918703 XF86-2.1-lkit.tar.gz O Server LinkKit. 422137 XF86-2.1-man.tar.gz O Manual pages. 1006427 XF86-2.1-pex.tar.gz O PEX binaries, includes and libraries. 462124 XF86-2.1-slib.tar.gz O Static libraries. 48871 XF86-2.1-xdmshd.tar.gz O[3] Shadow password xdm kit. R = Required for basic operation. O = Optional. 1 = Select server required for your board. If you're unsure which server to choose, run SuperProbe (in the bin package). 2 = These are the initialization files for xdm and xinit. If you don't have them, this is required. If you do have them, these are not changed. 3 = The version of xdm available in the bin package is for use without shadow passwords. The xdmshd package provides a kit to build xdm with shadow password support. Installation ------------ The distribution was compiled to reside in /usr/X386. The entire installation takes up about 28Mb. A "normal" installation takes up about 15Mb. The installation must be done as root as there are binaries which must be unpacked setuid-root. Each package is tarred up relative to /usr/X386 rather than /, so it's possible to unpack the distribution on another partition and make a symlink from there to /usr/X386. Each tarfile has been compressed using gzip, so the command `gunzip < {xxx.tar.gz} | tar xfBp -' will decompress and untar the file. At the very least, you will have to unpack all of the required packages described above. The optional packages can be unpacked now or later. The next step is to configure the server. First, make sure the symbolic link /usr/X386/bin/X points to the correct server. As mentioned above, if you're unsure about which server to select, run the SuperProbe program (in /usr/X386/bin) which should give you that information. Then, you have to create a configuration file Xconfig, found in /usr/X386/lib/X11. The distribution provides a sample Xconfig.sample, which can be used as a starting point. Unfortunately, this can be a complex task. Read the Xconfig manpages and all documentation regarding your server. There are lots of helpful hints and pre-tested settings in the files found in /usr/X386/lib/X11/etc. The X libraries use the dynamic linker, ld.so, which must be installed. Make sure that /usr/X386/lib is one of the entries in /etc/ld.so.conf, or add it to your LD_LIBRARY_PATH environment variable. After installing, run ldconfig to update the system with the location of the new X libraries. Finally, add /usr/X386/bin to your PATH, and /usr/X386/man to your MANPATH. The command `startx' can be used to start the server and any clients. Further information is available in the manpages. Notes ----- None of the above servers were compiled with PEX support. A server with PEX support can easily be built with the LinkKit. The Mono server also has no support for dual-headed displays (external Hercules/MDA adapters). This support may be added by building the Mono server using the LinkKit. The xdm provided in the bin package was compiled without shadow password support. Since at the time of this distribution there was no clear consensus on the shadow library to use, the xdmshd package needs to be linked before it can be used.