INSTALL(1)

NAME
install - notes about Plan 9 from User Space installation

SYNOPSIS
cd ; ./INSTALL

DESCRIPTION
To obtain the Plan 9 tree, use CVS (see cvs(1)) or download a tar file from

In the root of the tree, run ./INSTALL. This script first uses make(1) to build the Plan 9 build program mk(1) if necessary. It cleans all previously built object files and libraries out of the tree, rebuilds and installs everything, and then cleans up.

There are a few files in tree which have the root hard-coded in them. After the build, INSTALL edits these files to replace the string /usr/local/plan9 with the name of the root of the current tree.

Finally, INSTALL builds an HTML version of the manual and installs it in /man.

INSTALL can safely be repeated to rebuild the system from scratch.

At the end of the build, INSTALL prints suggested settings for the environment variables $PLAN9 and $PATH. After setting those, the script $PLAN9/dist/isum will print a short summary of the installation output, omitting the usual command chatter but preserving compiler warnings and errors.

Plan 9 from User Space uses different threading implementations on Linux 2.6 and later kernels than on 2.4 and earlier; and on FreeBSD 5 and later kernels than on FreeBSD 4 and earlier. Running binaries from one class on another will not work.

Some Linux 2.6 systems (e.g., Gentoo) do not use the new NPTL pthread library even though the kernel supports them. On these systems, plan9port must fall back on the threading code intended for Linux 2.4. To accomplish this, INSTALL checks whether the running system uses NPTL and sets SYSVERSION in /config accordingly. The file /LOCAL.config is appended to config after this auto-detection and can be used to override the choices. If LOCAL.config contains a line WSYS=nowsys then the system is built without using X11.

FILES

/lib/moveplan9.files
    the list of files that need to have /usr/local/plan9 edited out of them

/lib/moveplan9.sh
    the script that edits the files

/src/mkmk.sh
    the shell script used to build mk(1)

/dist/manweb
    the shell script that builds the HTML manual

/man/index.html
    the top-level page in the HTML version of the manual

/install.log
    logged output from the last run of INSTALL

SEE ALSO
intro(1), cvs(1)