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