UPDATING revision 1.15
1 1.15 christos $NetBSD: UPDATING,v 1.15 2001/02/04 19:50:26 christos Exp $ 2 1.1 abs 3 1.1 abs This file is intended to be a brief introduction to the build 4 1.1 abs process and a reference on what to do if something doesn't work. 5 1.1 abs 6 1.1 abs For a more detailed description see Makefile. 7 1.1 abs 8 1.1 abs Recent changes: 9 1.1 abs ^^^^^^^^^^^^^^^ 10 1.15 christos 11 1.15 christos 20010204: 12 1.15 christos prepare the code to compile with stricter gcc flags. in 13 1.15 christos particular start eliminating redundant declarations. Yacc 14 1.15 christos needs to be installed before make build. 15 1.10 christos 16 1.10 christos 20010114: 17 1.10 christos introduce .if commands(target) in make(1). You need to 18 1.10 christos bring everything up-to-date first, then without installing 19 1.10 christos anything make and install in /usr/bin/make, then proceed 20 1.10 christos with make build. 21 1.9 sommerfe 22 1.9 sommerfe 20010101: 23 1.9 sommerfe bsd.subdir.mk committed 20001230 had a bug which caused 24 1.9 sommerfe afterinstall targets to run too soon; update again. 25 1.8 sommerfe 26 1.8 sommerfe 20001230: 27 1.8 sommerfe New share/mk files needed to support .WAIT in SUBDIR variables. 28 1.8 sommerfe If you get make errors, 29 1.8 sommerfe (cd share/mk; make install) 30 1.8 sommerfe Also, PRINTOBJDIR has changed and is now used more heavily. 31 1.6 ad 32 1.6 ad 20001019: 33 1.7 ad The `ca' device driver has been replaced by `ld'; although the 34 1.6 ad major and minor numbers haven't changed, you should update your /dev 35 1.6 ad directory. 36 1.1 abs 37 1.4 itojun 20000929: 38 1.4 itojun The following make directives are obsoleted. 39 1.4 itojun MKCRYPTO_RSA NOCRYPTO_RSA NOCRYPTO_RC5 NOCRYPTO_IDEA 40 1.4 itojun By default, RSA is built into libcrypto. IDEA and RC5 will not be 41 1.4 itojun bulit into libcrypto. By using MKCRYPTO_{RC5,IDEA}, you can build 42 1.4 itojun additional library libcrypto_{idea,rc5}. 43 1.4 itojun 44 1.1 abs 20000623: 45 1.1 abs MKCRYPTO and friends added to share/mk/bsd.own.mk. 46 1.1 abs 'cd share/mk ; make install' needed before make build. 47 1.1 abs 48 1.1 abs 49 1.1 abs Hints for a more successful build: 50 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 51 1.2 mrg Build a new kernel first: 52 1.2 mrg This makes sure that any new system calls or features 53 1.2 mrg expected by the new userland will be present. This 54 1.2 mrg helps to avoid critical errors when upgrading. 55 1.1 abs Use object directories: 56 1.1 abs This helps to keep stale object 57 1.1 abs files from polluting the build if a Makefile "forgets" 58 1.1 abs about one. It also makes it easier to clean up after 59 1.1 abs a build. It's also necessary if you want to use the 60 1.1 abs same source tree for multiple machines. 61 1.1 abs To use object directories: 62 1.1 abs a) cd /usr/src ; make cleandir 63 1.2 mrg b) Add "OBJMACHINE=yes" to /etc/mk.conf 64 1.2 mrg c) Add "MKOBJDIRS=yes" to /etc/mk.conf 65 1.1 abs d) cd /usr/src ; make build 66 1.2 mrg Note that running "make obj" in a directory will create 67 1.2 mrg in obj.$MACHINE directory. 68 1.1 abs Build to a DESTDIR: 69 1.1 abs This helps to keep old 70 1.1 abs installed files (especially libraries) from interfering 71 1.1 abs with the new build. 72 1.1 abs To build to a DESTDIR, set the DESTDIR environment 73 1.2 mrg variable before running make build. It should be set to 74 1.2 mrg the pathname of an initially empty directory. 75 1.1 abs Problems: you might need to update critical utilities 76 1.1 abs without using DESTDIR since nothing is executed 77 1.1 abs from what is installed in DESTDIR. 78 1.1 abs (See critical utils, below) 79 1.1 abs Build often: 80 1.1 abs This keeps critical utilities current enough to not choke 81 1.1 abs on any other part of the source tree that depends on up to 82 1.1 abs date functionality. 83 1.1 abs 84 1.1 abs What to do if things don't work: 85 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 86 1.1 abs When things don't work there is usually a few things that commonly 87 1.1 abs should be done. 88 1.1 abs 1) make includes 89 1.1 abs This should be done automatically by make build. 90 1.1 abs 2) cd share/mk && make install 91 1.1 abs Again, automatically done by make build. 92 1.1 abs 93 1.1 abs Failsafe rebuild of a small part of the tree: 94 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 95 1.1 abs To make sure you rebuild something correctly you want to do 96 1.1 abs something like the following: 97 1.1 abs 1) Make sure the includes and .mk files are up to date. 98 1.1 abs 2) Make sure any program used to build the particular 99 1.1 abs utility is up to date. (yacc, lex, etc...) 100 1.1 abs 3) cd ...path/to/util... 101 1.1 abs make cleandir 102 1.1 abs rm ...all obj directories... 103 1.1 abs make cleandir # yes, again 104 1.1 abs make obj 105 1.1 abs make depend && make 106 1.1 abs 107 1.1 abs Failsafe rebuild of the entire tree: 108 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 109 1.1 abs If you really want to make sure the source tree is clean and 110 1.2 mrg ready for a build try the following. Note that sourcing /etc/mk.conf 111 1.2 mrg (a make(1) Makefile) in this manner is not right, and will not work 112 1.2 mrg for anyone who uses any make(1) features in /etc/mk.conf. 113 1.1 abs 114 1.1 abs ---cut here--- 115 1.1 abs #!/bin/sh 116 1.1 abs . /etc/mk.conf 117 1.1 abs 118 1.1 abs if [ -z $BSDSRCDIR ] ; then 119 1.1 abs BSDSRCDIR=/usr/src 120 1.1 abs fi 121 1.1 abs if [ \! -d $BSDSRCDIR ] ; then 122 1.1 abs echo Unable to find sources 123 1.1 abs exit 1 124 1.1 abs fi 125 1.1 abs find $BSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \; 126 1.1 abs 127 1.1 abs if [ -z $BSDOBJDIR ] ; then 128 1.1 abs BSDOBJDIR=/usr/obj 129 1.1 abs fi 130 1.1 abs if [ -d $BSDOBJDIR ] ; then 131 1.1 abs rm -rf $BSDOBJDIR 132 1.1 abs fi 133 1.1 abs 134 1.1 abs cd $BSDSRCDIR && make cleandir 135 1.1 abs 136 1.1 abs ---cut here--- 137 1.1 abs 138 1.1 abs Critical utilities: 139 1.1 abs ^^^^^^^^^^^^^^^^^^^ 140 1.1 abs gnu/usr.bin/egcs 141 1.3 itojun usr.bin/compile_et 142 1.1 abs usr.bin/make 143 1.1 abs usr.bin/yacc 144 1.1 abs usr.bin/lex 145 1.11 lukem usr.bin/xlint 146 1.2 mrg usr.sbin/config 147 1.1 abs 148 1.1 abs Other problems and possibly solutions: 149 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 150 1.1 abs Symptom:Unreasonable compiler errors. 151 1.1 abs Fix: Rebuild gnu/usr.bin/egcs 152 1.1 abs 153 1.1 abs Symptom:Complaints involving a Makefile. 154 1.14 hubertf Fix: Rebuild usr.bin/make 155 1.1 abs Fix: Make sure .mk files are up to date. 156 1.1 abs cd share/mk && make install 157 1.2 mrg 158 1.2 mrg Symptom:Kernel `config' fails to configure any kernel, including GENERIC. 159 1.2 mrg Fix: Rebuild usr.sbin/config 160 1.1 abs 161 1.1 abs Symptom: 162 1.1 abs Fix: Rebuild usr.bin/yacc 163 1.1 abs 164 1.1 abs Symptom: 165 1.1 abs Fix: Rebuild usr.bin/lex 166 1.1 abs 167 1.1 abs Symptom: 168 1.1 abs Fix: rm /usr/lib/libbfd.a 169 1.4 itojun 170 1.4 itojun Symptom:Obsolete intermediate files are used during compilation 171 1.4 itojun Fix: Try the following sequence of commands in the directory in question. 172 1.4 itojun make cleandir; rm `make print-objdir`; make cleandir; make obj 173 1.4 itojun (If you built the tree without "make obj" in the past, obsolete files 174 1.4 itojun may remain. The command tries to clean everything up) 175 1.5 wiz 176 1.5 wiz Symptom:.../sysinst/run.c:xx: warning: initialization from incompatible pointer type 177 1.5 wiz Fix: Rebuild and install usr.bin/menuc 178 1.12 itojun 179 1.12 itojun Symptom:mklocale not found during build in share/locale/ctype 180 1.12 itojun Fix: Build and install usr.bin/mklocale 181 1.13 dogcow 182 1.13 dogcow Symptom:undefined reference to `__assert13' 183 1.13 dogcow Fix: Rebuild and install lib/libc 184 1.13 dogcow 185 1.13 dogcow 186
Indexes created Sun Oct 12 05:10:08 GMT 2025