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