[BACK]Return to BUILDING CVS log [TXT][DIR] 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.59.2.2.2.1 and 1.69

version 1.59.2.2.2.1, 2007/09/30 20:27:36 version 1.69, 2008/03/18 04:24:38
Line 3  BUILDING(8)             NetBSD System Ma
Line 3  BUILDING(8)             NetBSD System Ma
 NAME  NAME
      BUILDING -- Procedure for building NetBSD from source code.       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  REQUIREMENTS
      NetBSD is designed to be buildable on most POSIX-compliant host systems.       NetBSD is designed to be buildable on most POSIX-compliant host systems.
      The basic build procedure is the same whether compiling natively (on the       The basic build procedure is the same whether compiling natively (on the
Line 469  BUILDING
Line 454  BUILDING
      Additional make(1) targets are usable specifically from the top source       Additional make(1) targets are usable specifically from the top source
      level to facilitate building the entire NetBSD source tree.       level to facilitate building the entire NetBSD source tree.
   
      build         Build the entire NetBSD system.  This orders portions of       build         Build the entire NetBSD system (except the kernel).  This
                    the source tree such that prerequisites will be built in                     orders portions of the source tree such that prerequisites
                    the proper order.                     will be built in the proper order.
   
      distribution  Do a ``make build'', and then install a full distribution       distribution  Do a ``make build'', and then install a full distribution
                    into DESTDIR, including files in DESTDIR/dev, DESTDIR/etc,                     (which does not include a kernel) into DESTDIR, including
                    DESTDIR/root and DESTDIR/var.                     files in DESTDIR/dev, DESTDIR/etc, DESTDIR/root and
                      DESTDIR/var.
   
      buildworld    As per ``make distribution'', except that it ensures that       buildworld    As per ``make distribution'', except that it ensures that
                    DESTDIR is not the root directory.                     DESTDIR is not the root directory.
Line 499  BUILDING
Line 485  BUILDING
                    to fix them).                     to fix them).
   
      sets          Create distribution sets from DESTDIR into       sets          Create distribution sets from DESTDIR into
                    RELEASEDIR/MACHINE/binary/sets.  Should be run after ``make                     RELEASEDIR/RELEASEMACHINEDIR/binary/sets.  Should be run
                    distribution'' (as ``make build'' does not install all of                     after ``make distribution'' (as ``make build'' does not
                    the required files).                     install all of the required files).
   
      sourcesets    Create source sets of the source tree into       sourcesets    Create source sets of the source tree into
                    RELEASEDIR/source/sets.                     RELEASEDIR/source/sets.
   
      syspkgs       Create syspkgs from DESTDIR into       syspkgs       Create syspkgs from DESTDIR into
                    RELEASEDIR/MACHINE/binary/syspkgs.  Should be run after                     RELEASEDIR/RELEASEMACHINEDIR/binary/syspkgs.  Should be run
                    ``make distribution'' (as ``make build'' does not install                     after ``make distribution'' (as ``make build'' does not
                    all of the required files).                     install all of the required files).
   
      release       Do a ``make distribution'', build kernels, distribution       release       Do a ``make distribution'', build kernels, distribution
                    media, and install sets (this as per ``make sets''), and                     media, and install sets (this as per ``make sets''), and
Line 531  BUILDING
Line 517  BUILDING
                    populated by ``make release'' or equivalent.                     populated by ``make release'' or equivalent.
   
                    Note that other, smaller, CD-ROM images may be created in                     Note that other, smaller, CD-ROM images may be created in
                    the RELEASEDIR/MACHINE/installation/cdrom directory by                     the RELEASEDIR/RELEASEMACHINEDIR/installation/cdrom direc-
                    ``make release''.  These smaller images usually contain the                     tory by ``make release''.  These smaller images usually
                    same tools as the larger images in RELEASEDIR/iso, but do                     contain the same tools as the larger images in
                    not contain additional content such as the distribution                     RELEASEDIR/iso, but do not contain additional content such
                    sets.                     as the distribution sets.
   
                    Note that the mac68k port still uses an older method of                     Note that the mac68k port still uses an older method of
                    creating CD-ROM images.  This requires the mkisofs(1) util-                     creating CD-ROM images.  This requires the mkisofs(1) util-
