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