UPDATING revision 1.122
11.122Sitojun$NetBSD: UPDATING,v 1.122 2004/05/31 00:18:58 itojun Exp $
21.1Sabs
31.1SabsThis file is intended to be a brief introduction to the build
41.1Sabsprocess and a reference on what to do if something doesn't work.
51.1Sabs
61.1SabsFor a more detailed description see Makefile.
71.1Sabs
81.1SabsRecent changes:
91.1Sabs^^^^^^^^^^^^^^^
101.99Smrg
111.121Slukem20040516:
121.121Slukem	The end-user modifiable X11 configuration has been moved
131.121Slukem	from /usr/X11R6/lib/X11/<dir> to /etc/X11/<dir>.
141.121Slukem	Ensure that src and xsrc is up to date, and run
151.121Slukem	"make cleandir" in src/x11 before your next build.
161.121Slukem
171.119Satatat20040426:
181.119Satatat	Support for the original dynamic sysctl node structure has
191.119Satatat	been removed in favor of the newer layout.  This affects
201.119Satatat	consumers of the create and delete interface, as well as
211.119Satatat	the dynamic discovery mechanism.  This is believed only to
221.119Satatat	be the sysctl(8) binary itself, at this point in time, so
231.119Satatat	the only effect of this should be that a sysctl binary
241.119Satatat	built from sources dated between 2003/12/04 and 2004/03/24
251.119Satatat	will not work on a kernel built from sources dated after
261.119Satatat	2004/04/25.  If you need a new sysctl binary but build.sh
271.119Satatat	does not work, make sure that your revision of
281.120Satatat	src/sys/sys/sysctl.h is 1.112 (or later), and then the
291.120Satatat	do the following:
301.119Satatat
311.120Satatat	cd /usr/src (or wherever your source tree is)
321.120Satatat	make USETOOLS=no includes
331.120Satatat	cd lib/libc
341.120Satatat	make USETOOLS=no dependall install
351.120Satatat	cd ../../sbin/sysctl
361.119Satatat	make USETOOLS=no dependall install
371.119Satatat
381.122Sitojun	If you are using older sysctl binary, GNU autoconf would fail to
391.122Sitojun	identify your machine architecture, and tries to build binary for
401.122Sitojun	"unknown-unknown-netbsd20F" or something like that.  if that happens,
411.122Sitojun	make sure to follow the above steps.
421.122Sitojun
431.118Sdbj20040425:
441.118Sdbj	The ffs superblock issues listed below under 20040109 and 20030402
451.118Sdbj	are now automatically addressed by the /etc/rc.d/fixsb script or by
461.118Sdbj	sysinst when it checks a a filesystem. The manual fsck_ffs -b16 -c4
471.118Sdbj	invocation mentioned below will continue to work and is now
481.118Sdbj	automated by those scripts.  Note that under certain circumstances,
491.118Sdbj	affected filesystems upgraded to a -current kernel first before
501.118Sdbj	upgrading their userland with the fixsb and fsck_ffs fixes may
511.118Sdbj	encounter a 'freeing free inode' panic when writing to the affected
521.118Sdbj	filesystem, so it is a good idea to repair the filesystem as soon as
531.118Sdbj	possible.  For more details on the fixsb script, see pr install/25138.
541.118Sdbj
551.115Schristos20040418:
561.121Slukem	statfs(2) and friends have been replaced with statvfs(2). Before
571.115Schristos	installing a newly build userland make sure that you are running
581.115Schristos	a newly built kernel with COMPAT_20 set. In addition your libc
591.115Schristos	build might not work (undefined SYS_statfs symbol) because make
601.115Schristos	clean does not know how to remove files it does not know about
611.116Schristos	anymore. Manually remove all generated .S sources and objects
621.116Schristos	from the libc build directory.
631.115Schristos
641.114Sjmc20040326:
651.114Sjmc	The method by which athhal-elf.o gets pulled into i386 kernel builds
661.117Sjmc	has been changed. The file is now stored as a uuencoded file in CVS
671.114Sjmc	and the generated Makefile will use the new .uue rules from bsd.file.mk
681.114Sjmc	to build it.
691.114Sjmc
701.114Sjmc	This means you must have the latest bsd.files.mk installed when
711.114Sjmc	building a kernel without USETOOLS=yes.
721.114Sjmc
731.113Sdan20040318:
741.113Sdan	A bug in the cgd(4) blowfish code was corrected, without
751.113Sdan	provision of backwards compatibility, after several public
761.113Sdan	notices over several months. Users of cgd with blowfish cipher
771.113Sdan	ONLY must dump their data before updating their kernels, and
781.113Sdan	recreate cgd's and restore data using the new kernel. See
791.113Sdan	(recent message to current-users, URL when mail-index has updated)
801.113Sdan
811.108Sbjh2120040313:
821.108Sbjh21	On acorn32, the opms and qms drivers have been withdrawn, and
831.108Sbjh21	the old wsqms driver is now called qms.  Kernel config files
841.108Sbjh21	will need updating.  See the ones in sys/arch/acorn32/conf
851.108Sbjh21	for examples.
861.108Sbjh21
871.106Sbjh2120040125:
881.106Sbjh21	On acorn32, the beep and sysbeep devices are no longer
891.106Sbjh21	needed, and will need to be deleted from kernel configuration
901.106Sbjh21	files.
911.105Sbjh21
921.102Sdbj20040109:
931.102Sdbj	Compatibility for old ffs superblock layouts has been
941.102Sdbj	added, and the restrictive fsck checks have been reenabled
951.102Sdbj	when using those layouts.  If you have been using -current
961.102Sdbj	since 20030402, you may find that fsck again signals fatal
971.110Sdbj	superblock mismatches.  To repair, make sure you have
981.111Ssimonb	an updated fsck_ffs and then you can use fsck_ffs -b 16 -c 4
991.109Sdbj	to complete the filesystem upgrade.  A message has
1001.111Ssimonb	been added to the kernel which should detect this problem.
1011.111Ssimonb	See the following discussion for more information:
1021.112Skeihan	http://mail-index.NetBSD.org/current-users/2004/01/11/0022.html
1031.102Sdbj
1041.99Smrg20031203:
1051.100Skeihan	New binutils builds may fail due to old dependencies.
1061.99Smrg	It's necessary to "make cleandir" to ensure that
1071.99Smrg	the dependencies will be rebuilt correctly.
1081.98Swiz
1091.98Swiz20031111:
1101.98Swiz	A newer mkdep is needed.  Error noting that is
1111.98Swiz		cc: Ambiguous abbreviation --
1121.97Slukem
1131.97Slukem20031008:
1141.97Slukem	/usr/include/sys/disklabel_mbr.h was removed.
1151.97Slukem	It's necessary to "make cleandir" to ensure that
1161.97Slukem	the dependencies will be rebuilt correctly.
1171.96Schristos
1181.109Sdbj20031007:
1191.111Ssimonb	A sign exension bug was fixed which set all the high bits
1201.111Ssimonb	of our newly expanded ffs fs_flags.  This should only
1211.111Ssimonb	affect users who installed or upgraded in September of 2003.
1221.109Sdbj	A small utility program was posted to tech-kern which
1231.111Ssimonb	should fix this problem, and a warning message was added
1241.111Ssimonb	to the kernel which should discover and warn about it.  See
1251.111Ssimonb	http://mail-index.NetBSD.org/tech-kern/2003/10/07/0005.html
1261.109Sdbj
1271.96Schristos20030906:
1281.96Schristos	With the addition of siginfo support the old signal trampoline
1291.96Schristos	code has been deprecated to COMPAT_16. Make sure that your running
1301.96Schristos	kernel has COMPAT_16 enabled before building userland.
1311.94Schristos
1321.94Schristos20030801:
1331.95Swiz	With the new openssl, there is some header and library shuffling.
1341.94Schristos	rm -f /usr/include/des.h /usr/include/kerberosIV/* /lib/libdes* \
1351.95Swiz	/usr/lib/libdes* before building.
1361.92Swiz
1371.92Swiz20030703:
1381.92Swiz	Texinfo was updated to 4.6.  To avoid failures when trying to
1391.92Swiz	build the included texinfo files, do:
1401.92Swiz
1411.92Swiz	cd src/gnu/usr.bin/texinfo
1421.92Swiz	make MKINFO=no dependall install
1431.90Swiz
1441.90Swiz20030630:
1451.101Sjunyoung	Groff was updated to 1.19; it's probably necessary to do
1461.91Swiz		cd share/mk && make install
1471.90Swiz		cd src/gnu/usr.bin/groff
1481.90Swiz		make MKMAN=no dependall install
1491.90Swiz	(untested).
1501.89Schristos
1511.89Schristos20030516:
1521.89Schristos	Due to bugs in the export handling code, invalid export lines
1531.89Schristos	were accepted before and caused the kernel to panic when
1541.89Schristos	mountd got restarted because it freed memory that had already
1551.89Schristos	been freed. This has been fixed and the kernel checks
1561.89Schristos	export addresses very strictly. If you upgrade your kernel,
1571.89Schristos	make sure you also upgrade mountd, because if your export
1581.89Schristos	file contains lines with an old inet4 address syntax (i.e.
1591.89Schristos	a.b.c or a.b or a), they will get rejected by the new kernel.
1601.87Sbjh21
1611.87Sbjh2120030402:
1621.87Sbjh21	The superblock layout for FFS was changed.  If you have 1.6
1631.87Sbjh21	fsck binaries, they will signal a fatal superblock mismatch
1641.87Sbjh21	with the first alternate, because they compare too many
1651.87Sbjh21	fields (even ones that aren't useful).  If possible, upgrade
1661.87Sbjh21	your fsck_ffs binary before using a new kernel.
1671.87Sbjh21	None of this signals actual filesystem damage.
1681.85Satatat
1691.85Satatat20030324:
1701.85Satatat	sendmail version 8.12.8 was imported.  Since sendmail is
1711.85Satatat	now setgid to the smmsp group, and runs in "collection"
1721.85Satatat	mode for most common activities, there is a new config
1731.85Satatat	file called submit.cf that needs to live in /etc/mail.
1741.85Satatat	The generic submit.cf sample in /usr/share/sendmail/cf
1751.85Satatat	is named netbsd-msp.cf.  Upgrading your regular sendmail
1761.85Satatat	configuration file is also strongly advised.
1771.85Satatat
1781.85Satatat	See the section named "MESSAGE SUBMISSION PROGRAM" in
1791.85Satatat	the updated /usr/share/sendmail/README file for more
1801.85Satatat	information.
1811.82Swiz
1821.82Swiz20030117:
1831.82Swiz	Texinfo was updated to 4.3.  To avoid failures when trying to
1841.82Swiz	build the included texinfo files, do:
1851.82Swiz
1861.82Swiz	cd src/gnu/usr.bin/texinfo
1871.82Swiz	make MKINFO=no dependall install
1881.81Slukem
1891.81Slukem20021223:
1901.81Slukem	The METALOG format changed slightly, to remove the leading
1911.81Slukem	"${DESTDIR}" from path names.
1921.81Slukem	This only affects people building with UNPRIVED.
1931.81Slukem	For complete safety, remove the DESTDIR entirely and
1941.81Slukem	update tools/mtree, before running make build.
1951.88Sitojun
1961.88Sitojun20021219:
1971.88Sitojun	CVS repository layout was changed.  See the following for details
1981.88Sitojun	if you are using (anonymous) cvs to update your tree.
1991.88Sitojun
2001.93Ssalo	http://mail-index.NetBSD.org/netbsd-announce/2002/12/19/0000.html
2011.80Slukem
2021.80Slukem20021219:
2031.80Slukem	install(1) had a '-N dbdir' option added, to specify an
2041.80Slukem	alternate location to look up users & groups (instead
2051.80Slukem	of the host system passwd(5) and group(5) databases).
2061.80Slukem
2071.80Slukem	The build system was modified to take advantage of
2081.80Slukem	this option (using ${NETBSDSRCDIR}/etc), so if you
2091.83Skei	use USETOOLS==no, you may have to rebuild and
2101.80Slukem	reinstall usr.bin/xinstall first.
2111.78Slukem
2121.78Slukem20021130:
2131.78Slukem	fparseln(3) moved from libutil to libc.
2141.78Slukem	If building to DESTDIR=/, reinstall the includes
2151.78Slukem	and rebuild libc:
2161.78Slukem		make includes
2171.78Slukem		make do-lib-libc
2181.78Slukem	If using build.sh, "cd tools/compat && make clean"
2191.78Slukem	before rebuilding the tools.
2201.77Slukem
2211.77Slukem20021126:
2221.77Slukem	The mk.conf(5) variable SYS_INCLUDE has been deprecated,
2231.77Slukem	including the optional "SYS_INCLUDE=symlinks" support.
2241.77Slukem	All header files, including <sys/*.h> are copied into
2251.77Slukem	/usr/include.
2261.76Sthorpej
2271.76Sthorpej20021121:
2281.76Sthorpej	The C run-time support files crtbegin.o and crtend.o
2291.76Sthorpej	(and their companions crtbeginS.o and crtendS.o) were
2301.76Sthorpej	split up, with new crti.o and crtn.o files resulting.
2311.76Sthorpej	This means that libtool needs to be rebuilt once the
2321.76Sthorpej	new libraries are installed.  The process of rebuilding
2331.76Sthorpej	libtool will cause it to automatically notice the new
2341.76Sthorpej	required files, but it *must* be rebuilt in order to
2351.76Sthorpej	do this.
2361.76Sthorpej
2371.76Sthorpej	An out-of-date libtool will result in shared libraries
2381.76Sthorpej	which lack _init() and _fini() routines, which means that
2391.76Sthorpej	their global contructors/destructors will not be invoked.
2401.75Sthorpej
2411.75Sthorpej20021121:
2421.75Sthorpej	A bug related to how ARM ELF objects were tagged has been
2431.75Sthorpej	corrected.
2441.75Sthorpej
2451.75Sthorpej	NetBSD ARM ELF uses the soft-VFP floating point model by
2461.75Sthorpej	default.  However, the assembler lacked support for marking
2471.75Sthorpej	objects as using the VFP floating point format, and the
2481.79Swiz	compiler was not properly passing the flag indicating "soft-VFP"
2491.75Sthorpej	to the assembler.
2501.75Sthorpej
2511.75Sthorpej	Unfortunately, this means that the linker will now consider
2521.75Sthorpej	old (i.e. not marked "softvfp") NetBSD ARM ELF objects to be
2531.75Sthorpej	incompatible with new (properly marked) objects.
2541.75Sthorpej
2551.75Sthorpej	The problem will only manifest itself if you attempt to compile
2561.75Sthorpej	a new program using the fixed toolchain, and link that program
2571.75Sthorpej	against old libraries which do not have the proper "softvfp"
2581.75Sthorpej	markings.  ALL OF YOUR EXISTING BINARIES AND SHARED LIBRARIES
2591.75Sthorpej	WILL CONTINUE TO WORK PROPERLY.
2601.75Sthorpej
2611.75Sthorpej	The only work-around for the problem is to recompile all of
2621.75Sthorpej	the libraries on the system.  The easiest way to do this for
2631.79Swiz	system libraries is to install a binary snapshot; they are
2641.93Ssalo	generally available on releng.NetBSD.org.  Any packages you
2651.75Sthorpej	have installed which supply libraries will have to be recompiled
2661.75Sthorpej	if you wish to link new programs against those libraries.
2671.75Sthorpej
2681.75Sthorpej	If you have questions about this matter, please contact
2691.93Ssalo	port-arm@NetBSD.org.
2701.73Sprovos
2711.73Sprovos20021011:
2721.73Sprovos	Systrace has been improved to support privilege elevation.
2731.73Sprovos	Updating the kernel requires the userland part of systrace
2741.79Swiz	to be rebuilt.
2751.72Sthorpej
2761.72Sthorpej20021010:
2771.72Sthorpej	The config(8) grammar was changed to allow options to register
2781.72Sthorpej	dependencies on attributes, as well as other options.  Users
2791.72Sthorpej	must update and reinstall usr.sbin/config before building a new
2801.72Sthorpej	kernel.
2811.70Sthorpej
2821.70Sthorpej20021009:
2831.70Sthorpej	A new attribute dependency syntax was introduced to config(8),
2841.70Sthorpej	which is now used by the SCSI configuration description.  Users
2851.71Swiz	must update and reinstall usr.sbin/config before building a new
2861.70Sthorpej	kernel.
2871.69Sthorpej
2881.69Sthorpej20021003:
2891.69Sthorpej	Several changes have been made to the autoconfiguration
2901.69Sthorpej	framework.  Users must update and reinstall usr.sbin/config
2911.69Sthorpej	before building a new kernel.
2921.74Sjschauma
2931.74Sjschauma20021001:
2941.74Sjschauma	The i386mp branch has been merged.  To compile a kernel, users
2951.74Sjschauma	will need to add the option 'cpu* at mainbus?' to their configuration
2961.74Sjschauma	file.  Multiprocessor kernels will need
2971.74Sjschauma	ioapic*		at mainbus? apid ?
2981.74Sjschauma	options		MULTIPROCESSOR
2991.74Sjschauma	options		COM_MPLOCK
3001.68Slukem
3011.68Slukem20020922:
3021.68Slukem	MKDYNAMICROOT=yes enabled by default, which means that
3031.68Slukem	certain shared libraries are installed into /lib, the shared
3041.68Slukem	linker is installed into /libexec, and all programs in /bin
3051.68Slukem	and /sbin are dynamically linked.
3061.68Slukem	If you do not use "make build", you should ensure that
3071.68Slukem	you have the libraries and shared linker in the new locations,
3081.68Slukem	with:
3091.68Slukem		make do-lib-csu do-lib-libc do-lib do-gnu-lib do-ld.elf_so
3101.67Slukem
3111.67Slukem20020917:
3121.67Slukem	USE_NEW_TOOLCHAIN has been replaced with:
3131.67Slukem	    -	TOOLCHAIN_MISSING -- set to "yes" on platforms for which
3141.67Slukem		there is no working in-tree toolchain (hppa, ns32k, sh5,
3151.67Slukem		x86_64).
3161.67Slukem	    -	EXTERNAL_TOOLCHAIN -- if defined by the user, points to the
3171.79Swiz		root of an external toolchain (e.g. /usr/local/gnu).  This
3181.67Slukem		enables the cross-build framework even for TOOLCHAIN_MISSING
3191.67Slukem		platforms.
3201.66Sgehenna
3211.66Sgehenna20020906:
3221.66Sgehenna	gehenna-devsw has been merged into the trunk. Need to update and
3231.79Swiz	reinstall usr.sbin/config before building the kernel.
3241.65Slukem
3251.65Slukem20020822:
3261.65Slukem	Crunched rescue tools (contents of /bin and /sbin, plus others)
3271.65Slukem	are now provided in /rescue.
3281.65Slukem
3291.65Slukem	To ensure that these are built statically linked (no matter
3301.65Slukem	what the setting of LDSTATIC is), use a crunchgen(1) built
3311.65Slukem	from sources newer than 20020820 (see the next entry).
3321.65Slukem
3331.65Slukem20020820:
3341.65Slukem	crunchgen(1) changed to ensure that the generated program
3351.65Slukem	is statically linked.
3361.65Slukem
3371.65Slukem	Solution: update and reinstall usr.bin/crunch
3381.84Sgrant
3391.84Sgrant20020605:
3401.84Sgrant	smmsp user/group has been added for sendmail.
3411.84Sgrant
3421.84Sgrant	Add the following into /etc/group:
3431.84Sgrant
3441.84Sgrant	smmsp:*:17:
3451.84Sgrant
3461.84Sgrant	and the following to /etc/master.passwd (via vipw):
3471.84Sgrant
3481.84Sgrant	smmsp:*:17:17::0:0:Sendmail Message Submission Program:/nonexistent:/sbin/nologin
3491.61Sitojun
3501.61Sitojun20020515:
3511.61Sitojun	sshd user/group has been added.  Need to hand add this in, or sshd
3521.61Sitojun	will not let you log in (with default, or UsePrivlegeSeparation=yes)
3531.61Sitojun
3541.61Sitojun	Add the following into /etc/group:
3551.61Sitojun
3561.61Sitojun	sshd:*:16:
3571.61Sitojun
3581.61Sitojun	and the following to /etc/master.passwd (via vipw):
3591.61Sitojun
3601.63Senami	sshd:*:16:16::0:0:& pseudo-user:/var/chroot/sshd:/sbin/nologin
3611.61Sitojun	
3621.79Swiz	Also /var/chroot/sshd directory needs to be present (digged as part of
3631.79Swiz	the build process).
3641.60Ssommerfe
3651.60Ssommerfe20020426:
3661.60Ssommerfe	NBUILDJOBS obsoleted in favor of just using -j.
3671.59Slukem
3681.59Slukem20020426:
3691.59Slukem	etc/postinstall added, which performs various checks for 
3701.59Slukem	configuration file updates and changes, and can fix most of
3711.59Slukem	the problems identified.
3721.59Slukem	This should make it much easier to upgrade a system's
3731.59Slukem	configuration from earlier systems (as far back as NetBSD 1.5).
3741.56Slukem
3751.56Slukem20020320:
3761.79Swiz	<bsd.lib.mk> needs a new install(1) for its "-a cmd" support.
3771.79Swiz	Build and install at usr.bin/xinstall before the build.
3781.56Slukem
3791.55Sitojun20020319:
3801.79Swiz	Raw IPv6 socket now makes strict checking for sa_family and sa_len
3811.79Swiz	on send(2) operation.  Be sure to have sbin/rtsol and usr.sbin/rtsold
3821.55Sitojun	newer than November 2001 when you upgrade the kernel.
3831.55Sitojun
3841.54Sitojun20020311:
3851.54Sitojun	ssh configuration files were moved from /etc to /etc/ssh.  Beware
3861.54Sitojun	if you restart your machine from remote.  Note that sshd.conf needs
3871.54Sitojun	to be changed (due to the use of "/etc" inside).
3881.54Sitojun
3891.54Sitojun20020223:
3901.53Smatt	Users of the VAX port will need to rebuild and install gas
3911.53Smatt	so it deal with the now present register prefix used in all
3921.53Smatt	the VAX assembly files.
3931.53Smatt
3941.50Sitojun20020118:
3951.50Sitojun	ntpd user/group has been added.  Need to hand add this in or builds
3961.50Sitojun	will break as mtree aborts early.
3971.50Sitojun
3981.50Sitojun	Add the following into /etc/group:
3991.50Sitojun
4001.50Sitojun	ntpd:*:15:
4011.50Sitojun
4021.50Sitojun	and the following to /etc/master.passwd (via vipw):
4031.50Sitojun
4041.50Sitojun	ntpd:*:15:15::0:0:Ntpd pseudo-user:/var/chroot/ntpd:/sbin/nologin
4051.50Sitojun
4061.49Sjmc20011207:
4071.49Sjmc	If you're attempting to build a snapshot on sparc64 and are getting
4081.49Sjmc	reloc errors from the toolchain groff binary this means your native
4091.49Sjmc	toolchain has some broken C++ bits.
4101.49Sjmc
4111.49Sjmc	To fix:
4121.49Sjmc
4131.49Sjmc	Build a new toolchain (i.e. build.sh -t)
4141.49Sjmc	Use the new toolchain to build and install natively (i.e. /usr/lib)
4151.49Sjmc
4161.49Sjmc	gnu/lib/libgcc
4171.51Spooka	gnu/lib/libstdc++
4181.49Sjmc
4191.49Sjmc	After this a snapshot will be able to be built.
4201.49Sjmc
4211.47Sjmc20011201:
4221.47Sjmc	In order for a sparc64 build to work you must have a working awk. If
4231.47Sjmc	you've built and installed a system with the new toolchain up to this
4241.52Swiz	point you do not have a working awk as its ability to do floating
4251.47Sjmc	point is broken. 
4261.47Sjmc
4271.47Sjmc	To build:
4281.47Sjmc
4291.47Sjmc	remake and install gnu/lib/libgcc
4301.47Sjmc	remake and install gnu/usr.bin/gawk into /usr/bin (make sure it links
4311.48Sjmc	against the new libgcc.a)
4321.47Sjmc
4331.46Sthorpej20011128:
4341.46Sthorpej	Kernel config information was changed to use defflag in
4351.46Sthorpej	the various "files" files.  Bug fixes to config(8) are
4361.46Sthorpej	required in order for this to work properly.  Make sure
4371.46Sthorpej	to build and install in usr.sbin/config before attempting
4381.46Sthorpej	to build a new kernel.
4391.46Sthorpej
4401.45Syamt20011030:
4411.45Syamt	libc/locale/wcstod.c now needs new lint(1). Update lint(1)
4421.45Syamt	before building libc.
4431.43Smason
4441.44Stv20011029:
4451.44Stv	The new document BUILDING.mdoc (view with nroff | more, or
4461.44Stv	see pre-generated .txt and .html versions) describes the build
4471.44Stv	procedure in great detail.  BUILDING, and the USE_NEW_TOOLCHAIN
4481.44Stv	build process, are intended in the long run to replace this
4491.44Stv	manual update log.
4501.44Stv
4511.44Stv	Users building a USE_NEW_TOOLCHAIN system should read the
4521.44Stv	BUILDING document for caveats.  Generally, BUILDING supersedes
4531.44Stv	UPDATING for these systems, as tool updating is taken care of
4541.44Stv	by the new build system.
4551.42Sperry
4561.42Sperry20011028:
4571.42Sperry	src/etc/Makefile now needs install to be able to handle
4581.42Sperry	symlinks that point to nowhere. A bug in install that
4591.42Sperry	prevented this was corrected.
4601.42Sperry
4611.42Sperry	Solution: update and reinstall usr.bin/xinstall
4621.42Sperry	Better Solution: Use the new toolchain and it will just work
4631.42Sperry	for you.
4641.40Slukem
4651.40Slukem20011006:
4661.40Slukem	/etc/mtree/NetBSD.dist has been updated to take advantage of
4671.40Slukem	absolute path support added to mtree(8). Older mtree(8)s don't
4681.40Slukem	understand the format.
4691.40Slukem
4701.40Slukem	Solution: update and reinstall usr.sbin/mtree
4711.39Sjmc
4721.39Sjmc20011004:
4731.39Sjmc	Crunchgen has been updated to work via reach-over makefiles. Updating
4741.39Sjmc	is suggested before running a snapshot build
4751.36Stv
4761.35Sthorpej20010915:
4771.35Sthorpej	The new "ubcperf" code committed by Chuck Silvers removed
4781.35Sthorpej	a header file, uvm/uvm_vnode.h.  There may be stale .depend
4791.35Sthorpej	files that still reference this file.
4801.35Sthorpej
4811.35Sthorpej	Solution: "make cleandir && make dependall" in affected
4821.35Sthorpej	directories.
4831.31Senami
4841.31Senami20010803:
4851.31Senami	grep.info is now built from grep.texi using makeinfo.  Since it
4861.31Senami	requires makeinfo v4.0, you need to install new texinfo before
4871.31Senami	building gnu/usr.bin/grep.  To install new texinfo, please follow
4881.31Senami	the instruction described in 20010726 entry.
4891.30Senami
4901.64Ssommerfe20010803: 
4911.41Swiz	(i386 only): i386 kernel now uses new instructions like
4921.111Ssimonb	`fxsave' which old gas doesn't understand.  To build the
4931.64Ssommerfe	kernel successfully, you need to build and install a new toolchain, 
4941.64Ssommerfe	(i.e., build.sh -t) or 	(temporarily) comment out "options I686_CPU" 
4951.64Ssommerfe	from your kernel configuration until you rebuild your userland.
4961.64Ssommerfe	See 20011029 above and BUILDING file in this directory for more information.
4971.64Ssommerfe	[updated 20020630 since i386 gas moved when USE_NEW_TOOLCHAIN enabled]
4981.29Sbjh21
4991.29Sbjh2120010731:
5001.29Sbjh21	Bootloader update on ELF platforms.  DDB in kernels from before
5011.29Sbjh21	this will be unable to read symbol tables provided by newer
5021.29Sbjh21	bootloaders.
5031.27Sassar
5041.27Sassar20010726:
5051.27Sassar	Texinfo was updated to 4.0.  To avoid failures when trying to
5061.28Sassar	build the included texinfo files, do:
5071.28Sassar
5081.28Sassar	cd src/gnu/usr.bin/texinfo
5091.28Sassar	make MKINFO=no dependall install
5101.25Sthorpej
5111.25Sthorpej20010718:
5121.25Sthorpej	Enabled correct .init/.fini processing in crt0.  The way this
5131.25Sthorpej	was done was to change a -I directive to cc(1), which means
5141.25Sthorpej	make(1) will have a stale dependency (it will be checking the
5151.25Sthorpej	timestamp on the wrong "dot_init.h").
5161.25Sthorpej
5171.25Sthorpej	The symptom you will see is that new programs die with SIGSEGV
5181.25Sthorpej	if you have a stale dependency.
5191.25Sthorpej
5201.25Sthorpej	Solution: "make cleandir" in both lib/csu and libexec/ld.elf_so
5211.25Sthorpej	before starting your build.
5221.26Sthorpej
5231.26Sthorpej20010628:
5241.26Sthorpej	A construct was added to uvm_page.h that uncovered a bug
5251.26Sthorpej	in lint(1).  If you get a warning/error about a non-portable
5261.26Sthorpej	bitfield, update your lint(1) before proceeding.
5271.21Sjmc
5281.21Sjmc20010226:
5291.22Sjmc	Added named user/group to system. Need to hand add this in or builds
5301.21Sjmc	will break as mtree aborts early.
5311.21Sjmc
5321.21Sjmc	To work around add by hand:
5331.21Sjmc
5341.21Sjmc	named:*:14:
5351.21Sjmc
5361.22Sjmc	to /etc/group and add:
5371.22Sjmc
5381.22Sjmc	named:*:14:14::0:0:Named pseudo-user:/var/named:/sbin/nologin
5391.22Sjmc
5401.22Sjmc	to master.passwd (use vipw for instance if doing by hand).
5411.22Sjmc
5421.22Sjmc	Now a make build should progress.
5431.18Sjmc
5441.18Sjmc20010219:
5451.52Swiz	get/setprogname() added. Any hostprogs that may use this will need
5461.111Ssimonb	to be bootstrapped manually until the host system is current.
5471.18Sjmc
5481.111Ssimonb	Known problems: sys/arch/macppc/stand/fixcoff
5491.19Scgd			usr.sbin/config (adding -DMAKE_BOOTSTRAP to
5501.19Scgd			  CFLAGS and rebuilding should work)
5511.20Sjmc			usr.sbin/mdsetimage - Build a static copy if
5521.111Ssimonb			  building a snapshot before fully bootstrapped.
5531.15Schristos
5541.15Schristos20010204:
5551.15Schristos	prepare the code to compile with stricter gcc flags. in
5561.15Schristos	particular start eliminating redundant declarations. Yacc
5571.15Schristos	needs to be installed before make build.
5581.10Schristos
5591.10Schristos20010114:
5601.10Schristos	introduce .if commands(target) in make(1). You need to
5611.10Schristos	bring everything up-to-date first, then without installing
5621.23Stron	anything make and install in usr.bin/make, then proceed
5631.10Schristos	with make build.
5641.9Ssommerfe
5651.9Ssommerfe20010101:
5661.9Ssommerfe	bsd.subdir.mk committed 20001230 had a bug which caused
5671.9Ssommerfe	afterinstall targets to run too soon; update again.
5681.8Ssommerfe
5691.8Ssommerfe20001230:
5701.8Ssommerfe	New share/mk files needed to support .WAIT in SUBDIR variables.
5711.8Ssommerfe	If you get make errors, 
5721.8Ssommerfe		(cd share/mk; make install)
5731.8Ssommerfe	Also, PRINTOBJDIR has changed and is now used more heavily.
5741.6Sad
5751.6Sad20001019:
5761.7Sad	The `ca' device driver has been replaced by `ld'; although the
5771.6Sad	major and minor numbers haven't changed, you should update your /dev
5781.6Sad	directory.
5791.1Sabs
5801.4Sitojun20000929:
5811.4Sitojun	The following make directives are obsoleted.
5821.4Sitojun	MKCRYPTO_RSA NOCRYPTO_RSA NOCRYPTO_RC5 NOCRYPTO_IDEA 
5831.4Sitojun	By default, RSA is built into libcrypto.  IDEA and RC5 will not be
5841.16Swiz	built into libcrypto.  By using MKCRYPTO_{RC5,IDEA}, you can build
5851.4Sitojun	additional library libcrypto_{idea,rc5}.
5861.1Sabs
5871.1Sabs
5881.1SabsHints for a more successful build:
5891.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
5901.2Smrg    Build a new kernel first:
5911.2Smrg	This makes sure that any new system calls or features
5921.2Smrg	   expected by the new userland will be present.  This
5931.2Smrg	   helps to avoid critical errors when upgrading.
5941.1Sabs    Use object directories:
5951.1Sabs	This helps to keep stale object
5961.1Sabs	   files from polluting the build if a Makefile "forgets"
5971.1Sabs	   about one.  It also makes it easier to clean up after
5981.1Sabs	   a build.  It's also necessary if you want to use the
5991.1Sabs	   same source tree for multiple machines.
6001.1Sabs	   To use object directories:
6011.1Sabs	    a) cd /usr/src ; make cleandir
6021.2Smrg	    b) Add "OBJMACHINE=yes" to /etc/mk.conf
6031.2Smrg	    c) Add "MKOBJDIRS=yes" to /etc/mk.conf
6041.1Sabs	    d) cd /usr/src ; make build
6051.2Smrg	   Note that running "make obj" in a directory will create
6061.2Smrg	   in obj.$MACHINE directory.
6071.1Sabs    Build to a DESTDIR:
6081.1Sabs	This helps to keep old
6091.1Sabs	   installed files (especially libraries) from interfering
6101.1Sabs	   with the new build.
6111.1Sabs	   To build to a DESTDIR, set the DESTDIR environment
6121.2Smrg	   variable before running make build.  It should be set to
6131.2Smrg	   the pathname of an initially empty directory.
6141.1Sabs	   Problems: you might need to update critical utilities
6151.1Sabs		without using DESTDIR since nothing is executed
6161.1Sabs		from what is installed in DESTDIR.
6171.1Sabs		(See critical utils, below)
6181.1Sabs    Build often:
6191.1Sabs	This keeps critical utilities current enough to not choke
6201.1Sabs	on any other part of the source tree that depends on up to
6211.1Sabs	date functionality.
6221.1Sabs 
6231.1SabsWhat to do if things don't work:
6241.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
6251.1SabsWhen things don't work there is usually a few things that commonly
6261.1Sabsshould be done.
6271.1Sabs    1)	make includes
6281.1Sabs	This should be done automatically by make build.
6291.1Sabs    2)  cd share/mk && make install
6301.1Sabs	Again, automatically done by make build.
6311.1Sabs
6321.1SabsFailsafe rebuild of a small part of the tree:
6331.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
6341.1SabsTo make sure you rebuild something correctly you want to do
6351.1Sabssomething like the following:
6361.1Sabs    1)  Make sure the includes and .mk files are up to date.
6371.1Sabs    2)  Make sure any program used to build the particular
6381.1Sabs	utility is up to date.  (yacc, lex, etc...)
6391.1Sabs    3)  cd ...path/to/util...
6401.1Sabs	make cleandir
6411.1Sabs	rm ...all obj directories...
6421.1Sabs	make cleandir			# yes, again
6431.1Sabs	make obj
6441.1Sabs	make depend && make
6451.1Sabs
6461.1SabsFailsafe rebuild of the entire tree:
6471.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
6481.1SabsIf you really want to make sure the source tree is clean and
6491.2Smrgready for a build try the following.  Note that sourcing /etc/mk.conf
6501.2Smrg(a make(1) Makefile) in this manner is not right, and will not work
6511.2Smrgfor anyone who uses any make(1) features in /etc/mk.conf.
6521.1Sabs
6531.1Sabs---cut here---
6541.1Sabs#!/bin/sh
6551.1Sabs. /etc/mk.conf
6561.1Sabs
6571.58Slukemif [ -z $NETBSDSRCDIR ] ; then
6581.58Slukem    NETBSDSRCDIR=/usr/src
6591.1Sabsfi
6601.58Slukemif [ \! -d $NETBSDSRCDIR ] ; then
6611.1Sabs    echo Unable to find sources
6621.1Sabs    exit 1
6631.1Sabsfi
6641.58Slukemfind $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \;
6651.1Sabs
6661.1Sabsif [ -z $BSDOBJDIR ] ; then
6671.1Sabs    BSDOBJDIR=/usr/obj
6681.1Sabsfi
6691.1Sabsif [ -d $BSDOBJDIR ] ; then
6701.1Sabs    rm -rf $BSDOBJDIR
6711.1Sabsfi
6721.1Sabs
6731.58Slukemcd $NETBSDSRCDIR && make cleandir
6741.1Sabs
6751.1Sabs---cut here---
6761.1Sabs
6771.1SabsCritical utilities:
6781.1Sabs^^^^^^^^^^^^^^^^^^^
6791.1Sabs	gnu/usr.bin/egcs
6801.3Sitojun	usr.bin/compile_et
6811.1Sabs	usr.bin/make
6821.1Sabs	usr.bin/yacc
6831.1Sabs	usr.bin/lex
6841.11Slukem	usr.bin/xlint
6851.2Smrg	usr.sbin/config
6861.1Sabs
6871.34SsimonbOther problems and possible solutions:
6881.1Sabs^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
6891.1SabsSymptom:Unreasonable compiler errors.
6901.1SabsFix:	Rebuild gnu/usr.bin/egcs
6911.1Sabs
6921.1SabsSymptom:Complaints involving a Makefile.
6931.17SerhFix:	Rebuild usr.bin/make:
6941.17Serh	cd usr.bin/make && make && make install
6951.111Ssimonb	Or, a failsafe method if that doesn't work:
6961.17Serh	cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin
6971.17Serh
6981.1SabsFix:	Make sure .mk files are up to date.
6991.1Sabs	cd share/mk && make install
7001.2Smrg
7011.2SmrgSymptom:Kernel `config' fails to configure any kernel, including GENERIC.
7021.2SmrgFix:	Rebuild usr.sbin/config
7031.1Sabs
7041.1SabsSymptom:
7051.1SabsFix:	Rebuild usr.bin/yacc
7061.1Sabs
7071.1SabsSymptom:
7081.1SabsFix:	Rebuild usr.bin/lex
7091.1Sabs
7101.1SabsSymptom:
7111.1SabsFix:	rm /usr/lib/libbfd.a
7121.4Sitojun
7131.4SitojunSymptom:Obsolete intermediate files are used during compilation
7141.4SitojunFix:	Try the following sequence of commands in the directory in question.
7151.4Sitojun	make cleandir; rm `make print-objdir`; make cleandir; make obj
7161.4Sitojun	(If you built the tree without "make obj" in the past, obsolete files
7171.4Sitojun	may remain.  The command tries to clean everything up)
7181.5Swiz
7191.5SwizSymptom:.../sysinst/run.c:xx: warning: initialization from incompatible pointer type
7201.5SwizFix:	Rebuild and install usr.bin/menuc
7211.12Sitojun
7221.12SitojunSymptom:mklocale not found during build in share/locale/ctype
7231.12SitojunFix:	Build and install usr.bin/mklocale
7241.13Sdogcow
7251.86SkleinkSymptom:undefined reference to `__assert13' or `__unsetenv13'
7261.13SdogcowFix:    Rebuild and install lib/libc
7271.13Sdogcow
7281.19ScgdSymptom:usr.sbin/config fails to build.
7291.19ScgdFix:	Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile.
7301.13Sdogcow
7311.19ScgdSymptom:undefined reference to `getprogname' or `setprogname'
7321.19ScgdFix:    Rebuild and install lib/libc
7331.24Sabs
7341.24SabsSymptom:lint does not understand the '-X' option
7351.24SabsFix:    May need to build & install libs with NOLINT=1 before rebuilding lint
736