1 4ef9ff62 2005-01-14 devnull .TH INSTALL 1
3 4ef9ff62 2005-01-14 devnull install \- notes about Plan 9 from User Space installation
4 4ef9ff62 2005-01-14 devnull .SH SYNOPSIS
6 4ef9ff62 2005-01-14 devnull cd \*9; ./INSTALL
7 4ef9ff62 2005-01-14 devnull .SH DESCRIPTION
8 4ef9ff62 2005-01-14 devnull To obtain the Plan 9 tree, use CVS
10 4ef9ff62 2005-01-14 devnull .IR cvs (1))
11 4ef9ff62 2005-01-14 devnull or download a tar file from
12 4ef9ff62 2005-01-14 devnull .HR http://swtch.com/plan9port "" .
14 4ef9ff62 2005-01-14 devnull In the root of the tree, run
15 4ef9ff62 2005-01-14 devnull .BR ./INSTALL .
16 4ef9ff62 2005-01-14 devnull This script first uses
17 4ef9ff62 2005-01-14 devnull .IR make (1)
18 4ef9ff62 2005-01-14 devnull to build the Plan 9 build program
19 4ef9ff62 2005-01-14 devnull .IR mk (1)
20 4ef9ff62 2005-01-14 devnull if necessary.
21 4ef9ff62 2005-01-14 devnull It cleans all previously built object files and libraries out of the tree,
22 4ef9ff62 2005-01-14 devnull rebuilds and installs everything, and then cleans up.
24 4ef9ff62 2005-01-14 devnull There are a few files in tree which have the root
25 4ef9ff62 2005-01-14 devnull hard-coded in them.
26 4ef9ff62 2005-01-14 devnull After the build,
27 4ef9ff62 2005-01-14 devnull .I INSTALL
28 4ef9ff62 2005-01-14 devnull edits these files to replace the string
29 4ef9ff62 2005-01-14 devnull .B /usr/local/plan9
30 4ef9ff62 2005-01-14 devnull with the name of the root of the current tree.
33 4ef9ff62 2005-01-14 devnull .I INSTALL
34 4ef9ff62 2005-01-14 devnull builds an HTML version of the manual and installs it in
35 4ef9ff62 2005-01-14 devnull .BR \*9/man .
37 4ef9ff62 2005-01-14 devnull .I INSTALL
38 4ef9ff62 2005-01-14 devnull can safely be repeated to rebuild the system from scratch.
40 3dc1ecc1 2005-01-14 devnull The system uses different threading implementations on Linux 2.6 and
41 3dc1ecc1 2005-01-14 devnull later kernels than on 2.4 and earlier;
42 3dc1ecc1 2005-01-14 devnull and on FreeBSD 5 and later kernels than on FreeBSD 4 and earlier.
43 b04c42e9 2005-01-17 devnull Running binaries from one class on another will not work.
45 b04c42e9 2005-01-17 devnull Some Linux 2.6 systems (e.g., Gentoo) do not use the new NPTL pthread library
46 b04c42e9 2005-01-17 devnull even though the kernel supports them. On these systems, plan9port must
47 b04c42e9 2005-01-17 devnull fall back on the threading code intended for Linux 2.4. To accomplish this,
48 b04c42e9 2005-01-17 devnull .I INSTALL
49 b04c42e9 2005-01-17 devnull checks whether the running system uses NPTL and sets
50 b04c42e9 2005-01-17 devnull .B SYSVERSION
52 b04c42e9 2005-01-17 devnull .B \*9/config
53 b04c42e9 2005-01-17 devnull accordingly.
54 4ef9ff62 2005-01-14 devnull .SH FILES
56 4ef9ff62 2005-01-14 devnull .B \*9/lib/moveplan9.files
57 4ef9ff62 2005-01-14 devnull the list of files that need to have
58 4ef9ff62 2005-01-14 devnull .B /usr/local/plan9
59 4ef9ff62 2005-01-14 devnull edited out of them
61 4ef9ff62 2005-01-14 devnull .B \*9/lib/moveplan9.sh
62 4ef9ff62 2005-01-14 devnull the script that edits the files
64 4ef9ff62 2005-01-14 devnull .B \*9/src/mkmk.sh
65 4ef9ff62 2005-01-14 devnull the shell script used to build
66 4ef9ff62 2005-01-14 devnull .IR mk (1)
68 4ef9ff62 2005-01-14 devnull .B \*9/dist/manweb
69 4ef9ff62 2005-01-14 devnull the shell script that builds the HTML manual
71 4ef9ff62 2005-01-14 devnull .B \*9/man/index.html
72 4ef9ff62 2005-01-14 devnull the top-level page in the HTML version of the manual
73 4ef9ff62 2005-01-14 devnull .SH SEE ALSO
74 4ef9ff62 2005-01-14 devnull .IR intro (1),
75 4ef9ff62 2005-01-14 devnull .IR cvs (1)
