src/BUILDING - diff

Return to BUILDING 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/BUILDING between version 1.62 and 1.62.4.2

version 1.62, 2007/04/13 19:43:38

version 1.62.4.2, 2008/01/09 01:19:18

Line 3 BUILDING(8) NetBSD System Ma

NAME

BUILDING -- Procedure for building NetBSD from source code.

STATUS

This document is a work-in-progress. As such, the information described

here may not match the reality of the build system as of this writing.

Once this document is completely in sync with reality, this paragraph

will be removed.

Discrepancies between this documentation and the current reality of

implementation are noted specially, as with the note below:

Note: This document applies only to platforms which use the new toolchain

as indicated by the default setting of TOOLCHAIN_MISSING in <bsd.own.mk>.

Platforms which have not yet been switched to the new toolchain should

continue building traditionally, using the notes specified in the file

UPDATING.

REQUIREMENTS

NetBSD is designed to be buildable on most POSIX-compliant host systems.

The basic build procedure is the same whether compiling natively (on the

Line 542 BUILDING

Line 527 BUILDING

ity, which is not part of NetBSD, but which can be

installed from pkgsrc/sysutils/cdrtools.

iso-image-source

Create a NetBSD installation CD-ROM image in the

RELEASEDIR/iso directory. The CD-ROM file system will have

a layout as described in release(7). It will have top

level directories for the machine type and source.

For most machine types, the CD-ROM will be bootable, and

will automatically run the sysinst(8) menu-based installa-

tion program, which can be used to install or upgrade a

NetBSD system. Bootable CD-ROMs also contain tools that

may be useful in repairing a damaged NetBSD installation.

Before ``make iso-image-source'' is attempted, RELEASEDIR

must be populated by ``make sourcesets release'' or equiva-

lent.

Note that other, smaller, CD-ROM images may be created in

the RELEASEDIR/MACHINE/installation/cdrom directory by

``make release''. These smaller images usually contain the

same tools as the larger images in RELEASEDIR/iso, but do

not contain additional content such as the distribution

sets.

Note that the mac68k port still uses an older method of

creating CD-ROM images. This requires the mkisofs(1) util-

ity, which is not part of NetBSD, but which can be

installed from pkgsrc/sysutils/cdrtools.

regression-tests

Can only be run after building the regression tests in the

directory ``regress''. Runs the compiled regression tests

Line 611 BUILDING

Line 624 BUILDING

iso-image Perform ``make iso-image''.

iso-image-source

Perform ``make iso-image-source''.

The following command line options alter the behaviour of the build.sh

operations described above:

Line 618 BUILDING

Line 634 BUILDING

-B buildid

Set the value of BUILDID to buildid. This will also append the

build idenfitier to the name of the ``make'' wrapper script so

build identifier to the name of the ``make'' wrapper script so

that the resulting name is of the form

``nbmake-MACHINE-BUILDID''.

-C cdextras

Set the value of CDEXTRA to cdextras which is a space-separated

list of files or directories which will be added in order to

the CD-ROM image when used in conjunction with ``iso-image'' or

``iso-image-source''. Files will be added to the root of the

CD-ROM image, whereas directories will be copied recursively.

If relative paths are specified, they will be converted to

absolute paths before being used.

-D dest Set the value of DESTDIR to dest. If a relative path is speci-

fied, it will be converted to an absolute path before being

used.

Line 786 HISTORY

Line 811 HISTORY

BUGS

A few platforms are not yet using this build system.

NetBSD April 13, 2007 NetBSD

NetBSD September 1, 2007 NetBSD

CVSweb <webmaster@jp.NetBSD.org>