XFree86 on Darwin and Mac OS X : Getting Started
Previous: Hardware Support and Configuration
Next: Run X Windows

3. Getting Started

Following are instructions for building and running your own copy of XFree86. The procedure for getting your X server up and running on Darwin and Mac OS X are very similar, but it is actually somewhat more difficult on Mac OS X. Where there are differences I have noted them below. Both Mac OS X Developers' Preview 4 and Mac OS X Public Beta are covered. Note that to build XFree86 for yourself on Mac OS X Beta, you will need to have the Developers' Tools. If you did not receive these as a member of ADC, they are available for download from the Apple Developer Connection.

If you want to save some time, you can use the precompiled binaries provided by the XFree86 server at ftp://ftp.xfree86.org/pub/XFree86/4.0.2/binaries/Darwin/. Follow the instructions in the Install document to install it.

This will create two new directory trees, /usr/X11R6 and /private/etc/X11. If you have the developers' tools, you may have to run ranlib on all the libraries in /usr/X11R6/lib/* before trying to build other X applications.

If you get the precompiled binaries you can skip ahead to the section on running X windows

On the other hand, if you want to build things yourself from scratch, follow the directions below.

If you want to recompile the X server on Mac OS X, you will have to make the header files as described below.

3.1. Get the Code

The first thing you need to do is to get the source code from the XFree86 project.

3.2. Make Header Files for Mac OS X

These next steps are not necessary if you are building XFree86 on Darwin. Mac OS X Beta or DP4 does not include many of the "in-progress" header files that are needed to successfully build XFree86. The general philosophy is that at any given time, Mac OS X will include only headers files that are "ready for prime time" while Darwin will include a snapshot of Apple's current efforts. So if you have access to a Darwin system, I would suggest using this instead of Mac OS X to build XFree86. If you don't, read the appropriate page below for an outline of what you need to do:

3.3. Build XFree86

Once you have everything ready it is easy to build and install XFree86. From the command line:

cd sandbox/xc
make World >& world.log

(wait for several hours)

su root
make install >& install.log
make install.man >& man.log


XFree86 on Darwin and Mac OS X : Getting Started
Previous: Hardware Support and Configuration
Next: Run X Windows