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