Installing the Binaries

# 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