UPDATING revision 1.123
11.123Sjmc$NetBSD: UPDATING,v 1.123 2004/06/13 08:08:43 jmc 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.99Smrg 191.121Slukem20040516: 201.121Slukem The end-user modifiable X11 configuration has been moved 211.121Slukem from /usr/X11R6/lib/X11/<dir> to /etc/X11/<dir>. 221.121Slukem Ensure that src and xsrc is up to date, and run 231.121Slukem "make cleandir" in src/x11 before your next build. 241.121Slukem 251.119Satatat20040426: 261.119Satatat Support for the original dynamic sysctl node structure has 271.119Satatat been removed in favor of the newer layout. This affects 281.119Satatat consumers of the create and delete interface, as well as 291.119Satatat the dynamic discovery mechanism. This is believed only to 301.119Satatat be the sysctl(8) binary itself, at this point in time, so 311.119Satatat the only effect of this should be that a sysctl binary 321.119Satatat built from sources dated between 2003/12/04 and 2004/03/24 331.119Satatat will not work on a kernel built from sources dated after 341.119Satatat 2004/04/25. If you need a new sysctl binary but build.sh 351.119Satatat does not work, make sure that your revision of 361.120Satatat src/sys/sys/sysctl.h is 1.112 (or later), and then the 371.120Satatat do the following: 381.119Satatat 391.120Satatat cd /usr/src (or wherever your source tree is) 401.120Satatat make USETOOLS=no includes 411.120Satatat cd lib/libc 421.120Satatat make USETOOLS=no dependall install 431.120Satatat cd ../../sbin/sysctl 441.119Satatat make USETOOLS=no dependall install 451.119Satatat 461.122Sitojun If you are using older sysctl binary, GNU autoconf would fail to 471.122Sitojun identify your machine architecture, and tries to build binary for 481.122Sitojun "unknown-unknown-netbsd20F" or something like that. if that happens, 491.122Sitojun make sure to follow the above steps. 501.122Sitojun 511.118Sdbj20040425: 521.118Sdbj The ffs superblock issues listed below under 20040109 and 20030402 531.118Sdbj are now automatically addressed by the /etc/rc.d/fixsb script or by 541.118Sdbj sysinst when it checks a a filesystem. The manual fsck_ffs -b16 -c4 551.118Sdbj invocation mentioned below will continue to work and is now 561.118Sdbj automated by those scripts. Note that under certain circumstances, 571.118Sdbj affected filesystems upgraded to a -current kernel first before 581.118Sdbj upgrading their userland with the fixsb and fsck_ffs fixes may 591.118Sdbj encounter a 'freeing free inode' panic when writing to the affected 601.118Sdbj filesystem, so it is a good idea to repair the filesystem as soon as 611.118Sdbj possible. For more details on the fixsb script, see pr install/25138. 621.118Sdbj 631.115Schristos20040418: 641.121Slukem statfs(2) and friends have been replaced with statvfs(2). Before 651.115Schristos installing a newly build userland make sure that you are running 661.115Schristos a newly built kernel with COMPAT_20 set. In addition your libc 671.115Schristos build might not work (undefined SYS_statfs symbol) because make 681.115Schristos clean does not know how to remove files it does not know about 691.116Schristos anymore. Manually remove all generated .S sources and objects 701.116Schristos from the libc build directory. 711.115Schristos 721.114Sjmc20040326: 731.114Sjmc The method by which athhal-elf.o gets pulled into i386 kernel builds 741.117Sjmc has been changed. The file is now stored as a uuencoded file in CVS 751.114Sjmc and the generated Makefile will use the new .uue rules from bsd.file.mk 761.114Sjmc to build it. 771.114Sjmc 781.114Sjmc This means you must have the latest bsd.files.mk installed when 791.114Sjmc building a kernel without USETOOLS=yes. 801.114Sjmc 811.113Sdan20040318: 821.113Sdan A bug in the cgd(4) blowfish code was corrected, without 831.113Sdan provision of backwards compatibility, after several public 841.113Sdan notices over several months. Users of cgd with blowfish cipher 851.113Sdan ONLY must dump their data before updating their kernels, and 861.113Sdan recreate cgd's and restore data using the new kernel. See 871.113Sdan (recent message to current-users, URL when mail-index has updated) 881.113Sdan 891.108Sbjh2120040313: 901.108Sbjh21 On acorn32, the opms and qms drivers have been withdrawn, and 911.108Sbjh21 the old wsqms driver is now called qms. Kernel config files 921.108Sbjh21 will need updating. See the ones in sys/arch/acorn32/conf 931.108Sbjh21 for examples. 941.108Sbjh21 951.106Sbjh2120040125: 961.106Sbjh21 On acorn32, the beep and sysbeep devices are no longer 971.106Sbjh21 needed, and will need to be deleted from kernel configuration 981.106Sbjh21 files. 991.105Sbjh21 1001.102Sdbj20040109: 1011.102Sdbj Compatibility for old ffs superblock layouts has been 1021.102Sdbj added, and the restrictive fsck checks have been reenabled 1031.102Sdbj when using those layouts. If you have been using -current 1041.102Sdbj since 20030402, you may find that fsck again signals fatal 1051.110Sdbj superblock mismatches. To repair, make sure you have 1061.111Ssimonb an updated fsck_ffs and then you can use fsck_ffs -b 16 -c 4 1071.109Sdbj to complete the filesystem upgrade. A message has 1081.111Ssimonb been added to the kernel which should detect this problem. 1091.111Ssimonb See the following discussion for more information: 1101.112Skeihan http://mail-index.NetBSD.org/current-users/2004/01/11/0022.html 1111.102Sdbj 1121.99Smrg20031203: 1131.100Skeihan New binutils builds may fail due to old dependencies. 1141.99Smrg It's necessary to "make cleandir" to ensure that 1151.99Smrg the dependencies will be rebuilt correctly. 1161.98Swiz 1171.98Swiz20031111: 1181.98Swiz A newer mkdep is needed. Error noting that is 1191.98Swiz cc: Ambiguous abbreviation -- 1201.97Slukem 1211.97Slukem20031008: 1221.97Slukem /usr/include/sys/disklabel_mbr.h was removed. 1231.97Slukem It's necessary to "make cleandir" to ensure that 1241.97Slukem the dependencies will be rebuilt correctly. 1251.96Schristos 1261.109Sdbj20031007: 1271.111Ssimonb A sign exension bug was fixed which set all the high bits 1281.111Ssimonb of our newly expanded ffs fs_flags. This should only 1291.111Ssimonb affect users who installed or upgraded in September of 2003. 1301.109Sdbj A small utility program was posted to tech-kern which 1311.111Ssimonb should fix this problem, and a warning message was added 1321.111Ssimonb to the kernel which should discover and warn about it. See 1331.111Ssimonb http://mail-index.NetBSD.org/tech-kern/2003/10/07/0005.html 1341.109Sdbj 1351.96Schristos20030906: 1361.96Schristos With the addition of siginfo support the old signal trampoline 1371.96Schristos code has been deprecated to COMPAT_16. Make sure that your running 1381.96Schristos kernel has COMPAT_16 enabled before building userland. 1391.94Schristos 1401.94Schristos20030801: 1411.95Swiz With the new openssl, there is some header and library shuffling. 1421.94Schristos rm -f /usr/include/des.h /usr/include/kerberosIV/* /lib/libdes* \ 1431.95Swiz /usr/lib/libdes* before building. 1441.92Swiz 1451.92Swiz20030703: 1461.92Swiz Texinfo was updated to 4.6. To avoid failures when trying to 1471.92Swiz build the included texinfo files, do: 1481.92Swiz 1491.92Swiz cd src/gnu/usr.bin/texinfo 1501.92Swiz make MKINFO=no dependall install 1511.90Swiz 1521.90Swiz20030630: 1531.101Sjunyoung Groff was updated to 1.19; it's probably necessary to do 1541.91Swiz cd share/mk && make install 1551.90Swiz cd src/gnu/usr.bin/groff 1561.90Swiz make MKMAN=no dependall install 1571.90Swiz (untested). 1581.89Schristos 1591.89Schristos20030516: 1601.89Schristos Due to bugs in the export handling code, invalid export lines 1611.89Schristos were accepted before and caused the kernel to panic when 1621.89Schristos mountd got restarted because it freed memory that had already 1631.89Schristos been freed. This has been fixed and the kernel checks 1641.89Schristos export addresses very strictly. If you upgrade your kernel, 1651.89Schristos make sure you also upgrade mountd, because if your export 1661.89Schristos file contains lines with an old inet4 address syntax (i.e. 1671.89Schristos a.b.c or a.b or a), they will get rejected by the new kernel. 1681.87Sbjh21 1691.87Sbjh2120030402: 1701.87Sbjh21 The superblock layout for FFS was changed. If you have 1.6 1711.87Sbjh21 fsck binaries, they will signal a fatal superblock mismatch 1721.87Sbjh21 with the first alternate, because they compare too many 1731.87Sbjh21 fields (even ones that aren't useful). If possible, upgrade 1741.87Sbjh21 your fsck_ffs binary before using a new kernel. 1751.87Sbjh21 None of this signals actual filesystem damage. 1761.85Satatat 1771.85Satatat20030324: 1781.85Satatat sendmail version 8.12.8 was imported. Since sendmail is 1791.85Satatat now setgid to the smmsp group, and runs in "collection" 1801.85Satatat mode for most common activities, there is a new config 1811.85Satatat file called submit.cf that needs to live in /etc/mail. 1821.85Satatat The generic submit.cf sample in /usr/share/sendmail/cf 1831.85Satatat is named netbsd-msp.cf. Upgrading your regular sendmail 1841.85Satatat configuration file is also strongly advised. 1851.85Satatat 1861.85Satatat See the section named "MESSAGE SUBMISSION PROGRAM" in 1871.85Satatat the updated /usr/share/sendmail/README file for more 1881.85Satatat information. 1891.82Swiz 1901.82Swiz20030117: 1911.82Swiz Texinfo was updated to 4.3. To avoid failures when trying to 1921.82Swiz build the included texinfo files, do: 1931.82Swiz 1941.82Swiz cd src/gnu/usr.bin/texinfo 1951.82Swiz make MKINFO=no dependall install 1961.81Slukem 1971.81Slukem20021223: 1981.81Slukem The METALOG format changed slightly, to remove the leading 1991.81Slukem "${DESTDIR}" from path names. 2001.81Slukem This only affects people building with UNPRIVED. 2011.81Slukem For complete safety, remove the DESTDIR entirely and 2021.81Slukem update tools/mtree, before running make build. 2031.88Sitojun 2041.88Sitojun20021219: 2051.88Sitojun CVS repository layout was changed. See the following for details 2061.88Sitojun if you are using (anonymous) cvs to update your tree. 2071.88Sitojun 2081.93Ssalo http://mail-index.NetBSD.org/netbsd-announce/2002/12/19/0000.html 2091.80Slukem 2101.80Slukem20021219: 2111.80Slukem install(1) had a '-N dbdir' option added, to specify an 2121.80Slukem alternate location to look up users & groups (instead 2131.80Slukem of the host system passwd(5) and group(5) databases). 2141.80Slukem 2151.80Slukem The build system was modified to take advantage of 2161.80Slukem this option (using ${NETBSDSRCDIR}/etc), so if you 2171.83Skei use USETOOLS==no, you may have to rebuild and 2181.80Slukem reinstall usr.bin/xinstall first. 2191.78Slukem 2201.78Slukem20021130: 2211.78Slukem fparseln(3) moved from libutil to libc. 2221.78Slukem If building to DESTDIR=/, reinstall the includes 2231.78Slukem and rebuild libc: 2241.78Slukem make includes 2251.78Slukem make do-lib-libc 2261.78Slukem If using build.sh, "cd tools/compat && make clean" 2271.78Slukem before rebuilding the tools. 2281.77Slukem 2291.77Slukem20021126: 2301.77Slukem The mk.conf(5) variable SYS_INCLUDE has been deprecated, 2311.77Slukem including the optional "SYS_INCLUDE=symlinks" support. 2321.77Slukem All header files, including <sys/*.h> are copied into 2331.77Slukem /usr/include. 2341.76Sthorpej 2351.76Sthorpej20021121: 2361.76Sthorpej The C run-time support files crtbegin.o and crtend.o 2371.76Sthorpej (and their companions crtbeginS.o and crtendS.o) were 2381.76Sthorpej split up, with new crti.o and crtn.o files resulting. 2391.76Sthorpej This means that libtool needs to be rebuilt once the 2401.76Sthorpej new libraries are installed. The process of rebuilding 2411.76Sthorpej libtool will cause it to automatically notice the new 2421.76Sthorpej required files, but it *must* be rebuilt in order to 2431.76Sthorpej do this. 2441.76Sthorpej 2451.76Sthorpej An out-of-date libtool will result in shared libraries 2461.76Sthorpej which lack _init() and _fini() routines, which means that 2471.76Sthorpej their global contructors/destructors will not be invoked. 2481.75Sthorpej 2491.75Sthorpej20021121: 2501.75Sthorpej A bug related to how ARM ELF objects were tagged has been 2511.75Sthorpej corrected. 2521.75Sthorpej 2531.75Sthorpej NetBSD ARM ELF uses the soft-VFP floating point model by 2541.75Sthorpej default. However, the assembler lacked support for marking 2551.75Sthorpej objects as using the VFP floating point format, and the 2561.79Swiz compiler was not properly passing the flag indicating "soft-VFP" 2571.75Sthorpej to the assembler. 2581.75Sthorpej 2591.75Sthorpej Unfortunately, this means that the linker will now consider 2601.75Sthorpej old (i.e. not marked "softvfp") NetBSD ARM ELF objects to be 2611.75Sthorpej incompatible with new (properly marked) objects. 2621.75Sthorpej 2631.75Sthorpej The problem will only manifest itself if you attempt to compile 2641.75Sthorpej a new program using the fixed toolchain, and link that program 2651.75Sthorpej against old libraries which do not have the proper "softvfp" 2661.75Sthorpej markings. ALL OF YOUR EXISTING BINARIES AND SHARED LIBRARIES 2671.75Sthorpej WILL CONTINUE TO WORK PROPERLY. 2681.75Sthorpej 2691.75Sthorpej The only work-around for the problem is to recompile all of 2701.75Sthorpej the libraries on the system. The easiest way to do this for 2711.79Swiz system libraries is to install a binary snapshot; they are 2721.93Ssalo generally available on releng.NetBSD.org. Any packages you 2731.75Sthorpej have installed which supply libraries will have to be recompiled 2741.75Sthorpej if you wish to link new programs against those libraries. 2751.75Sthorpej 2761.75Sthorpej If you have questions about this matter, please contact 2771.93Ssalo port-arm@NetBSD.org. 2781.73Sprovos 2791.73Sprovos20021011: 2801.73Sprovos Systrace has been improved to support privilege elevation. 2811.73Sprovos Updating the kernel requires the userland part of systrace 2821.79Swiz to be rebuilt. 2831.72Sthorpej 2841.72Sthorpej20021010: 2851.72Sthorpej The config(8) grammar was changed to allow options to register 2861.72Sthorpej dependencies on attributes, as well as other options. Users 2871.72Sthorpej must update and reinstall usr.sbin/config before building a new 2881.72Sthorpej kernel. 2891.70Sthorpej 2901.70Sthorpej20021009: 2911.70Sthorpej A new attribute dependency syntax was introduced to config(8), 2921.70Sthorpej which is now used by the SCSI configuration description. Users 2931.71Swiz must update and reinstall usr.sbin/config before building a new 2941.70Sthorpej kernel. 2951.69Sthorpej 2961.69Sthorpej20021003: 2971.69Sthorpej Several changes have been made to the autoconfiguration 2981.69Sthorpej framework. Users must update and reinstall usr.sbin/config 2991.69Sthorpej before building a new kernel. 3001.74Sjschauma 3011.74Sjschauma20021001: 3021.74Sjschauma The i386mp branch has been merged. To compile a kernel, users 3031.74Sjschauma will need to add the option 'cpu* at mainbus?' to their configuration 3041.74Sjschauma file. Multiprocessor kernels will need 3051.74Sjschauma ioapic* at mainbus? apid ? 3061.74Sjschauma options MULTIPROCESSOR 3071.74Sjschauma options COM_MPLOCK 3081.68Slukem 3091.68Slukem20020922: 3101.68Slukem MKDYNAMICROOT=yes enabled by default, which means that 3111.68Slukem certain shared libraries are installed into /lib, the shared 3121.68Slukem linker is installed into /libexec, and all programs in /bin 3131.68Slukem and /sbin are dynamically linked. 3141.68Slukem If you do not use "make build", you should ensure that 3151.68Slukem you have the libraries and shared linker in the new locations, 3161.68Slukem with: 3171.68Slukem make do-lib-csu do-lib-libc do-lib do-gnu-lib do-ld.elf_so 3181.67Slukem 3191.67Slukem20020917: 3201.67Slukem USE_NEW_TOOLCHAIN has been replaced with: 3211.67Slukem - TOOLCHAIN_MISSING -- set to "yes" on platforms for which 3221.67Slukem there is no working in-tree toolchain (hppa, ns32k, sh5, 3231.67Slukem x86_64). 3241.67Slukem - EXTERNAL_TOOLCHAIN -- if defined by the user, points to the 3251.79Swiz root of an external toolchain (e.g. /usr/local/gnu). This 3261.67Slukem enables the cross-build framework even for TOOLCHAIN_MISSING 3271.67Slukem platforms. 3281.66Sgehenna 3291.66Sgehenna20020906: 3301.66Sgehenna gehenna-devsw has been merged into the trunk. Need to update and 3311.79Swiz reinstall usr.sbin/config before building the kernel. 3321.65Slukem 3331.65Slukem20020822: 3341.65Slukem Crunched rescue tools (contents of /bin and /sbin, plus others) 3351.65Slukem are now provided in /rescue. 3361.65Slukem 3371.65Slukem To ensure that these are built statically linked (no matter 3381.65Slukem what the setting of LDSTATIC is), use a crunchgen(1) built 3391.65Slukem from sources newer than 20020820 (see the next entry). 3401.65Slukem 3411.65Slukem20020820: 3421.65Slukem crunchgen(1) changed to ensure that the generated program 3431.65Slukem is statically linked. 3441.65Slukem 3451.65Slukem Solution: update and reinstall usr.bin/crunch 3461.84Sgrant 3471.84Sgrant20020605: 3481.84Sgrant smmsp user/group has been added for sendmail. 3491.84Sgrant 3501.84Sgrant Add the following into /etc/group: 3511.84Sgrant 3521.84Sgrant smmsp:*:17: 3531.84Sgrant 3541.84Sgrant and the following to /etc/master.passwd (via vipw): 3551.84Sgrant 3561.84Sgrant smmsp:*:17:17::0:0:Sendmail Message Submission Program:/nonexistent:/sbin/nologin 3571.61Sitojun 3581.61Sitojun20020515: 3591.61Sitojun sshd user/group has been added. Need to hand add this in, or sshd 3601.61Sitojun will not let you log in (with default, or UsePrivlegeSeparation=yes) 3611.61Sitojun 3621.61Sitojun Add the following into /etc/group: 3631.61Sitojun 3641.61Sitojun sshd:*:16: 3651.61Sitojun 3661.61Sitojun and the following to /etc/master.passwd (via vipw): 3671.61Sitojun 3681.63Senami sshd:*:16:16::0:0:& pseudo-user:/var/chroot/sshd:/sbin/nologin 3691.61Sitojun 3701.79Swiz Also /var/chroot/sshd directory needs to be present (digged as part of 3711.79Swiz the build process). 3721.60Ssommerfe 3731.60Ssommerfe20020426: 3741.60Ssommerfe NBUILDJOBS obsoleted in favor of just using -j. 3751.59Slukem 3761.59Slukem20020426: 3771.59Slukem etc/postinstall added, which performs various checks for 3781.59Slukem configuration file updates and changes, and can fix most of 3791.59Slukem the problems identified. 3801.59Slukem This should make it much easier to upgrade a system's 3811.59Slukem configuration from earlier systems (as far back as NetBSD 1.5). 3821.56Slukem 3831.56Slukem20020320: 3841.79Swiz <bsd.lib.mk> needs a new install(1) for its "-a cmd" support. 3851.79Swiz Build and install at usr.bin/xinstall before the build. 3861.56Slukem 3871.55Sitojun20020319: 3881.79Swiz Raw IPv6 socket now makes strict checking for sa_family and sa_len 3891.79Swiz on send(2) operation. Be sure to have sbin/rtsol and usr.sbin/rtsold 3901.55Sitojun newer than November 2001 when you upgrade the kernel. 3911.55Sitojun 3921.54Sitojun20020311: 3931.54Sitojun ssh configuration files were moved from /etc to /etc/ssh. Beware 3941.54Sitojun if you restart your machine from remote. Note that sshd.conf needs 3951.54Sitojun to be changed (due to the use of "/etc" inside). 3961.54Sitojun 3971.54Sitojun20020223: 3981.53Smatt Users of the VAX port will need to rebuild and install gas 3991.53Smatt so it deal with the now present register prefix used in all 4001.53Smatt the VAX assembly files. 4011.53Smatt 4021.50Sitojun20020118: 4031.50Sitojun ntpd user/group has been added. Need to hand add this in or builds 4041.50Sitojun will break as mtree aborts early. 4051.50Sitojun 4061.50Sitojun Add the following into /etc/group: 4071.50Sitojun 4081.50Sitojun ntpd:*:15: 4091.50Sitojun 4101.50Sitojun and the following to /etc/master.passwd (via vipw): 4111.50Sitojun 4121.50Sitojun ntpd:*:15:15::0:0:Ntpd pseudo-user:/var/chroot/ntpd:/sbin/nologin 4131.50Sitojun 4141.49Sjmc20011207: 4151.49Sjmc If you're attempting to build a snapshot on sparc64 and are getting 4161.49Sjmc reloc errors from the toolchain groff binary this means your native 4171.49Sjmc toolchain has some broken C++ bits. 4181.49Sjmc 4191.49Sjmc To fix: 4201.49Sjmc 4211.49Sjmc Build a new toolchain (i.e. build.sh -t) 4221.49Sjmc Use the new toolchain to build and install natively (i.e. /usr/lib) 4231.49Sjmc 4241.49Sjmc gnu/lib/libgcc 4251.51Spooka gnu/lib/libstdc++ 4261.49Sjmc 4271.49Sjmc After this a snapshot will be able to be built. 4281.49Sjmc 4291.47Sjmc20011201: 4301.47Sjmc In order for a sparc64 build to work you must have a working awk. If 4311.47Sjmc you've built and installed a system with the new toolchain up to this 4321.52Swiz point you do not have a working awk as its ability to do floating 4331.47Sjmc point is broken. 4341.47Sjmc 4351.47Sjmc To build: 4361.47Sjmc 4371.47Sjmc remake and install gnu/lib/libgcc 4381.47Sjmc remake and install gnu/usr.bin/gawk into /usr/bin (make sure it links 4391.48Sjmc against the new libgcc.a) 4401.47Sjmc 4411.46Sthorpej20011128: 4421.46Sthorpej Kernel config information was changed to use defflag in 4431.46Sthorpej the various "files" files. Bug fixes to config(8) are 4441.46Sthorpej required in order for this to work properly. Make sure 4451.46Sthorpej to build and install in usr.sbin/config before attempting 4461.46Sthorpej to build a new kernel. 4471.46Sthorpej 4481.45Syamt20011030: 4491.45Syamt libc/locale/wcstod.c now needs new lint(1). Update lint(1) 4501.45Syamt before building libc. 4511.43Smason 4521.44Stv20011029: 4531.44Stv The new document BUILDING.mdoc (view with nroff | more, or 4541.44Stv see pre-generated .txt and .html versions) describes the build 4551.44Stv procedure in great detail. BUILDING, and the USE_NEW_TOOLCHAIN 4561.44Stv build process, are intended in the long run to replace this 4571.44Stv manual update log. 4581.44Stv 4591.44Stv Users building a USE_NEW_TOOLCHAIN system should read the 4601.44Stv BUILDING document for caveats. Generally, BUILDING supersedes 4611.44Stv UPDATING for these systems, as tool updating is taken care of 4621.44Stv by the new build system. 4631.42Sperry 4641.42Sperry20011028: 4651.42Sperry src/etc/Makefile now needs install to be able to handle 4661.42Sperry symlinks that point to nowhere. A bug in install that 4671.42Sperry prevented this was corrected. 4681.42Sperry 4691.42Sperry Solution: update and reinstall usr.bin/xinstall 4701.42Sperry Better Solution: Use the new toolchain and it will just work 4711.42Sperry for you. 4721.40Slukem 4731.40Slukem20011006: 4741.40Slukem /etc/mtree/NetBSD.dist has been updated to take advantage of 4751.40Slukem absolute path support added to mtree(8). Older mtree(8)s don't 4761.40Slukem understand the format. 4771.40Slukem 4781.40Slukem Solution: update and reinstall usr.sbin/mtree 4791.39Sjmc 4801.39Sjmc20011004: 4811.39Sjmc Crunchgen has been updated to work via reach-over makefiles. Updating 4821.39Sjmc is suggested before running a snapshot build 4831.36Stv 4841.35Sthorpej20010915: 4851.35Sthorpej The new "ubcperf" code committed by Chuck Silvers removed 4861.35Sthorpej a header file, uvm/uvm_vnode.h. There may be stale .depend 4871.35Sthorpej files that still reference this file. 4881.35Sthorpej 4891.35Sthorpej Solution: "make cleandir && make dependall" in affected 4901.35Sthorpej directories. 4911.31Senami 4921.31Senami20010803: 4931.31Senami grep.info is now built from grep.texi using makeinfo. Since it 4941.31Senami requires makeinfo v4.0, you need to install new texinfo before 4951.31Senami building gnu/usr.bin/grep. To install new texinfo, please follow 4961.31Senami the instruction described in 20010726 entry. 4971.30Senami 4981.64Ssommerfe20010803: 4991.41Swiz (i386 only): i386 kernel now uses new instructions like 5001.111Ssimonb `fxsave' which old gas doesn't understand. To build the 5011.64Ssommerfe kernel successfully, you need to build and install a new toolchain, 5021.64Ssommerfe (i.e., build.sh -t) or (temporarily) comment out "options I686_CPU" 5031.64Ssommerfe from your kernel configuration until you rebuild your userland. 5041.64Ssommerfe See 20011029 above and BUILDING file in this directory for more information. 5051.64Ssommerfe [updated 20020630 since i386 gas moved when USE_NEW_TOOLCHAIN enabled] 5061.29Sbjh21 5071.29Sbjh2120010731: 5081.29Sbjh21 Bootloader update on ELF platforms. DDB in kernels from before 5091.29Sbjh21 this will be unable to read symbol tables provided by newer 5101.29Sbjh21 bootloaders. 5111.27Sassar 5121.27Sassar20010726: 5131.27Sassar Texinfo was updated to 4.0. To avoid failures when trying to 5141.28Sassar build the included texinfo files, do: 5151.28Sassar 5161.28Sassar cd src/gnu/usr.bin/texinfo 5171.28Sassar make MKINFO=no dependall install 5181.25Sthorpej 5191.25Sthorpej20010718: 5201.25Sthorpej Enabled correct .init/.fini processing in crt0. The way this 5211.25Sthorpej was done was to change a -I directive to cc(1), which means 5221.25Sthorpej make(1) will have a stale dependency (it will be checking the 5231.25Sthorpej timestamp on the wrong "dot_init.h"). 5241.25Sthorpej 5251.25Sthorpej The symptom you will see is that new programs die with SIGSEGV 5261.25Sthorpej if you have a stale dependency. 5271.25Sthorpej 5281.25Sthorpej Solution: "make cleandir" in both lib/csu and libexec/ld.elf_so 5291.25Sthorpej before starting your build. 5301.26Sthorpej 5311.26Sthorpej20010628: 5321.26Sthorpej A construct was added to uvm_page.h that uncovered a bug 5331.26Sthorpej in lint(1). If you get a warning/error about a non-portable 5341.26Sthorpej bitfield, update your lint(1) before proceeding. 5351.21Sjmc 5361.21Sjmc20010226: 5371.22Sjmc Added named user/group to system. Need to hand add this in or builds 5381.21Sjmc will break as mtree aborts early. 5391.21Sjmc 5401.21Sjmc To work around add by hand: 5411.21Sjmc 5421.21Sjmc named:*:14: 5431.21Sjmc 5441.22Sjmc to /etc/group and add: 5451.22Sjmc 5461.22Sjmc named:*:14:14::0:0:Named pseudo-user:/var/named:/sbin/nologin 5471.22Sjmc 5481.22Sjmc to master.passwd (use vipw for instance if doing by hand). 5491.22Sjmc 5501.22Sjmc Now a make build should progress. 5511.18Sjmc 5521.18Sjmc20010219: 5531.52Swiz get/setprogname() added. Any hostprogs that may use this will need 5541.111Ssimonb to be bootstrapped manually until the host system is current. 5551.18Sjmc 5561.111Ssimonb Known problems: sys/arch/macppc/stand/fixcoff 5571.19Scgd usr.sbin/config (adding -DMAKE_BOOTSTRAP to 5581.19Scgd CFLAGS and rebuilding should work) 5591.20Sjmc usr.sbin/mdsetimage - Build a static copy if 5601.111Ssimonb building a snapshot before fully bootstrapped. 5611.15Schristos 5621.15Schristos20010204: 5631.15Schristos prepare the code to compile with stricter gcc flags. in 5641.15Schristos particular start eliminating redundant declarations. Yacc 5651.15Schristos needs to be installed before make build. 5661.10Schristos 5671.10Schristos20010114: 5681.10Schristos introduce .if commands(target) in make(1). You need to 5691.10Schristos bring everything up-to-date first, then without installing 5701.23Stron anything make and install in usr.bin/make, then proceed 5711.10Schristos with make build. 5721.9Ssommerfe 5731.9Ssommerfe20010101: 5741.9Ssommerfe bsd.subdir.mk committed 20001230 had a bug which caused 5751.9Ssommerfe afterinstall targets to run too soon; update again. 5761.8Ssommerfe 5771.8Ssommerfe20001230: 5781.8Ssommerfe New share/mk files needed to support .WAIT in SUBDIR variables. 5791.8Ssommerfe If you get make errors, 5801.8Ssommerfe (cd share/mk; make install) 5811.8Ssommerfe Also, PRINTOBJDIR has changed and is now used more heavily. 5821.6Sad 5831.6Sad20001019: 5841.7Sad The `ca' device driver has been replaced by `ld'; although the 5851.6Sad major and minor numbers haven't changed, you should update your /dev 5861.6Sad directory. 5871.1Sabs 5881.4Sitojun20000929: 5891.4Sitojun The following make directives are obsoleted. 5901.4Sitojun MKCRYPTO_RSA NOCRYPTO_RSA NOCRYPTO_RC5 NOCRYPTO_IDEA 5911.4Sitojun By default, RSA is built into libcrypto. IDEA and RC5 will not be 5921.16Swiz built into libcrypto. By using MKCRYPTO_{RC5,IDEA}, you can build 5931.4Sitojun additional library libcrypto_{idea,rc5}. 5941.1Sabs 5951.1Sabs 5961.1SabsHints for a more successful build: 5971.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 5981.123Sjmc Use build.sh, but do not use its "expert mode": 5991.123Sjmc This will will automatically build the tools in the 6001.123Sjmc correct order, and it will keep the tools and the 6011.123Sjmc new build products from interfering with the running 6021.123Sjmc system. This will allow you to ignore most of the 6031.123Sjmc other advice in this file. 6041.2Smrg Build a new kernel first: 6051.2Smrg This makes sure that any new system calls or features 6061.2Smrg expected by the new userland will be present. This 6071.2Smrg helps to avoid critical errors when upgrading. 6081.1Sabs Use object directories: 6091.1Sabs This helps to keep stale object 6101.1Sabs files from polluting the build if a Makefile "forgets" 6111.1Sabs about one. It also makes it easier to clean up after 6121.1Sabs a build. It's also necessary if you want to use the 6131.1Sabs same source tree for multiple machines. 6141.123Sjmc To use object directories with build.sh: 6151.123Sjmc a) invoke build.sh with the "-M" or "-O" options. 6161.123Sjmc To use object directories without using build.sh: 6171.1Sabs a) cd /usr/src ; make cleandir 6181.2Smrg b) Add "OBJMACHINE=yes" to /etc/mk.conf 6191.2Smrg c) Add "MKOBJDIRS=yes" to /etc/mk.conf 6201.1Sabs d) cd /usr/src ; make build 6211.2Smrg Note that running "make obj" in a directory will create 6221.2Smrg in obj.$MACHINE directory. 6231.1Sabs Build to a DESTDIR: 6241.123Sjmc This helps to keep old installed files (especially libraries) 6251.123Sjmc from interfering with the new build. 6261.123Sjmc To build to a DESTDIR with build.sh, use the "-D" option. 6271.123Sjmc To build to a DESTDIR without using build.sh, set the DESTDIR 6281.123Sjmc environment variable before running make build. It should be 6291.123Sjmc set to the pathname of an initially empty directory. 6301.123Sjmc Problems: if you do not use build.sh, you might need to 6311.123Sjmc update critical utilities without using DESTDIR since 6321.123Sjmc nothing is executed from what is installed in DESTDIR. 6331.123Sjmc (See critical utils, below.) 6341.1Sabs Build often: 6351.1Sabs This keeps critical utilities current enough to not choke 6361.1Sabs on any other part of the source tree that depends on up to 6371.123Sjmc date functionality. If you use build.sh, you should not have 6381.123Sjmc this problem. 6391.1Sabs 6401.1SabsWhat to do if things don't work: 6411.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 6421.1SabsWhen things don't work there is usually a few things that commonly 6431.1Sabsshould be done. 6441.1Sabs 1) make includes 6451.1Sabs This should be done automatically by make build. 6461.1Sabs 2) cd share/mk && make install 6471.1Sabs Again, automatically done by make build. 6481.1Sabs 6491.1SabsFailsafe rebuild of a small part of the tree: 6501.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 6511.1SabsTo make sure you rebuild something correctly you want to do 6521.1Sabssomething like the following: 6531.1Sabs 1) Make sure the includes and .mk files are up to date. 6541.1Sabs 2) Make sure any program used to build the particular 6551.1Sabs utility is up to date. (yacc, lex, etc...) 6561.1Sabs 3) cd ...path/to/util... 6571.1Sabs make cleandir 6581.1Sabs rm ...all obj directories... 6591.1Sabs make cleandir # yes, again 6601.1Sabs make obj 6611.1Sabs make depend && make 6621.1Sabs 6631.1SabsFailsafe rebuild of the entire tree: 6641.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 6651.1SabsIf you really want to make sure the source tree is clean and 6661.2Smrgready for a build try the following. Note that sourcing /etc/mk.conf 6671.2Smrg(a make(1) Makefile) in this manner is not right, and will not work 6681.2Smrgfor anyone who uses any make(1) features in /etc/mk.conf. 6691.1Sabs 6701.1Sabs---cut here--- 6711.1Sabs#!/bin/sh 6721.1Sabs. /etc/mk.conf 6731.1Sabs 6741.58Slukemif [ -z $NETBSDSRCDIR ] ; then 6751.58Slukem NETBSDSRCDIR=/usr/src 6761.1Sabsfi 6771.58Slukemif [ \! -d $NETBSDSRCDIR ] ; then 6781.1Sabs echo Unable to find sources 6791.1Sabs exit 1 6801.1Sabsfi 6811.58Slukemfind $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \; 6821.1Sabs 6831.1Sabsif [ -z $BSDOBJDIR ] ; then 6841.1Sabs BSDOBJDIR=/usr/obj 6851.1Sabsfi 6861.1Sabsif [ -d $BSDOBJDIR ] ; then 6871.1Sabs rm -rf $BSDOBJDIR 6881.1Sabsfi 6891.1Sabs 6901.58Slukemcd $NETBSDSRCDIR && make cleandir 6911.1Sabs 6921.1Sabs---cut here--- 6931.1Sabs 6941.1SabsCritical utilities: 6951.1Sabs^^^^^^^^^^^^^^^^^^^ 6961.1Sabs gnu/usr.bin/egcs 6971.3Sitojun usr.bin/compile_et 6981.1Sabs usr.bin/make 6991.1Sabs usr.bin/yacc 7001.1Sabs usr.bin/lex 7011.11Slukem usr.bin/xlint 7021.2Smrg usr.sbin/config 7031.1Sabs 7041.34SsimonbOther problems and possible solutions: 7051.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 7061.1SabsSymptom:Unreasonable compiler errors. 7071.1SabsFix: Rebuild gnu/usr.bin/egcs 7081.1Sabs 7091.1SabsSymptom:Complaints involving a Makefile. 7101.17SerhFix: Rebuild usr.bin/make: 7111.17Serh cd usr.bin/make && make && make install 7121.111Ssimonb Or, a failsafe method if that doesn't work: 7131.17Serh cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin 7141.17Serh 7151.1SabsFix: Make sure .mk files are up to date. 7161.1Sabs cd share/mk && make install 7171.2Smrg 7181.2SmrgSymptom:Kernel `config' fails to configure any kernel, including GENERIC. 7191.2SmrgFix: Rebuild usr.sbin/config 7201.1Sabs 7211.1SabsSymptom: 7221.1SabsFix: Rebuild usr.bin/yacc 7231.1Sabs 7241.1SabsSymptom: 7251.1SabsFix: Rebuild usr.bin/lex 7261.1Sabs 7271.1SabsSymptom: 7281.1SabsFix: rm /usr/lib/libbfd.a 7291.4Sitojun 7301.4SitojunSymptom:Obsolete intermediate files are used during compilation 7311.4SitojunFix: Try the following sequence of commands in the directory in question. 7321.4Sitojun make cleandir; rm `make print-objdir`; make cleandir; make obj 7331.4Sitojun (If you built the tree without "make obj" in the past, obsolete files 7341.4Sitojun may remain. The command tries to clean everything up) 7351.5Swiz 7361.5SwizSymptom:.../sysinst/run.c:xx: warning: initialization from incompatible pointer type 7371.5SwizFix: Rebuild and install usr.bin/menuc 7381.12Sitojun 7391.12SitojunSymptom:mklocale not found during build in share/locale/ctype 7401.12SitojunFix: Build and install usr.bin/mklocale 7411.13Sdogcow 7421.86SkleinkSymptom:undefined reference to `__assert13' or `__unsetenv13' 7431.13SdogcowFix: Rebuild and install lib/libc 7441.13Sdogcow 7451.19ScgdSymptom:usr.sbin/config fails to build. 7461.19ScgdFix: Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile. 7471.13Sdogcow 7481.19ScgdSymptom:undefined reference to `getprogname' or `setprogname' 7491.19ScgdFix: Rebuild and install lib/libc 7501.24Sabs 7511.24SabsSymptom:lint does not understand the '-X' option 7521.24SabsFix: May need to build & install libs with NOLINT=1 before rebuilding lint 753