UPDATING revision 1.253 1 1.253 joerg $NetBSD: UPDATING,v 1.253 2014/02/01 12:51:02 joerg 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.230 tls
19 1.251 martin 20140131:
20 1.253 joerg The new compiler_rt/libc integration moved a few things. It is strongly
21 1.253 joerg disadvised to a clean build. At least lib/libc, the compat version(s)
22 1.253 joerg of libc, libkern, rump and the kernels need to be cleaned.
23 1.251 martin
24 1.250 christos 20131227:
25 1.250 christos 1. The new ntpd runs in a restricted mode to prevent amplification
26 1.250 christos attacks. If you need ntpdc to work you need to explicitly enable
27 1.250 christos mode7 in your config file. Make sure you put the necessary restrict
28 1.250 christos statements to avoid being exposed.
29 1.250 christos 2. strncat has moved from lib/libc to common/lib/libc; you might need
30 1.250 christos to make clean in libc
31 1.250 christos
32 1.249 mrg 20131129:
33 1.249 mrg The GMP sources were updated, and builds will likely fail without
34 1.249 mrg cleaning their build trees for both tools and in-tree, like below.
35 1.249 mrg
36 1.248 mrg 20131128:
37 1.248 mrg The MPC and MPFR sources were updated, and builds may require their
38 1.248 mrg tools and in-tree directories cleaned for successful updates.
39 1.248 mrg
40 1.246 martin 20130605:
41 1.247 spz The kernel option FAST_IPSEC no longer exists, it's been renamed
42 1.247 spz to IPSEC (and the older IPSEC version removed).
43 1.247 spz
44 1.247 spz 20130605:
45 1.246 martin Previous freetype installations eroneously installed private
46 1.246 martin header files. If you are building against a non-empty $DESTDIR,
47 1.246 martin please remove ${DESTDIR}//usr/X11R7/include/freetype2/freetype/.
48 1.246 martin
49 1.245 mrg 20130531:
50 1.245 mrg The xdm update may cause build failure due to xdm.man being
51 1.245 mrg in the obj tree. Make sure to ensure any like this:
52 1.245 mrg nbmake: nbmake: don't know how to make xdm.man. Stop
53 1.245 mrg is fixed by deleting the xdm.man in the obj tree.
54 1.245 mrg
55 1.244 mrg 20130530:
56 1.244 mrg Updates of many xsrc packages will leave old .pc files around.
57 1.244 mrg Best to clean out the xsrc objdir entirely before rebuilds.
58 1.244 mrg
59 1.242 christos 20130301:
60 1.242 christos The removal of netiso requires manual removal of /usr/include/netiso
61 1.243 christos prior to the build and make cleandir in /usr/src/usr.bin/{ktruss,kdump}
62 1.242 christos
63 1.238 dholland 20120726:
64 1.241 wiz The update of OpenSSL requires cleaning both the OpenSSL build
65 1.241 wiz directory and DESTDIR. *Even non-update builds require cleaning
66 1.240 dholland DESTDIR.* Builds done without taking these steps may fail, or in
67 1.241 wiz some cases may succeed and install broken OpenSSL libraries that
68 1.240 dholland cause third-party software to link incorrectly and/or crash.
69 1.238 dholland
70 1.237 wiz 20120507:
71 1.241 wiz The database schema for makemandb was changed. You will
72 1.237 wiz need to update the database using 'makemandb -f' or wait
73 1.237 wiz for the next weekly run to fix it.
74 1.237 wiz
75 1.236 bsh 20120319:
76 1.236 bsh sys/conf/Makefile.kern.inc has been modified to adjust the
77 1.236 bsh size of db_symtab automatically. You need to update dbsym in
78 1.236 bsh your $TOOLDIR to build kernels with options SYMTAB_SPACE. If
79 1.236 bsh you don't want this behavior, add AUTO_SYMTAB_SPACE=no to your
80 1.236 bsh mk.conf.
81 1.236 bsh
82 1.235 joerg 20120216:
83 1.241 wiz Default for MKCATPAGES changed to NO. Update builds will fail
84 1.241 wiz unless DESTDIR is cleaned manually. If you built between 20120207
85 1.239 dholland and 20120216, daily and weekly could have created an unreadable
86 1.241 wiz /var/db/man.db index for apropos. Running makemandb -f or
87 1.235 joerg the next run of weekly will fix it.
88 1.233 joerg
89 1.232 christos 20111227:
90 1.232 christos If you built between 20111225 and 20111227 you need to remove
91 1.232 christos /usr/lib/libpam.so.4* and /usr/lib/security/*.so.4, since the
92 1.232 christos bump has been reverted.
93 1.232 christos
94 1.231 tls 20111125:
95 1.231 tls The "rnd" pseudodevice has been added to sys/conf/std, which
96 1.231 tls means it should no longer be explicitly listed in kernel
97 1.231 tls configuration files. The line "pseudo-device rnd" should be
98 1.231 tls removed from any custom kernel config files users may have.
99 1.231 tls
100 1.230 tls 20111119:
101 1.230 tls A problem with the datastructures used by the rndctl(8)
102 1.230 tls utility (pointers in datastructures in an array, making 32->64
103 1.230 tls bit compatibility very painful) has been fixed in a
104 1.230 tls non-backwards-compatible way. If you replace your kernel,
105 1.230 tls replace your rndctl executable too.
106 1.241 wiz
107 1.229 jym 20111001:
108 1.229 jym the prop_*_send_syscall() functions from proplib(3) have been
109 1.229 jym changed and their new version is not backward compatible with the old
110 1.241 wiz one. So ensure that all consumers of these functions (currently:
111 1.229 jym quota2 code and its tests) are updated together with the new lib.
112 1.229 jym
113 1.228 mrg 20110817:
114 1.228 mrg sparc has been changed to use GCC 4.5.3, so any objdir or
115 1.228 mrg DESTDIR for them should be deleted before updating.
116 1.228 mrg
117 1.227 riastrad 20110806:
118 1.227 riastrad i386 and amd64 have been changed to use GCC 4.5.3, so any
119 1.227 riastrad objdir or DESTDIR for them should be deleted before updating.
120 1.227 riastrad
121 1.226 mrg 20110805:
122 1.226 mrg The update to GCC 4.5.3 requires a non-trivial portion of
123 1.226 mrg the tree to be cleaned. Best to delete both objdir and
124 1.226 mrg DESTDIR before running this update. So far, only the
125 1.226 mrg sparc64, mips and powerpc platforms have changed.
126 1.226 mrg
127 1.225 matt 20110803:
128 1.241 wiz The layout of external/public-domain/xz has changed. To do an
129 1.225 matt update build you will have to remove the contents of the OBJDIR
130 1.225 matt for external/public-domain/xz/bin by hand as the xz entry there
131 1.225 matt is now a directory.
132 1.225 matt
133 1.223 joerg 20110410:
134 1.241 wiz The configuration of src/tools/gcc has changed. To do an
135 1.224 dholland update build you have to clean both tools/binutils and
136 1.224 dholland tools/gcc by hand.
137 1.223 joerg
138 1.222 plunky 20110328:
139 1.222 plunky Building the Xorg binary was moved into a subdirectory to fix
140 1.241 wiz ordering issues with "make all". It may be necessary to remove
141 1.222 plunky the OBJDIR for external/mit/xorg/server/xorg-server/hw/xfree86
142 1.222 plunky if your update build fails, as the "Xorg" entry there is now a
143 1.222 plunky directory.
144 1.222 plunky
145 1.220 joerg 20110121:
146 1.221 lukem Assembler files no longer use -traditional-cpp. This can break
147 1.220 joerg the build of individual parts of the tree. This is handled
148 1.220 joerg correctly by build.sh. Manual builds have to update /usr/share/mk
149 1.220 joerg and re-run config(1) for any kernel configurations as needed.
150 1.218 joerg
151 1.217 jruoho 20101217:
152 1.217 jruoho The tcpdump(8) program was changed to drop privileges and chroot(2)
153 1.241 wiz by default. It may be necessary to manually update passwd(5) and
154 1.217 jruoho group(5) in order to make the program work with existing setups.
155 1.217 jruoho
156 1.216 christos 20101125:
157 1.216 christos The latest changes to setenv(3) dissallow setting environment
158 1.241 wiz variables with names that contain '='. Revision 1.18 of env.c
159 1.241 wiz assumed that this was allowed. Installing a new libc with an
160 1.216 christos old copy of /usr/bin/env causes env x=1 printenv | grep x= to
161 1.216 christos break which affects the autoconf tests for dependency finding,
162 1.216 christos so building gcc will end up printing:
163 1.216 christos checking dependency style of gcc... none
164 1.216 christos configure: error: no usable dependency style found
165 1.216 christos Fix it by rebuilding and re-installing env.
166 1.138 lukem
167 1.215 mrg 20101119:
168 1.215 mrg Recent Xorg updates in xsrc/external/mit/ may cause various build
169 1.215 mrg or run-time problems. Delete your entire DESTDIR and OBJDIR if you
170 1.215 mrg have any build problems with xsrc, or problems with mismatched
171 1.215 mrg versions between xorg-server and drivers.
172 1.215 mrg
173 1.213 jmmv 20100604:
174 1.213 jmmv The update of ATF to 0.9 causes old tests written in shell to fail
175 1.213 jmmv unless they are rebuilt. If you are building with MKUPDATE=yes,
176 1.213 jmmv you need to clean the src/external/bsd/atf/tests/ and the src/tests/
177 1.213 jmmv trees by hand.
178 1.213 jmmv
179 1.211 tnozaki 20100522:
180 1.212 mrg Recent Xorg updates in xsrc/external/mit/ will cause various build
181 1.212 mrg problems. Delete your entire DESTDIR and OBJDIR if you have any
182 1.212 mrg build problems with xsrc.
183 1.212 mrg
184 1.212 mrg 20100522:
185 1.211 tnozaki private section of <ctype.h> was splitted, and now mklocale(1)
186 1.214 dholland include ctype_local.h, so you have to make cleandir in tools/mklocale.
187 1.211 tnozaki
188 1.210 christos 20100520:
189 1.241 wiz The location of the xkb compiled descriptions has changed. Please
190 1.210 christos remove usr/X11R7/lib/X11/xkb/compiled from your $DESTDIR.
191 1.210 christos
192 1.209 njoly 20100222:
193 1.209 njoly The shared objects file extension has been changed from .so to
194 1.209 njoly .pico, in order to avoid conflicts with shared libraries names
195 1.209 njoly libXX.so. All now stale regular .so files can be removed from
196 1.209 njoly your object directories.
197 1.209 njoly
198 1.208 roy 20100204:
199 1.208 roy The termcap database has been removed from the sources,
200 1.208 roy but has not been marked obsolete so it is not removed
201 1.208 roy from the system when upgrading.
202 1.208 roy As such, you will need to remove them from your object
203 1.208 roy and destination directories.
204 1.208 roy
205 1.203 dyoung 20091101:
206 1.205 dholland After updating, it may be necessary to make the 'cleandir'
207 1.205 dholland target in src/tools/yacc/ and in src/usr.bin/yacc/ before a
208 1.205 dholland 'build.sh -u tools' or 'build.sh -u distribution'. Ditto
209 1.205 dholland src/tools/lex/ and src/usr.bin/lex/.
210 1.203 dyoung
211 1.202 mrg 20091001:
212 1.206 dholland On amd64 you must rebuild tools (to get the new binutils)
213 1.206 dholland before building a kernel, or the build fails on cpufunc.S.
214 1.206 dholland
215 1.206 dholland 20091001:
216 1.202 mrg An error will create a ./usr/X11R7/lib/X11/xkb/compiled/xkb
217 1.202 mrg symlink, failing the build. Delete the link, and the subdir
218 1.202 mrg it is in, and retry your build.
219 1.202 mrg
220 1.201 dsl 20090718:
221 1.201 dsl libc build changed so that strchr() provides the extra entry
222 1.241 wiz point for index(). Update build of libc.a (and libc_pic.a)
223 1.201 dsl may fail because the archive contains the unwanted index.o.
224 1.201 dsl (Similarly for strrchr() and rindex().)
225 1.201 dsl
226 1.198 mrg 20090709:
227 1.198 mrg Native Xorg was upgraded again. Builds will probably fail again
228 1.198 mrg without a clean objdir, at least for src/external/mit/xorg.
229 1.198 mrg
230 1.197 mrg 20090616:
231 1.197 mrg Native Xorg was upgraded. Builds will need a clean objdir for
232 1.197 mrg src/external/mit/xorg. Upgrading a system from sets will not
233 1.197 mrg work properly yet as the /usr/X11R7/lib/X11/xkb/symbols/pc
234 1.197 mrg subdirectory has been changed into a file, and this needs to
235 1.197 mrg be manually "rm -r"'ed before installing xbase.tgz.
236 1.197 mrg
237 1.195 perry 20090501:
238 1.195 perry Several new functions were added to string.h/libc, and this
239 1.195 perry can cause autoconf problems during the tool build for people
240 1.241 wiz who fail to clean out their tools objects properly. If you
241 1.195 perry note messages about stpcpy, stpncpy or strnlen accompanying a
242 1.195 perry failure during the tool build, clean out all your tools
243 1.195 perry objects and start again.
244 1.195 perry
245 1.194 mrg 20090325:
246 1.194 mrg The i386 port was switched to i486 default toolchain. This requires
247 1.194 mrg cleaning your src/tools directory and $TOOLDIR and rebuilding them.
248 1.194 mrg
249 1.192 skrll 20090126:
250 1.241 wiz The __posix_fadvise50 system call changed assembly stub type. You
251 1.207 mbalmer need to 'rm -f __posix_fadvise50.*' in the libc build directory
252 1.207 mbalmer to avoid using the old assembly stub.
253 1.192 skrll
254 1.191 joerg 20090202:
255 1.191 joerg pkg_install now depends on the pkgdb cache for automatic conflict
256 1.191 joerg detection. It is recommented to rebuild the cache with
257 1.191 joerg ``pkg_admin rebuild''.
258 1.191 joerg
259 1.184 christos 20090110:
260 1.241 wiz time_t and dev_t have been bumped to 64 bit quantities. To upgrade:
261 1.241 wiz 1. Make sure your kernel has COMPAT_50 in it. Build and install.
262 1.188 christos This is needed even in the MODULAR kernel because there is
263 1.188 christos conditionally compiled code in rtsock.c.
264 1.184 christos 2. make sure build.sh completes and the binaries in a chroot work
265 1.184 christos before installing.
266 1.184 christos 3. If you don't use build.sh and you build directly to root, and
267 1.241 wiz your build breaks in the middle, don't despair. Make sure headers
268 1.184 christos are installed properly, and start building libraries first libc
269 1.184 christos and libutil, install them and then continue building all the
270 1.241 wiz libraries in src/lib and src/gnu/lib and install them. Once
271 1.184 christos the new libraries are installed, you can restart the build.
272 1.184 christos 4. If you compile packages and you notice link time warnings,
273 1.189 hubertf rebuild the required packages to update their shared libraries.
274 1.189 hubertf Any package you rebuild will require rebuilding all the packages
275 1.189 hubertf that depend on it.
276 1.186 christos 5. Next time you run pwd_mkdb with the new binary, the file
277 1.186 christos will be upgraded and it will not be backwards compatible.
278 1.190 apb 6. The utmpx/wtmpx files (/var/run/utmpx and /var/log/wtmpx, see
279 1.190 apb lastlogx(5)) have been versioned, and there is a heuristic
280 1.241 wiz for utmp. You are better off removing the old files after
281 1.190 apb upgrading. The automated clearing of /var/run during
282 1.190 apb boot, and the automated rotating of files in /var/log by
283 1.190 apb newsyslog(8), may mean that you do not have to remove the
284 1.190 apb files manually.
285 1.190 apb 7. The optional accounting file (/var/account/acct, see
286 1.190 apb accton(8)) has not been versioned, and will need to be
287 1.190 apb removed. The automatic rotation of the accounting file by
288 1.190 apb /etc/daily limits the bad consequences of failure to remove
289 1.190 apb the file.
290 1.196 dholland 8. Application software that writes time_t to binary files on
291 1.241 wiz disk will break or need attention. Most notably: if you are
292 1.196 dholland using PostgreSQL < 8.4, you need to dump your databases,
293 1.196 dholland rebuild PostgreSQL with the new time_t, then restore.
294 1.185 jmcneill
295 1.183 pgoyette 20081219:
296 1.183 pgoyette config(1) has been updated, and one of the files it creates -
297 1.183 pgoyette swapnetbsd.o - has changed format. You need to rebuild config
298 1.183 pgoyette (done automatically by build.sh) and then you need to rerun
299 1.183 pgoyette config on all kernel configuration files before rebuilding those
300 1.183 pgoyette kernels.
301 1.183 pgoyette
302 1.181 cube 20081205:
303 1.181 cube If you build with MKX11=no, you should remove /etc/rc.d/xdm and
304 1.181 cube /etc/rc.d/xfs from DESTDIR because those files were moved to the xetc
305 1.181 cube set and will appear as extra files for MKX11=no update builds.
306 1.178 lukem
307 1.179 tsutsui 20081122:
308 1.182 tsutsui On i386, various kernel options(4) in GENERIC including
309 1.180 wiz file systems have been disabled and moved into kernel modules.
310 1.180 wiz Before trying a new GENERIC kernel, you have to prepare the
311 1.179 tsutsui following files as well as a new GENERIC kernel:
312 1.179 tsutsui
313 1.179 tsutsui - build and install kernel modules from src/sys/modules
314 1.179 tsutsui
315 1.179 tsutsui - install the latest bootloader, which will load a module
316 1.180 wiz for the file system from which the kernel is loaded automatically
317 1.179 tsutsui
318 1.180 wiz If you have to load your kernel from a file system which is not of
319 1.180 wiz the same type as the root file system, you have to load the necessary
320 1.180 wiz file system module manually on the boot prompt or in the boot.cfg file.
321 1.179 tsutsui
322 1.178 lukem 20080827:
323 1.178 lukem If you built and installed a libc from sources between
324 1.178 lukem 2008/08/20 and 2008/08/26 you got a broken strtouq(3)
325 1.178 lukem which results in false errors reported by lint(1).
326 1.178 lukem Since this breaks the libc build itself, manual help is
327 1.180 wiz needed -- lint must be disabled temporarily, e.g.:
328 1.178 lukem $ (cd lib/libc && make MKLINT=no dependall install)
329 1.178 lukem
330 1.177 christos 20080813:
331 1.177 christos MKDEBUG build was broken because the .depend files did not know
332 1.241 wiz about .go files. You need to remove all .depend files and rebuild.
333 1.177 christos
334 1.200 dholland 20080802:
335 1.200 dholland A regression in binary compatibility for pthread_mutex_t has
336 1.241 wiz been fixed. Unfortunately, the price is breaking compatibility
337 1.200 dholland for -current.
338 1.200 dholland
339 1.200 dholland Threaded programs (using libpthread) and C++ programs (using
340 1.200 dholland libstdc++) compiled after 20070907 and before 20080802 need to
341 1.200 dholland be recompiled.
342 1.200 dholland
343 1.200 dholland One way to find affected pkgsrc packages:
344 1.200 dholland
345 1.200 dholland $ grep REQUIRES=/usr/lib/libpthread /var/db/pkg/*/+BUILD_INFO
346 1.200 dholland $ grep REQUIRES=/usr/lib/libstdc++ /var/db/pkg/*/+BUILD_INFO
347 1.200 dholland
348 1.175 simonb 20080731:
349 1.175 simonb WAPBL (metadata journaling support) has been added, but at this
350 1.175 simonb time isn't backwards compatible with pre-WAPBL aware kernels
351 1.175 simonb and userland (fsck_ffs in particular). Please make sure you
352 1.175 simonb don't use a journaled filesystem with an older kernel/userland,
353 1.176 simonb especially an uncleanly mounted journaled filesystem. WAPBL
354 1.176 simonb also requires the super block to be in the UFS2 format. You
355 1.176 simonb can use fsck_ffs -c 4 to update the superblock format.
356 1.175 simonb
357 1.174 lukem 20080721:
358 1.174 lukem Assembler warnings are now fatal if $WARNS>0 and $NOGCCERROR
359 1.174 lukem isn't defined.
360 1.174 lukem
361 1.173 freza 20080531:
362 1.241 wiz The ioctl number of DRVSUSPENDDEV command on /dev/drvctl changed
363 1.241 wiz from 125 (conflicted with DRVCTLCOMMAND) to 129. The drvctl(8)
364 1.173 freza utility needs to be rebuilt and reinstalled as older binaries
365 1.241 wiz won't work correctly. The following sequence of commands:
366 1.173 freza
367 1.173 freza $ (cd sys/sys/ && nbmake-$arch includes)
368 1.173 freza $ (cd sbin/drvctl/ && nbmake-$arch clean)
369 1.173 freza $ (cd sbin/drvctl/ && nbmake-$arch all)
370 1.173 freza
371 1.173 freza leaves new drvctl utility in sbin/drvctl build directory.
372 1.173 freza
373 1.172 lukem 20080503:
374 1.172 lukem The <bsd.lib.mk> variable MKPRIVATELIB was renamed to LIBISPRIVATE.
375 1.172 lukem
376 1.171 he 20080521:
377 1.171 he For a while, unprivileged UPDATE builds would fail to
378 1.171 he succeed at the checkflist stage, complaining that
379 1.171 he ${DESTDIR}/stand/<arch>/ did not exist. A fix for this
380 1.171 he problem was committed to share/mk/bsd.kmodule.mk, revision 1.9.
381 1.171 he If you already hit this problem, update the .mk file,
382 1.171 he remove ${DESTDIR}/stand/<arch>, and re-run the build.
383 1.171 he
384 1.174 lukem 20080303:
385 1.174 lukem Linker warnings are now fatal if $WARNS>0.
386 1.174 lukem
387 1.170 christos 20080126:
388 1.170 christos The posix_fadvise system call has been changed from an assembly
389 1.241 wiz stub, to a c file that calls an assembly stub. You need to
390 1.170 christos 'rm -f posix_fadvise.* .depend' in the libc build directory to
391 1.170 christos avoid using the old assembly stub.
392 1.170 christos
393 1.168 joerg 20071209:
394 1.241 wiz The acpiec(4) driver has been split into two attachments. If you
395 1.168 joerg get ACPI errors before the attachment, please update your kernel
396 1.169 wiz configuration file appropriately or see GENERIC for more details.
397 1.168 joerg
398 1.166 xtraeme 20071115:
399 1.166 xtraeme The it(4) driver has been renamed to itesio(4) and the old port
400 1.166 xtraeme argument specified in the kernel configuration file is not valid
401 1.241 wiz anymore. The itesio(4) driver now uses the Super I/O address port
402 1.241 wiz rather than the EC address port. Please update your kernel
403 1.167 wiz configuration file appropriately or see GENERIC for more details.
404 1.166 xtraeme
405 1.165 jmmv 20071028:
406 1.165 jmmv The pccons(4) driver has been removed from the NetBSD/shark port.
407 1.165 jmmv You need to update any custom kernel configuration file you have
408 1.165 jmmv to remove any references to pccons (which includes removing the
409 1.165 jmmv now useless XSERVER option) and replace them with the correct
410 1.165 jmmv entries for the wscons driver. See the GENERIC configuration file
411 1.165 jmmv for more details.
412 1.165 jmmv
413 1.164 gdt 20070913:
414 1.164 gdt A latent bug in dhclient/dhcpd that caused it to be unable to
415 1.164 gdt enumerate interfaces was fixed. The bug began to cause
416 1.164 gdt problems after 20070911 when the kernel's SIOCGIFCONF
417 1.164 gdt implementation was repaired. From 20070529 to 20070911 racoon
418 1.164 gdt could not enumerate interfaces. (These are noted because
419 1.164 gdt normal kernel/userspace version matching hygiene is not
420 1.164 gdt sufficient to avoid this problem.) Ensure that both kernel
421 1.164 gdt and userland are from after 20070913.
422 1.164 gdt
423 1.163 joerg 20070703:
424 1.241 wiz nbinstall has been renamed ${MACHINE_GNU_ARCH}-install. It
425 1.199 dholland calls the target-specific strip program, and the logic to pass
426 1.199 dholland down STRIP from make has been removed. This requires a
427 1.199 dholland re-installation of tools.
428 1.163 joerg
429 1.161 dsl 20070422:
430 1.161 dsl The way OS emulations lookup filenames inside the emulation root
431 1.161 dsl has been changed. Rather than modify the pathname (and copy back
432 1.161 dsl to userspace) namei() and lookup() directly check the emulation
433 1.241 wiz root. One side effect is that absolute symlinks inside the emulated
434 1.167 wiz root file system will be relative to that file system - unless they
435 1.161 dsl start /../ this is useful when the emulated root is a real install
436 1.161 dsl that has such links.
437 1.161 dsl This might affect symlinks that have been added to reference outside
438 1.161 dsl the emulated root.
439 1.161 dsl
440 1.160 jmcneill 20070412:
441 1.241 wiz The pckbc driver on sgimips IP32 has been removed. Use macekbc
442 1.241 wiz instead. See the GENERIC32_IP3x kernel configuration for an
443 1.160 jmcneill example.
444 1.160 jmcneill
445 1.159 gdt 20070319:
446 1.159 gdt src/lib/libc/Makefile revision 1.129 broke libc and ld.elf_so
447 1.159 gdt on many platforms due to incorrect flags settings. If you
448 1.159 gdt updated and built after about 20070315, do "nbmake-$arch
449 1.159 gdt cleandir" in src/lib/libc and src/libexec/ld.elf_so to force a
450 1.159 gdt rebuild of object files that might have been built
451 1.159 gdt incorrectly, and ensure that you have at least
452 1.159 gdt src/lib/libc/Makefile 1.130.
453 1.159 gdt
454 1.241 wiz 20070210:
455 1.158 dbj src/sys/sys/{sa.h,savar.h} were removed.
456 1.158 dbj find ${OBJDIR} \( -name .depend -o -name '*.d' \) -print \
457 1.158 dbj | xargs egrep -l '/sa.h|/savar.h' | xargs rm
458 1.158 dbj will allow dependencies on those files to get get rebuilt
459 1.158 dbj
460 1.157 apb 20070209:
461 1.157 apb The threading model was changed when the newlock2 branch
462 1.157 apb was merged to NetBSD-current. If you boot with a new
463 1.157 apb kernel (version 4.99.10), then you also need a new pthread
464 1.157 apb library (/usr/lib/libpthread.so.0.7). If you boot with
465 1.157 apb an old kernel, then you need the old pthread library
466 1.157 apb (/usr/lib/libpthread.so.0.6). Provided you keep the kernel and
467 1.157 apb the pthread library in sync, old threaded applications should
468 1.157 apb continue to work with an old or new kernel. Note that named(8)
469 1.157 apb is the only threaded application in the base system.
470 1.157 apb
471 1.154 he 20061214:
472 1.154 he Following the move of string_to_flags() and flags_to_string()
473 1.154 he from the bin/ls/ sources to libutil, users doing UPDATE builds
474 1.154 he will need to do a "make cleandir" in
475 1.154 he tools/mtree/, tools/makefs/, tools/binstall/, tools/pax/,
476 1.154 he bin/pax/, bin/ls/, usr.sbin/mtree/, usr.sbin/makefs/,
477 1.156 he usr.bin/xinstall/, libexec/ftpd/, rescue/, as well
478 1.156 he as the installation images in distrib/
479 1.154 he in order to excise stale references to the old stat_flags.h header
480 1.154 he file in the ls sources -- stat_flags.h has been removed.
481 1.154 he
482 1.152 christos 20061108:
483 1.152 christos The configure script used in the src/tools/gcc compiler has been
484 1.152 christos changed to indicate that our libc has ssp support built-in and
485 1.241 wiz does not depend on -lssp and -lssp-nonshared. You'll need to
486 1.152 christos make clean in src/tools/gcc first to rebuild the compiler.
487 1.152 christos
488 1.151 rpaulo 20061009:
489 1.151 rpaulo The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer
490 1.241 wiz available. Use net.inet{,6}.tcp{,6}.congctl.selected instead.
491 1.151 rpaulo
492 1.150 bjh21 20060814:
493 1.150 bjh21 The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been
494 1.150 bjh21 withdrawn. Use vidcvideo and pckbd instead. See the GENERIC
495 1.150 bjh21 kernel configuration for an example. X servers from the last
496 1.150 bjh21 few years should cope.
497 1.150 bjh21
498 1.149 christos 20060703:
499 1.241 wiz MPACPI is no more. We always configure PCI interrupts using ACPI
500 1.241 wiz if we have an ACPI kernel. The option MPACPI_SCANPCI has been renamed
501 1.241 wiz to ACPI_SCANPCI. Thanks to work from fvdl.
502 1.149 christos
503 1.148 dogcow 20060627:
504 1.148 dogcow socket(2) has changed, and its system call has been versioned.
505 1.148 dogcow For userlands with the old version of socket(2), make sure that
506 1.148 dogcow your kernel has 'options COMPAT_30' set, or else 'bad system call'
507 1.148 dogcow errors will result.
508 1.148 dogcow
509 1.1 abs Hints for a more successful build:
510 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
511 1.123 jmc Use build.sh, but do not use its "expert mode":
512 1.132 jmmv This will automatically build the tools in the
513 1.123 jmc correct order, and it will keep the tools and the
514 1.123 jmc new build products from interfering with the running
515 1.123 jmc system. This will allow you to ignore most of the
516 1.123 jmc other advice in this file.
517 1.2 mrg Build a new kernel first:
518 1.2 mrg This makes sure that any new system calls or features
519 1.2 mrg expected by the new userland will be present. This
520 1.2 mrg helps to avoid critical errors when upgrading.
521 1.1 abs Use object directories:
522 1.1 abs This helps to keep stale object
523 1.1 abs files from polluting the build if a Makefile "forgets"
524 1.1 abs about one. It also makes it easier to clean up after
525 1.1 abs a build. It's also necessary if you want to use the
526 1.1 abs same source tree for multiple machines.
527 1.123 jmc To use object directories with build.sh:
528 1.123 jmc a) invoke build.sh with the "-M" or "-O" options.
529 1.123 jmc To use object directories without using build.sh:
530 1.1 abs a) cd /usr/src ; make cleandir
531 1.2 mrg b) Add "OBJMACHINE=yes" to /etc/mk.conf
532 1.2 mrg c) Add "MKOBJDIRS=yes" to /etc/mk.conf
533 1.1 abs d) cd /usr/src ; make build
534 1.2 mrg Note that running "make obj" in a directory will create
535 1.2 mrg in obj.$MACHINE directory.
536 1.1 abs Build to a DESTDIR:
537 1.123 jmc This helps to keep old installed files (especially libraries)
538 1.123 jmc from interfering with the new build.
539 1.123 jmc To build to a DESTDIR with build.sh, use the "-D" option.
540 1.123 jmc To build to a DESTDIR without using build.sh, set the DESTDIR
541 1.123 jmc environment variable before running make build. It should be
542 1.123 jmc set to the pathname of an initially empty directory.
543 1.123 jmc Problems: if you do not use build.sh, you might need to
544 1.123 jmc update critical utilities without using DESTDIR since
545 1.123 jmc nothing is executed from what is installed in DESTDIR.
546 1.123 jmc (See critical utils, below.)
547 1.1 abs Build often:
548 1.1 abs This keeps critical utilities current enough to not choke
549 1.1 abs on any other part of the source tree that depends on up to
550 1.123 jmc date functionality. If you use build.sh, you should not have
551 1.123 jmc this problem.
552 1.241 wiz
553 1.1 abs What to do if things don't work:
554 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
555 1.230 tls When things don't work there are usually a few things that commonly
556 1.1 abs should be done.
557 1.1 abs 1) make includes
558 1.1 abs This should be done automatically by make build.
559 1.1 abs 2) cd share/mk && make install
560 1.1 abs Again, automatically done by make build.
561 1.1 abs
562 1.1 abs Failsafe rebuild of a small part of the tree:
563 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
564 1.1 abs To make sure you rebuild something correctly you want to do
565 1.1 abs something like the following:
566 1.1 abs 1) Make sure the includes and .mk files are up to date.
567 1.1 abs 2) Make sure any program used to build the particular
568 1.1 abs utility is up to date. (yacc, lex, etc...)
569 1.1 abs 3) cd ...path/to/util...
570 1.1 abs make cleandir
571 1.1 abs rm ...all obj directories...
572 1.1 abs make cleandir # yes, again
573 1.1 abs make obj
574 1.1 abs make depend && make
575 1.1 abs
576 1.1 abs Failsafe rebuild of the entire tree:
577 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
578 1.1 abs If you really want to make sure the source tree is clean and
579 1.2 mrg ready for a build try the following. Note that sourcing /etc/mk.conf
580 1.2 mrg (a make(1) Makefile) in this manner is not right, and will not work
581 1.2 mrg for anyone who uses any make(1) features in /etc/mk.conf.
582 1.1 abs
583 1.1 abs ---cut here---
584 1.1 abs #!/bin/sh
585 1.1 abs . /etc/mk.conf
586 1.1 abs
587 1.58 lukem if [ -z $NETBSDSRCDIR ] ; then
588 1.58 lukem NETBSDSRCDIR=/usr/src
589 1.1 abs fi
590 1.58 lukem if [ \! -d $NETBSDSRCDIR ] ; then
591 1.1 abs echo Unable to find sources
592 1.1 abs exit 1
593 1.1 abs fi
594 1.58 lukem find $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \;
595 1.1 abs
596 1.1 abs if [ -z $BSDOBJDIR ] ; then
597 1.1 abs BSDOBJDIR=/usr/obj
598 1.1 abs fi
599 1.1 abs if [ -d $BSDOBJDIR ] ; then
600 1.1 abs rm -rf $BSDOBJDIR
601 1.1 abs fi
602 1.1 abs
603 1.58 lukem cd $NETBSDSRCDIR && make cleandir
604 1.1 abs
605 1.1 abs ---cut here---
606 1.1 abs
607 1.1 abs Critical utilities:
608 1.1 abs ^^^^^^^^^^^^^^^^^^^
609 1.3 itojun usr.bin/compile_et
610 1.1 abs usr.bin/make
611 1.1 abs usr.bin/yacc
612 1.1 abs usr.bin/lex
613 1.11 lukem usr.bin/xlint
614 1.142 drochner usr.bin/config
615 1.1 abs
616 1.34 simonb Other problems and possible solutions:
617 1.1 abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
618 1.1 abs Symptom:Complaints involving a Makefile.
619 1.17 erh Fix: Rebuild usr.bin/make:
620 1.17 erh cd usr.bin/make && make && make install
621 1.111 simonb Or, a failsafe method if that doesn't work:
622 1.17 erh cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin
623 1.17 erh
624 1.1 abs Fix: Make sure .mk files are up to date.
625 1.1 abs cd share/mk && make install
626 1.2 mrg
627 1.2 mrg Symptom:Kernel `config' fails to configure any kernel, including GENERIC.
628 1.142 drochner Fix: Rebuild usr.bin/config
629 1.1 abs
630 1.1 abs Symptom:
631 1.1 abs Fix: Rebuild usr.bin/yacc
632 1.1 abs
633 1.1 abs Symptom:
634 1.1 abs Fix: Rebuild usr.bin/lex
635 1.1 abs
636 1.1 abs Symptom:
637 1.1 abs Fix: rm /usr/lib/libbfd.a
638 1.4 itojun
639 1.4 itojun Symptom:Obsolete intermediate files are used during compilation
640 1.4 itojun Fix: Try the following sequence of commands in the directory in question.
641 1.4 itojun make cleandir; rm `make print-objdir`; make cleandir; make obj
642 1.4 itojun (If you built the tree without "make obj" in the past, obsolete files
643 1.4 itojun may remain. The command tries to clean everything up)
644 1.5 wiz
645 1.207 mbalmer Symptom:.../sysinst/run.c:xx: warning: initialization from incompatible
646 1.207 mbalmer pointer type
647 1.5 wiz Fix: Rebuild and install usr.bin/menuc
648 1.12 itojun
649 1.12 itojun Symptom:mklocale not found during build in share/locale/ctype
650 1.12 itojun Fix: Build and install usr.bin/mklocale
651 1.13 dogcow
652 1.86 kleink Symptom:undefined reference to `__assert13' or `__unsetenv13'
653 1.13 dogcow Fix: Rebuild and install lib/libc
654 1.13 dogcow
655 1.142 drochner Symptom:usr.bin/config fails to build.
656 1.19 cgd Fix: Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile.
657 1.13 dogcow
658 1.19 cgd Symptom:undefined reference to `getprogname' or `setprogname'
659 1.19 cgd Fix: Rebuild and install lib/libc
660 1.24 abs
661 1.24 abs Symptom:lint does not understand the '-X' option
662 1.24 abs Fix: May need to build & install libs with NOLINT=1 before rebuilding lint
663 1.223 joerg
664 1.223 joerg Symptom:Update build fails in src/tools/gcc complaining that a variable
665 1.223 joerg (e.g. CPPFLAGS) has changed since the previous run.
666 1.223 joerg Fix: Run "nbmake-${ARCH} clean" in src/tools/gcc or do a clean build.
667