Readme for the XFree86 3.1.1 LinkKit

# 1 Readme for the XFree86 3.1.1 LinkKit

Contents of this section

1. For systems which don't use gcc-2, you may need to install libgcc.a if the binary distribution you are using was built with gcc-2.
2. Make sure that you have the XFree86 3.1.1 config files and libraries and headers installed under /usr/X11R6. For some OSs these will be included in the `lib' and `inc' packages. For others they are included in the `prog' or `dev' package. Older versions are not compatible.
3. Edit the site.def file to define which servers you want to build, and the drivers and extensions you want included.
   - Set `HasGcc` and `HasGcc2` to match the compiler you are using if the defaults aren't correct.
   - If the LinkKit was built with gcc-2.x and you are using some other compiler, you must install libgcc.a and set `NeedLibGcc` to `YES`.
   - To build the 256 colour server: set `XF86SVGAServer` to `YES`.
   - To build the 16 colour server: set `XF86VGA16Server` to `YES`.
   - To build the monochrome server: set `XF86MonoServer` to `YES`.
   - To build the S3 server: set `XF86S3Server` to `YES`.
   - To build the Mach8 server: set `XF86Mach8Server` to `YES`.
   - To build the Mach32 server: set `XF86Mach32Server` to `YES`.
   - To build the Mach64 server: set `XF86Mach64Server` to `YES`.
   - To build the P9000 server: set `XF86P9000Server` to `YES`.
   - To build the AGX server: set `XF86AGXServer` to `YES`.
   - To build the ET4000/W32 server: set `XF86W32Server` to `YES`.
   - To build the IBM 8514/A server: set `XF86I8514Server` to `YES`.
   - To build the Xnest server: set `XnestServer` to `YES`.
   - Set `XF86SvgaDrivers` to the list of drivers you want to include in the SVGA server.
   - Set `XF86Vga16Drivers` to the list of drivers you want to include in the 16 colour server.
   - Set `XF86Vga2Drivers` to the list of drivers you want to include in the monochrome vga server.
   - Set`XF86MonoDrivers` to the list of non-vga mono drivers you want to include in the mono or VGA16 servers (when building dual-headed servers).
   - Note: the ordering of drivers determines the order in which the probing is done. The ``generic`' driver should be the last one included in the Mono and VGA16 and SVGA servers because its probe always succeeds.
   - To include the PEX extension: set `BuildPexExt` to `YES`.
   - To include the X Image Extension: set `BuildXIE` to `YES`.
   - To include the Low Bandwidth X extension: set `BuildLBX` to `YES`.
   - To include the Screen Saver extension: set `BuildScreenSaverExt` to `YES`.
   - If you are building more than one Xserver, uncomment the `ServerToInstall` line and set it to the name of the Xserver you want to be the default server (i.e., the one that the ``X'' sym-link points to).
4. If you are including a driver that it not part of the standard distribution, make a directory in `drivers/vga256` (`drivers/vga2` if it is for the VGA2 part of the Mono server, `drivers/vga16` if it is for the 16 colour server, or `drivers/mono` non-VGA part of the Mono and VGA16 servers) and copy either the source or .o file and a suitable Imakefile into that directory. The name of the directory should be the same as the name of the driver (refer to the documentation in the `VGADriverDoc` directory for more details).
5. To build the Makefile, run

         ./mkmf

6. Run ``make`' to link the server(s) as configured.
7. Run ``make install`' to install the new server(s).
8. Run ``make clean`' to remove the files that were created by this procedure.
9. If you edit the site.def file and change the selection of servers being built or the drivers included in them, repeat the above procedure. If changing the selection of Xserver extensions being included it is sufficient to run ``make Makefile`' instead of ``./xmkmf`'.
10. It is possible to see which drivers are included in the Xserver by running it with the ``-showconfig`' flag. To check which extensions are included, start the Xserver and run ``xdpyinfo`'.

    $XConsortium: LinkKit.sgml,v 1.2 95/01/16 13:17:43 kaleb Exp $
    $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/LinkKit.sgml,v 3.3 1995/01/28 16:01:36 dawes Exp $

Next Chapter, Previous Chapter

Table of contents of this chapter, General table of contents

Top of the document, Beginning of this Chapter