version 1.234.2.1, 2012/02/16 19:56:43 |
version 1.260, 2015/03/11 08:50:32 |
Line 11 Note that much of the advice in this UPD |
|
Line 11 Note that much of the advice in this UPD |
|
build.sh existed. Nevertheless, the advice here may be useful for |
build.sh existed. Nevertheless, the advice here may be useful for |
working around specific problems with build.sh. |
working around specific problems with build.sh. |
|
|
|
Sections are marked with "^^^^^". After the section on "Recent changes" |
|
are several sections containing more general information. |
|
|
See also: BUILDING, build.sh, Makefile. |
See also: BUILDING, build.sh, Makefile. |
|
|
Recent changes: |
Recent changes: |
^^^^^^^^^^^^^^^ |
^^^^^^^^^^^^^^^ |
|
|
|
20150310: |
|
Improvements to openssl for arm mean that update builds of |
|
the openssl libraries will fail. A make cleandir in |
|
external/bsd/openssl/lib is needed |
|
|
|
20141026: |
|
A mishap during the import of pppd may cause your corruption |
|
in your cvs directory if you happened to do a cvs update |
|
during a short period of time. To fix, just remove the |
|
directory src/external/bsd/ppp/dist/pppd completely |
|
and let cvs restore it on next update. |
|
|
|
20140721: |
|
The src/external/mit/lua/src directory was accidentally created |
|
and then deleted in the CVS repository. If you get errors like |
|
|
|
cvs [update aborted]: cannot open directory |
|
/cvsroot/src/external/mit/lua/src: No such file or directory |
|
|
|
then delete your local copy of that directory tree and try again. |
|
|
|
20140530: |
|
ARM eABI switched to DWARF based exception handling. This requires |
|
rebuilding all C++ code. It is strongly advised to do a clean build. |
|
|
|
20140131: |
|
The new compiler_rt/libc integration moved a few things. It is strongly |
|
advised to do a clean build. At least lib/libc, the compat version(s) |
|
of libc, libkern, rump and the kernels need to be cleaned. |
|
|
|
20131227: |
|
1. The new ntpd runs in a restricted mode to prevent amplification |
|
attacks. If you need ntpdc to work you need to explicitly enable |
|
mode7 in your config file. Make sure you put the necessary restrict |
|
statements to avoid being exposed. |
|
2. strncat has moved from lib/libc to common/lib/libc; you might need |
|
to make clean in libc |
|
|
|
20131129: |
|
The GMP sources were updated, and builds will likely fail without |
|
cleaning their build trees for both tools and in-tree, like below. |
|
|
|
20131128: |
|
The MPC and MPFR sources were updated, and builds may require their |
|
tools and in-tree directories cleaned for successful updates. |
|
|
|
20130605: |
|
The kernel option FAST_IPSEC no longer exists, it's been renamed |
|
to IPSEC (and the older IPSEC version removed). |
|
|
|
20130605: |
|
Previous freetype installations eroneously installed private |
|
header files. If you are building against a non-empty $DESTDIR, |
|
please remove ${DESTDIR}//usr/X11R7/include/freetype2/freetype/. |
|
|
|
20130531: |
|
The xdm update may cause build failure due to xdm.man being |
|
in the obj tree. Make sure to ensure any like this: |
|
nbmake: nbmake: don't know how to make xdm.man. Stop |
|
is fixed by deleting the xdm.man in the obj tree. |
|
|
|
20130530: |
|
Updates of many xsrc packages will leave old .pc files around. |
|
Best to clean out the xsrc objdir entirely before rebuilds. |
|
|
|
20130301: |
|
The removal of netiso requires manual removal of /usr/include/netiso |
|
prior to the build and make cleandir in /usr/src/usr.bin/{ktruss,kdump} |
|
|
|
20120726: |
|
The update of OpenSSL requires cleaning both the OpenSSL build |
|
directory and DESTDIR. *Even non-update builds require cleaning |
|
DESTDIR.* Builds done without taking these steps may fail, or in |
|
some cases may succeed and install broken OpenSSL libraries that |
|
cause third-party software to link incorrectly and/or crash. |
|
|
|
20120507: |
|
The database schema for makemandb was changed. You will |
|
need to update the database using 'makemandb -f' or wait |
|
for the next weekly run to fix it. |
|
|
|
20120319: |
|
sys/conf/Makefile.kern.inc has been modified to adjust the |
|
size of db_symtab automatically. You need to update dbsym in |
|
your $TOOLDIR to build kernels with options SYMTAB_SPACE. If |
|
you don't want this behavior, add AUTO_SYMTAB_SPACE=no to your |
|
mk.conf. |
|
|
20120216: |
20120216: |
Default for MKCATPAGES changed to NO. Update builds will fail |
Default for MKCATPAGES changed to NO. Update builds will fail |
unless DESTDIR is cleaned manually. If you built between 20120207 |
unless DESTDIR is cleaned manually. If you built between 20120207 |
and 20120216, daily and weekly could have created an unreable |
and 20120216, daily and weekly could have created an unreadable |
/var/db/man.db index for apropos. Running makemandb -f or |
/var/db/man.db index for apropos. Running makemandb -f or |
the next run of weekly will fix it. |
the next run of weekly will fix it. |
|
|
20111227: |
20111227: |
|
|
bit compatibility very painful) has been fixed in a |
bit compatibility very painful) has been fixed in a |
non-backwards-compatible way. If you replace your kernel, |
non-backwards-compatible way. If you replace your kernel, |
replace your rndctl executable too. |
replace your rndctl executable too. |
|
|
20111001: |
20111001: |
the prop_*_send_syscall() functions from proplib(3) have been |
the prop_*_send_syscall() functions from proplib(3) have been |
changed and their new version is not backward compatible with the old |
changed and their new version is not backward compatible with the old |
one. So ensure that all consumers of these functions (currently: |
one. So ensure that all consumers of these functions (currently: |
quota2 code and its tests) are updated together with the new lib. |
quota2 code and its tests) are updated together with the new lib. |
|
|
20110817: |
20110817: |
|
|
sparc64, mips and powerpc platforms have changed. |
sparc64, mips and powerpc platforms have changed. |
|
|
20110803: |
20110803: |
The layout of external/public-domain/xz has changed. To do an |
The layout of external/public-domain/xz has changed. To do an |
update build you will have to remove the contents of the OBJDIR |
update build you will have to remove the contents of the OBJDIR |
for external/public-domain/xz/bin by hand as the xz entry there |
for external/public-domain/xz/bin by hand as the xz entry there |
is now a directory. |
is now a directory. |
|
|
20110410: |
20110410: |
The configuration of src/tools/gcc has changed. To do an |
The configuration of src/tools/gcc has changed. To do an |
update build you have to clean both tools/binutils and |
update build you have to clean both tools/binutils and |
tools/gcc by hand. |
tools/gcc by hand. |
|
|
20110328: |
20110328: |
Building the Xorg binary was moved into a subdirectory to fix |
Building the Xorg binary was moved into a subdirectory to fix |
ordering issues with "make all". It may be necessary to remove |
ordering issues with "make all". It may be necessary to remove |
the OBJDIR for external/mit/xorg/server/xorg-server/hw/xfree86 |
the OBJDIR for external/mit/xorg/server/xorg-server/hw/xfree86 |
if your update build fails, as the "Xorg" entry there is now a |
if your update build fails, as the "Xorg" entry there is now a |
directory. |
directory. |
|
|
|
|
20101217: |
20101217: |
The tcpdump(8) program was changed to drop privileges and chroot(2) |
The tcpdump(8) program was changed to drop privileges and chroot(2) |
by default. It may be necessary to manually update passwd(5) and |
by default. It may be necessary to manually update passwd(5) and |
group(5) in order to make the program work with existing setups. |
group(5) in order to make the program work with existing setups. |
|
|
20101125: |
20101125: |
The latest changes to setenv(3) dissallow setting environment |
The latest changes to setenv(3) dissallow setting environment |
variables with names that contain '='. Revision 1.18 of env.c |
variables with names that contain '='. Revision 1.18 of env.c |
assumed that this was allowed. Installing a new libc with an |
assumed that this was allowed. Installing a new libc with an |
old copy of /usr/bin/env causes env x=1 printenv | grep x= to |
old copy of /usr/bin/env causes env x=1 printenv | grep x= to |
break which affects the autoconf tests for dependency finding, |
break which affects the autoconf tests for dependency finding, |
so building gcc will end up printing: |
so building gcc will end up printing: |
|
|
include ctype_local.h, so you have to make cleandir in tools/mklocale. |
include ctype_local.h, so you have to make cleandir in tools/mklocale. |
|
|
20100520: |
20100520: |
The location of the xkb compiled descriptions has changed. Please |
The location of the xkb compiled descriptions has changed. Please |
remove usr/X11R7/lib/X11/xkb/compiled from your $DESTDIR. |
remove usr/X11R7/lib/X11/xkb/compiled from your $DESTDIR. |
|
|
20100222: |
20100222: |
|
|
|
|
20090718: |
20090718: |
libc build changed so that strchr() provides the extra entry |
libc build changed so that strchr() provides the extra entry |
point for index(). Update build of libc.a (and libc_pic.a) |
point for index(). Update build of libc.a (and libc_pic.a) |
may fail because the archive contains the unwanted index.o. |
may fail because the archive contains the unwanted index.o. |
(Similarly for strrchr() and rindex().) |
(Similarly for strrchr() and rindex().) |
|
|
|
|
20090501: |
20090501: |
Several new functions were added to string.h/libc, and this |
Several new functions were added to string.h/libc, and this |
can cause autoconf problems during the tool build for people |
can cause autoconf problems during the tool build for people |
who fail to clean out their tools objects properly. If you |
who fail to clean out their tools objects properly. If you |
note messages about stpcpy, stpncpy or strnlen accompanying a |
note messages about stpcpy, stpncpy or strnlen accompanying a |
failure during the tool build, clean out all your tools |
failure during the tool build, clean out all your tools |
objects and start again. |
objects and start again. |
|
|
cleaning your src/tools directory and $TOOLDIR and rebuilding them. |
cleaning your src/tools directory and $TOOLDIR and rebuilding them. |
|
|
20090126: |
20090126: |
The __posix_fadvise50 system call changed assembly stub type. You |
The __posix_fadvise50 system call changed assembly stub type. You |
need to 'rm -f __posix_fadvise50.*' in the libc build directory |
need to 'rm -f __posix_fadvise50.*' in the libc build directory |
to avoid using the old assembly stub. |
to avoid using the old assembly stub. |
|
|
|
|
``pkg_admin rebuild''. |
``pkg_admin rebuild''. |
|
|
20090110: |
20090110: |
time_t and dev_t have been bumped to 64 bit quantities. To upgrade: |
time_t and dev_t have been bumped to 64 bit quantities. To upgrade: |
1. Make sure your kernel has COMPAT_50 in it. Build and install. |
1. Make sure your kernel has COMPAT_50 in it. Build and install. |
This is needed even in the MODULAR kernel because there is |
This is needed even in the MODULAR kernel because there is |
conditionally compiled code in rtsock.c. |
conditionally compiled code in rtsock.c. |
2. make sure build.sh completes and the binaries in a chroot work |
2. make sure build.sh completes and the binaries in a chroot work |
before installing. |
before installing. |
3. If you don't use build.sh and you build directly to root, and |
3. If you don't use build.sh and you build directly to root, and |
your build breaks in the middle, don't despair. Make sure headers |
your build breaks in the middle, don't despair. Make sure headers |
are installed properly, and start building libraries first libc |
are installed properly, and start building libraries first libc |
and libutil, install them and then continue building all the |
and libutil, install them and then continue building all the |
libraries in src/lib and src/gnu/lib and install them. Once |
libraries in src/lib and src/gnu/lib and install them. Once |
the new libraries are installed, you can restart the build. |
the new libraries are installed, you can restart the build. |
4. If you compile packages and you notice link time warnings, |
4. If you compile packages and you notice link time warnings, |
rebuild the required packages to update their shared libraries. |
rebuild the required packages to update their shared libraries. |
|
|
will be upgraded and it will not be backwards compatible. |
will be upgraded and it will not be backwards compatible. |
6. The utmpx/wtmpx files (/var/run/utmpx and /var/log/wtmpx, see |
6. The utmpx/wtmpx files (/var/run/utmpx and /var/log/wtmpx, see |
lastlogx(5)) have been versioned, and there is a heuristic |
lastlogx(5)) have been versioned, and there is a heuristic |
for utmp. You are better off removing the old files after |
for utmp. You are better off removing the old files after |
upgrading. The automated clearing of /var/run during |
upgrading. The automated clearing of /var/run during |
boot, and the automated rotating of files in /var/log by |
boot, and the automated rotating of files in /var/log by |
newsyslog(8), may mean that you do not have to remove the |
newsyslog(8), may mean that you do not have to remove the |
|
|
/etc/daily limits the bad consequences of failure to remove |
/etc/daily limits the bad consequences of failure to remove |
the file. |
the file. |
8. Application software that writes time_t to binary files on |
8. Application software that writes time_t to binary files on |
disk will break or need attention. Most notably: if you are |
disk will break or need attention. Most notably: if you are |
using PostgreSQL < 8.4, you need to dump your databases, |
using PostgreSQL < 8.4, you need to dump your databases, |
rebuild PostgreSQL with the new time_t, then restore. |
rebuild PostgreSQL with the new time_t, then restore. |
|
|
|
|
|
|
20080813: |
20080813: |
MKDEBUG build was broken because the .depend files did not know |
MKDEBUG build was broken because the .depend files did not know |
about .go files. You need to remove all .depend files and rebuild. |
about .go files. You need to remove all .depend files and rebuild. |
|
|
20080802: |
20080802: |
A regression in binary compatibility for pthread_mutex_t has |
A regression in binary compatibility for pthread_mutex_t has |
been fixed. Unfortunately, the price is breaking compatibility |
been fixed. Unfortunately, the price is breaking compatibility |
for -current. |
for -current. |
|
|
Threaded programs (using libpthread) and C++ programs (using |
Threaded programs (using libpthread) and C++ programs (using |
|
|
isn't defined. |
isn't defined. |
|
|
20080531: |
20080531: |
The ioctl number of DRVSUSPENDDEV command on /dev/drvctl changed |
The ioctl number of DRVSUSPENDDEV command on /dev/drvctl changed |
from 125 (conflicted with DRVCTLCOMMAND) to 129. The drvctl(8) |
from 125 (conflicted with DRVCTLCOMMAND) to 129. The drvctl(8) |
utility needs to be rebuilt and reinstalled as older binaries |
utility needs to be rebuilt and reinstalled as older binaries |
won't work correctly. The following sequence of commands: |
won't work correctly. The following sequence of commands: |
|
|
$ (cd sys/sys/ && nbmake-$arch includes) |
$ (cd sys/sys/ && nbmake-$arch includes) |
$ (cd sbin/drvctl/ && nbmake-$arch clean) |
$ (cd sbin/drvctl/ && nbmake-$arch clean) |
|
|
|
|
20080126: |
20080126: |
The posix_fadvise system call has been changed from an assembly |
The posix_fadvise system call has been changed from an assembly |
stub, to a c file that calls an assembly stub. You need to |
stub, to a c file that calls an assembly stub. You need to |
'rm -f posix_fadvise.* .depend' in the libc build directory to |
'rm -f posix_fadvise.* .depend' in the libc build directory to |
avoid using the old assembly stub. |
avoid using the old assembly stub. |
|
|
20071209: |
20071209: |
The acpiec(4) driver has been split into two attachments. If you |
The acpiec(4) driver has been split into two attachments. If you |
get ACPI errors before the attachment, please update your kernel |
get ACPI errors before the attachment, please update your kernel |
configuration file appropriately or see GENERIC for more details. |
configuration file appropriately or see GENERIC for more details. |
|
|
20071115: |
20071115: |
The it(4) driver has been renamed to itesio(4) and the old port |
The it(4) driver has been renamed to itesio(4) and the old port |
argument specified in the kernel configuration file is not valid |
argument specified in the kernel configuration file is not valid |
anymore. The itesio(4) driver now uses the Super I/O address port |
anymore. The itesio(4) driver now uses the Super I/O address port |
rather than the EC address port. Please update your kernel |
rather than the EC address port. Please update your kernel |
configuration file appropriately or see GENERIC for more details. |
configuration file appropriately or see GENERIC for more details. |
|
|
20071028: |
20071028: |
|
|
and userland are from after 20070913. |
and userland are from after 20070913. |
|
|
20070703: |
20070703: |
nbinstall has been renamed ${MACHINE_GNU_ARCH}-install. It |
nbinstall has been renamed ${MACHINE_GNU_ARCH}-install. It |
calls the target-specific strip program, and the logic to pass |
calls the target-specific strip program, and the logic to pass |
down STRIP from make has been removed. This requires a |
down STRIP from make has been removed. This requires a |
re-installation of tools. |
re-installation of tools. |
|
|
The way OS emulations lookup filenames inside the emulation root |
The way OS emulations lookup filenames inside the emulation root |
has been changed. Rather than modify the pathname (and copy back |
has been changed. Rather than modify the pathname (and copy back |
to userspace) namei() and lookup() directly check the emulation |
to userspace) namei() and lookup() directly check the emulation |
root. One side effect is that absolute symlinks inside the emulated |
root. One side effect is that absolute symlinks inside the emulated |
root file system will be relative to that file system - unless they |
root file system will be relative to that file system - unless they |
start /../ this is useful when the emulated root is a real install |
start /../ this is useful when the emulated root is a real install |
that has such links. |
that has such links. |
|
|
the emulated root. |
the emulated root. |
|
|
20070412: |
20070412: |
The pckbc driver on sgimips IP32 has been removed. Use macekbc |
The pckbc driver on sgimips IP32 has been removed. Use macekbc |
instead. See the GENERIC32_IP3x kernel configuration for an |
instead. See the GENERIC32_IP3x kernel configuration for an |
example. |
example. |
|
|
20070319: |
20070319: |
|
|
incorrectly, and ensure that you have at least |
incorrectly, and ensure that you have at least |
src/lib/libc/Makefile 1.130. |
src/lib/libc/Makefile 1.130. |
|
|
20070210: |
20070210: |
src/sys/sys/{sa.h,savar.h} were removed. |
src/sys/sys/{sa.h,savar.h} were removed. |
find ${OBJDIR} \( -name .depend -o -name '*.d' \) -print \ |
find ${OBJDIR} \( -name .depend -o -name '*.d' \) -print \ |
| xargs egrep -l '/sa.h|/savar.h' | xargs rm |
| xargs egrep -l '/sa.h|/savar.h' | xargs rm |
|
|
20061108: |
20061108: |
The configure script used in the src/tools/gcc compiler has been |
The configure script used in the src/tools/gcc compiler has been |
changed to indicate that our libc has ssp support built-in and |
changed to indicate that our libc has ssp support built-in and |
does not depend on -lssp and -lssp-nonshared. You'll need to |
does not depend on -lssp and -lssp-nonshared. You'll need to |
make clean in src/tools/gcc first to rebuild the compiler. |
make clean in src/tools/gcc first to rebuild the compiler. |
|
|
20061009: |
20061009: |
The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer |
The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer |
available. Use net.inet{,6}.tcp{,6}.congctl.selected instead. |
available. Use net.inet{,6}.tcp{,6}.congctl.selected instead. |
|
|
20060814: |
20060814: |
The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been |
The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been |
|
|
few years should cope. |
few years should cope. |
|
|
20060703: |
20060703: |
MPACPI is no more. We always configure PCI interrupts using ACPI |
MPACPI is no more. We always configure PCI interrupts using ACPI |
if we have an ACPI kernel. The option MPACPI_SCANPCI has been renamed |
if we have an ACPI kernel. The option MPACPI_SCANPCI has been renamed |
to ACPI_SCANPCI. Thanks to work from fvdl. |
to ACPI_SCANPCI. Thanks to work from fvdl. |
|
|
20060627: |
20060627: |
socket(2) has changed, and its system call has been versioned. |
socket(2) has changed, and its system call has been versioned. |
Line 486 Hints for a more successful build: |
|
Line 577 Hints for a more successful build: |
|
on any other part of the source tree that depends on up to |
on any other part of the source tree that depends on up to |
date functionality. If you use build.sh, you should not have |
date functionality. If you use build.sh, you should not have |
this problem. |
this problem. |
|
|
What to do if things don't work: |
What to do if things don't work: |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
When things don't work there are usually a few things that commonly |
When things don't work there are usually a few things that commonly |
Line 601 Fix: May need to build & install libs |
|
Line 692 Fix: May need to build & install libs |
|
Symptom:Update build fails in src/tools/gcc complaining that a variable |
Symptom:Update build fails in src/tools/gcc complaining that a variable |
(e.g. CPPFLAGS) has changed since the previous run. |
(e.g. CPPFLAGS) has changed since the previous run. |
Fix: Run "nbmake-${ARCH} clean" in src/tools/gcc or do a clean build. |
Fix: Run "nbmake-${ARCH} clean" in src/tools/gcc or do a clean build. |
|
|
|
Symptom:cvs [update aborted]: cannot open directory /cvsroot/src/...: |
|
No such file or directory. |
|
Cause: If a directory is created by mistake, then it is sometimes |
|
deleted from the CVS repository using administrative commands |
|
that bypass the normal cvs access controls. If your cvs working tree |
|
contains references to a directory that has been deleted on the |
|
server in this way, then "cvs update" reports this error. |
|
Fix: Recursively delete the affected directory from your working tree |
|
and try the update again. |