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 67MB 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.

The contents of the packages are:

REQUIRED:

X32doc

READMEs.

X32bin

all of the executable X client applications and shared libs

X32fnts

the misc, 75dpi and PEX fonts

X32lib

data files needed at runtime

X32cfg

customizable xinit and xdm runtime configuration files.

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

X32SVGA

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

X32VG16

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

X32Mono

the Monochrome X Server

X328514

the X server for IBM 8514/A and compatible boards

X32AGX

the X server for AGX boards

X32I128

the X server for I128 boards

X32Ma8

the X server for ATI Mach8 graphics boards

X32Ma32

the X server for ATI Mach32 graphics boards

X32Ma64

the X server for ATI Mach64 graphics boards

X32P9K

the X server for P9000 based boards

X32S3

the X server for S3 based boards

X32S3V

the X server for S3 ViRGE boards

X32W32

the X server for et4000w32 and et6000 based boards

The following servers are available for PC98 hardware from the directory XFree98-3.2

X329EGC

EGC

X329GAN

GANB-WAP(cirrus)

X329480

PEGC-480

X329NS3

NEC(S3)

X329NKV

NEC(cirrus)

X329LPW

PowerWindowLB(S3)

X329SPW

SKB-PowerWindow(S3)

X329WEP

WABEP(cirrus)

X329WBS

WABS(cirrus)

X329WSN

WSN-A2F(cirrus)

X329GA9

GA-968V4/PCI(S3 968)

X329TGU

TGUI

OPTIONAL:

X32fsrv

the font server with man pages.

X32prog

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

X32man

man pages

X32lkit

X server reconfiguration kit

X32lk98

X server reconfiguration kit for PC98 X servers

X32f100

100dpi fonts

X32fcyr

Cyrillic fonts

X32fscl

Scalable fonts

X32fnon

Other fonts (Japanese, Chinese, etc)

X32set

XF86Setup configuration utility, needs X32VG16

X32nest

Nested X server

X32vfb

Virtual framebuffer X server

X32html

HTML format version of the documentation

X32ps

PostScript format version of the documentation

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 Additional Setup 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. The X server needs special permissions that are only granted to the root user. Assuming that the destination directory for XFree86 3.2 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 X32doc.tgz
     tar xzf X32bin.tgz
     tar xzf X32lib.tgz 
     tar xzf X32fnts.tgz
     tar xzf X32man.tgz
    
     tar xzf X32prog.tgz
     tar xzf X32fsrv.tgz
     tar xzf X32cfg.tgz
    
    And unpack the server(s) you need:
     tar xzf X32<server>.tgz
    

3.3 Additional setup

  1. 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.
  2. 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
    
  3. 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
    
    On OpenBSD, this step is not necessary, since /usr/X11R6/lib is included by default in the search patch of the dynamic linker.
  4. 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