src/UPDATING - diff

Return to UPDATING CVS log

Up to [cvs.NetBSD.org] / src

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/UPDATING between version 1.24 and 1.162

version 1.24, 2001/05/27 23:34:22

version 1.162, 2007/06/10 00:45:08

Line 1

$NetBSD$

This file is intended to be a brief introduction to the build

This file (UPDATING) is intended to be a brief reference to recent

process and a reference on what to do if something doesn't work.

changes that might cause problems in the build process, and a guide for

what to do if something doesn't work.

For a more detailed description of the recommended way to build NetBSD

using build.sh, see the BUILDING file.

Note that much of the advice in this UPDATING file was written before

build.sh existed. Nevertheless, the advice here may be useful for

working around specific problems with build.sh.

For a more detailed description see Makefile.

See also: BUILDING, build.sh, Makefile.

Recent changes:

^^^^^^^^^^^^^^^

20010226:

20070422:

The way OS emulations lookup filenames inside the emulation root

Added named user/group to system. Need to hand add this in or builds

has been changed. Rather than modify the pathname (and copy back

will break as mtree aborts early.

to userspace) namei() and lookup() directly check the emulation

root. One side effect is that absolute symlinks inside the emulated

To work around add by hand:

root filesytem will be relative to that filesystem - unless they

start /../ this is useful when the emulated root is a real install

named:*:14:

that has such links.

This might affect symlinks that have been added to reference outside

to /etc/group and add:

the emulated root.

named:*:14:14::0:0:Named pseudo-user:/var/named:/sbin/nologin

20070412:

The pckbc driver on sgimips IP32 has been removed. Use macekbc

to master.passwd (use vipw for instance if doing by hand).

instead. See the GENERIC32_IP3x kernel configuration for an

example.

Now a make build should progress.

20070319:

20010219:

src/lib/libc/Makefile revision 1.129 broke libc and ld.elf_so

get/setprogname() added. Any hostprog's that may use this will need

on many platforms due to incorrect flags settings. If you

to be bootstrapped manually until the host system is current.

updated and built after about 20070315, do "nbmake-$arch

cleandir" in src/lib/libc and src/libexec/ld.elf_so to force a

Known problems: sys/arch/macppc/stand/fixcoff

rebuild of object files that might have been built

usr.sbin/config (adding -DMAKE_BOOTSTRAP to

incorrectly, and ensure that you have at least

CFLAGS and rebuilding should work)

src/lib/libc/Makefile 1.130.

usr.sbin/mdsetimage - Build a static copy if

building a snapshot before fully bootstrapped.

20070210:

src/sys/sys/{sa.h,savar.h} were removed.

20010204:

find ${OBJDIR} $ -name .depend -o -name '*.d' $ -print \

prepare the code to compile with stricter gcc flags. in

| xargs egrep -l '/sa.h|/savar.h' | xargs rm

particular start eliminating redundant declarations. Yacc

will allow dependencies on those files to get get rebuilt

needs to be installed before make build.

20070209:

20010114:

The threading model was changed when the newlock2 branch

introduce .if commands(target) in make(1). You need to

was merged to NetBSD-current. If you boot with a new

bring everything up-to-date first, then without installing

kernel (version 4.99.10), then you also need a new pthread

anything make and install in usr.bin/make, then proceed

library (/usr/lib/libpthread.so.0.7). If you boot with

with make build.

an old kernel, then you need the old pthread library

(/usr/lib/libpthread.so.0.6). Provided you keep the kernel and

20010101:

the pthread library in sync, old threaded applications should

bsd.subdir.mk committed 20001230 had a bug which caused

continue to work with an old or new kernel. Note that named(8)

afterinstall targets to run too soon; update again.

is the only threaded application in the base system.

20001230:

20061214:

New share/mk files needed to support .WAIT in SUBDIR variables.

Following the move of string_to_flags() and flags_to_string()

If you get make errors,

from the bin/ls/ sources to libutil, users doing UPDATE builds

(cd share/mk; make install)

will need to do a "make cleandir" in

Also, PRINTOBJDIR has changed and is now used more heavily.

tools/mtree/, tools/makefs/, tools/binstall/, tools/pax/,

bin/pax/, bin/ls/, usr.sbin/mtree/, usr.sbin/makefs/,

20001019:

usr.bin/xinstall/, libexec/ftpd/, rescue/, as well

The `ca' device driver has been replaced by `ld'; although the

as the installation images in distrib/

major and minor numbers haven't changed, you should update your /dev

in order to excise stale references to the old stat_flags.h header

directory.

file in the ls sources -- stat_flags.h has been removed.

20000929:

20061108:

The following make directives are obsoleted.

