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