NetBSD/UPDATING

166 lines
5.1 KiB
Plaintext

$NetBSD: UPDATING,v 1.9 2001/01/01 15:29:16 sommerfeld Exp $
This file is intended to be a brief introduction to the build
process and a reference on what to do if something doesn't work.
For a more detailed description see Makefile.
Recent changes:
^^^^^^^^^^^^^^^
20010101:
bsd.subdir.mk committed 20001230 had a bug which caused
afterinstall targets to run too soon; update again.
20001230:
New share/mk files needed to support .WAIT in SUBDIR variables.
If you get make errors,
(cd share/mk; make install)
Also, PRINTOBJDIR has changed and is now used more heavily.
20001019:
The `ca' device driver has been replaced by `ld'; although the
major and minor numbers haven't changed, you should update your /dev
directory.
20000929:
The following make directives are obsoleted.
MKCRYPTO_RSA NOCRYPTO_RSA NOCRYPTO_RC5 NOCRYPTO_IDEA
By default, RSA is built into libcrypto. IDEA and RC5 will not be
bulit into libcrypto. By using MKCRYPTO_{RC5,IDEA}, you can build
additional library libcrypto_{idea,rc5}.
20000623:
MKCRYPTO and friends added to share/mk/bsd.own.mk.
'cd share/mk ; make install' needed before make build.
Hints for a more successful build:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Build a new kernel first:
This makes sure that any new system calls or features
expected by the new userland will be present. This
helps to avoid critical errors when upgrading.
Use object directories:
This helps to keep stale object
files from polluting the build if a Makefile "forgets"
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:
a) cd /usr/src ; make cleandir
b) Add "OBJMACHINE=yes" to /etc/mk.conf
c) Add "MKOBJDIRS=yes" to /etc/mk.conf
d) cd /usr/src ; make build
Note that running "make obj" in a directory will create
in obj.$MACHINE directory.
Build to a DESTDIR:
This helps to keep old
installed files (especially libraries) from interfering
with the new build.
To build to a DESTDIR, set the DESTDIR environment
variable before running make build. It should be set to
the pathname of an initially empty directory.
Problems: you might need to update critical utilities
without using DESTDIR since nothing is executed
from what is installed in DESTDIR.
(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.
What to do if things don't work:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
When things don't work there is usually a few things that commonly
should be done.
1) make includes
This should be done automatically by make build.
2) cd share/mk && make install
Again, automatically done by make build.
Failsafe rebuild of a small part of the tree:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To make sure you rebuild something correctly you want to do
something like the following:
1) Make sure the includes and .mk files are up to date.
2) Make sure any program used to build the particular
utility is up to date. (yacc, lex, etc...)
3) cd ...path/to/util...
make cleandir
rm ...all obj directories...
make cleandir # yes, again
make obj
make depend && make
Failsafe rebuild of the entire tree:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If you really want to make sure the source tree is clean and
ready for a build try the following. Note that sourcing /etc/mk.conf
(a make(1) Makefile) in this manner is not right, and will not work
for anyone who uses any make(1) features in /etc/mk.conf.
---cut here---
#!/bin/sh
. /etc/mk.conf
if [ -z $BSDSRCDIR ] ; then
BSDSRCDIR=/usr/src
fi
if [ \! -d $BSDSRCDIR ] ; then
echo Unable to find sources
exit 1
fi
find $BSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \;
if [ -z $BSDOBJDIR ] ; then
BSDOBJDIR=/usr/obj
fi
if [ -d $BSDOBJDIR ] ; then
rm -rf $BSDOBJDIR
fi
cd $BSDSRCDIR && make cleandir
---cut here---
Critical utilities:
^^^^^^^^^^^^^^^^^^^
gnu/usr.bin/egcs
usr.bin/compile_et
usr.bin/make
usr.bin/yacc
usr.bin/lex
usr.sbin/config
Other problems and possibly solutions:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Symptom:Unreasonable compiler errors.
Fix: Rebuild gnu/usr.bin/egcs
Symptom:Complaints involving a Makefile.
Fix: Make sure .mk files are up to date.
cd share/mk && make install
Fix: Rebuild usr.bin/make
Symptom:Kernel `config' fails to configure any kernel, including GENERIC.
Fix: Rebuild usr.sbin/config
Symptom:
Fix: Rebuild usr.bin/yacc
Symptom:
Fix: Rebuild usr.bin/lex
Symptom:
Fix: rm /usr/lib/libbfd.a
Symptom:Obsolete intermediate files are used during compilation
Fix: Try the following sequence of commands in the directory in question.
make cleandir; rm `make print-objdir`; make cleandir; make obj
(If you built the tree without "make obj" in the past, obsolete files
may remain. The command tries to clean everything up)
Symptom:.../sysinst/run.c:xx: warning: initialization from incompatible pointer type
Fix: Rebuild and install usr.bin/menuc