UPDATING revision 1.248
11.248Smrg$NetBSD: UPDATING,v 1.248 2013/11/29 02:05:59 mrg 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.248Smrg20131128: 201.248Smrg The MPC and MPFR sources were updated, and builds may require their 211.248Smrg tools and in-tree directories cleaned for successful updates. 221.248Smrg 231.246Smartin20130605: 241.247Sspz The kernel option FAST_IPSEC no longer exists, it's been renamed 251.247Sspz to IPSEC (and the older IPSEC version removed). 261.247Sspz 271.247Sspz20130605: 281.246Smartin Previous freetype installations eroneously installed private 291.246Smartin header files. If you are building against a non-empty $DESTDIR, 301.246Smartin please remove ${DESTDIR}//usr/X11R7/include/freetype2/freetype/. 311.246Smartin 321.245Smrg20130531: 331.245Smrg The xdm update may cause build failure due to xdm.man being 341.245Smrg in the obj tree. Make sure to ensure any like this: 351.245Smrg nbmake: nbmake: don't know how to make xdm.man. Stop 361.245Smrg is fixed by deleting the xdm.man in the obj tree. 371.245Smrg 381.244Smrg20130530: 391.244Smrg Updates of many xsrc packages will leave old .pc files around. 401.244Smrg Best to clean out the xsrc objdir entirely before rebuilds. 411.244Smrg 421.242Schristos20130301: 431.242Schristos The removal of netiso requires manual removal of /usr/include/netiso 441.243Schristos prior to the build and make cleandir in /usr/src/usr.bin/{ktruss,kdump} 451.242Schristos 461.238Sdholland20120726: 471.241Swiz The update of OpenSSL requires cleaning both the OpenSSL build 481.241Swiz directory and DESTDIR. *Even non-update builds require cleaning 491.240Sdholland DESTDIR.* Builds done without taking these steps may fail, or in 501.241Swiz some cases may succeed and install broken OpenSSL libraries that 511.240Sdholland cause third-party software to link incorrectly and/or crash. 521.238Sdholland 531.237Swiz20120507: 541.241Swiz The database schema for makemandb was changed. You will 551.237Swiz need to update the database using 'makemandb -f' or wait 561.237Swiz for the next weekly run to fix it. 571.237Swiz 581.236Sbsh20120319: 591.236Sbsh sys/conf/Makefile.kern.inc has been modified to adjust the 601.236Sbsh size of db_symtab automatically. You need to update dbsym in 611.236Sbsh your $TOOLDIR to build kernels with options SYMTAB_SPACE. If 621.236Sbsh you don't want this behavior, add AUTO_SYMTAB_SPACE=no to your 631.236Sbsh mk.conf. 641.236Sbsh 651.235Sjoerg20120216: 661.241Swiz Default for MKCATPAGES changed to NO. Update builds will fail 671.241Swiz unless DESTDIR is cleaned manually. If you built between 20120207 681.239Sdholland and 20120216, daily and weekly could have created an unreadable 691.241Swiz /var/db/man.db index for apropos. Running makemandb -f or 701.235Sjoerg the next run of weekly will fix it. 711.233Sjoerg 721.232Schristos20111227: 731.232Schristos If you built between 20111225 and 20111227 you need to remove 741.232Schristos /usr/lib/libpam.so.4* and /usr/lib/security/*.so.4, since the 751.232Schristos bump has been reverted. 761.232Schristos 771.231Stls20111125: 781.231Stls The "rnd" pseudodevice has been added to sys/conf/std, which 791.231Stls means it should no longer be explicitly listed in kernel 801.231Stls configuration files. The line "pseudo-device rnd" should be 811.231Stls removed from any custom kernel config files users may have. 821.231Stls 831.230Stls20111119: 841.230Stls A problem with the datastructures used by the rndctl(8) 851.230Stls utility (pointers in datastructures in an array, making 32->64 861.230Stls bit compatibility very painful) has been fixed in a 871.230Stls non-backwards-compatible way. If you replace your kernel, 881.230Stls replace your rndctl executable too. 891.241Swiz 901.229Sjym20111001: 911.229Sjym the prop_*_send_syscall() functions from proplib(3) have been 921.229Sjym changed and their new version is not backward compatible with the old 931.241Swiz one. So ensure that all consumers of these functions (currently: 941.229Sjym quota2 code and its tests) are updated together with the new lib. 951.229Sjym 961.228Smrg20110817: 971.228Smrg sparc has been changed to use GCC 4.5.3, so any objdir or 981.228Smrg DESTDIR for them should be deleted before updating. 991.228Smrg 1001.227Sriastrad20110806: 1011.227Sriastrad i386 and amd64 have been changed to use GCC 4.5.3, so any 1021.227Sriastrad objdir or DESTDIR for them should be deleted before updating. 1031.227Sriastrad 1041.226Smrg20110805: 1051.226Smrg The update to GCC 4.5.3 requires a non-trivial portion of 1061.226Smrg the tree to be cleaned. Best to delete both objdir and 1071.226Smrg DESTDIR before running this update. So far, only the 1081.226Smrg sparc64, mips and powerpc platforms have changed. 1091.226Smrg 1101.225Smatt20110803: 1111.241Swiz The layout of external/public-domain/xz has changed. To do an 1121.225Smatt update build you will have to remove the contents of the OBJDIR 1131.225Smatt for external/public-domain/xz/bin by hand as the xz entry there 1141.225Smatt is now a directory. 1151.225Smatt 1161.223Sjoerg20110410: 1171.241Swiz The configuration of src/tools/gcc has changed. To do an 1181.224Sdholland update build you have to clean both tools/binutils and 1191.224Sdholland tools/gcc by hand. 1201.223Sjoerg 1211.222Splunky20110328: 1221.222Splunky Building the Xorg binary was moved into a subdirectory to fix 1231.241Swiz ordering issues with "make all". It may be necessary to remove 1241.222Splunky the OBJDIR for external/mit/xorg/server/xorg-server/hw/xfree86 1251.222Splunky if your update build fails, as the "Xorg" entry there is now a 1261.222Splunky directory. 1271.222Splunky 1281.220Sjoerg20110121: 1291.221Slukem Assembler files no longer use -traditional-cpp. This can break 1301.220Sjoerg the build of individual parts of the tree. This is handled 1311.220Sjoerg correctly by build.sh. Manual builds have to update /usr/share/mk 1321.220Sjoerg and re-run config(1) for any kernel configurations as needed. 1331.218Sjoerg 1341.217Sjruoho20101217: 1351.217Sjruoho The tcpdump(8) program was changed to drop privileges and chroot(2) 1361.241Swiz by default. It may be necessary to manually update passwd(5) and 1371.217Sjruoho group(5) in order to make the program work with existing setups. 1381.217Sjruoho 1391.216Schristos20101125: 1401.216Schristos The latest changes to setenv(3) dissallow setting environment 1411.241Swiz variables with names that contain '='. Revision 1.18 of env.c 1421.241Swiz assumed that this was allowed. Installing a new libc with an 1431.216Schristos old copy of /usr/bin/env causes env x=1 printenv | grep x= to 1441.216Schristos break which affects the autoconf tests for dependency finding, 1451.216Schristos so building gcc will end up printing: 1461.216Schristos checking dependency style of gcc... none 1471.216Schristos configure: error: no usable dependency style found 1481.216Schristos Fix it by rebuilding and re-installing env. 1491.138Slukem 1501.215Smrg20101119: 1511.215Smrg Recent Xorg updates in xsrc/external/mit/ may cause various build 1521.215Smrg or run-time problems. Delete your entire DESTDIR and OBJDIR if you 1531.215Smrg have any build problems with xsrc, or problems with mismatched 1541.215Smrg versions between xorg-server and drivers. 1551.215Smrg 1561.213Sjmmv20100604: 1571.213Sjmmv The update of ATF to 0.9 causes old tests written in shell to fail 1581.213Sjmmv unless they are rebuilt. If you are building with MKUPDATE=yes, 1591.213Sjmmv you need to clean the src/external/bsd/atf/tests/ and the src/tests/ 1601.213Sjmmv trees by hand. 1611.213Sjmmv 1621.211Stnozaki20100522: 1631.212Smrg Recent Xorg updates in xsrc/external/mit/ will cause various build 1641.212Smrg problems. Delete your entire DESTDIR and OBJDIR if you have any 1651.212Smrg build problems with xsrc. 1661.212Smrg 1671.212Smrg20100522: 1681.211Stnozaki private section of <ctype.h> was splitted, and now mklocale(1) 1691.214Sdholland include ctype_local.h, so you have to make cleandir in tools/mklocale. 1701.211Stnozaki 1711.210Schristos20100520: 1721.241Swiz The location of the xkb compiled descriptions has changed. Please 1731.210Schristos remove usr/X11R7/lib/X11/xkb/compiled from your $DESTDIR. 1741.210Schristos 1751.209Snjoly20100222: 1761.209Snjoly The shared objects file extension has been changed from .so to 1771.209Snjoly .pico, in order to avoid conflicts with shared libraries names 1781.209Snjoly libXX.so. All now stale regular .so files can be removed from 1791.209Snjoly your object directories. 1801.209Snjoly 1811.208Sroy20100204: 1821.208Sroy The termcap database has been removed from the sources, 1831.208Sroy but has not been marked obsolete so it is not removed 1841.208Sroy from the system when upgrading. 1851.208Sroy As such, you will need to remove them from your object 1861.208Sroy and destination directories. 1871.208Sroy 1881.203Sdyoung20091101: 1891.205Sdholland After updating, it may be necessary to make the 'cleandir' 1901.205Sdholland target in src/tools/yacc/ and in src/usr.bin/yacc/ before a 1911.205Sdholland 'build.sh -u tools' or 'build.sh -u distribution'. Ditto 1921.205Sdholland src/tools/lex/ and src/usr.bin/lex/. 1931.203Sdyoung 1941.202Smrg20091001: 1951.206Sdholland On amd64 you must rebuild tools (to get the new binutils) 1961.206Sdholland before building a kernel, or the build fails on cpufunc.S. 1971.206Sdholland 1981.206Sdholland20091001: 1991.202Smrg An error will create a ./usr/X11R7/lib/X11/xkb/compiled/xkb 2001.202Smrg symlink, failing the build. Delete the link, and the subdir 2011.202Smrg it is in, and retry your build. 2021.202Smrg 2031.201Sdsl20090718: 2041.201Sdsl libc build changed so that strchr() provides the extra entry 2051.241Swiz point for index(). Update build of libc.a (and libc_pic.a) 2061.201Sdsl may fail because the archive contains the unwanted index.o. 2071.201Sdsl (Similarly for strrchr() and rindex().) 2081.201Sdsl 2091.198Smrg20090709: 2101.198Smrg Native Xorg was upgraded again. Builds will probably fail again 2111.198Smrg without a clean objdir, at least for src/external/mit/xorg. 2121.198Smrg 2131.197Smrg20090616: 2141.197Smrg Native Xorg was upgraded. Builds will need a clean objdir for 2151.197Smrg src/external/mit/xorg. Upgrading a system from sets will not 2161.197Smrg work properly yet as the /usr/X11R7/lib/X11/xkb/symbols/pc 2171.197Smrg subdirectory has been changed into a file, and this needs to 2181.197Smrg be manually "rm -r"'ed before installing xbase.tgz. 2191.197Smrg 2201.195Sperry20090501: 2211.195Sperry Several new functions were added to string.h/libc, and this 2221.195Sperry can cause autoconf problems during the tool build for people 2231.241Swiz who fail to clean out their tools objects properly. If you 2241.195Sperry note messages about stpcpy, stpncpy or strnlen accompanying a 2251.195Sperry failure during the tool build, clean out all your tools 2261.195Sperry objects and start again. 2271.195Sperry 2281.194Smrg20090325: 2291.194Smrg The i386 port was switched to i486 default toolchain. This requires 2301.194Smrg cleaning your src/tools directory and $TOOLDIR and rebuilding them. 2311.194Smrg 2321.192Sskrll20090126: 2331.241Swiz The __posix_fadvise50 system call changed assembly stub type. You 2341.207Smbalmer need to 'rm -f __posix_fadvise50.*' in the libc build directory 2351.207Smbalmer to avoid using the old assembly stub. 2361.192Sskrll 2371.191Sjoerg20090202: 2381.191Sjoerg pkg_install now depends on the pkgdb cache for automatic conflict 2391.191Sjoerg detection. It is recommented to rebuild the cache with 2401.191Sjoerg ``pkg_admin rebuild''. 2411.191Sjoerg 2421.184Schristos20090110: 2431.241Swiz time_t and dev_t have been bumped to 64 bit quantities. To upgrade: 2441.241Swiz 1. Make sure your kernel has COMPAT_50 in it. Build and install. 2451.188Schristos This is needed even in the MODULAR kernel because there is 2461.188Schristos conditionally compiled code in rtsock.c. 2471.184Schristos 2. make sure build.sh completes and the binaries in a chroot work 2481.184Schristos before installing. 2491.184Schristos 3. If you don't use build.sh and you build directly to root, and 2501.241Swiz your build breaks in the middle, don't despair. Make sure headers 2511.184Schristos are installed properly, and start building libraries first libc 2521.184Schristos and libutil, install them and then continue building all the 2531.241Swiz libraries in src/lib and src/gnu/lib and install them. Once 2541.184Schristos the new libraries are installed, you can restart the build. 2551.184Schristos 4. If you compile packages and you notice link time warnings, 2561.189Shubertf rebuild the required packages to update their shared libraries. 2571.189Shubertf Any package you rebuild will require rebuilding all the packages 2581.189Shubertf that depend on it. 2591.186Schristos 5. Next time you run pwd_mkdb with the new binary, the file 2601.186Schristos will be upgraded and it will not be backwards compatible. 2611.190Sapb 6. The utmpx/wtmpx files (/var/run/utmpx and /var/log/wtmpx, see 2621.190Sapb lastlogx(5)) have been versioned, and there is a heuristic 2631.241Swiz for utmp. You are better off removing the old files after 2641.190Sapb upgrading. The automated clearing of /var/run during 2651.190Sapb boot, and the automated rotating of files in /var/log by 2661.190Sapb newsyslog(8), may mean that you do not have to remove the 2671.190Sapb files manually. 2681.190Sapb 7. The optional accounting file (/var/account/acct, see 2691.190Sapb accton(8)) has not been versioned, and will need to be 2701.190Sapb removed. The automatic rotation of the accounting file by 2711.190Sapb /etc/daily limits the bad consequences of failure to remove 2721.190Sapb the file. 2731.196Sdholland 8. Application software that writes time_t to binary files on 2741.241Swiz disk will break or need attention. Most notably: if you are 2751.196Sdholland using PostgreSQL < 8.4, you need to dump your databases, 2761.196Sdholland rebuild PostgreSQL with the new time_t, then restore. 2771.185Sjmcneill 2781.183Spgoyette20081219: 2791.183Spgoyette config(1) has been updated, and one of the files it creates - 2801.183Spgoyette swapnetbsd.o - has changed format. You need to rebuild config 2811.183Spgoyette (done automatically by build.sh) and then you need to rerun 2821.183Spgoyette config on all kernel configuration files before rebuilding those 2831.183Spgoyette kernels. 2841.183Spgoyette 2851.181Scube20081205: 2861.181Scube If you build with MKX11=no, you should remove /etc/rc.d/xdm and 2871.181Scube /etc/rc.d/xfs from DESTDIR because those files were moved to the xetc 2881.181Scube set and will appear as extra files for MKX11=no update builds. 2891.178Slukem 2901.179Stsutsui20081122: 2911.182Stsutsui On i386, various kernel options(4) in GENERIC including 2921.180Swiz file systems have been disabled and moved into kernel modules. 2931.180Swiz Before trying a new GENERIC kernel, you have to prepare the 2941.179Stsutsui following files as well as a new GENERIC kernel: 2951.179Stsutsui 2961.179Stsutsui - build and install kernel modules from src/sys/modules 2971.179Stsutsui 2981.179Stsutsui - install the latest bootloader, which will load a module 2991.180Swiz for the file system from which the kernel is loaded automatically 3001.179Stsutsui 3011.180Swiz If you have to load your kernel from a file system which is not of 3021.180Swiz the same type as the root file system, you have to load the necessary 3031.180Swiz file system module manually on the boot prompt or in the boot.cfg file. 3041.179Stsutsui 3051.178Slukem20080827: 3061.178Slukem If you built and installed a libc from sources between 3071.178Slukem 2008/08/20 and 2008/08/26 you got a broken strtouq(3) 3081.178Slukem which results in false errors reported by lint(1). 3091.178Slukem Since this breaks the libc build itself, manual help is 3101.180Swiz needed -- lint must be disabled temporarily, e.g.: 3111.178Slukem $ (cd lib/libc && make MKLINT=no dependall install) 3121.178Slukem 3131.177Schristos20080813: 3141.177Schristos MKDEBUG build was broken because the .depend files did not know 3151.241Swiz about .go files. You need to remove all .depend files and rebuild. 3161.177Schristos 3171.200Sdholland20080802: 3181.200Sdholland A regression in binary compatibility for pthread_mutex_t has 3191.241Swiz been fixed. Unfortunately, the price is breaking compatibility 3201.200Sdholland for -current. 3211.200Sdholland 3221.200Sdholland Threaded programs (using libpthread) and C++ programs (using 3231.200Sdholland libstdc++) compiled after 20070907 and before 20080802 need to 3241.200Sdholland be recompiled. 3251.200Sdholland 3261.200Sdholland One way to find affected pkgsrc packages: 3271.200Sdholland 3281.200Sdholland $ grep REQUIRES=/usr/lib/libpthread /var/db/pkg/*/+BUILD_INFO 3291.200Sdholland $ grep REQUIRES=/usr/lib/libstdc++ /var/db/pkg/*/+BUILD_INFO 3301.200Sdholland 3311.175Ssimonb20080731: 3321.175Ssimonb WAPBL (metadata journaling support) has been added, but at this 3331.175Ssimonb time isn't backwards compatible with pre-WAPBL aware kernels 3341.175Ssimonb and userland (fsck_ffs in particular). Please make sure you 3351.175Ssimonb don't use a journaled filesystem with an older kernel/userland, 3361.176Ssimonb especially an uncleanly mounted journaled filesystem. WAPBL 3371.176Ssimonb also requires the super block to be in the UFS2 format. You 3381.176Ssimonb can use fsck_ffs -c 4 to update the superblock format. 3391.175Ssimonb 3401.174Slukem20080721: 3411.174Slukem Assembler warnings are now fatal if $WARNS>0 and $NOGCCERROR 3421.174Slukem isn't defined. 3431.174Slukem 3441.173Sfreza20080531: 3451.241Swiz The ioctl number of DRVSUSPENDDEV command on /dev/drvctl changed 3461.241Swiz from 125 (conflicted with DRVCTLCOMMAND) to 129. The drvctl(8) 3471.173Sfreza utility needs to be rebuilt and reinstalled as older binaries 3481.241Swiz won't work correctly. The following sequence of commands: 3491.173Sfreza 3501.173Sfreza $ (cd sys/sys/ && nbmake-$arch includes) 3511.173Sfreza $ (cd sbin/drvctl/ && nbmake-$arch clean) 3521.173Sfreza $ (cd sbin/drvctl/ && nbmake-$arch all) 3531.173Sfreza 3541.173Sfreza leaves new drvctl utility in sbin/drvctl build directory. 3551.173Sfreza 3561.172Slukem20080503: 3571.172Slukem The <bsd.lib.mk> variable MKPRIVATELIB was renamed to LIBISPRIVATE. 3581.172Slukem 3591.171She20080521: 3601.171She For a while, unprivileged UPDATE builds would fail to 3611.171She succeed at the checkflist stage, complaining that 3621.171She ${DESTDIR}/stand/<arch>/ did not exist. A fix for this 3631.171She problem was committed to share/mk/bsd.kmodule.mk, revision 1.9. 3641.171She If you already hit this problem, update the .mk file, 3651.171She remove ${DESTDIR}/stand/<arch>, and re-run the build. 3661.171She 3671.174Slukem20080303: 3681.174Slukem Linker warnings are now fatal if $WARNS>0. 3691.174Slukem 3701.170Schristos20080126: 3711.170Schristos The posix_fadvise system call has been changed from an assembly 3721.241Swiz stub, to a c file that calls an assembly stub. You need to 3731.170Schristos 'rm -f posix_fadvise.* .depend' in the libc build directory to 3741.170Schristos avoid using the old assembly stub. 3751.170Schristos 3761.168Sjoerg20071209: 3771.241Swiz The acpiec(4) driver has been split into two attachments. If you 3781.168Sjoerg get ACPI errors before the attachment, please update your kernel 3791.169Swiz configuration file appropriately or see GENERIC for more details. 3801.168Sjoerg 3811.166Sxtraeme20071115: 3821.166Sxtraeme The it(4) driver has been renamed to itesio(4) and the old port 3831.166Sxtraeme argument specified in the kernel configuration file is not valid 3841.241Swiz anymore. The itesio(4) driver now uses the Super I/O address port 3851.241Swiz rather than the EC address port. Please update your kernel 3861.167Swiz configuration file appropriately or see GENERIC for more details. 3871.166Sxtraeme 3881.165Sjmmv20071028: 3891.165Sjmmv The pccons(4) driver has been removed from the NetBSD/shark port. 3901.165Sjmmv You need to update any custom kernel configuration file you have 3911.165Sjmmv to remove any references to pccons (which includes removing the 3921.165Sjmmv now useless XSERVER option) and replace them with the correct 3931.165Sjmmv entries for the wscons driver. See the GENERIC configuration file 3941.165Sjmmv for more details. 3951.165Sjmmv 3961.164Sgdt20070913: 3971.164Sgdt A latent bug in dhclient/dhcpd that caused it to be unable to 3981.164Sgdt enumerate interfaces was fixed. The bug began to cause 3991.164Sgdt problems after 20070911 when the kernel's SIOCGIFCONF 4001.164Sgdt implementation was repaired. From 20070529 to 20070911 racoon 4011.164Sgdt could not enumerate interfaces. (These are noted because 4021.164Sgdt normal kernel/userspace version matching hygiene is not 4031.164Sgdt sufficient to avoid this problem.) Ensure that both kernel 4041.164Sgdt and userland are from after 20070913. 4051.164Sgdt 4061.163Sjoerg20070703: 4071.241Swiz nbinstall has been renamed ${MACHINE_GNU_ARCH}-install. It 4081.199Sdholland calls the target-specific strip program, and the logic to pass 4091.199Sdholland down STRIP from make has been removed. This requires a 4101.199Sdholland re-installation of tools. 4111.163Sjoerg 4121.161Sdsl20070422: 4131.161Sdsl The way OS emulations lookup filenames inside the emulation root 4141.161Sdsl has been changed. Rather than modify the pathname (and copy back 4151.161Sdsl to userspace) namei() and lookup() directly check the emulation 4161.241Swiz root. One side effect is that absolute symlinks inside the emulated 4171.167Swiz root file system will be relative to that file system - unless they 4181.161Sdsl start /../ this is useful when the emulated root is a real install 4191.161Sdsl that has such links. 4201.161Sdsl This might affect symlinks that have been added to reference outside 4211.161Sdsl the emulated root. 4221.161Sdsl 4231.160Sjmcneill20070412: 4241.241Swiz The pckbc driver on sgimips IP32 has been removed. Use macekbc 4251.241Swiz instead. See the GENERIC32_IP3x kernel configuration for an 4261.160Sjmcneill example. 4271.160Sjmcneill 4281.159Sgdt20070319: 4291.159Sgdt src/lib/libc/Makefile revision 1.129 broke libc and ld.elf_so 4301.159Sgdt on many platforms due to incorrect flags settings. If you 4311.159Sgdt updated and built after about 20070315, do "nbmake-$arch 4321.159Sgdt cleandir" in src/lib/libc and src/libexec/ld.elf_so to force a 4331.159Sgdt rebuild of object files that might have been built 4341.159Sgdt incorrectly, and ensure that you have at least 4351.159Sgdt src/lib/libc/Makefile 1.130. 4361.159Sgdt 4371.241Swiz20070210: 4381.158Sdbj src/sys/sys/{sa.h,savar.h} were removed. 4391.158Sdbj find ${OBJDIR} \( -name .depend -o -name '*.d' \) -print \ 4401.158Sdbj | xargs egrep -l '/sa.h|/savar.h' | xargs rm 4411.158Sdbj will allow dependencies on those files to get get rebuilt 4421.158Sdbj 4431.157Sapb20070209: 4441.157Sapb The threading model was changed when the newlock2 branch 4451.157Sapb was merged to NetBSD-current. If you boot with a new 4461.157Sapb kernel (version 4.99.10), then you also need a new pthread 4471.157Sapb library (/usr/lib/libpthread.so.0.7). If you boot with 4481.157Sapb an old kernel, then you need the old pthread library 4491.157Sapb (/usr/lib/libpthread.so.0.6). Provided you keep the kernel and 4501.157Sapb the pthread library in sync, old threaded applications should 4511.157Sapb continue to work with an old or new kernel. Note that named(8) 4521.157Sapb is the only threaded application in the base system. 4531.157Sapb 4541.154She20061214: 4551.154She Following the move of string_to_flags() and flags_to_string() 4561.154She from the bin/ls/ sources to libutil, users doing UPDATE builds 4571.154She will need to do a "make cleandir" in 4581.154She tools/mtree/, tools/makefs/, tools/binstall/, tools/pax/, 4591.154She bin/pax/, bin/ls/, usr.sbin/mtree/, usr.sbin/makefs/, 4601.156She usr.bin/xinstall/, libexec/ftpd/, rescue/, as well 4611.156She as the installation images in distrib/ 4621.154She in order to excise stale references to the old stat_flags.h header 4631.154She file in the ls sources -- stat_flags.h has been removed. 4641.154She 4651.152Schristos20061108: 4661.152Schristos The configure script used in the src/tools/gcc compiler has been 4671.152Schristos changed to indicate that our libc has ssp support built-in and 4681.241Swiz does not depend on -lssp and -lssp-nonshared. You'll need to 4691.152Schristos make clean in src/tools/gcc first to rebuild the compiler. 4701.152Schristos 4711.151Srpaulo20061009: 4721.151Srpaulo The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer 4731.241Swiz available. Use net.inet{,6}.tcp{,6}.congctl.selected instead. 4741.151Srpaulo 4751.150Sbjh2120060814: 4761.150Sbjh21 The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been 4771.150Sbjh21 withdrawn. Use vidcvideo and pckbd instead. See the GENERIC 4781.150Sbjh21 kernel configuration for an example. X servers from the last 4791.150Sbjh21 few years should cope. 4801.150Sbjh21 4811.149Schristos20060703: 4821.241Swiz MPACPI is no more. We always configure PCI interrupts using ACPI 4831.241Swiz if we have an ACPI kernel. The option MPACPI_SCANPCI has been renamed 4841.241Swiz to ACPI_SCANPCI. Thanks to work from fvdl. 4851.149Schristos 4861.148Sdogcow20060627: 4871.148Sdogcow socket(2) has changed, and its system call has been versioned. 4881.148Sdogcow For userlands with the old version of socket(2), make sure that 4891.148Sdogcow your kernel has 'options COMPAT_30' set, or else 'bad system call' 4901.148Sdogcow errors will result. 4911.148Sdogcow 4921.1SabsHints for a more successful build: 4931.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 4941.123Sjmc Use build.sh, but do not use its "expert mode": 4951.132Sjmmv This will automatically build the tools in the 4961.123Sjmc correct order, and it will keep the tools and the 4971.123Sjmc new build products from interfering with the running 4981.123Sjmc system. This will allow you to ignore most of the 4991.123Sjmc other advice in this file. 5001.2Smrg Build a new kernel first: 5011.2Smrg This makes sure that any new system calls or features 5021.2Smrg expected by the new userland will be present. This 5031.2Smrg helps to avoid critical errors when upgrading. 5041.1Sabs Use object directories: 5051.1Sabs This helps to keep stale object 5061.1Sabs files from polluting the build if a Makefile "forgets" 5071.1Sabs about one. It also makes it easier to clean up after 5081.1Sabs a build. It's also necessary if you want to use the 5091.1Sabs same source tree for multiple machines. 5101.123Sjmc To use object directories with build.sh: 5111.123Sjmc a) invoke build.sh with the "-M" or "-O" options. 5121.123Sjmc To use object directories without using build.sh: 5131.1Sabs a) cd /usr/src ; make cleandir 5141.2Smrg b) Add "OBJMACHINE=yes" to /etc/mk.conf 5151.2Smrg c) Add "MKOBJDIRS=yes" to /etc/mk.conf 5161.1Sabs d) cd /usr/src ; make build 5171.2Smrg Note that running "make obj" in a directory will create 5181.2Smrg in obj.$MACHINE directory. 5191.1Sabs Build to a DESTDIR: 5201.123Sjmc This helps to keep old installed files (especially libraries) 5211.123Sjmc from interfering with the new build. 5221.123Sjmc To build to a DESTDIR with build.sh, use the "-D" option. 5231.123Sjmc To build to a DESTDIR without using build.sh, set the DESTDIR 5241.123Sjmc environment variable before running make build. It should be 5251.123Sjmc set to the pathname of an initially empty directory. 5261.123Sjmc Problems: if you do not use build.sh, you might need to 5271.123Sjmc update critical utilities without using DESTDIR since 5281.123Sjmc nothing is executed from what is installed in DESTDIR. 5291.123Sjmc (See critical utils, below.) 5301.1Sabs Build often: 5311.1Sabs This keeps critical utilities current enough to not choke 5321.1Sabs on any other part of the source tree that depends on up to 5331.123Sjmc date functionality. If you use build.sh, you should not have 5341.123Sjmc this problem. 5351.241Swiz 5361.1SabsWhat to do if things don't work: 5371.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5381.230StlsWhen things don't work there are usually a few things that commonly 5391.1Sabsshould be done. 5401.1Sabs 1) make includes 5411.1Sabs This should be done automatically by make build. 5421.1Sabs 2) cd share/mk && make install 5431.1Sabs Again, automatically done by make build. 5441.1Sabs 5451.1SabsFailsafe rebuild of a small part of the tree: 5461.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5471.1SabsTo make sure you rebuild something correctly you want to do 5481.1Sabssomething like the following: 5491.1Sabs 1) Make sure the includes and .mk files are up to date. 5501.1Sabs 2) Make sure any program used to build the particular 5511.1Sabs utility is up to date. (yacc, lex, etc...) 5521.1Sabs 3) cd ...path/to/util... 5531.1Sabs make cleandir 5541.1Sabs rm ...all obj directories... 5551.1Sabs make cleandir # yes, again 5561.1Sabs make obj 5571.1Sabs make depend && make 5581.1Sabs 5591.1SabsFailsafe rebuild of the entire tree: 5601.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5611.1SabsIf you really want to make sure the source tree is clean and 5621.2Smrgready for a build try the following. Note that sourcing /etc/mk.conf 5631.2Smrg(a make(1) Makefile) in this manner is not right, and will not work 5641.2Smrgfor anyone who uses any make(1) features in /etc/mk.conf. 5651.1Sabs 5661.1Sabs---cut here--- 5671.1Sabs#!/bin/sh 5681.1Sabs. /etc/mk.conf 5691.1Sabs 5701.58Slukemif [ -z $NETBSDSRCDIR ] ; then 5711.58Slukem NETBSDSRCDIR=/usr/src 5721.1Sabsfi 5731.58Slukemif [ \! -d $NETBSDSRCDIR ] ; then 5741.1Sabs echo Unable to find sources 5751.1Sabs exit 1 5761.1Sabsfi 5771.58Slukemfind $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \; 5781.1Sabs 5791.1Sabsif [ -z $BSDOBJDIR ] ; then 5801.1Sabs BSDOBJDIR=/usr/obj 5811.1Sabsfi 5821.1Sabsif [ -d $BSDOBJDIR ] ; then 5831.1Sabs rm -rf $BSDOBJDIR 5841.1Sabsfi 5851.1Sabs 5861.58Slukemcd $NETBSDSRCDIR && make cleandir 5871.1Sabs 5881.1Sabs---cut here--- 5891.1Sabs 5901.1SabsCritical utilities: 5911.1Sabs^^^^^^^^^^^^^^^^^^^ 5921.3Sitojun usr.bin/compile_et 5931.1Sabs usr.bin/make 5941.1Sabs usr.bin/yacc 5951.1Sabs usr.bin/lex 5961.11Slukem usr.bin/xlint 5971.142Sdrochner usr.bin/config 5981.1Sabs 5991.34SsimonbOther problems and possible solutions: 6001.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 6011.1SabsSymptom:Complaints involving a Makefile. 6021.17SerhFix: Rebuild usr.bin/make: 6031.17Serh cd usr.bin/make && make && make install 6041.111Ssimonb Or, a failsafe method if that doesn't work: 6051.17Serh cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin 6061.17Serh 6071.1SabsFix: Make sure .mk files are up to date. 6081.1Sabs cd share/mk && make install 6091.2Smrg 6101.2SmrgSymptom:Kernel `config' fails to configure any kernel, including GENERIC. 6111.142SdrochnerFix: Rebuild usr.bin/config 6121.1Sabs 6131.1SabsSymptom: 6141.1SabsFix: Rebuild usr.bin/yacc 6151.1Sabs 6161.1SabsSymptom: 6171.1SabsFix: Rebuild usr.bin/lex 6181.1Sabs 6191.1SabsSymptom: 6201.1SabsFix: rm /usr/lib/libbfd.a 6211.4Sitojun 6221.4SitojunSymptom:Obsolete intermediate files are used during compilation 6231.4SitojunFix: Try the following sequence of commands in the directory in question. 6241.4Sitojun make cleandir; rm `make print-objdir`; make cleandir; make obj 6251.4Sitojun (If you built the tree without "make obj" in the past, obsolete files 6261.4Sitojun may remain. The command tries to clean everything up) 6271.5Swiz 6281.207SmbalmerSymptom:.../sysinst/run.c:xx: warning: initialization from incompatible 6291.207Smbalmer pointer type 6301.5SwizFix: Rebuild and install usr.bin/menuc 6311.12Sitojun 6321.12SitojunSymptom:mklocale not found during build in share/locale/ctype 6331.12SitojunFix: Build and install usr.bin/mklocale 6341.13Sdogcow 6351.86SkleinkSymptom:undefined reference to `__assert13' or `__unsetenv13' 6361.13SdogcowFix: Rebuild and install lib/libc 6371.13Sdogcow 6381.142SdrochnerSymptom:usr.bin/config fails to build. 6391.19ScgdFix: Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile. 6401.13Sdogcow 6411.19ScgdSymptom:undefined reference to `getprogname' or `setprogname' 6421.19ScgdFix: Rebuild and install lib/libc 6431.24Sabs 6441.24SabsSymptom:lint does not understand the '-X' option 6451.24SabsFix: May need to build & install libs with NOLINT=1 before rebuilding lint 6461.223Sjoerg 6471.223SjoergSymptom:Update build fails in src/tools/gcc complaining that a variable 6481.223Sjoerg (e.g. CPPFLAGS) has changed since the previous run. 6491.223SjoergFix: Run "nbmake-${ARCH} clean" in src/tools/gcc or do a clean build. 650