Home | History | Annotate | Line # | Download | only in src
UPDATING revision 1.122
      1  1.122    itojun $NetBSD: UPDATING,v 1.122 2004/05/31 00:18:58 itojun Exp $
      2    1.1       abs 
      3    1.1       abs This file is intended to be a brief introduction to the build
      4    1.1       abs process and a reference on what to do if something doesn't work.
      5    1.1       abs 
      6    1.1       abs For a more detailed description see Makefile.
      7    1.1       abs 
      8    1.1       abs Recent changes:
      9    1.1       abs ^^^^^^^^^^^^^^^
     10   1.99       mrg 
     11  1.121     lukem 20040516:
     12  1.121     lukem 	The end-user modifiable X11 configuration has been moved
     13  1.121     lukem 	from /usr/X11R6/lib/X11/<dir> to /etc/X11/<dir>.
     14  1.121     lukem 	Ensure that src and xsrc is up to date, and run
     15  1.121     lukem 	"make cleandir" in src/x11 before your next build.
     16  1.121     lukem 
     17  1.119    atatat 20040426:
     18  1.119    atatat 	Support for the original dynamic sysctl node structure has
     19  1.119    atatat 	been removed in favor of the newer layout.  This affects
     20  1.119    atatat 	consumers of the create and delete interface, as well as
     21  1.119    atatat 	the dynamic discovery mechanism.  This is believed only to
     22  1.119    atatat 	be the sysctl(8) binary itself, at this point in time, so
     23  1.119    atatat 	the only effect of this should be that a sysctl binary
     24  1.119    atatat 	built from sources dated between 2003/12/04 and 2004/03/24
     25  1.119    atatat 	will not work on a kernel built from sources dated after
     26  1.119    atatat 	2004/04/25.  If you need a new sysctl binary but build.sh
     27  1.119    atatat 	does not work, make sure that your revision of
     28  1.120    atatat 	src/sys/sys/sysctl.h is 1.112 (or later), and then the
     29  1.120    atatat 	do the following:
     30  1.119    atatat 
     31  1.120    atatat 	cd /usr/src (or wherever your source tree is)
     32  1.120    atatat 	make USETOOLS=no includes
     33  1.120    atatat 	cd lib/libc
     34  1.120    atatat 	make USETOOLS=no dependall install
     35  1.120    atatat 	cd ../../sbin/sysctl
     36  1.119    atatat 	make USETOOLS=no dependall install
     37  1.119    atatat 
     38  1.122    itojun 	If you are using older sysctl binary, GNU autoconf would fail to
     39  1.122    itojun 	identify your machine architecture, and tries to build binary for
     40  1.122    itojun 	"unknown-unknown-netbsd20F" or something like that.  if that happens,
     41  1.122    itojun 	make sure to follow the above steps.
     42  1.122    itojun 
     43  1.118       dbj 20040425:
     44  1.118       dbj 	The ffs superblock issues listed below under 20040109 and 20030402
     45  1.118       dbj 	are now automatically addressed by the /etc/rc.d/fixsb script or by
     46  1.118       dbj 	sysinst when it checks a a filesystem. The manual fsck_ffs -b16 -c4
     47  1.118       dbj 	invocation mentioned below will continue to work and is now
     48  1.118       dbj 	automated by those scripts.  Note that under certain circumstances,
     49  1.118       dbj 	affected filesystems upgraded to a -current kernel first before
     50  1.118       dbj 	upgrading their userland with the fixsb and fsck_ffs fixes may
     51  1.118       dbj 	encounter a 'freeing free inode' panic when writing to the affected
     52  1.118       dbj 	filesystem, so it is a good idea to repair the filesystem as soon as
     53  1.118       dbj 	possible.  For more details on the fixsb script, see pr install/25138.
     54  1.118       dbj 
     55  1.115  christos 20040418:
     56  1.121     lukem 	statfs(2) and friends have been replaced with statvfs(2). Before
     57  1.115  christos 	installing a newly build userland make sure that you are running
     58  1.115  christos 	a newly built kernel with COMPAT_20 set. In addition your libc
     59  1.115  christos 	build might not work (undefined SYS_statfs symbol) because make
     60  1.115  christos 	clean does not know how to remove files it does not know about
     61  1.116  christos 	anymore. Manually remove all generated .S sources and objects
     62  1.116  christos 	from the libc build directory.
     63  1.115  christos 
     64  1.114       jmc 20040326:
     65  1.114       jmc 	The method by which athhal-elf.o gets pulled into i386 kernel builds
     66  1.117       jmc 	has been changed. The file is now stored as a uuencoded file in CVS
     67  1.114       jmc 	and the generated Makefile will use the new .uue rules from bsd.file.mk
     68  1.114       jmc 	to build it.
     69  1.114       jmc 
     70  1.114       jmc 	This means you must have the latest bsd.files.mk installed when
     71  1.114       jmc 	building a kernel without USETOOLS=yes.
     72  1.114       jmc 
     73  1.113       dan 20040318:
     74  1.113       dan 	A bug in the cgd(4) blowfish code was corrected, without
     75  1.113       dan 	provision of backwards compatibility, after several public
     76  1.113       dan 	notices over several months. Users of cgd with blowfish cipher
     77  1.113       dan 	ONLY must dump their data before updating their kernels, and
     78  1.113       dan 	recreate cgd's and restore data using the new kernel. See
     79  1.113       dan 	(recent message to current-users, URL when mail-index has updated)
     80  1.113       dan 
     81  1.108     bjh21 20040313:
     82  1.108     bjh21 	On acorn32, the opms and qms drivers have been withdrawn, and
     83  1.108     bjh21 	the old wsqms driver is now called qms.  Kernel config files
     84  1.108     bjh21 	will need updating.  See the ones in sys/arch/acorn32/conf
     85  1.108     bjh21 	for examples.
     86  1.108     bjh21 
     87  1.106     bjh21 20040125:
     88  1.106     bjh21 	On acorn32, the beep and sysbeep devices are no longer
     89  1.106     bjh21 	needed, and will need to be deleted from kernel configuration
     90  1.106     bjh21 	files.
     91  1.105     bjh21 
     92  1.102       dbj 20040109:
     93  1.102       dbj 	Compatibility for old ffs superblock layouts has been
     94  1.102       dbj 	added, and the restrictive fsck checks have been reenabled
     95  1.102       dbj 	when using those layouts.  If you have been using -current
     96  1.102       dbj 	since 20030402, you may find that fsck again signals fatal
     97  1.110       dbj 	superblock mismatches.  To repair, make sure you have
     98  1.111    simonb 	an updated fsck_ffs and then you can use fsck_ffs -b 16 -c 4
     99  1.109       dbj 	to complete the filesystem upgrade.  A message has
    100  1.111    simonb 	been added to the kernel which should detect this problem.
    101  1.111    simonb 	See the following discussion for more information:
    102  1.112    keihan 	http://mail-index.NetBSD.org/current-users/2004/01/11/0022.html
    103  1.102       dbj 
    104   1.99       mrg 20031203:
    105  1.100    keihan 	New binutils builds may fail due to old dependencies.
    106   1.99       mrg 	It's necessary to "make cleandir" to ensure that
    107   1.99       mrg 	the dependencies will be rebuilt correctly.
    108   1.98       wiz 
    109   1.98       wiz 20031111:
    110   1.98       wiz 	A newer mkdep is needed.  Error noting that is
    111   1.98       wiz 		cc: Ambiguous abbreviation --
    112   1.97     lukem 
    113   1.97     lukem 20031008:
    114   1.97     lukem 	/usr/include/sys/disklabel_mbr.h was removed.
    115   1.97     lukem 	It's necessary to "make cleandir" to ensure that
    116   1.97     lukem 	the dependencies will be rebuilt correctly.
    117   1.96  christos 
    118  1.109       dbj 20031007:
    119  1.111    simonb 	A sign exension bug was fixed which set all the high bits
    120  1.111    simonb 	of our newly expanded ffs fs_flags.  This should only
    121  1.111    simonb 	affect users who installed or upgraded in September of 2003.
    122  1.109       dbj 	A small utility program was posted to tech-kern which
    123  1.111    simonb 	should fix this problem, and a warning message was added
    124  1.111    simonb 	to the kernel which should discover and warn about it.  See
    125  1.111    simonb 	http://mail-index.NetBSD.org/tech-kern/2003/10/07/0005.html
    126  1.109       dbj 
    127   1.96  christos 20030906:
    128   1.96  christos 	With the addition of siginfo support the old signal trampoline
    129   1.96  christos 	code has been deprecated to COMPAT_16. Make sure that your running
    130   1.96  christos 	kernel has COMPAT_16 enabled before building userland.
    131   1.94  christos 
    132   1.94  christos 20030801:
    133   1.95       wiz 	With the new openssl, there is some header and library shuffling.
    134   1.94  christos 	rm -f /usr/include/des.h /usr/include/kerberosIV/* /lib/libdes* \
    135   1.95       wiz 	/usr/lib/libdes* before building.
    136   1.92       wiz 
    137   1.92       wiz 20030703:
    138   1.92       wiz 	Texinfo was updated to 4.6.  To avoid failures when trying to
    139   1.92       wiz 	build the included texinfo files, do:
    140   1.92       wiz 
    141   1.92       wiz 	cd src/gnu/usr.bin/texinfo
    142   1.92       wiz 	make MKINFO=no dependall install
    143   1.90       wiz 
    144   1.90       wiz 20030630:
    145  1.101  junyoung 	Groff was updated to 1.19; it's probably necessary to do
    146   1.91       wiz 		cd share/mk && make install
    147   1.90       wiz 		cd src/gnu/usr.bin/groff
    148   1.90       wiz 		make MKMAN=no dependall install
    149   1.90       wiz 	(untested).
    150   1.89  christos 
    151   1.89  christos 20030516:
    152   1.89  christos 	Due to bugs in the export handling code, invalid export lines
    153   1.89  christos 	were accepted before and caused the kernel to panic when
    154   1.89  christos 	mountd got restarted because it freed memory that had already
    155   1.89  christos 	been freed. This has been fixed and the kernel checks
    156   1.89  christos 	export addresses very strictly. If you upgrade your kernel,
    157   1.89  christos 	make sure you also upgrade mountd, because if your export
    158   1.89  christos 	file contains lines with an old inet4 address syntax (i.e.
    159   1.89  christos 	a.b.c or a.b or a), they will get rejected by the new kernel.
    160   1.87     bjh21 
    161   1.87     bjh21 20030402:
    162   1.87     bjh21 	The superblock layout for FFS was changed.  If you have 1.6
    163   1.87     bjh21 	fsck binaries, they will signal a fatal superblock mismatch
    164   1.87     bjh21 	with the first alternate, because they compare too many
    165   1.87     bjh21 	fields (even ones that aren't useful).  If possible, upgrade
    166   1.87     bjh21 	your fsck_ffs binary before using a new kernel.
    167   1.87     bjh21 	None of this signals actual filesystem damage.
    168   1.85    atatat 
    169   1.85    atatat 20030324:
    170   1.85    atatat 	sendmail version 8.12.8 was imported.  Since sendmail is
    171   1.85    atatat 	now setgid to the smmsp group, and runs in "collection"
    172   1.85    atatat 	mode for most common activities, there is a new config
    173   1.85    atatat 	file called submit.cf that needs to live in /etc/mail.
    174   1.85    atatat 	The generic submit.cf sample in /usr/share/sendmail/cf
    175   1.85    atatat 	is named netbsd-msp.cf.  Upgrading your regular sendmail
    176   1.85    atatat 	configuration file is also strongly advised.
    177   1.85    atatat 
    178   1.85    atatat 	See the section named "MESSAGE SUBMISSION PROGRAM" in
    179   1.85    atatat 	the updated /usr/share/sendmail/README file for more
    180   1.85    atatat 	information.
    181   1.82       wiz 
    182   1.82       wiz 20030117:
    183   1.82       wiz 	Texinfo was updated to 4.3.  To avoid failures when trying to
    184   1.82       wiz 	build the included texinfo files, do:
    185   1.82       wiz 
    186   1.82       wiz 	cd src/gnu/usr.bin/texinfo
    187   1.82       wiz 	make MKINFO=no dependall install
    188   1.81     lukem 
    189   1.81     lukem 20021223:
    190   1.81     lukem 	The METALOG format changed slightly, to remove the leading
    191   1.81     lukem 	"${DESTDIR}" from path names.
    192   1.81     lukem 	This only affects people building with UNPRIVED.
    193   1.81     lukem 	For complete safety, remove the DESTDIR entirely and
    194   1.81     lukem 	update tools/mtree, before running make build.
    195   1.88    itojun 
    196   1.88    itojun 20021219:
    197   1.88    itojun 	CVS repository layout was changed.  See the following for details
    198   1.88    itojun 	if you are using (anonymous) cvs to update your tree.
    199   1.88    itojun 
    200   1.93      salo 	http://mail-index.NetBSD.org/netbsd-announce/2002/12/19/0000.html
    201   1.80     lukem 
    202   1.80     lukem 20021219:
    203   1.80     lukem 	install(1) had a '-N dbdir' option added, to specify an
    204   1.80     lukem 	alternate location to look up users & groups (instead
    205   1.80     lukem 	of the host system passwd(5) and group(5) databases).
    206   1.80     lukem 
    207   1.80     lukem 	The build system was modified to take advantage of
    208   1.80     lukem 	this option (using ${NETBSDSRCDIR}/etc), so if you
    209   1.83       kei 	use USETOOLS==no, you may have to rebuild and
    210   1.80     lukem 	reinstall usr.bin/xinstall first.
    211   1.78     lukem 
    212   1.78     lukem 20021130:
    213   1.78     lukem 	fparseln(3) moved from libutil to libc.
    214   1.78     lukem 	If building to DESTDIR=/, reinstall the includes
    215   1.78     lukem 	and rebuild libc:
    216   1.78     lukem 		make includes
    217   1.78     lukem 		make do-lib-libc
    218   1.78     lukem 	If using build.sh, "cd tools/compat && make clean"
    219   1.78     lukem 	before rebuilding the tools.
    220   1.77     lukem 
    221   1.77     lukem 20021126:
    222   1.77     lukem 	The mk.conf(5) variable SYS_INCLUDE has been deprecated,
    223   1.77     lukem 	including the optional "SYS_INCLUDE=symlinks" support.
    224   1.77     lukem 	All header files, including <sys/*.h> are copied into
    225   1.77     lukem 	/usr/include.
    226   1.76   thorpej 
    227   1.76   thorpej 20021121:
    228   1.76   thorpej 	The C run-time support files crtbegin.o and crtend.o
    229   1.76   thorpej 	(and their companions crtbeginS.o and crtendS.o) were
    230   1.76   thorpej 	split up, with new crti.o and crtn.o files resulting.
    231   1.76   thorpej 	This means that libtool needs to be rebuilt once the
    232   1.76   thorpej 	new libraries are installed.  The process of rebuilding
    233   1.76   thorpej 	libtool will cause it to automatically notice the new
    234   1.76   thorpej 	required files, but it *must* be rebuilt in order to
    235   1.76   thorpej 	do this.
    236   1.76   thorpej 
    237   1.76   thorpej 	An out-of-date libtool will result in shared libraries
    238   1.76   thorpej 	which lack _init() and _fini() routines, which means that
    239   1.76   thorpej 	their global contructors/destructors will not be invoked.
    240   1.75   thorpej 
    241   1.75   thorpej 20021121:
    242   1.75   thorpej 	A bug related to how ARM ELF objects were tagged has been
    243   1.75   thorpej 	corrected.
    244   1.75   thorpej 
    245   1.75   thorpej 	NetBSD ARM ELF uses the soft-VFP floating point model by
    246   1.75   thorpej 	default.  However, the assembler lacked support for marking
    247   1.75   thorpej 	objects as using the VFP floating point format, and the
    248   1.79       wiz 	compiler was not properly passing the flag indicating "soft-VFP"
    249   1.75   thorpej 	to the assembler.
    250   1.75   thorpej 
    251   1.75   thorpej 	Unfortunately, this means that the linker will now consider
    252   1.75   thorpej 	old (i.e. not marked "softvfp") NetBSD ARM ELF objects to be
    253   1.75   thorpej 	incompatible with new (properly marked) objects.
    254   1.75   thorpej 
    255   1.75   thorpej 	The problem will only manifest itself if you attempt to compile
    256   1.75   thorpej 	a new program using the fixed toolchain, and link that program
    257   1.75   thorpej 	against old libraries which do not have the proper "softvfp"
    258   1.75   thorpej 	markings.  ALL OF YOUR EXISTING BINARIES AND SHARED LIBRARIES
    259   1.75   thorpej 	WILL CONTINUE TO WORK PROPERLY.
    260   1.75   thorpej 
    261   1.75   thorpej 	The only work-around for the problem is to recompile all of
    262   1.75   thorpej 	the libraries on the system.  The easiest way to do this for
    263   1.79       wiz 	system libraries is to install a binary snapshot; they are
    264   1.93      salo 	generally available on releng.NetBSD.org.  Any packages you
    265   1.75   thorpej 	have installed which supply libraries will have to be recompiled
    266   1.75   thorpej 	if you wish to link new programs against those libraries.
    267   1.75   thorpej 
    268   1.75   thorpej 	If you have questions about this matter, please contact
    269   1.93      salo 	port-arm (a] NetBSD.org.
    270   1.73    provos 
    271   1.73    provos 20021011:
    272   1.73    provos 	Systrace has been improved to support privilege elevation.
    273   1.73    provos 	Updating the kernel requires the userland part of systrace
    274   1.79       wiz 	to be rebuilt.
    275   1.72   thorpej 
    276   1.72   thorpej 20021010:
    277   1.72   thorpej 	The config(8) grammar was changed to allow options to register
    278   1.72   thorpej 	dependencies on attributes, as well as other options.  Users
    279   1.72   thorpej 	must update and reinstall usr.sbin/config before building a new
    280   1.72   thorpej 	kernel.
    281   1.70   thorpej 
    282   1.70   thorpej 20021009:
    283   1.70   thorpej 	A new attribute dependency syntax was introduced to config(8),
    284   1.70   thorpej 	which is now used by the SCSI configuration description.  Users
    285   1.71       wiz 	must update and reinstall usr.sbin/config before building a new
    286   1.70   thorpej 	kernel.
    287   1.69   thorpej 
    288   1.69   thorpej 20021003:
    289   1.69   thorpej 	Several changes have been made to the autoconfiguration
    290   1.69   thorpej 	framework.  Users must update and reinstall usr.sbin/config
    291   1.69   thorpej 	before building a new kernel.
    292   1.74  jschauma 
    293   1.74  jschauma 20021001:
    294   1.74  jschauma 	The i386mp branch has been merged.  To compile a kernel, users
    295   1.74  jschauma 	will need to add the option 'cpu* at mainbus?' to their configuration
    296   1.74  jschauma 	file.  Multiprocessor kernels will need
    297   1.74  jschauma 	ioapic*		at mainbus? apid ?
    298   1.74  jschauma 	options		MULTIPROCESSOR
    299   1.74  jschauma 	options		COM_MPLOCK
    300   1.68     lukem 
    301   1.68     lukem 20020922:
    302   1.68     lukem 	MKDYNAMICROOT=yes enabled by default, which means that
    303   1.68     lukem 	certain shared libraries are installed into /lib, the shared
    304   1.68     lukem 	linker is installed into /libexec, and all programs in /bin
    305   1.68     lukem 	and /sbin are dynamically linked.
    306   1.68     lukem 	If you do not use "make build", you should ensure that
    307   1.68     lukem 	you have the libraries and shared linker in the new locations,
    308   1.68     lukem 	with:
    309   1.68     lukem 		make do-lib-csu do-lib-libc do-lib do-gnu-lib do-ld.elf_so
    310   1.67     lukem 
    311   1.67     lukem 20020917:
    312   1.67     lukem 	USE_NEW_TOOLCHAIN has been replaced with:
    313   1.67     lukem 	    -	TOOLCHAIN_MISSING -- set to "yes" on platforms for which
    314   1.67     lukem 		there is no working in-tree toolchain (hppa, ns32k, sh5,
    315   1.67     lukem 		x86_64).
    316   1.67     lukem 	    -	EXTERNAL_TOOLCHAIN -- if defined by the user, points to the
    317   1.79       wiz 		root of an external toolchain (e.g. /usr/local/gnu).  This
    318   1.67     lukem 		enables the cross-build framework even for TOOLCHAIN_MISSING
    319   1.67     lukem 		platforms.
    320   1.66   gehenna 
    321   1.66   gehenna 20020906:
    322   1.66   gehenna 	gehenna-devsw has been merged into the trunk. Need to update and
    323   1.79       wiz 	reinstall usr.sbin/config before building the kernel.
    324   1.65     lukem 
    325   1.65     lukem 20020822:
    326   1.65     lukem 	Crunched rescue tools (contents of /bin and /sbin, plus others)
    327   1.65     lukem 	are now provided in /rescue.
    328   1.65     lukem 
    329   1.65     lukem 	To ensure that these are built statically linked (no matter
    330   1.65     lukem 	what the setting of LDSTATIC is), use a crunchgen(1) built
    331   1.65     lukem 	from sources newer than 20020820 (see the next entry).
    332   1.65     lukem 
    333   1.65     lukem 20020820:
    334   1.65     lukem 	crunchgen(1) changed to ensure that the generated program
    335   1.65     lukem 	is statically linked.
    336   1.65     lukem 
    337   1.65     lukem 	Solution: update and reinstall usr.bin/crunch
    338   1.84     grant 
    339   1.84     grant 20020605:
    340   1.84     grant 	smmsp user/group has been added for sendmail.
    341   1.84     grant 
    342   1.84     grant 	Add the following into /etc/group:
    343   1.84     grant 
    344   1.84     grant 	smmsp:*:17:
    345   1.84     grant 
    346   1.84     grant 	and the following to /etc/master.passwd (via vipw):
    347   1.84     grant 
    348   1.84     grant 	smmsp:*:17:17::0:0:Sendmail Message Submission Program:/nonexistent:/sbin/nologin
    349   1.61    itojun 
    350   1.61    itojun 20020515:
    351   1.61    itojun 	sshd user/group has been added.  Need to hand add this in, or sshd
    352   1.61    itojun 	will not let you log in (with default, or UsePrivlegeSeparation=yes)
    353   1.61    itojun 
    354   1.61    itojun 	Add the following into /etc/group:
    355   1.61    itojun 
    356   1.61    itojun 	sshd:*:16:
    357   1.61    itojun 
    358   1.61    itojun 	and the following to /etc/master.passwd (via vipw):
    359   1.61    itojun 
    360   1.63     enami 	sshd:*:16:16::0:0:& pseudo-user:/var/chroot/sshd:/sbin/nologin
    361   1.61    itojun 	
    362   1.79       wiz 	Also /var/chroot/sshd directory needs to be present (digged as part of
    363   1.79       wiz 	the build process).
    364   1.60  sommerfe 
    365   1.60  sommerfe 20020426:
    366   1.60  sommerfe 	NBUILDJOBS obsoleted in favor of just using -j.
    367   1.59     lukem 
    368   1.59     lukem 20020426:
    369   1.59     lukem 	etc/postinstall added, which performs various checks for 
    370   1.59     lukem 	configuration file updates and changes, and can fix most of
    371   1.59     lukem 	the problems identified.
    372   1.59     lukem 	This should make it much easier to upgrade a system's
    373   1.59     lukem 	configuration from earlier systems (as far back as NetBSD 1.5).
    374   1.56     lukem 
    375   1.56     lukem 20020320:
    376   1.79       wiz 	<bsd.lib.mk> needs a new install(1) for its "-a cmd" support.
    377   1.79       wiz 	Build and install at usr.bin/xinstall before the build.
    378   1.56     lukem 
    379   1.55    itojun 20020319:
    380   1.79       wiz 	Raw IPv6 socket now makes strict checking for sa_family and sa_len
    381   1.79       wiz 	on send(2) operation.  Be sure to have sbin/rtsol and usr.sbin/rtsold
    382   1.55    itojun 	newer than November 2001 when you upgrade the kernel.
    383   1.55    itojun 
    384   1.54    itojun 20020311:
    385   1.54    itojun 	ssh configuration files were moved from /etc to /etc/ssh.  Beware
    386   1.54    itojun 	if you restart your machine from remote.  Note that sshd.conf needs
    387   1.54    itojun 	to be changed (due to the use of "/etc" inside).
    388   1.54    itojun 
    389   1.54    itojun 20020223:
    390   1.53      matt 	Users of the VAX port will need to rebuild and install gas
    391   1.53      matt 	so it deal with the now present register prefix used in all
    392   1.53      matt 	the VAX assembly files.
    393   1.53      matt 
    394   1.50    itojun 20020118:
    395   1.50    itojun 	ntpd user/group has been added.  Need to hand add this in or builds
    396   1.50    itojun 	will break as mtree aborts early.
    397   1.50    itojun 
    398   1.50    itojun 	Add the following into /etc/group:
    399   1.50    itojun 
    400   1.50    itojun 	ntpd:*:15:
    401   1.50    itojun 
    402   1.50    itojun 	and the following to /etc/master.passwd (via vipw):
    403   1.50    itojun 
    404   1.50    itojun 	ntpd:*:15:15::0:0:Ntpd pseudo-user:/var/chroot/ntpd:/sbin/nologin
    405   1.50    itojun 
    406   1.49       jmc 20011207:
    407   1.49       jmc 	If you're attempting to build a snapshot on sparc64 and are getting
    408   1.49       jmc 	reloc errors from the toolchain groff binary this means your native
    409   1.49       jmc 	toolchain has some broken C++ bits.
    410   1.49       jmc 
    411   1.49       jmc 	To fix:
    412   1.49       jmc 
    413   1.49       jmc 	Build a new toolchain (i.e. build.sh -t)
    414   1.49       jmc 	Use the new toolchain to build and install natively (i.e. /usr/lib)
    415   1.49       jmc 
    416   1.49       jmc 	gnu/lib/libgcc
    417   1.51     pooka 	gnu/lib/libstdc++
    418   1.49       jmc 
    419   1.49       jmc 	After this a snapshot will be able to be built.
    420   1.49       jmc 
    421   1.47       jmc 20011201:
    422   1.47       jmc 	In order for a sparc64 build to work you must have a working awk. If
    423   1.47       jmc 	you've built and installed a system with the new toolchain up to this
    424   1.52       wiz 	point you do not have a working awk as its ability to do floating
    425   1.47       jmc 	point is broken. 
    426   1.47       jmc 
    427   1.47       jmc 	To build:
    428   1.47       jmc 
    429   1.47       jmc 	remake and install gnu/lib/libgcc
    430   1.47       jmc 	remake and install gnu/usr.bin/gawk into /usr/bin (make sure it links
    431   1.48       jmc 	against the new libgcc.a)
    432   1.47       jmc 
    433   1.46   thorpej 20011128:
    434   1.46   thorpej 	Kernel config information was changed to use defflag in
    435   1.46   thorpej 	the various "files" files.  Bug fixes to config(8) are
    436   1.46   thorpej 	required in order for this to work properly.  Make sure
    437   1.46   thorpej 	to build and install in usr.sbin/config before attempting
    438   1.46   thorpej 	to build a new kernel.
    439   1.46   thorpej 
    440   1.45      yamt 20011030:
    441   1.45      yamt 	libc/locale/wcstod.c now needs new lint(1). Update lint(1)
    442   1.45      yamt 	before building libc.
    443   1.43     mason 
    444   1.44        tv 20011029:
    445   1.44        tv 	The new document BUILDING.mdoc (view with nroff | more, or
    446   1.44        tv 	see pre-generated .txt and .html versions) describes the build
    447   1.44        tv 	procedure in great detail.  BUILDING, and the USE_NEW_TOOLCHAIN
    448   1.44        tv 	build process, are intended in the long run to replace this
    449   1.44        tv 	manual update log.
    450   1.44        tv 
    451   1.44        tv 	Users building a USE_NEW_TOOLCHAIN system should read the
    452   1.44        tv 	BUILDING document for caveats.  Generally, BUILDING supersedes
    453   1.44        tv 	UPDATING for these systems, as tool updating is taken care of
    454   1.44        tv 	by the new build system.
    455   1.42     perry 
    456   1.42     perry 20011028:
    457   1.42     perry 	src/etc/Makefile now needs install to be able to handle
    458   1.42     perry 	symlinks that point to nowhere. A bug in install that
    459   1.42     perry 	prevented this was corrected.
    460   1.42     perry 
    461   1.42     perry 	Solution: update and reinstall usr.bin/xinstall
    462   1.42     perry 	Better Solution: Use the new toolchain and it will just work
    463   1.42     perry 	for you.
    464   1.40     lukem 
    465   1.40     lukem 20011006:
    466   1.40     lukem 	/etc/mtree/NetBSD.dist has been updated to take advantage of
    467   1.40     lukem 	absolute path support added to mtree(8). Older mtree(8)s don't
    468   1.40     lukem 	understand the format.
    469   1.40     lukem 
    470   1.40     lukem 	Solution: update and reinstall usr.sbin/mtree
    471   1.39       jmc 
    472   1.39       jmc 20011004:
    473   1.39       jmc 	Crunchgen has been updated to work via reach-over makefiles. Updating
    474   1.39       jmc 	is suggested before running a snapshot build
    475   1.36        tv 
    476   1.35   thorpej 20010915:
    477   1.35   thorpej 	The new "ubcperf" code committed by Chuck Silvers removed
    478   1.35   thorpej 	a header file, uvm/uvm_vnode.h.  There may be stale .depend
    479   1.35   thorpej 	files that still reference this file.
    480   1.35   thorpej 
    481   1.35   thorpej 	Solution: "make cleandir && make dependall" in affected
    482   1.35   thorpej 	directories.
    483   1.31     enami 
    484   1.31     enami 20010803:
    485   1.31     enami 	grep.info is now built from grep.texi using makeinfo.  Since it
    486   1.31     enami 	requires makeinfo v4.0, you need to install new texinfo before
    487   1.31     enami 	building gnu/usr.bin/grep.  To install new texinfo, please follow
    488   1.31     enami 	the instruction described in 20010726 entry.
    489   1.30     enami 
    490   1.64  sommerfe 20010803: 
    491   1.41       wiz 	(i386 only): i386 kernel now uses new instructions like
    492  1.111    simonb 	`fxsave' which old gas doesn't understand.  To build the
    493   1.64  sommerfe 	kernel successfully, you need to build and install a new toolchain, 
    494   1.64  sommerfe 	(i.e., build.sh -t) or 	(temporarily) comment out "options I686_CPU" 
    495   1.64  sommerfe 	from your kernel configuration until you rebuild your userland.
    496   1.64  sommerfe 	See 20011029 above and BUILDING file in this directory for more information.
    497   1.64  sommerfe 	[updated 20020630 since i386 gas moved when USE_NEW_TOOLCHAIN enabled]
    498   1.29     bjh21 
    499   1.29     bjh21 20010731:
    500   1.29     bjh21 	Bootloader update on ELF platforms.  DDB in kernels from before
    501   1.29     bjh21 	this will be unable to read symbol tables provided by newer
    502   1.29     bjh21 	bootloaders.
    503   1.27     assar 
    504   1.27     assar 20010726:
    505   1.27     assar 	Texinfo was updated to 4.0.  To avoid failures when trying to
    506   1.28     assar 	build the included texinfo files, do:
    507   1.28     assar 
    508   1.28     assar 	cd src/gnu/usr.bin/texinfo
    509   1.28     assar 	make MKINFO=no dependall install
    510   1.25   thorpej 
    511   1.25   thorpej 20010718:
    512   1.25   thorpej 	Enabled correct .init/.fini processing in crt0.  The way this
    513   1.25   thorpej 	was done was to change a -I directive to cc(1), which means
    514   1.25   thorpej 	make(1) will have a stale dependency (it will be checking the
    515   1.25   thorpej 	timestamp on the wrong "dot_init.h").
    516   1.25   thorpej 
    517   1.25   thorpej 	The symptom you will see is that new programs die with SIGSEGV
    518   1.25   thorpej 	if you have a stale dependency.
    519   1.25   thorpej 
    520   1.25   thorpej 	Solution: "make cleandir" in both lib/csu and libexec/ld.elf_so
    521   1.25   thorpej 	before starting your build.
    522   1.26   thorpej 
    523   1.26   thorpej 20010628:
    524   1.26   thorpej 	A construct was added to uvm_page.h that uncovered a bug
    525   1.26   thorpej 	in lint(1).  If you get a warning/error about a non-portable
    526   1.26   thorpej 	bitfield, update your lint(1) before proceeding.
    527   1.21       jmc 
    528   1.21       jmc 20010226:
    529   1.22       jmc 	Added named user/group to system. Need to hand add this in or builds
    530   1.21       jmc 	will break as mtree aborts early.
    531   1.21       jmc 
    532   1.21       jmc 	To work around add by hand:
    533   1.21       jmc 
    534   1.21       jmc 	named:*:14:
    535   1.21       jmc 
    536   1.22       jmc 	to /etc/group and add:
    537   1.22       jmc 
    538   1.22       jmc 	named:*:14:14::0:0:Named pseudo-user:/var/named:/sbin/nologin
    539   1.22       jmc 
    540   1.22       jmc 	to master.passwd (use vipw for instance if doing by hand).
    541   1.22       jmc 
    542   1.22       jmc 	Now a make build should progress.
    543   1.18       jmc 
    544   1.18       jmc 20010219:
    545   1.52       wiz 	get/setprogname() added. Any hostprogs that may use this will need
    546  1.111    simonb 	to be bootstrapped manually until the host system is current.
    547   1.18       jmc 
    548  1.111    simonb 	Known problems: sys/arch/macppc/stand/fixcoff
    549   1.19       cgd 			usr.sbin/config (adding -DMAKE_BOOTSTRAP to
    550   1.19       cgd 			  CFLAGS and rebuilding should work)
    551   1.20       jmc 			usr.sbin/mdsetimage - Build a static copy if
    552  1.111    simonb 			  building a snapshot before fully bootstrapped.
    553   1.15  christos 
    554   1.15  christos 20010204:
    555   1.15  christos 	prepare the code to compile with stricter gcc flags. in
    556   1.15  christos 	particular start eliminating redundant declarations. Yacc
    557   1.15  christos 	needs to be installed before make build.
    558   1.10  christos 
    559   1.10  christos 20010114:
    560   1.10  christos 	introduce .if commands(target) in make(1). You need to
    561   1.10  christos 	bring everything up-to-date first, then without installing
    562   1.23      tron 	anything make and install in usr.bin/make, then proceed
    563   1.10  christos 	with make build.
    564    1.9  sommerfe 
    565    1.9  sommerfe 20010101:
    566    1.9  sommerfe 	bsd.subdir.mk committed 20001230 had a bug which caused
    567    1.9  sommerfe 	afterinstall targets to run too soon; update again.
    568    1.8  sommerfe 
    569    1.8  sommerfe 20001230:
    570    1.8  sommerfe 	New share/mk files needed to support .WAIT in SUBDIR variables.
    571    1.8  sommerfe 	If you get make errors, 
    572    1.8  sommerfe 		(cd share/mk; make install)
    573    1.8  sommerfe 	Also, PRINTOBJDIR has changed and is now used more heavily.
    574    1.6        ad 
    575    1.6        ad 20001019:
    576    1.7        ad 	The `ca' device driver has been replaced by `ld'; although the
    577    1.6        ad 	major and minor numbers haven't changed, you should update your /dev
    578    1.6        ad 	directory.
    579    1.1       abs 
    580    1.4    itojun 20000929:
    581    1.4    itojun 	The following make directives are obsoleted.
    582    1.4    itojun 	MKCRYPTO_RSA NOCRYPTO_RSA NOCRYPTO_RC5 NOCRYPTO_IDEA 
    583    1.4    itojun 	By default, RSA is built into libcrypto.  IDEA and RC5 will not be
    584   1.16       wiz 	built into libcrypto.  By using MKCRYPTO_{RC5,IDEA}, you can build
    585    1.4    itojun 	additional library libcrypto_{idea,rc5}.
    586    1.1       abs 
    587    1.1       abs 
    588    1.1       abs Hints for a more successful build:
    589    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    590    1.2       mrg     Build a new kernel first:
    591    1.2       mrg 	This makes sure that any new system calls or features
    592    1.2       mrg 	   expected by the new userland will be present.  This
    593    1.2       mrg 	   helps to avoid critical errors when upgrading.
    594    1.1       abs     Use object directories:
    595    1.1       abs 	This helps to keep stale object
    596    1.1       abs 	   files from polluting the build if a Makefile "forgets"
    597    1.1       abs 	   about one.  It also makes it easier to clean up after
    598    1.1       abs 	   a build.  It's also necessary if you want to use the
    599    1.1       abs 	   same source tree for multiple machines.
    600    1.1       abs 	   To use object directories:
    601    1.1       abs 	    a) cd /usr/src ; make cleandir
    602    1.2       mrg 	    b) Add "OBJMACHINE=yes" to /etc/mk.conf
    603    1.2       mrg 	    c) Add "MKOBJDIRS=yes" to /etc/mk.conf
    604    1.1       abs 	    d) cd /usr/src ; make build
    605    1.2       mrg 	   Note that running "make obj" in a directory will create
    606    1.2       mrg 	   in obj.$MACHINE directory.
    607    1.1       abs     Build to a DESTDIR:
    608    1.1       abs 	This helps to keep old
    609    1.1       abs 	   installed files (especially libraries) from interfering
    610    1.1       abs 	   with the new build.
    611    1.1       abs 	   To build to a DESTDIR, set the DESTDIR environment
    612    1.2       mrg 	   variable before running make build.  It should be set to
    613    1.2       mrg 	   the pathname of an initially empty directory.
    614    1.1       abs 	   Problems: you might need to update critical utilities
    615    1.1       abs 		without using DESTDIR since nothing is executed
    616    1.1       abs 		from what is installed in DESTDIR.
    617    1.1       abs 		(See critical utils, below)
    618    1.1       abs     Build often:
    619    1.1       abs 	This keeps critical utilities current enough to not choke
    620    1.1       abs 	on any other part of the source tree that depends on up to
    621    1.1       abs 	date functionality.
    622    1.1       abs  
    623    1.1       abs What to do if things don't work:
    624    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    625    1.1       abs When things don't work there is usually a few things that commonly
    626    1.1       abs should be done.
    627    1.1       abs     1)	make includes
    628    1.1       abs 	This should be done automatically by make build.
    629    1.1       abs     2)  cd share/mk && make install
    630    1.1       abs 	Again, automatically done by make build.
    631    1.1       abs 
    632    1.1       abs Failsafe rebuild of a small part of the tree:
    633    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    634    1.1       abs To make sure you rebuild something correctly you want to do
    635    1.1       abs something like the following:
    636    1.1       abs     1)  Make sure the includes and .mk files are up to date.
    637    1.1       abs     2)  Make sure any program used to build the particular
    638    1.1       abs 	utility is up to date.  (yacc, lex, etc...)
    639    1.1       abs     3)  cd ...path/to/util...
    640    1.1       abs 	make cleandir
    641    1.1       abs 	rm ...all obj directories...
    642    1.1       abs 	make cleandir			# yes, again
    643    1.1       abs 	make obj
    644    1.1       abs 	make depend && make
    645    1.1       abs 
    646    1.1       abs Failsafe rebuild of the entire tree:
    647    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    648    1.1       abs If you really want to make sure the source tree is clean and
    649    1.2       mrg ready for a build try the following.  Note that sourcing /etc/mk.conf
    650    1.2       mrg (a make(1) Makefile) in this manner is not right, and will not work
    651    1.2       mrg for anyone who uses any make(1) features in /etc/mk.conf.
    652    1.1       abs 
    653    1.1       abs ---cut here---
    654    1.1       abs #!/bin/sh
    655    1.1       abs . /etc/mk.conf
    656    1.1       abs 
    657   1.58     lukem if [ -z $NETBSDSRCDIR ] ; then
    658   1.58     lukem     NETBSDSRCDIR=/usr/src
    659    1.1       abs fi
    660   1.58     lukem if [ \! -d $NETBSDSRCDIR ] ; then
    661    1.1       abs     echo Unable to find sources
    662    1.1       abs     exit 1
    663    1.1       abs fi
    664   1.58     lukem find $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \;
    665    1.1       abs 
    666    1.1       abs if [ -z $BSDOBJDIR ] ; then
    667    1.1       abs     BSDOBJDIR=/usr/obj
    668    1.1       abs fi
    669    1.1       abs if [ -d $BSDOBJDIR ] ; then
    670    1.1       abs     rm -rf $BSDOBJDIR
    671    1.1       abs fi
    672    1.1       abs 
    673   1.58     lukem cd $NETBSDSRCDIR && make cleandir
    674    1.1       abs 
    675    1.1       abs ---cut here---
    676    1.1       abs 
    677    1.1       abs Critical utilities:
    678    1.1       abs ^^^^^^^^^^^^^^^^^^^
    679    1.1       abs 	gnu/usr.bin/egcs
    680    1.3    itojun 	usr.bin/compile_et
    681    1.1       abs 	usr.bin/make
    682    1.1       abs 	usr.bin/yacc
    683    1.1       abs 	usr.bin/lex
    684   1.11     lukem 	usr.bin/xlint
    685    1.2       mrg 	usr.sbin/config
    686    1.1       abs 
    687   1.34    simonb Other problems and possible solutions:
    688    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    689    1.1       abs Symptom:Unreasonable compiler errors.
    690    1.1       abs Fix:	Rebuild gnu/usr.bin/egcs
    691    1.1       abs 
    692    1.1       abs Symptom:Complaints involving a Makefile.
    693   1.17       erh Fix:	Rebuild usr.bin/make:
    694   1.17       erh 	cd usr.bin/make && make && make install
    695  1.111    simonb 	Or, a failsafe method if that doesn't work:
    696   1.17       erh 	cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin
    697   1.17       erh 
    698    1.1       abs Fix:	Make sure .mk files are up to date.
    699    1.1       abs 	cd share/mk && make install
    700    1.2       mrg 
    701    1.2       mrg Symptom:Kernel `config' fails to configure any kernel, including GENERIC.
    702    1.2       mrg Fix:	Rebuild usr.sbin/config
    703    1.1       abs 
    704    1.1       abs Symptom:
    705    1.1       abs Fix:	Rebuild usr.bin/yacc
    706    1.1       abs 
    707    1.1       abs Symptom:
    708    1.1       abs Fix:	Rebuild usr.bin/lex
    709    1.1       abs 
    710    1.1       abs Symptom:
    711    1.1       abs Fix:	rm /usr/lib/libbfd.a
    712    1.4    itojun 
    713    1.4    itojun Symptom:Obsolete intermediate files are used during compilation
    714    1.4    itojun Fix:	Try the following sequence of commands in the directory in question.
    715    1.4    itojun 	make cleandir; rm `make print-objdir`; make cleandir; make obj
    716    1.4    itojun 	(If you built the tree without "make obj" in the past, obsolete files
    717    1.4    itojun 	may remain.  The command tries to clean everything up)
    718    1.5       wiz 
    719    1.5       wiz Symptom:.../sysinst/run.c:xx: warning: initialization from incompatible pointer type
    720    1.5       wiz Fix:	Rebuild and install usr.bin/menuc
    721   1.12    itojun 
    722   1.12    itojun Symptom:mklocale not found during build in share/locale/ctype
    723   1.12    itojun Fix:	Build and install usr.bin/mklocale
    724   1.13    dogcow 
    725   1.86    kleink Symptom:undefined reference to `__assert13' or `__unsetenv13'
    726   1.13    dogcow Fix:    Rebuild and install lib/libc
    727   1.13    dogcow 
    728   1.19       cgd Symptom:usr.sbin/config fails to build.
    729   1.19       cgd Fix:	Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile.
    730   1.13    dogcow 
    731   1.19       cgd Symptom:undefined reference to `getprogname' or `setprogname'
    732   1.19       cgd Fix:    Rebuild and install lib/libc
    733   1.24       abs 
    734   1.24       abs Symptom:lint does not understand the '-X' option
    735   1.24       abs Fix:    May need to build & install libs with NOLINT=1 before rebuilding lint
    736