The configure script used in the src/tools/gcc compiler has been

MKCRYPTO_RSA NOCRYPTO_RSA NOCRYPTO_RC5 NOCRYPTO_IDEA

changed to indicate that our libc has ssp support built-in and

By default, RSA is built into libcrypto. IDEA and RC5 will not be

does not depend on -lssp and -lssp-nonshared. You'll need to

built into libcrypto. By using MKCRYPTO_{RC5,IDEA}, you can build

make clean in src/tools/gcc first to rebuild the compiler.

additional library libcrypto_{idea,rc5}.

20061009:

20000623:

The sysctl variables net.inet{,6}.tcp{,6}.newreno are no longer

MKCRYPTO and friends added to share/mk/bsd.own.mk.

available. Use net.inet{,6}.tcp{,6}.congctl.selected instead.

'cd share/mk ; make install' needed before make build.

20060814:

The vt, vidcconsole, kbd, and rpckbd drivers on acorn32 have been

withdrawn. Use vidcvideo and pckbd instead. See the GENERIC

kernel configuration for an example. X servers from the last

few years should cope.

20060703:

MPACPI is no more. We always configure PCI interrupts using ACPI

if we have an ACPI kernel. The option MPACPI_SCANPCI has been renamed

to ACPI_SCANPCI. Thanks to work from fvdl.

20060627:

socket(2) has changed, and its system call has been versioned.

For userlands with the old version of socket(2), make sure that

your kernel has 'options COMPAT_30' set, or else 'bad system call'

errors will result.

Hints for a more successful build:

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Use build.sh, but do not use its "expert mode":

This will automatically build the tools in the

correct order, and it will keep the tools and the

new build products from interfering with the running

system. This will allow you to ignore most of the

other advice in this file.

Build a new kernel first:

This makes sure that any new system calls or features

expected by the new userland will be present. This

Line 85 Hints for a more successful build:

Line 114 Hints for a more successful build:

about one. It also makes it easier to clean up after

a build. It's also necessary if you want to use the

same source tree for multiple machines.

To use object directories:

To use object directories with build.sh:

a) invoke build.sh with the "-M" or "-O" options.

To use object directories without using build.sh:

a) cd /usr/src ; make cleandir

b) Add "OBJMACHINE=yes" to /etc/mk.conf

c) Add "MKOBJDIRS=yes" to /etc/mk.conf

Line 93 Hints for a more successful build:

Line 124 Hints for a more successful build:

Note that running "make obj" in a directory will create

in obj.$MACHINE directory.

Build to a DESTDIR:

This helps to keep old

This helps to keep old installed files (especially libraries)

installed files (especially libraries) from interfering

from interfering with the new build.

with the new build.

To build to a DESTDIR with build.sh, use the "-D" option.

To build to a DESTDIR, set the DESTDIR environment

To build to a DESTDIR without using build.sh, set the DESTDIR

variable before running make build. It should be set to

environment variable before running make build. It should be

the pathname of an initially empty directory.

set to the pathname of an initially empty directory.

Problems: you might need to update critical utilities

Problems: if you do not use build.sh, you might need to

without using DESTDIR since nothing is executed

update critical utilities without using DESTDIR since

from what is installed in DESTDIR.

nothing is executed from what is installed in DESTDIR.

(See critical utils, below)

(See critical utils, below.)

Build often:

This keeps critical utilities current enough to not choke

on any other part of the source tree that depends on up to

date functionality.

date functionality. If you use build.sh, you should not have

this problem.

What to do if things don't work:

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Line 142 for anyone who uses any make(1) features

Line 174 for anyone who uses any make(1) features

#!/bin/sh

. /etc/mk.conf

if [ -z $BSDSRCDIR ] ; then

if [ -z $NETBSDSRCDIR ] ; then

BSDSRCDIR=/usr/src

NETBSDSRCDIR=/usr/src

if [ \! -d $BSDSRCDIR ] ; then

if [ \! -d $NETBSDSRCDIR ] ; then

echo Unable to find sources

exit 1

find $BSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \;

find $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \;

if [ -z $BSDOBJDIR ] ; then

BSDOBJDIR=/usr/obj

Line 158 if [ -d $BSDOBJDIR ] ; then

Line 190 if [ -d $BSDOBJDIR ] ; then

rm -rf $BSDOBJDIR

cd $BSDSRCDIR && make cleandir

cd $NETBSDSRCDIR && make cleandir

---cut here---

Critical utilities:

^^^^^^^^^^^^^^^^^^^

gnu/usr.bin/egcs

usr.bin/compile_et

usr.bin/make

usr.bin/yacc

usr.bin/lex

usr.bin/xlint

usr.sbin/config

usr.bin/config