3 Installing the Binaries

Contents of this section

The binary distribution is composed of a number of tar archives which are the executables, servers, fonts, libraries, include files, man pages, config files, and the server link kit. The full distribution takes over 55MB of disk space.

All archives are now made using the NetBSD package tools. We recommend that you install these tools first. All packages can be installed using pkg_add.

Note that many clients were moved from the X11R6 distribution to the ``contrib'' area. However, they are still distributed with the XFree86 binary distribution.

The contents of the packages are:

REQUIRED:

X311doc

READMEs and XFree86 specific man pages.

X311bin

all of the executable X client applications and shared libs

X311font

the misc and 75dpi fonts

X311lib

data files needed at runtime

X311cfg

customizable xinit, xdm, and fs runtime configuration files.

Choose at least one of the following to match your hardware:

X311svga

the 8-bit pseudo-color X server for Super VGA cards

X311vg16

the 4-bit pseudo-color X server for VGA & SVGA cards.

X311mono

the Monochrome X Server

X3118514

the X server for IBM 8514/A and compatible boards

X311agx

the X server for AGX boards

X311mc8

the X server for ATI Mach8 graphics boards

X311mc32

the X server for ATI Mach32 graphics boards

X311mc64

the X server for ATI Mach64 graphics boards

X311p9k

the X server for P9000 based boards

X311s3

the X server for S3 based boards

X311w32

the X server for et4000w32 based boards

OPTIONAL:

X311fs

the font server with man pages.

X311prog

the X11 header files and static libraries needed only for compiling other X applications

X311man

man pages except XFree86 specific ones in the doc archive

X311xfnt

the other fonts (100dpi, scaled, Japanese, Chinese, etc)

X311link

X server reconfiguration kit

If this is your first time, then you can safely install all of the packages. As a minimal install, you'll need doc, bin, fonts lib, config, and one X server.

3.1 Installing the packages with pkg_add

  1. Become ``root''.
  2. For each package that you want to install type:
     # pkg_add <pkg>.tgz
    
    If you don't have enough room in /usr/X11R6 you can specify another directory by using the -p option to pkg_add. See pkg_add(8) for details. Then make a symbolic link /usr/X11R6 to this directory.

Continue with item Setting XWINHOME below.

3.2 Installing the packages without pkg_add

To unpack and install the archives:

  1. Create some destination directory in which you'd like the X distribution to live. /usr/X11R6 is recommended, but if that partition is full (as it is on my machine), then just create an alternate directory, and sym-link /usr/X11R6 to this place. ie, on my machine, I do the following:
        % cd /usr/local
        % mkdir X11R6
        % ln -s /usr/local/X11R6 /usr/X11R6
    
  2. You must be logged in as root to unpack the archives and use a ``umask'' value of 022. Typing ``umask 022'' sets it. Caution: If you do not extract the files as user ``root'' with the correct umask you may not be able to run XFree86 3.1.1. The X server needs special permissions that are only granted to the root user. Assuming that the destination directory for XFree86 3.1.1 is /usr/X11R6, run the following from wherever all the archive files are (replace /usr/X11R6 with wherever you wish them to go if that isn't the place):
     cd /usr/X11R6
    
     tar xzf X311doc.tgz
     tar xzf X311bin.tgz
     tar xzf X311lib.tgz 
     tar xzf X311font.tgz
     tar xzf X311man.tgz
    
     tar xzf X311link.tgz
     tar xzf X311prog.tgz
     tar xzf X311xfnt.tgz
     tar xzf X311fs.tgz
     tar xzf X311cfg.tgz
    
    And unpack the server(s) you need:
     tar xzf X311<server>.tgz
    
  3. Set the XWINHOME environment variable to the path where you installed XFree86. Under csh type:
     setenv XWINHOME /usr/X11R6
    
    under sh type
     XWINHOME=/usr/X11R6 
     export XWINHOME
    
    (Replace /usr/X11R6 by the appropriate dir if necessary). Also, don't forget to include these lines in your .login or .profile for permanent use.
  4. Create a symbolic link in ${XWINHOME}/bin named ``X'' that points to the server that matches your video card: See the XF86_* man pages for hardware details. For example, if you have an ET4000 based SVGA card:
     cd $XWINHOME/bin
     rm -f X
     ln -s XF86_SVGA X
    
  5. Install support for the shared libraries: add the following lines at the end of /etc/rc.local:
     if [ -d /usr/X11R6/lib ]; then
        echo 'Adding X shared libraries'
        ldconfig /usr/X11R6/lib
     fi
    
  6. Reboot your machine to take all previous modifications into account.

If X was already installed on your machine and you have customized your xinit or xdm runtime configuration scripts, omit the config archive or unpack it elsewhere and extract only that which you need.

NOTE: you don't need to uncompress the fonts files in lib/X11/fonts. If you want to uncompress them anyway, don't forget to run ``mkfontdir'' in each directory after that.

Next Chapter, Previous Chapter

Table of contents of this chapter, General table of contents

Top of the document, Beginning of this Chapter