Line 559  BUILDING
Line 545  BUILDING
                    lent.                     lent.
   
                    Note that other, smaller, CD-ROM images may be created in                     Note that other, smaller, CD-ROM images may be created in
                    the RELEASEDIR/MACHINE/installation/cdrom directory by                     the RELEASEDIR/RELEASEMACHINEDIR/installation/cdrom direc-
                    ``make release''.  These smaller images usually contain the                     tory by ``make release''.  These smaller images usually
                    same tools as the larger images in RELEASEDIR/iso, but do                     contain the same tools as the larger images in
                    not contain additional content such as the distribution                     RELEASEDIR/iso, but do not contain additional content such
                    sets.                     as the distribution sets.
   
                    Note that the mac68k port still uses an older method of                     Note that the mac68k port still uses an older method of
                    creating CD-ROM images.  This requires the mkisofs(1) util-                     creating CD-ROM images.  This requires the mkisofs(1) util-
Line 627  BUILDING
Line 613  BUILDING
   
      releasekernel=kconf       releasekernel=kconf
                    Install a gzip(1)ed copy of the kernel built by                     Install a gzip(1)ed copy of the kernel built by
                    kernel=kconf into RELEASEDIR/MACHINE/binary/kernel, usually                     kernel=kconf into
                    as netbsd-kconf.gz, although the ``netbsd'' prefix is                     RELEASEDIR/RELEASEMACHINEDIR/binary/kernel, usually as
                    determined from the ``config'' directives in kconf.                     netbsd-kconf.gz, although the ``netbsd'' prefix is deter-
                      mined from the ``config'' directives in kconf.
   
      sets          Perform ``make sets''.       sets          Perform ``make sets''.
   
Line 649  BUILDING
Line 636  BUILDING
   
      -B buildid       -B buildid
                Set the value of BUILDID to buildid.  This will also append the                 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                 that the resulting name is of the form
                ``nbmake-MACHINE-BUILDID''.                 ``nbmake-MACHINE-BUILDID''.
   
      -C cddir  Set the value of CDEXTRA to cddir.  If a relative path is spec-       -C cdextras
                ified, it will be converted to an absolute path before being                 Set the value of CDEXTRA to cdextras which is a space-separated
                used.  When combined with ``iso-image'' or                 list of files or directories which will be added in order to
                ``iso-image-source'', it will cause the contents of cddir to be                 the CD-ROM image when used in conjunction with ``iso-image'' or
                added to the CD-ROM image.                 ``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-       -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                 fied, it will be converted to an absolute path before being
Line 682  BUILDING
Line 672  BUILDING
                it will be converted to an absolute path before being used.                 it will be converted to an absolute path before being used.
                Unsets MAKEOBJDIR.                 Unsets MAKEOBJDIR.
   
      -m mach   Set the value of MACHINE to mach.  This will also override any       -m mach   Set the value of MACHINE to mach, except in some special cases
                value of MACHINE_ARCH in the process environment with a value                 listed below.  This will also override any value of
                deduced from mach, unless -a is specified, or mach is a special                 MACHINE_ARCH in the process environment with a value deduced
                case listed below.  All cross builds require -m, but if unset                 from mach, unless -a is specified.  All cross builds require
                on a NetBSD host, the host's value of MACHINE will be detected                 -m, but if unset on a NetBSD host, the host's value of MACHINE
                and used automatically.                 will be detected and used automatically.
   
                Some machines support multiple values for MACHINE_ARCH.  For a                 Some machines support multiple values for MACHINE_ARCH.  The
                given value of mach, the following MACHINE and MACHINE_ARCH                 following special cases for the mach argument are defined to
                values will result:                 set the listed values of MACHINE and MACHINE_ARCH:
   
                      mach          MACHINE    MACHINE_ARCH                       mach          MACHINE    MACHINE_ARCH
                        evbarm        evbarm     (not set)
                        evbarm-eb     evbarm     armeb
                        evbarm-el     evbarm     arm
                      evbmips       evbmips    (not set)                       evbmips       evbmips    (not set)
                      evbmips-eb    evbmips    mipseb                       evbmips-eb    evbmips    mipseb
                      evbmips-el    evbmips    mipsel                       evbmips-el    evbmips    mipsel
Line 820  HISTORY
Line 813  HISTORY
 BUGS  BUGS
      A few platforms are not yet using this build system.       A few platforms are not yet using this build system.
   
 NetBSD                         September 1, 2007                        NetBSD  NetBSD                          March 18, 2008                          NetBSD

Legend:
Removed from v.1.59.2.2.2.1  
changed lines
  Added in v.1.69

CVSweb <webmaster@jp.NetBSD.org>