[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.62.4.2

version 1.59, 2006/10/08 17:54:30 version 1.62.4.2, 2008/01/09 01:19:18
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 485  BUILDING
Line 470  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/MACHINE/binary/sets.  Should be run after ``make
Line 507  BUILDING
Line 502  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/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.
   
        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       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 596  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 582  BUILDING
Line 624  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 634  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 670  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 801  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 811  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                         September 1, 2007                        NetBSD

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

CVSweb <webmaster@jp.NetBSD.org>