UPDATING revision 1.176
1 1.176 simonb $NetBSD: UPDATING,v 1.176 2008/08/02 14:30:37 simonb Exp $ 2 1.1 abs 3 1.123 jmc This file (UPDATING) is intended to be a brief reference to recent 4 1.123 jmc changes that might cause problems in the build process, and a guide for 5 1.123 jmc what to do if something doesn't work. 6 1.1 abs 7 1.123 jmc For a more detailed description of the recommended way to build NetBSD 8 1.123 jmc using build.sh, see the BUILDING file. 9 1.123 jmc 10 1.123 jmc Note that much of the advice in this UPDATING file was written before 11 1.123 jmc build.sh existed. Nevertheless, the advice here may be useful for 12 1.123 jmc working around specific problems with build.sh. 13 1.123 jmc 14 1.123 jmc See also: BUILDING, build.sh, Makefile. 15 1.1 abs 16 1.1 abs Recent changes: 17 1.1 abs ^^^^^^^^^^^^^^^ 18 1.138 lukem 19 1.175 simonb 20080731: 20 1.175 simonb WAPBL (metadata journaling support) has been added, but at this 21 1.175 simonb time isn't backwards compatible with pre-WAPBL aware kernels 22 1.175 simonb and userland (fsck_ffs in particular). Please make sure you 23 1.175 simonb don't use a journaled filesystem with an older kernel/userland, 24 1.176 simonb especially an uncleanly mounted journaled filesystem. WAPBL 25 1.176 simonb also requires the super block to be in the UFS2 format. You 26 1.176 simonb can use fsck_ffs -c 4 to update the superblock format. 27 1.175 simonb 28 1.174 lukem 20080721: 29 1.174 lukem Assembler warnings are now fatal if $WARNS>0 and $NOGCCERROR 30 1.174 lukem isn't defined. 31 1.174 lukem 32 1.173 freza 20080531: 33 1.173 freza The ioctl number of DRVSUSPENDDEV command on /dev/drvctl changed 34 1.173 freza from 125 (conflicted with DRVCTLCOMMAND) to 129. The drvctl(8) 35 1.173 freza utility needs to be rebuilt and reinstalled as older binaries 36 1.173 freza won't work correctly. The following sequence of commands: 37 1.173 freza 38 1.173 freza $ (cd sys/sys/ && nbmake-$arch includes) 39 1.173 freza $ (cd sbin/drvctl/ && nbmake-$arch clean) 40 1.173 freza $ (cd sbin/drvctl/ && nbmake-$arch all) 41 1.173 freza 42 1.173 freza leaves new drvctl utility in sbin/drvctl build directory. 43 1.173 freza 44 1.172 lukem 20080503: 45 1.172 lukem The <bsd.lib.mk> variable MKPRIVATELIB was renamed to LIBISPRIVATE. 46 1.172 lukem 47 1.171 he 20080521: 48 1.171 he For a while, unprivileged UPDATE builds would fail to 49 1.171 he succeed at the checkflist stage, complaining that 50 1.171 he ${DESTDIR}/stand/<arch>/ did not exist. A fix for this 51 1.171 he problem was committed to share/mk/bsd.kmodule.mk, revision 1.9. 52 1.171 he If you already hit this problem, update the .mk file, 53 1.171 he remove ${DESTDIR}/stand/<arch>, and re-run the build. 54 1.171 he 55 1.174 lukem 20080303: 56 1.174 lukem Linker warnings are now fatal if $WARNS>0. 57 1.174 lukem 58 1.170 christos 20080126: 59 1.170 christos The posix_fadvise system call has been changed from an assembly 60 1.170 christos stub, to a c file that calls an assembly stub. You need to 61 1.170 christos 'rm -f posix_fadvise.* .depend' in the libc build directory to 62 1.170 christos avoid using the old assembly stub. 63 1.170 christos 64 1.168 joerg 20071209: 65 1.168 joerg The acpiec(4) driver has been split into two attachments. If you 66 1.168 joerg get ACPI errors before the attachment, please update your kernel 67 1.169 wiz configuration file appropriately or see GENERIC for more details. 68 1.168 joerg 69 1.166 xtraeme 20071115: 70 1.166 xtraeme The it(4) driver has been renamed to itesio(4) and the old port 71 1.166 xtraeme argument specified in the kernel configuration file is not valid 72 1.166 xtraeme anymore. The itesio(4) driver now uses the Super I/O address port 73 1.166 xtraeme rather than the EC address port. Please update your kernel 74 1.167 wiz configuration file appropriately or see GENERIC for more details. 75 1.166 xtraeme 76 1.165 jmmv 20071028: 77 1.165 jmmv The pccons(4) driver has been removed from the NetBSD/shark port. 78 1.165 jmmv You need to update any custom kernel configuration file you have 79 1.165 jmmv to remove any references to pccons (which includes removing the 80 1.165 jmmv now useless XSERVER option) and replace them with the correct 81 1.165 jmmv entries for the wscons driver. See the GENERIC configuration file 82 1.165 jmmv for more details. 83 1.165 jmmv 84 1.164 gdt 20070913: 85 1.164 gdt A latent bug in dhclient/dhcpd that caused it to be unable to 86 1.164 gdt enumerate interfaces was fixed. The bug began to cause 87 1.164 gdt problems after 20070911 when the kernel's SIOCGIFCONF 88 1.164 gdt implementation was repaired. From 20070529 to 20070911 racoon 89 1.164 gdt could not enumerate interfaces. (These are noted because 90 1.164 gdt normal kernel/userspace version matching hygiene is not 91 1.164 gdt sufficient to avoid this problem.) Ensure that both kernel 92 1.164 gdt and userland are from after 20070913. 93 1.164 gdt 94 1.163 joerg 20070703: 95 1.163 joerg nbinstall has been renamed as it calls the target specific and 96 1.163 joerg the logic to pass down STRIP from mk been removed. This forces 97 1.163 joerg a re-installation of tools. 98 1.163 joerg 99 1.161 dsl 20070422: 100 1.161 dsl The way OS emulations lookup filenames inside the emulation root 101 1.161 dsl has been changed. Rather than modify the pathname (and copy back 102 1.161 dsl to userspace) namei() and lookup() directly check the emulation 103 1.161 dsl root. One side effect is that absolute symlinks inside the emulated 104 1.167 wiz root file system will be relative to that file system - unless they 105 1.161 dsl start /../ this is useful when the emulated root is a real install 106 1.161 dsl that has such links. 107 1.161 dsl This might affect symlinks that have been added to reference outside 108 1.161 dsl the emulated root. 109 1.161 dsl 110 1.160 jmcneill 20070412: 111 1.160 jmcneill The pckbc driver on sgimips IP32 has been removed. Use macekbc 112 1.160 jmcneill instead. See the GENERIC32_IP3x kernel configuration for an 113 1.160 jmcneill example. 114 1.160 jmcneill 115 1.159 gdt 20070319: 116 1.159 gdt src/lib/libc/Makefile revision 1.129 broke libc and ld.elf_so 117 1.159 gdt on many platforms due to incorrect flags settings. If you 118 1.159 gdt updated and built after about 20070315, do "nbmake-$arch 119 1.159 gdt cleandir" in src/lib/libc and src/libexec/ld.elf_so to force a 120 1.159 gdt rebuild of object files that might have been built 121 1.159 gdt incorrectly, and ensure that you have at least 122 1.159 gdt src/lib/libc/Makefile 1.130. 123 1.159 gdt 124 1.158 dbj 20070210: 125 1.158 dbj src/sys/sys/{sa.h,savar.h} were removed. 126 1.158 dbj find ${OBJDIR} \( -name .depend -o -name '*.d' \) -print \ 127 1.158 dbj | xargs egrep -l '/sa.h|/savar.h' | xargs rm 128 1.158 dbj will allow dependencies on those files to get get rebuilt 129 1.158 dbj 130 1.157 apb 20070209: 131 1.157 apb The threading model was changed when the newlock2 branch 132 1.157 apb was merged to NetBSD-current. If you boot with a new 133 1.157 apb kernel (version 4.99.10), then you also need a new pthread 134 1.157 apb library (/usr/lib/libpthread.so.0.7). If you boot with 135 1.157 apb an old kernel, then you need the old pthread library 136 1.157 apb (/usr/lib/libpthread.so.0.6). Provided you keep the kernel and 137 1.157 apb the pthread library in sync, old threaded applications should 138 1.157 apb continue to work with an old or new kernel. Note that named(8) 139 1.157 apb is the only threaded application in the base system. 140 1.157 apb 141 1.154 he 20061214: 142 1.154 he Following the move of string_to_flags() and flags_to_string() 143 1.154 he from the bin/ls/ sources to libutil, users doing UPDATE builds 144 1.154 he will need to do a "make cleandir" in 145 1.154 he tools/mtree/, tools/makefs/, tools/binstall/, tools/pax/, 146 1.154 he bin/pax/, bin/ls/, usr.sbin/mtree/, usr.sbin/makefs/, 147 1.156 he usr.bin/xinstall/, libexec/ftpd/, rescue/, as well 148 1.156 he as the installation images in distrib/ 149 1.154 he in order to excise stale references to the old stat_flags.h header 150 1.154 he file in the ls sources -- stat_flags.h has been removed. 151 1.154 he 152 1.152 christos 20061108: 153 1.152 christos The configure script used in the src/tools/gcc compiler has been 154 1.152 christos changed to indicate that our libc has ssp support built-in and 155 1.152 christos does not depend on -lssp and -lssp-nonshared. You'll need to 156 1.152 christos make clean in src/tools/gcc first to rebuild the compiler. 157 1.152 christos 158 1.151 rpaulo 20061009: 159 1.151 rpaulo The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer 160 1.151 rpaulo available. Use net.inet{,6}.tcp{,6}.congctl.selected instead. 161 1.151 rpaulo 162 1.150 bjh21 20060814: 163 1.150 bjh21 The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been 164 1.150 bjh21 withdrawn. Use vidcvideo and pckbd instead. See the GENERIC 165 1.150 bjh21 kernel configuration for an example. X servers from the last 166 1.150 bjh21 few years should cope. 167 1.150 bjh21 168 1.149 christos 20060703: 169 1.149 christos MPACPI is no more. We always configure PCI interrupts using ACPI 170 1.149 christos if we have an ACPI kernel. The option MPACPI_SCANPCI has been renamed 171 1.149 christos to ACPI_SCANPCI. Thanks to work from fvdl. 172 1.149 christos 173 1.148 dogcow 20060627: 174 1.148 dogcow socket(2) has changed, and its system call has been versioned. 175 1.148 dogcow For userlands with the old version of socket(2), make sure that 176 1.148 dogcow your kernel has 'options COMPAT_30' set, or else 'bad system call' 177 1.148 dogcow errors will result. 178 1.148 dogcow 179 1.1 abs Hints for a more successful build: 180 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 181 1.123 jmc Use build.sh, but do not use its "expert mode": 182 1.132 jmmv This will automatically build the tools in the 183 1.123 jmc correct order, and it will keep the tools and the 184 1.123 jmc new build products from interfering with the running 185 1.123 jmc system. This will allow you to ignore most of the 186 1.123 jmc other advice in this file. 187 1.2 mrg Build a new kernel first: 188 1.2 mrg This makes sure that any new system calls or features 189 1.2 mrg expected by the new userland will be present. This 190 1.2 mrg helps to avoid critical errors when upgrading. 191 1.1 abs Use object directories: 192 1.1 abs This helps to keep stale object 193 1.1 abs files from polluting the build if a Makefile "forgets" 194 1.1 abs about one. It also makes it easier to clean up after 195 1.1 abs a build. It's also necessary if you want to use the 196 1.1 abs same source tree for multiple machines. 197 1.123 jmc To use object directories with build.sh: 198 1.123 jmc a) invoke build.sh with the "-M" or "-O" options. 199 1.123 jmc To use object directories without using build.sh: 200 1.1 abs a) cd /usr/src ; make cleandir 201 1.2 mrg b) Add "OBJMACHINE=yes" to /etc/mk.conf 202 1.2 mrg c) Add "MKOBJDIRS=yes" to /etc/mk.conf 203 1.1 abs d) cd /usr/src ; make build 204 1.2 mrg Note that running "make obj" in a directory will create 205 1.2 mrg in obj.$MACHINE directory. 206 1.1 abs Build to a DESTDIR: 207 1.123 jmc This helps to keep old installed files (especially libraries) 208 1.123 jmc from interfering with the new build. 209 1.123 jmc To build to a DESTDIR with build.sh, use the "-D" option. 210 1.123 jmc To build to a DESTDIR without using build.sh, set the DESTDIR 211 1.123 jmc environment variable before running make build. It should be 212 1.123 jmc set to the pathname of an initially empty directory. 213 1.123 jmc Problems: if you do not use build.sh, you might need to 214 1.123 jmc update critical utilities without using DESTDIR since 215 1.123 jmc nothing is executed from what is installed in DESTDIR. 216 1.123 jmc (See critical utils, below.) 217 1.1 abs Build often: 218 1.1 abs This keeps critical utilities current enough to not choke 219 1.1 abs on any other part of the source tree that depends on up to 220 1.123 jmc date functionality. If you use build.sh, you should not have 221 1.123 jmc this problem. 222 1.1 abs 223 1.1 abs What to do if things don't work: 224 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 225 1.1 abs When things don't work there is usually a few things that commonly 226 1.1 abs should be done. 227 1.1 abs 1) make includes 228 1.1 abs This should be done automatically by make build. 229 1.1 abs 2) cd share/mk && make install 230 1.1 abs Again, automatically done by make build. 231 1.1 abs 232 1.1 abs Failsafe rebuild of a small part of the tree: 233 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 234 1.1 abs To make sure you rebuild something correctly you want to do 235 1.1 abs something like the following: 236 1.1 abs 1) Make sure the includes and .mk files are up to date. 237 1.1 abs 2) Make sure any program used to build the particular 238 1.1 abs utility is up to date. (yacc, lex, etc...) 239 1.1 abs 3) cd ...path/to/util... 240 1.1 abs make cleandir 241 1.1 abs rm ...all obj directories... 242 1.1 abs make cleandir # yes, again 243 1.1 abs make obj 244 1.1 abs make depend && make 245 1.1 abs 246 1.1 abs Failsafe rebuild of the entire tree: 247 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 248 1.1 abs If you really want to make sure the source tree is clean and 249 1.2 mrg ready for a build try the following. Note that sourcing /etc/mk.conf 250 1.2 mrg (a make(1) Makefile) in this manner is not right, and will not work 251 1.2 mrg for anyone who uses any make(1) features in /etc/mk.conf. 252 1.1 abs 253 1.1 abs ---cut here--- 254 1.1 abs #!/bin/sh 255 1.1 abs . /etc/mk.conf 256 1.1 abs 257 1.58 lukem if [ -z $NETBSDSRCDIR ] ; then 258 1.58 lukem NETBSDSRCDIR=/usr/src 259 1.1 abs fi 260 1.58 lukem if [ \! -d $NETBSDSRCDIR ] ; then 261 1.1 abs echo Unable to find sources 262 1.1 abs exit 1 263 1.1 abs fi 264 1.58 lukem find $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \; 265 1.1 abs 266 1.1 abs if [ -z $BSDOBJDIR ] ; then 267 1.1 abs BSDOBJDIR=/usr/obj 268 1.1 abs fi 269 1.1 abs if [ -d $BSDOBJDIR ] ; then 270 1.1 abs rm -rf $BSDOBJDIR 271 1.1 abs fi 272 1.1 abs 273 1.58 lukem cd $NETBSDSRCDIR && make cleandir 274 1.1 abs 275 1.1 abs ---cut here--- 276 1.1 abs 277 1.1 abs Critical utilities: 278 1.1 abs ^^^^^^^^^^^^^^^^^^^ 279 1.3 itojun usr.bin/compile_et 280 1.1 abs usr.bin/make 281 1.1 abs usr.bin/yacc 282 1.1 abs usr.bin/lex 283 1.11 lukem usr.bin/xlint 284 1.142 drochner usr.bin/config 285 1.1 abs 286 1.34 simonb Other problems and possible solutions: 287 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 288 1.1 abs Symptom:Complaints involving a Makefile. 289 1.17 erh Fix: Rebuild usr.bin/make: 290 1.17 erh cd usr.bin/make && make && make install 291 1.111 simonb Or, a failsafe method if that doesn't work: 292 1.17 erh cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin 293 1.17 erh 294 1.1 abs Fix: Make sure .mk files are up to date. 295 1.1 abs cd share/mk && make install 296 1.2 mrg 297 1.2 mrg Symptom:Kernel `config' fails to configure any kernel, including GENERIC. 298 1.142 drochner Fix: Rebuild usr.bin/config 299 1.1 abs 300 1.1 abs Symptom: 301 1.1 abs Fix: Rebuild usr.bin/yacc 302 1.1 abs 303 1.1 abs Symptom: 304 1.1 abs Fix: Rebuild usr.bin/lex 305 1.1 abs 306 1.1 abs Symptom: 307 1.1 abs Fix: rm /usr/lib/libbfd.a 308 1.4 itojun 309 1.4 itojun Symptom:Obsolete intermediate files are used during compilation 310 1.4 itojun Fix: Try the following sequence of commands in the directory in question. 311 1.4 itojun make cleandir; rm `make print-objdir`; make cleandir; make obj 312 1.4 itojun (If you built the tree without "make obj" in the past, obsolete files 313 1.4 itojun may remain. The command tries to clean everything up) 314 1.5 wiz 315 1.5 wiz Symptom:.../sysinst/run.c:xx: warning: initialization from incompatible pointer type 316 1.5 wiz Fix: Rebuild and install usr.bin/menuc 317 1.12 itojun 318 1.12 itojun Symptom:mklocale not found during build in share/locale/ctype 319 1.12 itojun Fix: Build and install usr.bin/mklocale 320 1.13 dogcow 321 1.86 kleink Symptom:undefined reference to `__assert13' or `__unsetenv13' 322 1.13 dogcow Fix: Rebuild and install lib/libc 323 1.13 dogcow 324 1.142 drochner Symptom:usr.bin/config fails to build. 325 1.19 cgd Fix: Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile. 326 1.13 dogcow 327 1.19 cgd Symptom:undefined reference to `getprogname' or `setprogname' 328 1.19 cgd Fix: Rebuild and install lib/libc 329 1.24 abs 330 1.24 abs Symptom:lint does not understand the '-X' option 331 1.24 abs Fix: May need to build & install libs with NOLINT=1 before rebuilding lint 332
Indexes created Sun Oct 12 02:09:55 GMT 2025