UPDATING revision 1.253
11.253Sjoerg$NetBSD: UPDATING,v 1.253 2014/02/01 12:51:02 joerg Exp $ 21.1Sabs 31.123SjmcThis file (UPDATING) is intended to be a brief reference to recent 41.123Sjmcchanges that might cause problems in the build process, and a guide for 51.123Sjmcwhat to do if something doesn't work. 61.1Sabs 71.123SjmcFor a more detailed description of the recommended way to build NetBSD 81.123Sjmcusing build.sh, see the BUILDING file. 91.123Sjmc 101.123SjmcNote that much of the advice in this UPDATING file was written before 111.123Sjmcbuild.sh existed. Nevertheless, the advice here may be useful for 121.123Sjmcworking around specific problems with build.sh. 131.123Sjmc 141.123SjmcSee also: BUILDING, build.sh, Makefile. 151.1Sabs 161.1SabsRecent changes: 171.1Sabs^^^^^^^^^^^^^^^ 181.230Stls 191.251Smartin20140131: 201.253Sjoerg The new compiler_rt/libc integration moved a few things. It is strongly 211.253Sjoerg disadvised to a clean build. At least lib/libc, the compat version(s) 221.253Sjoerg of libc, libkern, rump and the kernels need to be cleaned. 231.251Smartin 241.250Schristos20131227: 251.250Schristos 1. The new ntpd runs in a restricted mode to prevent amplification 261.250Schristos attacks. If you need ntpdc to work you need to explicitly enable 271.250Schristos mode7 in your config file. Make sure you put the necessary restrict 281.250Schristos statements to avoid being exposed. 291.250Schristos 2. strncat has moved from lib/libc to common/lib/libc; you might need 301.250Schristos to make clean in libc 311.250Schristos 321.249Smrg20131129: 331.249Smrg The GMP sources were updated, and builds will likely fail without 341.249Smrg cleaning their build trees for both tools and in-tree, like below. 351.249Smrg 361.248Smrg20131128: 371.248Smrg The MPC and MPFR sources were updated, and builds may require their 381.248Smrg tools and in-tree directories cleaned for successful updates. 391.248Smrg 401.246Smartin20130605: 411.247Sspz The kernel option FAST_IPSEC no longer exists, it's been renamed 421.247Sspz to IPSEC (and the older IPSEC version removed). 431.247Sspz 441.247Sspz20130605: 451.246Smartin Previous freetype installations eroneously installed private 461.246Smartin header files. If you are building against a non-empty $DESTDIR, 471.246Smartin please remove ${DESTDIR}//usr/X11R7/include/freetype2/freetype/. 481.246Smartin 491.245Smrg20130531: 501.245Smrg The xdm update may cause build failure due to xdm.man being 511.245Smrg in the obj tree. Make sure to ensure any like this: 521.245Smrg nbmake: nbmake: don't know how to make xdm.man. Stop 531.245Smrg is fixed by deleting the xdm.man in the obj tree. 541.245Smrg 551.244Smrg20130530: 561.244Smrg Updates of many xsrc packages will leave old .pc files around. 571.244Smrg Best to clean out the xsrc objdir entirely before rebuilds. 581.244Smrg 591.242Schristos20130301: 601.242Schristos The removal of netiso requires manual removal of /usr/include/netiso 611.243Schristos prior to the build and make cleandir in /usr/src/usr.bin/{ktruss,kdump} 621.242Schristos 631.238Sdholland20120726: 641.241Swiz The update of OpenSSL requires cleaning both the OpenSSL build 651.241Swiz directory and DESTDIR. *Even non-update builds require cleaning 661.240Sdholland DESTDIR.* Builds done without taking these steps may fail, or in 671.241Swiz some cases may succeed and install broken OpenSSL libraries that 681.240Sdholland cause third-party software to link incorrectly and/or crash. 691.238Sdholland 701.237Swiz20120507: 711.241Swiz The database schema for makemandb was changed. You will 721.237Swiz need to update the database using 'makemandb -f' or wait 731.237Swiz for the next weekly run to fix it. 741.237Swiz 751.236Sbsh20120319: 761.236Sbsh sys/conf/Makefile.kern.inc has been modified to adjust the 771.236Sbsh size of db_symtab automatically. You need to update dbsym in 781.236Sbsh your $TOOLDIR to build kernels with options SYMTAB_SPACE. If 791.236Sbsh you don't want this behavior, add AUTO_SYMTAB_SPACE=no to your 801.236Sbsh mk.conf. 811.236Sbsh 821.235Sjoerg20120216: 831.241Swiz Default for MKCATPAGES changed to NO. Update builds will fail 841.241Swiz unless DESTDIR is cleaned manually. If you built between 20120207 851.239Sdholland and 20120216, daily and weekly could have created an unreadable 861.241Swiz /var/db/man.db index for apropos. Running makemandb -f or 871.235Sjoerg the next run of weekly will fix it. 881.233Sjoerg 891.232Schristos20111227: 901.232Schristos If you built between 20111225 and 20111227 you need to remove 911.232Schristos /usr/lib/libpam.so.4* and /usr/lib/security/*.so.4, since the 921.232Schristos bump has been reverted. 931.232Schristos 941.231Stls20111125: 951.231Stls The "rnd" pseudodevice has been added to sys/conf/std, which 961.231Stls means it should no longer be explicitly listed in kernel 971.231Stls configuration files. The line "pseudo-device rnd" should be 981.231Stls removed from any custom kernel config files users may have. 991.231Stls 1001.230Stls20111119: 1011.230Stls A problem with the datastructures used by the rndctl(8) 1021.230Stls utility (pointers in datastructures in an array, making 32->64 1031.230Stls bit compatibility very painful) has been fixed in a 1041.230Stls non-backwards-compatible way. If you replace your kernel, 1051.230Stls replace your rndctl executable too. 1061.241Swiz 1071.229Sjym20111001: 1081.229Sjym the prop_*_send_syscall() functions from proplib(3) have been 1091.229Sjym changed and their new version is not backward compatible with the old 1101.241Swiz one. So ensure that all consumers of these functions (currently: 1111.229Sjym quota2 code and its tests) are updated together with the new lib. 1121.229Sjym 1131.228Smrg20110817: 1141.228Smrg sparc has been changed to use GCC 4.5.3, so any objdir or 1151.228Smrg DESTDIR for them should be deleted before updating. 1161.228Smrg 1171.227Sriastrad20110806: 1181.227Sriastrad i386 and amd64 have been changed to use GCC 4.5.3, so any 1191.227Sriastrad objdir or DESTDIR for them should be deleted before updating. 1201.227Sriastrad 1211.226Smrg20110805: 1221.226Smrg The update to GCC 4.5.3 requires a non-trivial portion of 1231.226Smrg the tree to be cleaned. Best to delete both objdir and 1241.226Smrg DESTDIR before running this update. So far, only the 1251.226Smrg sparc64, mips and powerpc platforms have changed. 1261.226Smrg 1271.225Smatt20110803: 1281.241Swiz The layout of external/public-domain/xz has changed. To do an 1291.225Smatt update build you will have to remove the contents of the OBJDIR 1301.225Smatt for external/public-domain/xz/bin by hand as the xz entry there 1311.225Smatt is now a directory. 1321.225Smatt 1331.223Sjoerg20110410: 1341.241Swiz The configuration of src/tools/gcc has changed. To do an 1351.224Sdholland update build you have to clean both tools/binutils and 1361.224Sdholland tools/gcc by hand. 1371.223Sjoerg 1381.222Splunky20110328: 1391.222Splunky Building the Xorg binary was moved into a subdirectory to fix 1401.241Swiz ordering issues with "make all". It may be necessary to remove 1411.222Splunky the OBJDIR for external/mit/xorg/server/xorg-server/hw/xfree86 1421.222Splunky if your update build fails, as the "Xorg" entry there is now a 1431.222Splunky directory. 1441.222Splunky 1451.220Sjoerg20110121: 1461.221Slukem Assembler files no longer use -traditional-cpp. This can break 1471.220Sjoerg the build of individual parts of the tree. This is handled 1481.220Sjoerg correctly by build.sh. Manual builds have to update /usr/share/mk 1491.220Sjoerg and re-run config(1) for any kernel configurations as needed. 1501.218Sjoerg 1511.217Sjruoho20101217: 1521.217Sjruoho The tcpdump(8) program was changed to drop privileges and chroot(2) 1531.241Swiz by default. It may be necessary to manually update passwd(5) and 1541.217Sjruoho group(5) in order to make the program work with existing setups. 1551.217Sjruoho 1561.216Schristos20101125: 1571.216Schristos The latest changes to setenv(3) dissallow setting environment 1581.241Swiz variables with names that contain '='. Revision 1.18 of env.c 1591.241Swiz assumed that this was allowed. Installing a new libc with an 1601.216Schristos old copy of /usr/bin/env causes env x=1 printenv | grep x= to 1611.216Schristos break which affects the autoconf tests for dependency finding, 1621.216Schristos so building gcc will end up printing: 1631.216Schristos checking dependency style of gcc... none 1641.216Schristos configure: error: no usable dependency style found 1651.216Schristos Fix it by rebuilding and re-installing env. 1661.138Slukem 1671.215Smrg20101119: 1681.215Smrg Recent Xorg updates in xsrc/external/mit/ may cause various build 1691.215Smrg or run-time problems. Delete your entire DESTDIR and OBJDIR if you 1701.215Smrg have any build problems with xsrc, or problems with mismatched 1711.215Smrg versions between xorg-server and drivers. 1721.215Smrg 1731.213Sjmmv20100604: 1741.213Sjmmv The update of ATF to 0.9 causes old tests written in shell to fail 1751.213Sjmmv unless they are rebuilt. If you are building with MKUPDATE=yes, 1761.213Sjmmv you need to clean the src/external/bsd/atf/tests/ and the src/tests/ 1771.213Sjmmv trees by hand. 1781.213Sjmmv 1791.211Stnozaki20100522: 1801.212Smrg Recent Xorg updates in xsrc/external/mit/ will cause various build 1811.212Smrg problems. Delete your entire DESTDIR and OBJDIR if you have any 1821.212Smrg build problems with xsrc. 1831.212Smrg 1841.212Smrg20100522: 1851.211Stnozaki private section of <ctype.h> was splitted, and now mklocale(1) 1861.214Sdholland include ctype_local.h, so you have to make cleandir in tools/mklocale. 1871.211Stnozaki 1881.210Schristos20100520: 1891.241Swiz The location of the xkb compiled descriptions has changed. Please 1901.210Schristos remove usr/X11R7/lib/X11/xkb/compiled from your $DESTDIR. 1911.210Schristos 1921.209Snjoly20100222: 1931.209Snjoly The shared objects file extension has been changed from .so to 1941.209Snjoly .pico, in order to avoid conflicts with shared libraries names 1951.209Snjoly libXX.so. All now stale regular .so files can be removed from 1961.209Snjoly your object directories. 1971.209Snjoly 1981.208Sroy20100204: 1991.208Sroy The termcap database has been removed from the sources, 2001.208Sroy but has not been marked obsolete so it is not removed 2011.208Sroy from the system when upgrading. 2021.208Sroy As such, you will need to remove them from your object 2031.208Sroy and destination directories. 2041.208Sroy 2051.203Sdyoung20091101: 2061.205Sdholland After updating, it may be necessary to make the 'cleandir' 2071.205Sdholland target in src/tools/yacc/ and in src/usr.bin/yacc/ before a 2081.205Sdholland 'build.sh -u tools' or 'build.sh -u distribution'. Ditto 2091.205Sdholland src/tools/lex/ and src/usr.bin/lex/. 2101.203Sdyoung 2111.202Smrg20091001: 2121.206Sdholland On amd64 you must rebuild tools (to get the new binutils) 2131.206Sdholland before building a kernel, or the build fails on cpufunc.S. 2141.206Sdholland 2151.206Sdholland20091001: 2161.202Smrg An error will create a ./usr/X11R7/lib/X11/xkb/compiled/xkb 2171.202Smrg symlink, failing the build. Delete the link, and the subdir 2181.202Smrg it is in, and retry your build. 2191.202Smrg 2201.201Sdsl20090718: 2211.201Sdsl libc build changed so that strchr() provides the extra entry 2221.241Swiz point for index(). Update build of libc.a (and libc_pic.a) 2231.201Sdsl may fail because the archive contains the unwanted index.o. 2241.201Sdsl (Similarly for strrchr() and rindex().) 2251.201Sdsl 2261.198Smrg20090709: 2271.198Smrg Native Xorg was upgraded again. Builds will probably fail again 2281.198Smrg without a clean objdir, at least for src/external/mit/xorg. 2291.198Smrg 2301.197Smrg20090616: 2311.197Smrg Native Xorg was upgraded. Builds will need a clean objdir for 2321.197Smrg src/external/mit/xorg. Upgrading a system from sets will not 2331.197Smrg work properly yet as the /usr/X11R7/lib/X11/xkb/symbols/pc 2341.197Smrg subdirectory has been changed into a file, and this needs to 2351.197Smrg be manually "rm -r"'ed before installing xbase.tgz. 2361.197Smrg 2371.195Sperry20090501: 2381.195Sperry Several new functions were added to string.h/libc, and this 2391.195Sperry can cause autoconf problems during the tool build for people 2401.241Swiz who fail to clean out their tools objects properly. If you 2411.195Sperry note messages about stpcpy, stpncpy or strnlen accompanying a 2421.195Sperry failure during the tool build, clean out all your tools 2431.195Sperry objects and start again. 2441.195Sperry 2451.194Smrg20090325: 2461.194Smrg The i386 port was switched to i486 default toolchain. This requires 2471.194Smrg cleaning your src/tools directory and $TOOLDIR and rebuilding them. 2481.194Smrg 2491.192Sskrll20090126: 2501.241Swiz The __posix_fadvise50 system call changed assembly stub type. You 2511.207Smbalmer need to 'rm -f __posix_fadvise50.*' in the libc build directory 2521.207Smbalmer to avoid using the old assembly stub. 2531.192Sskrll 2541.191Sjoerg20090202: 2551.191Sjoerg pkg_install now depends on the pkgdb cache for automatic conflict 2561.191Sjoerg detection. It is recommented to rebuild the cache with 2571.191Sjoerg ``pkg_admin rebuild''. 2581.191Sjoerg 2591.184Schristos20090110: 2601.241Swiz time_t and dev_t have been bumped to 64 bit quantities. To upgrade: 2611.241Swiz 1. Make sure your kernel has COMPAT_50 in it. Build and install. 2621.188Schristos This is needed even in the MODULAR kernel because there is 2631.188Schristos conditionally compiled code in rtsock.c. 2641.184Schristos 2. make sure build.sh completes and the binaries in a chroot work 2651.184Schristos before installing. 2661.184Schristos 3. If you don't use build.sh and you build directly to root, and 2671.241Swiz your build breaks in the middle, don't despair. Make sure headers 2681.184Schristos are installed properly, and start building libraries first libc 2691.184Schristos and libutil, install them and then continue building all the 2701.241Swiz libraries in src/lib and src/gnu/lib and install them. Once 2711.184Schristos the new libraries are installed, you can restart the build. 2721.184Schristos 4. If you compile packages and you notice link time warnings, 2731.189Shubertf rebuild the required packages to update their shared libraries. 2741.189Shubertf Any package you rebuild will require rebuilding all the packages 2751.189Shubertf that depend on it. 2761.186Schristos 5. Next time you run pwd_mkdb with the new binary, the file 2771.186Schristos will be upgraded and it will not be backwards compatible. 2781.190Sapb 6. The utmpx/wtmpx files (/var/run/utmpx and /var/log/wtmpx, see 2791.190Sapb lastlogx(5)) have been versioned, and there is a heuristic 2801.241Swiz for utmp. You are better off removing the old files after 2811.190Sapb upgrading. The automated clearing of /var/run during 2821.190Sapb boot, and the automated rotating of files in /var/log by 2831.190Sapb newsyslog(8), may mean that you do not have to remove the 2841.190Sapb files manually. 2851.190Sapb 7. The optional accounting file (/var/account/acct, see 2861.190Sapb accton(8)) has not been versioned, and will need to be 2871.190Sapb removed. The automatic rotation of the accounting file by 2881.190Sapb /etc/daily limits the bad consequences of failure to remove 2891.190Sapb the file. 2901.196Sdholland 8. Application software that writes time_t to binary files on 2911.241Swiz disk will break or need attention. Most notably: if you are 2921.196Sdholland using PostgreSQL < 8.4, you need to dump your databases, 2931.196Sdholland rebuild PostgreSQL with the new time_t, then restore. 2941.185Sjmcneill 2951.183Spgoyette20081219: 2961.183Spgoyette config(1) has been updated, and one of the files it creates - 2971.183Spgoyette swapnetbsd.o - has changed format. You need to rebuild config 2981.183Spgoyette (done automatically by build.sh) and then you need to rerun 2991.183Spgoyette config on all kernel configuration files before rebuilding those 3001.183Spgoyette kernels. 3011.183Spgoyette 3021.181Scube20081205: 3031.181Scube If you build with MKX11=no, you should remove /etc/rc.d/xdm and 3041.181Scube /etc/rc.d/xfs from DESTDIR because those files were moved to the xetc 3051.181Scube set and will appear as extra files for MKX11=no update builds. 3061.178Slukem 3071.179Stsutsui20081122: 3081.182Stsutsui On i386, various kernel options(4) in GENERIC including 3091.180Swiz file systems have been disabled and moved into kernel modules. 3101.180Swiz Before trying a new GENERIC kernel, you have to prepare the 3111.179Stsutsui following files as well as a new GENERIC kernel: 3121.179Stsutsui 3131.179Stsutsui - build and install kernel modules from src/sys/modules 3141.179Stsutsui 3151.179Stsutsui - install the latest bootloader, which will load a module 3161.180Swiz for the file system from which the kernel is loaded automatically 3171.179Stsutsui 3181.180Swiz If you have to load your kernel from a file system which is not of 3191.180Swiz the same type as the root file system, you have to load the necessary 3201.180Swiz file system module manually on the boot prompt or in the boot.cfg file. 3211.179Stsutsui 3221.178Slukem20080827: 3231.178Slukem If you built and installed a libc from sources between 3241.178Slukem 2008/08/20 and 2008/08/26 you got a broken strtouq(3) 3251.178Slukem which results in false errors reported by lint(1). 3261.178Slukem Since this breaks the libc build itself, manual help is 3271.180Swiz needed -- lint must be disabled temporarily, e.g.: 3281.178Slukem $ (cd lib/libc && make MKLINT=no dependall install) 3291.178Slukem 3301.177Schristos20080813: 3311.177Schristos MKDEBUG build was broken because the .depend files did not know 3321.241Swiz about .go files. You need to remove all .depend files and rebuild. 3331.177Schristos 3341.200Sdholland20080802: 3351.200Sdholland A regression in binary compatibility for pthread_mutex_t has 3361.241Swiz been fixed. Unfortunately, the price is breaking compatibility 3371.200Sdholland for -current. 3381.200Sdholland 3391.200Sdholland Threaded programs (using libpthread) and C++ programs (using 3401.200Sdholland libstdc++) compiled after 20070907 and before 20080802 need to 3411.200Sdholland be recompiled. 3421.200Sdholland 3431.200Sdholland One way to find affected pkgsrc packages: 3441.200Sdholland 3451.200Sdholland $ grep REQUIRES=/usr/lib/libpthread /var/db/pkg/*/+BUILD_INFO 3461.200Sdholland $ grep REQUIRES=/usr/lib/libstdc++ /var/db/pkg/*/+BUILD_INFO 3471.200Sdholland 3481.175Ssimonb20080731: 3491.175Ssimonb WAPBL (metadata journaling support) has been added, but at this 3501.175Ssimonb time isn't backwards compatible with pre-WAPBL aware kernels 3511.175Ssimonb and userland (fsck_ffs in particular). Please make sure you 3521.175Ssimonb don't use a journaled filesystem with an older kernel/userland, 3531.176Ssimonb especially an uncleanly mounted journaled filesystem. WAPBL 3541.176Ssimonb also requires the super block to be in the UFS2 format. You 3551.176Ssimonb can use fsck_ffs -c 4 to update the superblock format. 3561.175Ssimonb 3571.174Slukem20080721: 3581.174Slukem Assembler warnings are now fatal if $WARNS>0 and $NOGCCERROR 3591.174Slukem isn't defined. 3601.174Slukem 3611.173Sfreza20080531: 3621.241Swiz The ioctl number of DRVSUSPENDDEV command on /dev/drvctl changed 3631.241Swiz from 125 (conflicted with DRVCTLCOMMAND) to 129. The drvctl(8) 3641.173Sfreza utility needs to be rebuilt and reinstalled as older binaries 3651.241Swiz won't work correctly. The following sequence of commands: 3661.173Sfreza 3671.173Sfreza $ (cd sys/sys/ && nbmake-$arch includes) 3681.173Sfreza $ (cd sbin/drvctl/ && nbmake-$arch clean) 3691.173Sfreza $ (cd sbin/drvctl/ && nbmake-$arch all) 3701.173Sfreza 3711.173Sfreza leaves new drvctl utility in sbin/drvctl build directory. 3721.173Sfreza 3731.172Slukem20080503: 3741.172Slukem The <bsd.lib.mk> variable MKPRIVATELIB was renamed to LIBISPRIVATE. 3751.172Slukem 3761.171She20080521: 3771.171She For a while, unprivileged UPDATE builds would fail to 3781.171She succeed at the checkflist stage, complaining that 3791.171She ${DESTDIR}/stand/<arch>/ did not exist. A fix for this 3801.171She problem was committed to share/mk/bsd.kmodule.mk, revision 1.9. 3811.171She If you already hit this problem, update the .mk file, 3821.171She remove ${DESTDIR}/stand/<arch>, and re-run the build. 3831.171She 3841.174Slukem20080303: 3851.174Slukem Linker warnings are now fatal if $WARNS>0. 3861.174Slukem 3871.170Schristos20080126: 3881.170Schristos The posix_fadvise system call has been changed from an assembly 3891.241Swiz stub, to a c file that calls an assembly stub. You need to 3901.170Schristos 'rm -f posix_fadvise.* .depend' in the libc build directory to 3911.170Schristos avoid using the old assembly stub. 3921.170Schristos 3931.168Sjoerg20071209: 3941.241Swiz The acpiec(4) driver has been split into two attachments. If you 3951.168Sjoerg get ACPI errors before the attachment, please update your kernel 3961.169Swiz configuration file appropriately or see GENERIC for more details. 3971.168Sjoerg 3981.166Sxtraeme20071115: 3991.166Sxtraeme The it(4) driver has been renamed to itesio(4) and the old port 4001.166Sxtraeme argument specified in the kernel configuration file is not valid 4011.241Swiz anymore. The itesio(4) driver now uses the Super I/O address port 4021.241Swiz rather than the EC address port. Please update your kernel 4031.167Swiz configuration file appropriately or see GENERIC for more details. 4041.166Sxtraeme 4051.165Sjmmv20071028: 4061.165Sjmmv The pccons(4) driver has been removed from the NetBSD/shark port. 4071.165Sjmmv You need to update any custom kernel configuration file you have 4081.165Sjmmv to remove any references to pccons (which includes removing the 4091.165Sjmmv now useless XSERVER option) and replace them with the correct 4101.165Sjmmv entries for the wscons driver. See the GENERIC configuration file 4111.165Sjmmv for more details. 4121.165Sjmmv 4131.164Sgdt20070913: 4141.164Sgdt A latent bug in dhclient/dhcpd that caused it to be unable to 4151.164Sgdt enumerate interfaces was fixed. The bug began to cause 4161.164Sgdt problems after 20070911 when the kernel's SIOCGIFCONF 4171.164Sgdt implementation was repaired. From 20070529 to 20070911 racoon 4181.164Sgdt could not enumerate interfaces. (These are noted because 4191.164Sgdt normal kernel/userspace version matching hygiene is not 4201.164Sgdt sufficient to avoid this problem.) Ensure that both kernel 4211.164Sgdt and userland are from after 20070913. 4221.164Sgdt 4231.163Sjoerg20070703: 4241.241Swiz nbinstall has been renamed ${MACHINE_GNU_ARCH}-install. It 4251.199Sdholland calls the target-specific strip program, and the logic to pass 4261.199Sdholland down STRIP from make has been removed. This requires a 4271.199Sdholland re-installation of tools. 4281.163Sjoerg 4291.161Sdsl20070422: 4301.161Sdsl The way OS emulations lookup filenames inside the emulation root 4311.161Sdsl has been changed. Rather than modify the pathname (and copy back 4321.161Sdsl to userspace) namei() and lookup() directly check the emulation 4331.241Swiz root. One side effect is that absolute symlinks inside the emulated 4341.167Swiz root file system will be relative to that file system - unless they 4351.161Sdsl start /../ this is useful when the emulated root is a real install 4361.161Sdsl that has such links. 4371.161Sdsl This might affect symlinks that have been added to reference outside 4381.161Sdsl the emulated root. 4391.161Sdsl 4401.160Sjmcneill20070412: 4411.241Swiz The pckbc driver on sgimips IP32 has been removed. Use macekbc 4421.241Swiz instead. See the GENERIC32_IP3x kernel configuration for an 4431.160Sjmcneill example. 4441.160Sjmcneill 4451.159Sgdt20070319: 4461.159Sgdt src/lib/libc/Makefile revision 1.129 broke libc and ld.elf_so 4471.159Sgdt on many platforms due to incorrect flags settings. If you 4481.159Sgdt updated and built after about 20070315, do "nbmake-$arch 4491.159Sgdt cleandir" in src/lib/libc and src/libexec/ld.elf_so to force a 4501.159Sgdt rebuild of object files that might have been built 4511.159Sgdt incorrectly, and ensure that you have at least 4521.159Sgdt src/lib/libc/Makefile 1.130. 4531.159Sgdt 4541.241Swiz20070210: 4551.158Sdbj src/sys/sys/{sa.h,savar.h} were removed. 4561.158Sdbj find ${OBJDIR} \( -name .depend -o -name '*.d' \) -print \ 4571.158Sdbj | xargs egrep -l '/sa.h|/savar.h' | xargs rm 4581.158Sdbj will allow dependencies on those files to get get rebuilt 4591.158Sdbj 4601.157Sapb20070209: 4611.157Sapb The threading model was changed when the newlock2 branch 4621.157Sapb was merged to NetBSD-current. If you boot with a new 4631.157Sapb kernel (version 4.99.10), then you also need a new pthread 4641.157Sapb library (/usr/lib/libpthread.so.0.7). If you boot with 4651.157Sapb an old kernel, then you need the old pthread library 4661.157Sapb (/usr/lib/libpthread.so.0.6). Provided you keep the kernel and 4671.157Sapb the pthread library in sync, old threaded applications should 4681.157Sapb continue to work with an old or new kernel. Note that named(8) 4691.157Sapb is the only threaded application in the base system. 4701.157Sapb 4711.154She20061214: 4721.154She Following the move of string_to_flags() and flags_to_string() 4731.154She from the bin/ls/ sources to libutil, users doing UPDATE builds 4741.154She will need to do a "make cleandir" in 4751.154She tools/mtree/, tools/makefs/, tools/binstall/, tools/pax/, 4761.154She bin/pax/, bin/ls/, usr.sbin/mtree/, usr.sbin/makefs/, 4771.156She usr.bin/xinstall/, libexec/ftpd/, rescue/, as well 4781.156She as the installation images in distrib/ 4791.154She in order to excise stale references to the old stat_flags.h header 4801.154She file in the ls sources -- stat_flags.h has been removed. 4811.154She 4821.152Schristos20061108: 4831.152Schristos The configure script used in the src/tools/gcc compiler has been 4841.152Schristos changed to indicate that our libc has ssp support built-in and 4851.241Swiz does not depend on -lssp and -lssp-nonshared. You'll need to 4861.152Schristos make clean in src/tools/gcc first to rebuild the compiler. 4871.152Schristos 4881.151Srpaulo20061009: 4891.151Srpaulo The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer 4901.241Swiz available. Use net.inet{,6}.tcp{,6}.congctl.selected instead. 4911.151Srpaulo 4921.150Sbjh2120060814: 4931.150Sbjh21 The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been 4941.150Sbjh21 withdrawn. Use vidcvideo and pckbd instead. See the GENERIC 4951.150Sbjh21 kernel configuration for an example. X servers from the last 4961.150Sbjh21 few years should cope. 4971.150Sbjh21 4981.149Schristos20060703: 4991.241Swiz MPACPI is no more. We always configure PCI interrupts using ACPI 5001.241Swiz if we have an ACPI kernel. The option MPACPI_SCANPCI has been renamed 5011.241Swiz to ACPI_SCANPCI. Thanks to work from fvdl. 5021.149Schristos 5031.148Sdogcow20060627: 5041.148Sdogcow socket(2) has changed, and its system call has been versioned. 5051.148Sdogcow For userlands with the old version of socket(2), make sure that 5061.148Sdogcow your kernel has 'options COMPAT_30' set, or else 'bad system call' 5071.148Sdogcow errors will result. 5081.148Sdogcow 5091.1SabsHints for a more successful build: 5101.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5111.123Sjmc Use build.sh, but do not use its "expert mode": 5121.132Sjmmv This will automatically build the tools in the 5131.123Sjmc correct order, and it will keep the tools and the 5141.123Sjmc new build products from interfering with the running 5151.123Sjmc system. This will allow you to ignore most of the 5161.123Sjmc other advice in this file. 5171.2Smrg Build a new kernel first: 5181.2Smrg This makes sure that any new system calls or features 5191.2Smrg expected by the new userland will be present. This 5201.2Smrg helps to avoid critical errors when upgrading. 5211.1Sabs Use object directories: 5221.1Sabs This helps to keep stale object 5231.1Sabs files from polluting the build if a Makefile "forgets" 5241.1Sabs about one. It also makes it easier to clean up after 5251.1Sabs a build. It's also necessary if you want to use the 5261.1Sabs same source tree for multiple machines. 5271.123Sjmc To use object directories with build.sh: 5281.123Sjmc a) invoke build.sh with the "-M" or "-O" options. 5291.123Sjmc To use object directories without using build.sh: 5301.1Sabs a) cd /usr/src ; make cleandir 5311.2Smrg b) Add "OBJMACHINE=yes" to /etc/mk.conf 5321.2Smrg c) Add "MKOBJDIRS=yes" to /etc/mk.conf 5331.1Sabs d) cd /usr/src ; make build 5341.2Smrg Note that running "make obj" in a directory will create 5351.2Smrg in obj.$MACHINE directory. 5361.1Sabs Build to a DESTDIR: 5371.123Sjmc This helps to keep old installed files (especially libraries) 5381.123Sjmc from interfering with the new build. 5391.123Sjmc To build to a DESTDIR with build.sh, use the "-D" option. 5401.123Sjmc To build to a DESTDIR without using build.sh, set the DESTDIR 5411.123Sjmc environment variable before running make build. It should be 5421.123Sjmc set to the pathname of an initially empty directory. 5431.123Sjmc Problems: if you do not use build.sh, you might need to 5441.123Sjmc update critical utilities without using DESTDIR since 5451.123Sjmc nothing is executed from what is installed in DESTDIR. 5461.123Sjmc (See critical utils, below.) 5471.1Sabs Build often: 5481.1Sabs This keeps critical utilities current enough to not choke 5491.1Sabs on any other part of the source tree that depends on up to 5501.123Sjmc date functionality. If you use build.sh, you should not have 5511.123Sjmc this problem. 5521.241Swiz 5531.1SabsWhat to do if things don't work: 5541.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5551.230StlsWhen things don't work there are usually a few things that commonly 5561.1Sabsshould be done. 5571.1Sabs 1) make includes 5581.1Sabs This should be done automatically by make build. 5591.1Sabs 2) cd share/mk && make install 5601.1Sabs Again, automatically done by make build. 5611.1Sabs 5621.1SabsFailsafe rebuild of a small part of the tree: 5631.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5641.1SabsTo make sure you rebuild something correctly you want to do 5651.1Sabssomething like the following: 5661.1Sabs 1) Make sure the includes and .mk files are up to date. 5671.1Sabs 2) Make sure any program used to build the particular 5681.1Sabs utility is up to date. (yacc, lex, etc...) 5691.1Sabs 3) cd ...path/to/util... 5701.1Sabs make cleandir 5711.1Sabs rm ...all obj directories... 5721.1Sabs make cleandir # yes, again 5731.1Sabs make obj 5741.1Sabs make depend && make 5751.1Sabs 5761.1SabsFailsafe rebuild of the entire tree: 5771.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5781.1SabsIf you really want to make sure the source tree is clean and 5791.2Smrgready for a build try the following. Note that sourcing /etc/mk.conf 5801.2Smrg(a make(1) Makefile) in this manner is not right, and will not work 5811.2Smrgfor anyone who uses any make(1) features in /etc/mk.conf. 5821.1Sabs 5831.1Sabs---cut here--- 5841.1Sabs#!/bin/sh 5851.1Sabs. /etc/mk.conf 5861.1Sabs 5871.58Slukemif [ -z $NETBSDSRCDIR ] ; then 5881.58Slukem NETBSDSRCDIR=/usr/src 5891.1Sabsfi 5901.58Slukemif [ \! -d $NETBSDSRCDIR ] ; then 5911.1Sabs echo Unable to find sources 5921.1Sabs exit 1 5931.1Sabsfi 5941.58Slukemfind $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \; 5951.1Sabs 5961.1Sabsif [ -z $BSDOBJDIR ] ; then 5971.1Sabs BSDOBJDIR=/usr/obj 5981.1Sabsfi 5991.1Sabsif [ -d $BSDOBJDIR ] ; then 6001.1Sabs rm -rf $BSDOBJDIR 6011.1Sabsfi 6021.1Sabs 6031.58Slukemcd $NETBSDSRCDIR && make cleandir 6041.1Sabs 6051.1Sabs---cut here--- 6061.1Sabs 6071.1SabsCritical utilities: 6081.1Sabs^^^^^^^^^^^^^^^^^^^ 6091.3Sitojun usr.bin/compile_et 6101.1Sabs usr.bin/make 6111.1Sabs usr.bin/yacc 6121.1Sabs usr.bin/lex 6131.11Slukem usr.bin/xlint 6141.142Sdrochner usr.bin/config 6151.1Sabs 6161.34SsimonbOther problems and possible solutions: 6171.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 6181.1SabsSymptom:Complaints involving a Makefile. 6191.17SerhFix: Rebuild usr.bin/make: 6201.17Serh cd usr.bin/make && make && make install 6211.111Ssimonb Or, a failsafe method if that doesn't work: 6221.17Serh cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin 6231.17Serh 6241.1SabsFix: Make sure .mk files are up to date. 6251.1Sabs cd share/mk && make install 6261.2Smrg 6271.2SmrgSymptom:Kernel `config' fails to configure any kernel, including GENERIC. 6281.142SdrochnerFix: Rebuild usr.bin/config 6291.1Sabs 6301.1SabsSymptom: 6311.1SabsFix: Rebuild usr.bin/yacc 6321.1Sabs 6331.1SabsSymptom: 6341.1SabsFix: Rebuild usr.bin/lex 6351.1Sabs 6361.1SabsSymptom: 6371.1SabsFix: rm /usr/lib/libbfd.a 6381.4Sitojun 6391.4SitojunSymptom:Obsolete intermediate files are used during compilation 6401.4SitojunFix: Try the following sequence of commands in the directory in question. 6411.4Sitojun make cleandir; rm `make print-objdir`; make cleandir; make obj 6421.4Sitojun (If you built the tree without "make obj" in the past, obsolete files 6431.4Sitojun may remain. The command tries to clean everything up) 6441.5Swiz 6451.207SmbalmerSymptom:.../sysinst/run.c:xx: warning: initialization from incompatible 6461.207Smbalmer pointer type 6471.5SwizFix: Rebuild and install usr.bin/menuc 6481.12Sitojun 6491.12SitojunSymptom:mklocale not found during build in share/locale/ctype 6501.12SitojunFix: Build and install usr.bin/mklocale 6511.13Sdogcow 6521.86SkleinkSymptom:undefined reference to `__assert13' or `__unsetenv13' 6531.13SdogcowFix: Rebuild and install lib/libc 6541.13Sdogcow 6551.142SdrochnerSymptom:usr.bin/config fails to build. 6561.19ScgdFix: Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile. 6571.13Sdogcow 6581.19ScgdSymptom:undefined reference to `getprogname' or `setprogname' 6591.19ScgdFix: Rebuild and install lib/libc 6601.24Sabs 6611.24SabsSymptom:lint does not understand the '-X' option 6621.24SabsFix: May need to build & install libs with NOLINT=1 before rebuilding lint 6631.223Sjoerg 6641.223SjoergSymptom:Update build fails in src/tools/gcc complaining that a variable 6651.223Sjoerg (e.g. CPPFLAGS) has changed since the previous run. 6661.223SjoergFix: Run "nbmake-${ARCH} clean" in src/tools/gcc or do a clean build. 667