Home | History | Annotate | Line # | Download | only in src
UPDATING revision 1.250
      1  1.250  christos $NetBSD: UPDATING,v 1.250 2013/12/28 03:39:07 christos Exp $
      2    1.1       abs 
      3  1.123       jmc This file (UPDATING) is intended to be a brief reference to recent
      4  1.123       jmc changes that might cause problems in the build process, and a guide for
      5  1.123       jmc what to do if something doesn't work.
      6    1.1       abs 
      7  1.123       jmc For a more detailed description of the recommended way to build NetBSD
      8  1.123       jmc using build.sh, see the BUILDING file.
      9  1.123       jmc 
     10  1.123       jmc Note that much of the advice in this UPDATING file was written before
     11  1.123       jmc build.sh existed.  Nevertheless, the advice here may be useful for
     12  1.123       jmc working around specific problems with build.sh.
     13  1.123       jmc 
     14  1.123       jmc See also: BUILDING, build.sh, Makefile.
     15    1.1       abs 
     16    1.1       abs Recent changes:
     17    1.1       abs ^^^^^^^^^^^^^^^
     18  1.230       tls 
     19  1.250  christos 20131227:
     20  1.250  christos 	1. The new ntpd runs in a restricted mode to prevent amplification
     21  1.250  christos 	   attacks. If you need ntpdc to work you need to explicitly enable
     22  1.250  christos 	   mode7 in your config file. Make sure you put the necessary restrict
     23  1.250  christos 	   statements to avoid being exposed.
     24  1.250  christos 	2. strncat has moved from lib/libc to common/lib/libc; you might need
     25  1.250  christos 	   to make clean in libc
     26  1.250  christos 
     27  1.249       mrg 20131129:
     28  1.249       mrg 	The GMP sources were updated, and builds will likely fail without
     29  1.249       mrg 	cleaning their build trees for both tools and in-tree, like below.
     30  1.249       mrg 
     31  1.248       mrg 20131128:
     32  1.248       mrg 	The MPC and MPFR sources were updated, and builds may require their
     33  1.248       mrg 	tools and in-tree directories cleaned for successful updates.
     34  1.248       mrg 
     35  1.246    martin 20130605:
     36  1.247       spz 	The kernel option FAST_IPSEC no longer exists, it's been renamed
     37  1.247       spz 	to IPSEC (and the older IPSEC version removed).
     38  1.247       spz 
     39  1.247       spz 20130605:
     40  1.246    martin 	Previous freetype installations eroneously installed private
     41  1.246    martin 	header files. If you are building against a non-empty $DESTDIR,
     42  1.246    martin 	please remove ${DESTDIR}//usr/X11R7/include/freetype2/freetype/.
     43  1.246    martin 
     44  1.245       mrg 20130531:
     45  1.245       mrg 	The xdm update may cause build failure due to xdm.man being
     46  1.245       mrg 	in the obj tree.  Make sure to ensure any like this:
     47  1.245       mrg 		nbmake: nbmake: don't know how to make xdm.man. Stop
     48  1.245       mrg 	is fixed by deleting the xdm.man in the obj tree.
     49  1.245       mrg 
     50  1.244       mrg 20130530:
     51  1.244       mrg 	Updates of many xsrc packages will leave old .pc files around.
     52  1.244       mrg 	Best to clean out the xsrc objdir entirely before rebuilds.
     53  1.244       mrg 
     54  1.242  christos 20130301:
     55  1.242  christos 	The removal of netiso requires manual removal of /usr/include/netiso
     56  1.243  christos 	prior to the build and make cleandir in /usr/src/usr.bin/{ktruss,kdump}
     57  1.242  christos 
     58  1.238  dholland 20120726:
     59  1.241       wiz 	The update of OpenSSL requires cleaning both the OpenSSL build
     60  1.241       wiz 	directory and DESTDIR.  *Even non-update builds require cleaning
     61  1.240  dholland 	DESTDIR.* Builds done without taking these steps may fail, or in
     62  1.241       wiz 	some cases may succeed and install broken OpenSSL libraries that
     63  1.240  dholland 	cause third-party software to link incorrectly and/or crash.
     64  1.238  dholland 
     65  1.237       wiz 20120507:
     66  1.241       wiz 	The database schema for makemandb was changed.  You will
     67  1.237       wiz 	need to update the database using 'makemandb -f' or wait
     68  1.237       wiz 	for the next weekly run to fix it.
     69  1.237       wiz 
     70  1.236       bsh 20120319:
     71  1.236       bsh 	sys/conf/Makefile.kern.inc has been modified to adjust the
     72  1.236       bsh 	size of db_symtab automatically.  You need to update dbsym in
     73  1.236       bsh 	your $TOOLDIR to build kernels with options SYMTAB_SPACE.  If
     74  1.236       bsh 	you don't want this behavior, add AUTO_SYMTAB_SPACE=no to your
     75  1.236       bsh 	mk.conf.
     76  1.236       bsh 
     77  1.235     joerg 20120216:
     78  1.241       wiz 	Default for MKCATPAGES changed to NO.  Update builds will fail
     79  1.241       wiz 	unless DESTDIR is cleaned manually.  If you built between 20120207
     80  1.239  dholland 	and 20120216, daily and weekly could have created an unreadable
     81  1.241       wiz 	/var/db/man.db index for apropos.  Running makemandb -f or
     82  1.235     joerg 	the next run of weekly will fix it.
     83  1.233     joerg 
     84  1.232  christos 20111227:
     85  1.232  christos 	If you built between 20111225 and 20111227 you need to remove
     86  1.232  christos 	/usr/lib/libpam.so.4* and /usr/lib/security/*.so.4, since the
     87  1.232  christos 	bump has been reverted.
     88  1.232  christos 
     89  1.231       tls 20111125:
     90  1.231       tls 	The "rnd" pseudodevice has been added to sys/conf/std, which
     91  1.231       tls 	means it should no longer be explicitly listed in kernel
     92  1.231       tls 	configuration files.  The line "pseudo-device rnd" should be
     93  1.231       tls 	removed from any custom kernel config files users may have.
     94  1.231       tls 
     95  1.230       tls 20111119:
     96  1.230       tls 	A problem with the datastructures used by the rndctl(8)
     97  1.230       tls 	utility (pointers in datastructures in an array, making 32->64
     98  1.230       tls 	bit compatibility very painful) has been fixed in a
     99  1.230       tls 	non-backwards-compatible way.  If you replace your kernel,
    100  1.230       tls 	replace your rndctl executable too.
    101  1.241       wiz 
    102  1.229       jym 20111001:
    103  1.229       jym 	the prop_*_send_syscall() functions from proplib(3) have been
    104  1.229       jym 	changed and their new version is not backward compatible with the old
    105  1.241       wiz 	one.  So ensure that all consumers of these functions (currently:
    106  1.229       jym 	quota2 code and its tests) are updated together with the new lib.
    107  1.229       jym 
    108  1.228       mrg 20110817:
    109  1.228       mrg 	sparc has been changed to use GCC 4.5.3, so any objdir or
    110  1.228       mrg 	DESTDIR for them should be deleted before updating.
    111  1.228       mrg 
    112  1.227  riastrad 20110806:
    113  1.227  riastrad 	i386 and amd64 have been changed to use GCC 4.5.3, so any
    114  1.227  riastrad 	objdir or DESTDIR for them should be deleted before updating.
    115  1.227  riastrad 
    116  1.226       mrg 20110805:
    117  1.226       mrg 	The update to GCC 4.5.3 requires a non-trivial portion of
    118  1.226       mrg 	the tree to be cleaned.  Best to delete both objdir and
    119  1.226       mrg 	DESTDIR before running this update.  So far, only the
    120  1.226       mrg 	sparc64, mips and powerpc platforms have changed.
    121  1.226       mrg 
    122  1.225      matt 20110803:
    123  1.241       wiz 	The layout of external/public-domain/xz has changed.  To do an
    124  1.225      matt 	update build you will have to remove the contents of the OBJDIR
    125  1.225      matt 	for external/public-domain/xz/bin by hand as the xz entry there
    126  1.225      matt 	is now a directory.
    127  1.225      matt 
    128  1.223     joerg 20110410:
    129  1.241       wiz 	The configuration of src/tools/gcc has changed.  To do an
    130  1.224  dholland 	update build you have to clean both tools/binutils and
    131  1.224  dholland 	tools/gcc by hand.
    132  1.223     joerg 
    133  1.222    plunky 20110328:
    134  1.222    plunky 	Building the Xorg binary was moved into a subdirectory to fix
    135  1.241       wiz 	ordering issues with "make all".  It may be necessary to remove
    136  1.222    plunky 	the OBJDIR for external/mit/xorg/server/xorg-server/hw/xfree86
    137  1.222    plunky 	if your update build fails, as the "Xorg" entry there is now a
    138  1.222    plunky 	directory.
    139  1.222    plunky 
    140  1.220     joerg 20110121:
    141  1.221     lukem 	Assembler files no longer use -traditional-cpp.  This can break
    142  1.220     joerg 	the build of individual parts of the tree.  This is handled
    143  1.220     joerg 	correctly by build.sh.  Manual builds have to update /usr/share/mk
    144  1.220     joerg 	and re-run config(1) for any kernel configurations as needed.
    145  1.218     joerg 
    146  1.217    jruoho 20101217:
    147  1.217    jruoho 	The tcpdump(8) program was changed to drop privileges and chroot(2)
    148  1.241       wiz 	by default.  It may be necessary to manually update passwd(5) and
    149  1.217    jruoho 	group(5) in order to make the program work with existing setups.
    150  1.217    jruoho 
    151  1.216  christos 20101125:
    152  1.216  christos 	The latest changes to setenv(3) dissallow setting environment
    153  1.241       wiz 	variables with names that contain '='.  Revision 1.18 of env.c
    154  1.241       wiz 	assumed that this was allowed.  Installing a new libc with an
    155  1.216  christos 	old copy of /usr/bin/env causes env x=1 printenv | grep x= to
    156  1.216  christos 	break which affects the autoconf tests for dependency finding,
    157  1.216  christos 	so building gcc will end up printing:
    158  1.216  christos 	    checking dependency style of gcc... none
    159  1.216  christos 	    configure: error: no usable dependency style found
    160  1.216  christos 	Fix it by rebuilding and re-installing env.
    161  1.138     lukem 
    162  1.215       mrg 20101119:
    163  1.215       mrg 	Recent Xorg updates in xsrc/external/mit/ may cause various build
    164  1.215       mrg 	or run-time problems.  Delete your entire DESTDIR and OBJDIR if you
    165  1.215       mrg 	have any build problems with xsrc, or problems with mismatched
    166  1.215       mrg 	versions between xorg-server and drivers.
    167  1.215       mrg 
    168  1.213      jmmv 20100604:
    169  1.213      jmmv 	The update of ATF to 0.9 causes old tests written in shell to fail
    170  1.213      jmmv 	unless they are rebuilt.  If you are building with MKUPDATE=yes,
    171  1.213      jmmv 	you need to clean the src/external/bsd/atf/tests/ and the src/tests/
    172  1.213      jmmv 	trees by hand.
    173  1.213      jmmv 
    174  1.211   tnozaki 20100522:
    175  1.212       mrg 	Recent Xorg updates in xsrc/external/mit/ will cause various build
    176  1.212       mrg 	problems.  Delete your entire DESTDIR and OBJDIR if you have any
    177  1.212       mrg 	build problems with xsrc.
    178  1.212       mrg 
    179  1.212       mrg 20100522:
    180  1.211   tnozaki 	private section of <ctype.h> was splitted, and now mklocale(1)
    181  1.214  dholland 	include ctype_local.h, so you have to make cleandir in tools/mklocale.
    182  1.211   tnozaki 
    183  1.210  christos 20100520:
    184  1.241       wiz 	The location of the xkb compiled descriptions has changed.  Please
    185  1.210  christos 	remove usr/X11R7/lib/X11/xkb/compiled from your $DESTDIR.
    186  1.210  christos 
    187  1.209     njoly 20100222:
    188  1.209     njoly 	The shared objects file extension has been changed from .so to
    189  1.209     njoly 	.pico, in order to avoid conflicts with shared libraries names
    190  1.209     njoly 	libXX.so.  All now stale regular .so files can be removed from
    191  1.209     njoly 	your object directories.
    192  1.209     njoly 
    193  1.208       roy 20100204:
    194  1.208       roy 	The termcap database has been removed from the sources,
    195  1.208       roy 	but has not been marked obsolete so it is not removed
    196  1.208       roy 	from the system when upgrading.
    197  1.208       roy 	As such, you will need to remove them from your object
    198  1.208       roy 	and destination directories.
    199  1.208       roy 
    200  1.203    dyoung 20091101:
    201  1.205  dholland         After updating, it may be necessary to make the 'cleandir'
    202  1.205  dholland         target in src/tools/yacc/ and in src/usr.bin/yacc/ before a
    203  1.205  dholland         'build.sh -u tools' or 'build.sh -u distribution'.  Ditto
    204  1.205  dholland         src/tools/lex/ and src/usr.bin/lex/.
    205  1.203    dyoung 
    206  1.202       mrg 20091001:
    207  1.206  dholland 	On amd64 you must rebuild tools (to get the new binutils)
    208  1.206  dholland 	before building a kernel, or the build fails on cpufunc.S.
    209  1.206  dholland 
    210  1.206  dholland 20091001:
    211  1.202       mrg 	An error will create a ./usr/X11R7/lib/X11/xkb/compiled/xkb
    212  1.202       mrg 	symlink, failing the build.  Delete the link, and the subdir
    213  1.202       mrg 	it is in, and retry your build.
    214  1.202       mrg 
    215  1.201       dsl 20090718:
    216  1.201       dsl 	libc build changed so that strchr() provides the extra entry
    217  1.241       wiz 	point for index().  Update build of libc.a (and libc_pic.a)
    218  1.201       dsl 	may fail because the archive contains the unwanted index.o.
    219  1.201       dsl 	(Similarly for strrchr() and rindex().)
    220  1.201       dsl 
    221  1.198       mrg 20090709:
    222  1.198       mrg 	Native Xorg was upgraded again.  Builds will probably fail again
    223  1.198       mrg 	without a clean objdir, at least for src/external/mit/xorg.
    224  1.198       mrg 
    225  1.197       mrg 20090616:
    226  1.197       mrg 	Native Xorg was upgraded.  Builds will need a clean objdir for
    227  1.197       mrg 	src/external/mit/xorg.  Upgrading a system from sets will not
    228  1.197       mrg 	work properly yet as the /usr/X11R7/lib/X11/xkb/symbols/pc
    229  1.197       mrg 	subdirectory has been changed into a file, and this needs to
    230  1.197       mrg 	be manually "rm -r"'ed before installing xbase.tgz.
    231  1.197       mrg 
    232  1.195     perry 20090501:
    233  1.195     perry 	Several new functions were added to string.h/libc, and this
    234  1.195     perry 	can cause autoconf problems during the tool build for people
    235  1.241       wiz 	who fail to clean out their tools objects properly.  If you
    236  1.195     perry 	note messages about stpcpy, stpncpy or strnlen accompanying a
    237  1.195     perry 	failure during the tool build, clean out all your tools
    238  1.195     perry 	objects and start again.
    239  1.195     perry 
    240  1.194       mrg 20090325:
    241  1.194       mrg 	The i386 port was switched to i486 default toolchain.  This requires
    242  1.194       mrg 	cleaning your src/tools directory and $TOOLDIR and rebuilding them.
    243  1.194       mrg 
    244  1.192     skrll 20090126:
    245  1.241       wiz 	The __posix_fadvise50 system call changed assembly stub type.  You
    246  1.207   mbalmer 	need to 'rm -f __posix_fadvise50.*' in the libc build directory
    247  1.207   mbalmer 	to avoid using the old assembly stub.
    248  1.192     skrll 
    249  1.191     joerg 20090202:
    250  1.191     joerg 	pkg_install now depends on the pkgdb cache for automatic conflict
    251  1.191     joerg 	detection.  It is recommented to rebuild the cache with
    252  1.191     joerg 	``pkg_admin rebuild''.
    253  1.191     joerg 
    254  1.184  christos 20090110:
    255  1.241       wiz 	time_t and dev_t have been bumped to 64 bit quantities.  To upgrade:
    256  1.241       wiz 	1. Make sure your kernel has COMPAT_50 in it.  Build and install.
    257  1.188  christos 	   This is needed even in the MODULAR kernel because there is
    258  1.188  christos 	   conditionally compiled code in rtsock.c.
    259  1.184  christos 	2. make sure build.sh completes and the binaries in a chroot work
    260  1.184  christos 	   before installing.
    261  1.184  christos 	3. If you don't use build.sh and you build directly to root, and
    262  1.241       wiz 	   your build breaks in the middle, don't despair.  Make sure headers
    263  1.184  christos 	   are installed properly, and start building libraries first libc
    264  1.184  christos 	   and libutil, install them and then continue building all the
    265  1.241       wiz 	   libraries in src/lib and src/gnu/lib and install them.  Once
    266  1.184  christos 	   the new libraries are installed, you can restart the build.
    267  1.184  christos 	4. If you compile packages and you notice link time warnings,
    268  1.189   hubertf 	   rebuild the required packages to update their shared libraries.
    269  1.189   hubertf 	   Any package you rebuild will require rebuilding all the packages
    270  1.189   hubertf 	   that depend on it.
    271  1.186  christos 	5. Next time you run pwd_mkdb with the new binary, the file
    272  1.186  christos 	   will be upgraded and it will not be backwards compatible.
    273  1.190       apb 	6. The utmpx/wtmpx files (/var/run/utmpx and /var/log/wtmpx, see
    274  1.190       apb 	   lastlogx(5)) have been versioned, and there is a heuristic
    275  1.241       wiz 	   for utmp.  You are better off removing the old files after
    276  1.190       apb 	   upgrading.  The automated clearing of /var/run during
    277  1.190       apb 	   boot, and the automated rotating of files in /var/log by
    278  1.190       apb 	   newsyslog(8), may mean that you do not have to remove the
    279  1.190       apb 	   files manually.
    280  1.190       apb 	7. The optional accounting file (/var/account/acct, see
    281  1.190       apb 	   accton(8)) has not been versioned, and will need to be
    282  1.190       apb 	   removed.  The automatic rotation of the accounting file by
    283  1.190       apb 	   /etc/daily limits the bad consequences of failure to remove
    284  1.190       apb 	   the file.
    285  1.196  dholland 	8. Application software that writes time_t to binary files on
    286  1.241       wiz 	   disk will break or need attention.  Most notably: if you are
    287  1.196  dholland 	   using PostgreSQL < 8.4, you need to dump your databases,
    288  1.196  dholland 	   rebuild PostgreSQL with the new time_t, then restore.
    289  1.185  jmcneill 
    290  1.183  pgoyette 20081219:
    291  1.183  pgoyette 	config(1) has been updated, and one of the files it creates -
    292  1.183  pgoyette 	swapnetbsd.o - has changed format.  You need to rebuild config
    293  1.183  pgoyette 	(done automatically by build.sh) and then you need to rerun
    294  1.183  pgoyette 	config on all kernel configuration files before rebuilding those
    295  1.183  pgoyette 	kernels.
    296  1.183  pgoyette 
    297  1.181      cube 20081205:
    298  1.181      cube 	If you build with MKX11=no, you should remove /etc/rc.d/xdm and
    299  1.181      cube 	/etc/rc.d/xfs from DESTDIR because those files were moved to the xetc
    300  1.181      cube 	set and will appear as extra files for MKX11=no update builds.
    301  1.178     lukem 
    302  1.179   tsutsui 20081122:
    303  1.182   tsutsui 	On i386, various kernel options(4) in GENERIC including
    304  1.180       wiz 	file systems have been disabled and moved into kernel modules.
    305  1.180       wiz 	Before trying a new GENERIC kernel, you have to prepare the
    306  1.179   tsutsui 	following files as well as a new GENERIC kernel:
    307  1.179   tsutsui 
    308  1.179   tsutsui 	- build and install kernel modules from src/sys/modules
    309  1.179   tsutsui 
    310  1.179   tsutsui 	- install the latest bootloader, which will load a module
    311  1.180       wiz 	  for the file system from which the kernel is loaded automatically
    312  1.179   tsutsui 
    313  1.180       wiz 	If you have to load your kernel from a file system which is not of
    314  1.180       wiz 	the same type as the root file system, you have to load the necessary
    315  1.180       wiz 	file system module manually on the boot prompt or in the boot.cfg file.
    316  1.179   tsutsui 
    317  1.178     lukem 20080827:
    318  1.178     lukem 	If you built and installed a libc from sources between
    319  1.178     lukem 	2008/08/20 and 2008/08/26 you got a broken strtouq(3)
    320  1.178     lukem 	which results in false errors reported by lint(1).
    321  1.178     lukem 	Since this breaks the libc build itself, manual help is
    322  1.180       wiz 	needed -- lint must be disabled temporarily, e.g.:
    323  1.178     lukem 	  $ (cd lib/libc && make MKLINT=no dependall install)
    324  1.178     lukem 
    325  1.177  christos 20080813:
    326  1.177  christos 	MKDEBUG build was broken because the .depend files did not know
    327  1.241       wiz 	about .go files.  You need to remove all .depend files and rebuild.
    328  1.177  christos 
    329  1.200  dholland 20080802:
    330  1.200  dholland 	A regression in binary compatibility for pthread_mutex_t has
    331  1.241       wiz 	been fixed.  Unfortunately, the price is breaking compatibility
    332  1.200  dholland 	for -current.
    333  1.200  dholland 
    334  1.200  dholland 	Threaded programs (using libpthread) and C++ programs (using
    335  1.200  dholland 	libstdc++) compiled after 20070907 and before 20080802 need to
    336  1.200  dholland 	be recompiled.
    337  1.200  dholland 
    338  1.200  dholland 	One way to find affected pkgsrc packages:
    339  1.200  dholland 
    340  1.200  dholland 	  $ grep REQUIRES=/usr/lib/libpthread /var/db/pkg/*/+BUILD_INFO
    341  1.200  dholland 	  $ grep REQUIRES=/usr/lib/libstdc++ /var/db/pkg/*/+BUILD_INFO
    342  1.200  dholland 
    343  1.175    simonb 20080731:
    344  1.175    simonb 	WAPBL (metadata journaling support) has been added, but at this
    345  1.175    simonb 	time isn't backwards compatible with pre-WAPBL aware kernels
    346  1.175    simonb 	and userland (fsck_ffs in particular).  Please make sure you
    347  1.175    simonb 	don't use a journaled filesystem with an older kernel/userland,
    348  1.176    simonb 	especially an uncleanly mounted journaled filesystem.  WAPBL
    349  1.176    simonb 	also requires the super block to be in the UFS2 format.  You
    350  1.176    simonb 	can use fsck_ffs -c 4 to update the superblock format.
    351  1.175    simonb 
    352  1.174     lukem 20080721:
    353  1.174     lukem 	Assembler warnings are now fatal if $WARNS>0 and $NOGCCERROR
    354  1.174     lukem 	isn't defined.
    355  1.174     lukem 
    356  1.173     freza 20080531:
    357  1.241       wiz 	The ioctl number of DRVSUSPENDDEV command on /dev/drvctl changed
    358  1.241       wiz 	from 125 (conflicted with DRVCTLCOMMAND) to 129.  The drvctl(8)
    359  1.173     freza 	utility needs to be rebuilt and reinstalled as older binaries
    360  1.241       wiz 	won't work correctly.  The following sequence of commands:
    361  1.173     freza 
    362  1.173     freza 	  $ (cd sys/sys/ && nbmake-$arch includes)
    363  1.173     freza 	  $ (cd sbin/drvctl/ && nbmake-$arch clean)
    364  1.173     freza 	  $ (cd sbin/drvctl/ && nbmake-$arch all)
    365  1.173     freza 
    366  1.173     freza 	leaves new drvctl utility in sbin/drvctl build directory.
    367  1.173     freza 
    368  1.172     lukem 20080503:
    369  1.172     lukem 	The <bsd.lib.mk> variable MKPRIVATELIB was renamed to LIBISPRIVATE.
    370  1.172     lukem 
    371  1.171        he 20080521:
    372  1.171        he 	For a while, unprivileged UPDATE builds would fail to
    373  1.171        he 	succeed at the checkflist stage, complaining that
    374  1.171        he 	${DESTDIR}/stand/<arch>/ did not exist.  A fix for this
    375  1.171        he 	problem was committed to share/mk/bsd.kmodule.mk, revision 1.9.
    376  1.171        he 	If you already hit this problem, update the .mk file,
    377  1.171        he 	remove ${DESTDIR}/stand/<arch>, and re-run the build.
    378  1.171        he 
    379  1.174     lukem 20080303:
    380  1.174     lukem 	Linker warnings are now fatal if $WARNS>0.
    381  1.174     lukem 
    382  1.170  christos 20080126:
    383  1.170  christos 	The posix_fadvise system call has been changed from an assembly
    384  1.241       wiz 	stub, to a c file that calls an assembly stub.  You need to
    385  1.170  christos 	'rm -f posix_fadvise.* .depend' in the libc build directory to
    386  1.170  christos 	avoid using the old assembly stub.
    387  1.170  christos 
    388  1.168     joerg 20071209:
    389  1.241       wiz 	The acpiec(4) driver has been split into two attachments.  If you
    390  1.168     joerg 	get ACPI errors before the attachment, please update your kernel
    391  1.169       wiz 	configuration file appropriately or see GENERIC for more details.
    392  1.168     joerg 
    393  1.166   xtraeme 20071115:
    394  1.166   xtraeme 	The it(4) driver has been renamed to itesio(4) and the old port
    395  1.166   xtraeme 	argument specified in the kernel configuration file is not valid
    396  1.241       wiz 	anymore.  The itesio(4) driver now uses the Super I/O address port
    397  1.241       wiz 	rather than the EC address port.  Please update your kernel
    398  1.167       wiz 	configuration file appropriately or see GENERIC for more details.
    399  1.166   xtraeme 
    400  1.165      jmmv 20071028:
    401  1.165      jmmv 	The pccons(4) driver has been removed from the NetBSD/shark port.
    402  1.165      jmmv 	You need to update any custom kernel configuration file you have
    403  1.165      jmmv 	to remove any references to pccons (which includes removing the
    404  1.165      jmmv 	now useless XSERVER option) and replace them with the correct
    405  1.165      jmmv 	entries for the wscons driver.  See the GENERIC configuration file
    406  1.165      jmmv 	for more details.
    407  1.165      jmmv 
    408  1.164       gdt 20070913:
    409  1.164       gdt 	A latent bug in dhclient/dhcpd that caused it to be unable to
    410  1.164       gdt 	enumerate interfaces was fixed.  The bug began to cause
    411  1.164       gdt 	problems after 20070911 when the kernel's SIOCGIFCONF
    412  1.164       gdt 	implementation was repaired.  From 20070529 to 20070911 racoon
    413  1.164       gdt 	could not enumerate interfaces.  (These are noted because
    414  1.164       gdt 	normal kernel/userspace version matching hygiene is not
    415  1.164       gdt 	sufficient to avoid this problem.)  Ensure that both kernel
    416  1.164       gdt 	and userland are from after 20070913.
    417  1.164       gdt 
    418  1.163     joerg 20070703:
    419  1.241       wiz 	nbinstall has been renamed ${MACHINE_GNU_ARCH}-install.  It
    420  1.199  dholland 	calls the target-specific strip program, and the logic to pass
    421  1.199  dholland 	down STRIP from make has been removed.  This requires a
    422  1.199  dholland 	re-installation of tools.
    423  1.163     joerg 
    424  1.161       dsl 20070422:
    425  1.161       dsl 	The way OS emulations lookup filenames inside the emulation root
    426  1.161       dsl 	has been changed.  Rather than modify the pathname (and copy back
    427  1.161       dsl 	to userspace) namei() and lookup() directly check the emulation
    428  1.241       wiz 	root.  One side effect is that absolute symlinks inside the emulated
    429  1.167       wiz 	root file system will be relative to that file system - unless they
    430  1.161       dsl 	start /../ this is useful when the emulated root is a real install
    431  1.161       dsl 	that has such links.
    432  1.161       dsl 	This might affect symlinks that have been added to reference outside
    433  1.161       dsl 	the emulated root.
    434  1.161       dsl 
    435  1.160  jmcneill 20070412:
    436  1.241       wiz 	The pckbc driver on sgimips IP32 has been removed.  Use macekbc
    437  1.241       wiz 	instead.  See the GENERIC32_IP3x kernel configuration for an
    438  1.160  jmcneill 	example.
    439  1.160  jmcneill 
    440  1.159       gdt 20070319:
    441  1.159       gdt         src/lib/libc/Makefile revision 1.129 broke libc and ld.elf_so
    442  1.159       gdt         on many platforms due to incorrect flags settings.  If you
    443  1.159       gdt         updated and built after about 20070315, do "nbmake-$arch
    444  1.159       gdt 	cleandir" in src/lib/libc and src/libexec/ld.elf_so to force a
    445  1.159       gdt 	rebuild of object files that might have been built
    446  1.159       gdt 	incorrectly, and ensure that you have at least
    447  1.159       gdt 	src/lib/libc/Makefile 1.130.
    448  1.159       gdt 
    449  1.241       wiz 20070210:
    450  1.158       dbj         src/sys/sys/{sa.h,savar.h} were removed.
    451  1.158       dbj           find ${OBJDIR} \( -name .depend -o -name '*.d' \) -print \
    452  1.158       dbj               | xargs egrep -l '/sa.h|/savar.h' | xargs rm
    453  1.158       dbj         will allow dependencies on those files to get get rebuilt
    454  1.158       dbj 
    455  1.157       apb 20070209:
    456  1.157       apb         The threading model was changed when the newlock2 branch
    457  1.157       apb         was merged to NetBSD-current.  If you boot with a new
    458  1.157       apb         kernel (version 4.99.10), then you also need a new pthread
    459  1.157       apb         library (/usr/lib/libpthread.so.0.7).  If you boot with
    460  1.157       apb         an old kernel, then you need the old pthread library
    461  1.157       apb         (/usr/lib/libpthread.so.0.6).  Provided you keep the kernel and
    462  1.157       apb         the pthread library in sync, old threaded applications should
    463  1.157       apb         continue to work with an old or new kernel.  Note that named(8)
    464  1.157       apb 	is the only threaded application in the base system.
    465  1.157       apb 
    466  1.154        he 20061214:
    467  1.154        he 	Following the move of string_to_flags() and flags_to_string()
    468  1.154        he 	from the bin/ls/ sources to libutil, users doing UPDATE builds
    469  1.154        he 	will need to do a "make cleandir" in
    470  1.154        he 		tools/mtree/, tools/makefs/, tools/binstall/, tools/pax/,
    471  1.154        he 		bin/pax/, bin/ls/, usr.sbin/mtree/, usr.sbin/makefs/,
    472  1.156        he 		usr.bin/xinstall/, libexec/ftpd/, rescue/, as well
    473  1.156        he 		as the installation images in distrib/
    474  1.154        he 	in order to excise stale references to the old stat_flags.h header
    475  1.154        he 	file in the ls sources -- stat_flags.h has been removed.
    476  1.154        he 
    477  1.152  christos 20061108:
    478  1.152  christos 	The configure script used in the src/tools/gcc compiler has been
    479  1.152  christos 	changed to indicate that our libc has ssp support built-in and
    480  1.241       wiz 	does not depend on -lssp and -lssp-nonshared.  You'll need to
    481  1.152  christos 	make clean in src/tools/gcc first to rebuild the compiler.
    482  1.152  christos 
    483  1.151    rpaulo 20061009:
    484  1.151    rpaulo 	The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer
    485  1.241       wiz 	available.  Use net.inet{,6}.tcp{,6}.congctl.selected instead.
    486  1.151    rpaulo 
    487  1.150     bjh21 20060814:
    488  1.150     bjh21 	The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been
    489  1.150     bjh21 	withdrawn.  Use vidcvideo and pckbd instead.  See the GENERIC
    490  1.150     bjh21 	kernel configuration for an example.  X servers from the last
    491  1.150     bjh21 	few years should cope.
    492  1.150     bjh21 
    493  1.149  christos 20060703:
    494  1.241       wiz 	MPACPI is no more.  We always configure PCI interrupts using ACPI
    495  1.241       wiz 	if we have an ACPI kernel.  The option MPACPI_SCANPCI has been renamed
    496  1.241       wiz 	to ACPI_SCANPCI.  Thanks to work from fvdl.
    497  1.149  christos 
    498  1.148    dogcow 20060627:
    499  1.148    dogcow 	socket(2) has changed, and its system call has been versioned.
    500  1.148    dogcow 	For userlands with the old version of socket(2), make sure that
    501  1.148    dogcow 	your kernel has 'options COMPAT_30' set, or else 'bad system call'
    502  1.148    dogcow 	errors will result.
    503  1.148    dogcow 
    504    1.1       abs Hints for a more successful build:
    505    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    506  1.123       jmc     Use build.sh, but do not use its "expert mode":
    507  1.132      jmmv 	This will automatically build the tools in the
    508  1.123       jmc 	   correct order, and it will keep the tools and the
    509  1.123       jmc 	   new build products from interfering with the running
    510  1.123       jmc 	   system.  This will allow you to ignore most of the
    511  1.123       jmc 	   other advice in this file.
    512    1.2       mrg     Build a new kernel first:
    513    1.2       mrg 	This makes sure that any new system calls or features
    514    1.2       mrg 	   expected by the new userland will be present.  This
    515    1.2       mrg 	   helps to avoid critical errors when upgrading.
    516    1.1       abs     Use object directories:
    517    1.1       abs 	This helps to keep stale object
    518    1.1       abs 	   files from polluting the build if a Makefile "forgets"
    519    1.1       abs 	   about one.  It also makes it easier to clean up after
    520    1.1       abs 	   a build.  It's also necessary if you want to use the
    521    1.1       abs 	   same source tree for multiple machines.
    522  1.123       jmc 	   To use object directories with build.sh:
    523  1.123       jmc 	    a) invoke build.sh with the "-M" or "-O" options.
    524  1.123       jmc 	   To use object directories without using build.sh:
    525    1.1       abs 	    a) cd /usr/src ; make cleandir
    526    1.2       mrg 	    b) Add "OBJMACHINE=yes" to /etc/mk.conf
    527    1.2       mrg 	    c) Add "MKOBJDIRS=yes" to /etc/mk.conf
    528    1.1       abs 	    d) cd /usr/src ; make build
    529    1.2       mrg 	   Note that running "make obj" in a directory will create
    530    1.2       mrg 	   in obj.$MACHINE directory.
    531    1.1       abs     Build to a DESTDIR:
    532  1.123       jmc 	This helps to keep old installed files (especially libraries)
    533  1.123       jmc 	   from interfering with the new build.
    534  1.123       jmc 	   To build to a DESTDIR with build.sh, use the "-D" option.
    535  1.123       jmc 	   To build to a DESTDIR without using build.sh, set the DESTDIR
    536  1.123       jmc 	   environment variable before running make build.  It should be
    537  1.123       jmc 	   set to the pathname of an initially empty directory.
    538  1.123       jmc 	   Problems: if you do not use build.sh, you might need to
    539  1.123       jmc 		update critical utilities without using DESTDIR since
    540  1.123       jmc 		nothing is executed from what is installed in DESTDIR.
    541  1.123       jmc 		(See critical utils, below.)
    542    1.1       abs     Build often:
    543    1.1       abs 	This keeps critical utilities current enough to not choke
    544    1.1       abs 	on any other part of the source tree that depends on up to
    545  1.123       jmc 	date functionality.  If you use build.sh, you should not have
    546  1.123       jmc 	this problem.
    547  1.241       wiz 
    548    1.1       abs What to do if things don't work:
    549    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    550  1.230       tls When things don't work there are usually a few things that commonly
    551    1.1       abs should be done.
    552    1.1       abs     1)	make includes
    553    1.1       abs 	This should be done automatically by make build.
    554    1.1       abs     2)  cd share/mk && make install
    555    1.1       abs 	Again, automatically done by make build.
    556    1.1       abs 
    557    1.1       abs Failsafe rebuild of a small part of the tree:
    558    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    559    1.1       abs To make sure you rebuild something correctly you want to do
    560    1.1       abs something like the following:
    561    1.1       abs     1)  Make sure the includes and .mk files are up to date.
    562    1.1       abs     2)  Make sure any program used to build the particular
    563    1.1       abs 	utility is up to date.  (yacc, lex, etc...)
    564    1.1       abs     3)  cd ...path/to/util...
    565    1.1       abs 	make cleandir
    566    1.1       abs 	rm ...all obj directories...
    567    1.1       abs 	make cleandir			# yes, again
    568    1.1       abs 	make obj
    569    1.1       abs 	make depend && make
    570    1.1       abs 
    571    1.1       abs Failsafe rebuild of the entire tree:
    572    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    573    1.1       abs If you really want to make sure the source tree is clean and
    574    1.2       mrg ready for a build try the following.  Note that sourcing /etc/mk.conf
    575    1.2       mrg (a make(1) Makefile) in this manner is not right, and will not work
    576    1.2       mrg for anyone who uses any make(1) features in /etc/mk.conf.
    577    1.1       abs 
    578    1.1       abs ---cut here---
    579    1.1       abs #!/bin/sh
    580    1.1       abs . /etc/mk.conf
    581    1.1       abs 
    582   1.58     lukem if [ -z $NETBSDSRCDIR ] ; then
    583   1.58     lukem     NETBSDSRCDIR=/usr/src
    584    1.1       abs fi
    585   1.58     lukem if [ \! -d $NETBSDSRCDIR ] ; then
    586    1.1       abs     echo Unable to find sources
    587    1.1       abs     exit 1
    588    1.1       abs fi
    589   1.58     lukem find $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \;
    590    1.1       abs 
    591    1.1       abs if [ -z $BSDOBJDIR ] ; then
    592    1.1       abs     BSDOBJDIR=/usr/obj
    593    1.1       abs fi
    594    1.1       abs if [ -d $BSDOBJDIR ] ; then
    595    1.1       abs     rm -rf $BSDOBJDIR
    596    1.1       abs fi
    597    1.1       abs 
    598   1.58     lukem cd $NETBSDSRCDIR && make cleandir
    599    1.1       abs 
    600    1.1       abs ---cut here---
    601    1.1       abs 
    602    1.1       abs Critical utilities:
    603    1.1       abs ^^^^^^^^^^^^^^^^^^^
    604    1.3    itojun 	usr.bin/compile_et
    605    1.1       abs 	usr.bin/make
    606    1.1       abs 	usr.bin/yacc
    607    1.1       abs 	usr.bin/lex
    608   1.11     lukem 	usr.bin/xlint
    609  1.142  drochner 	usr.bin/config
    610    1.1       abs 
    611   1.34    simonb Other problems and possible solutions:
    612    1.1       abs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    613    1.1       abs Symptom:Complaints involving a Makefile.
    614   1.17       erh Fix:	Rebuild usr.bin/make:
    615   1.17       erh 	cd usr.bin/make && make && make install
    616  1.111    simonb 	Or, a failsafe method if that doesn't work:
    617   1.17       erh 	cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin
    618   1.17       erh 
    619    1.1       abs Fix:	Make sure .mk files are up to date.
    620    1.1       abs 	cd share/mk && make install
    621    1.2       mrg 
    622    1.2       mrg Symptom:Kernel `config' fails to configure any kernel, including GENERIC.
    623  1.142  drochner Fix:	Rebuild usr.bin/config
    624    1.1       abs 
    625    1.1       abs Symptom:
    626    1.1       abs Fix:	Rebuild usr.bin/yacc
    627    1.1       abs 
    628    1.1       abs Symptom:
    629    1.1       abs Fix:	Rebuild usr.bin/lex
    630    1.1       abs 
    631    1.1       abs Symptom:
    632    1.1       abs Fix:	rm /usr/lib/libbfd.a
    633    1.4    itojun 
    634    1.4    itojun Symptom:Obsolete intermediate files are used during compilation
    635    1.4    itojun Fix:	Try the following sequence of commands in the directory in question.
    636    1.4    itojun 	make cleandir; rm `make print-objdir`; make cleandir; make obj
    637    1.4    itojun 	(If you built the tree without "make obj" in the past, obsolete files
    638    1.4    itojun 	may remain.  The command tries to clean everything up)
    639    1.5       wiz 
    640  1.207   mbalmer Symptom:.../sysinst/run.c:xx: warning: initialization from incompatible
    641  1.207   mbalmer 	pointer type
    642    1.5       wiz Fix:	Rebuild and install usr.bin/menuc
    643   1.12    itojun 
    644   1.12    itojun Symptom:mklocale not found during build in share/locale/ctype
    645   1.12    itojun Fix:	Build and install usr.bin/mklocale
    646   1.13    dogcow 
    647   1.86    kleink Symptom:undefined reference to `__assert13' or `__unsetenv13'
    648   1.13    dogcow Fix:    Rebuild and install lib/libc
    649   1.13    dogcow 
    650  1.142  drochner Symptom:usr.bin/config fails to build.
    651   1.19       cgd Fix:	Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile.
    652   1.13    dogcow 
    653   1.19       cgd Symptom:undefined reference to `getprogname' or `setprogname'
    654   1.19       cgd Fix:    Rebuild and install lib/libc
    655   1.24       abs 
    656   1.24       abs Symptom:lint does not understand the '-X' option
    657   1.24       abs Fix:    May need to build & install libs with NOLINT=1 before rebuilding lint
    658  1.223     joerg 
    659  1.223     joerg Symptom:Update build fails in src/tools/gcc complaining that a variable
    660  1.223     joerg 	(e.g. CPPFLAGS) has changed since the previous run.
    661  1.223     joerg Fix:    Run "nbmake-${ARCH} clean" in src/tools/gcc or do a clean build.
    662