mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
86 lines
3.4 KiB
Text
86 lines
3.4 KiB
Text
|
|
||
|
|
INSTALL(1) INSTALL(1)
|
||
|
|
|
||
|
|
NAME
|
||
|
|
install - notes about Plan 9 from User Space installation
|
||
|
|
|
||
|
|
SYNOPSIS
|
||
|
|
cd /usr/local/plan9; ./INSTALL
|
||
|
|
|
||
|
|
DESCRIPTION
|
||
|
|
To obtain the Plan 9 tree, use CVS (see cvs(1)) or download
|
||
|
|
a tar file from http://swtch.com/plan9port.
|
||
|
|
|
||
|
|
In the root of the tree, run ./INSTALL. This script first
|
||
|
|
uses make(1) to build the Plan 9 build program mk(1) if nec-
|
||
|
|
essary. 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 /usr/local/plan9/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 set-
|
||
|
|
ting those, the script $PLAN9/dist/isum will print a short
|
||
|
|
summary of the installation output, omitting the usual com-
|
||
|
|
mand chatter but preserving compiler warnings and errors.
|
||
|
|
|
||
|
|
Plan 9 from User Space uses different threading implementa-
|
||
|
|
tions on Linux 2.6 and later kernels than on 2.4 and ear-
|
||
|
|
lier; 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 /usr/local/plan9/config accordingly. The file
|
||
|
|
/usr/local/plan9/LOCAL.config is appended to config after
|
||
|
|
this auto-detection and can be used to override the choices.
|
||
|
|
If LOCAL.config contains a line WSYSTYPE=nowsys then the
|
||
|
|
system is built without using X11.
|
||
|
|
|
||
|
|
Page 1 Plan 9 (printed 11/28/05)
|
||
|
|
|
||
|
|
INSTALL(1) INSTALL(1)
|
||
|
|
|
||
|
|
Once the system is built for the first time, it can be main-
|
||
|
|
tained and rebuilt using mk(1).
|
||
|
|
|
||
|
|
FILES
|
||
|
|
/usr/local/plan9/lib/moveplan9.files
|
||
|
|
the list of files that need to have /usr/local/plan9
|
||
|
|
edited out of them
|
||
|
|
|
||
|
|
/usr/local/plan9/lib/moveplan9.sh
|
||
|
|
the script that edits the files
|
||
|
|
|
||
|
|
/usr/local/plan9/src/mkmk.sh
|
||
|
|
the shell script used to build mk(1)
|
||
|
|
|
||
|
|
/usr/local/plan9/dist/manweb
|
||
|
|
the shell script that builds the HTML manual
|
||
|
|
|
||
|
|
/usr/local/plan9/man/index.html
|
||
|
|
the top-level page in the HTML version of the manual
|
||
|
|
|
||
|
|
/usr/local/plan9/install.log
|
||
|
|
logged output from the last run of INSTALL
|
||
|
|
|
||
|
|
SEE ALSO
|
||
|
|
intro(1), cvs(1)
|
||
|
|
|
||
|
|
Page 2 Plan 9 (printed 11/28/05)
|
||
|
|
|