[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 and 1.69

version 1.59, 2006/10/08 17:54:30 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 485  BUILDING
Line 471  BUILDING
                    INSTALLWORLDDIR is not the root directory if cross compil-                     INSTALLWORLDDIR is not the root directory if cross compil-
                    ing.                     ing.
   
                    Note: It is highly recommended that you upgrade your kernel                     The INSTALLSETS environment variable may be set to a list
                    and reboot before performing this operation.                     of distribution sets to be installed.  By default, all sets
                      except ``etc'' and ``xetc'' are installed (so most files in
                      INSTALLWORLDDIR/etc will not be installed or modified).
   
                      Note: Before performing this operation with
                      INSTALLWORLDDIR=/, it is highly recommended that you
                      upgrade your kernel and reboot.  After performing this
                      operation, it is recommended that you use etcupdate(8) to
                      update files in INSTALLWORLDDIR/etc and that you use
                      postinstall(8) to check for inconsistencies (and possibly
                      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 507  BUILDING
Line 503  BUILDING
                    described by release(7).  This requires that RELEASEDIR be                     described by release(7).  This requires that RELEASEDIR be
                    set (see above).                     set (see above).
   
      iso-image     Create a CD-ROM image in       iso-image     Create a NetBSD installation CD-ROM image in the
                    RELEASEDIR/MACHINE/installation/cdrom.  RELEASEDIR must                     RELEASEDIR/iso directory.  The CD-ROM file system will have
                    already have been populated by ``make release'' or equiva-                     a layout as described in release(7).
                    lent.  This requires the mkisofs(1) utility, which is not  
                    part of NetBSD, but which can be installed from                     For most machine types, the CD-ROM will be bootable, and
                    pkgsrc/sysutils/cdrtools.                     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'' is attempted, RELEASEDIR must be
                      populated by ``make release'' or equivalent.
   
                      Note that other, smaller, CD-ROM images may be created in
                      the RELEASEDIR/RELEASEMACHINEDIR/installation/cdrom direc-
                      tory 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.
   
        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/RELEASEMACHINEDIR/installation/cdrom direc-
                      tory 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       regression-tests
                    Can only be run after building the regression tests in the                     Can only be run after building the regression tests in the
Line 555  BUILDING
Line 597  BUILDING
      tools         Build and install the host tools from src/tools.       tools         Build and install the host tools from src/tools.
   
      install=idir  Install the contents of DESTDIR to idir, using ``make       install=idir  Install the contents of DESTDIR to idir, using ``make
                    installworld''.                     installworld''.  Note that files that are part of the
                      ``etc'' or ``xetc'' sets will not be installed.
   
      kernel=kconf  Build a new kernel.  The kconf argument is the name of a       kernel=kconf  Build a new kernel.  The kconf argument is the name of a
                    configuration file suitable for use by config(1).  If kconf                     configuration file suitable for use by config(1).  If kconf
Line 570  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 582  BUILDING
Line 626  BUILDING
   
      iso-image     Perform ``make iso-image''.       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       The following command line options alter the behaviour of the build.sh
      operations described above:       operations described above:
   
Line 589  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 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-       -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
                used.                 used.
Line 616  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 744  OBSOLETE VARIABLES
Line 803  OBSOLETE VARIABLES
                  TOOLCHAIN_MISSING=yes.                   TOOLCHAIN_MISSING=yes.
   
 SEE ALSO  SEE ALSO
      make(1), hier(7), release(7), pkgsrc/sysutils/cdrtools       make(1), hier(7), release(7), etcupdate(8), postinstall(8), sysinst(8),
        pkgsrc/sysutils/cdrtools
   
 HISTORY  HISTORY
      The build.sh based build scheme was introduced for NetBSD 1.6 as       The build.sh based build scheme was introduced for NetBSD 1.6 as
Line 753  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                          January 4, 2006                         NetBSD  NetBSD                          March 18, 2008                          NetBSD

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

CVSweb <webmaster@jp.NetBSD.org>