3 install \- notes about Plan 9 from User Space installation
13 To obtain the Plan 9 tree, use CVS
16 or download a tar file from
17 .HR http://swtch.com/plan9port "" .
19 The tree can be unpacked anywhere, but the
21 .BR /usr/local/plan9 .
22 In the root of the tree, run
24 This script builds the Plan 9 build program
27 cleans all previously built object files and libraries out of the tree,
28 rebuilds and installs everything, and then cleans up.
30 There are a few files in tree which have the root
34 edits these files to replace the string
36 with the name of the root of the current tree.
40 builds an HTML version of the manual and installs it in
43 The installation can be thought of as two steps:
44 build all the binaries, and then edit files as necessary
45 to fix the references to the installation root.
46 If necessary, these can be run separately.
51 performs only the first step.
56 performs only the second step.
57 The first step can be done with the tree in a temporary work directory,
58 but the second step must be done once the tree is in its final location.
59 These flags are only necessary when trying to conform to the
60 expectations of certain package management systems.
62 At the end of the installation,
64 prints suggested settings for the environment variables
69 Plan 9 from User Space uses different threading implementations on Linux 2.6 and
70 later kernels than on 2.4 and earlier;
71 and on FreeBSD 5 and later kernels than on FreeBSD 4 and earlier.
72 Running binaries from one class on another will not work.
74 Some Linux 2.6 systems (e.g., Gentoo) do not use the new NPTL pthread library
75 even though the kernel supports them. On these systems, plan9port must
76 fall back on the threading code intended for Linux 2.4. To accomplish this,
78 checks whether the running system uses NPTL and sets
87 after this auto-detection and can be used to override the choices.
92 then the system is built without using X11.
95 can safely be repeated to rebuild the system from scratch.
97 Once the system is built for the first time,
98 it can be maintained and rebuilt using
100 To rebuild individual commands or libraries,
107 in the appropriate source directory
112 .B \*9/lib/moveplan9.files
113 the list of files that need to have
117 .B \*9/lib/moveplan9.sh
118 the script that edits the files
121 the shell script used to build
125 the shell script that builds the HTML manual
127 .B \*9/man/index.html
128 the top-level page in the HTML version of the manual
131 logged output from the last run of