[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.7 and 1.14

version 1.7, 2002/03/04 02:10:02 version 1.14, 2002/09/17 16:35:39
Line 88  FILES
Line 88  FILES
      described in release(7).       described in release(7).
   
 CONFIGURATION  CONFIGURATION
      Environment variables
        Several environment variables control the behaviour of NetBSD builds.
   
        MACHINE           Machine type.
   
        MACHINE_ARCH      Machine architecture.
   
        MAKE              Path name to invoke make(1) as.
   
        MAKEFLAGS         Flags to invoke make(1) with.
   
        MAKEOBJDIR        Directory to use as the .OBJDIR for the current direc-
                          tory.  Used only if MAKEOBJDIRPREFIX is not defined.
                          MAKEOBJDIR can only be provided in the environment.
   
        MAKEOBJDIRPREFIX  Top level directory of the object directory tree.  If
                          this is defined, ${MAKEOBJDIRPREFIX}/${.CURDIR} is used
                          as the .OBJDIR for the current directory.  The current
                          directory may be read only.  MAKEOBJDIRPREFIX can only
                          be provided in the environment.
   
    "make" variables     "make" variables
      Several variables control the behavior of NetBSD builds.  Unless other-       Several variables control the behavior of NetBSD builds.  Unless other-
      wise specified, these variables may be set in either the process environ-       wise specified, these variables may be set in either the process environ-
      ment or the make(1) configuration file specified by MAKECONF.       ment or the make(1) configuration file specified by MAKECONF.
   
        BUILDID     Identifier for the build.  The identifier will be appended to
                    object directory names, and can be consulted in the make(1)
                    configuration file in order to set additional build parame-
                    ters, such as compiler flags.
   
      DESTDIR     Directory to contain the built NetBSD system.  If set, spe-       DESTDIR     Directory to contain the built NetBSD system.  If set, spe-
                  cial options are passed to the compilation tools to prevent                   cial options are passed to the compilation tools to prevent
                  their default use of the host system's /usr/include,                   their default use of the host system's /usr/include,
Line 214  CONFIGURATION
Line 240  CONFIGURATION
      UNPRIVED    If set, then an unprivileged install will occur.  The user,       UNPRIVED    If set, then an unprivileged install will occur.  The user,
                  group, permissions, and file flags, will not be set on the                   group, permissions, and file flags, will not be set on the
                  installed item; instead the information will be appended to a                   installed item; instead the information will be appended to a
                  file called METALOG in the .OBJDIR of src.  The contents of                   file called METALOG in DESTDIR.  The contents of METALOG is
                  METALOG is used during the generation of the distribution tar                   used during the generation of the distribution tar files to
                  files to ensure that the appropriate file ownership is                   ensure that the appropriate file ownership is stored.
                  stored.  
   
                  Default: Unset.                   Default: Unset.
   
Line 262  CONFIGURATION
Line 287  CONFIGURATION
   
                     Default: ``yes''                      Default: ``yes''
   
      NBUILDJOBS     If set, specifies the number of parallel make(1) processes       NBUILDJOBS     Now obsolete.  Use the make(1) option -j, instead (see be-
                     that should be run simultaneously.  This can speed up                      low)
                     builds on SMP machines, or machines with much more CPU  
                     power than I/O availability.  This should be used instead  
                     of the make(1) option -j, in order to ensure proper order-  
                     ing of build components.  
   
                     Default: Unset.                      Default: Unset.
   
Line 309  BUILDING
Line 330  BUILDING
      This is only a summary of options available to make(1); only the options       This is only a summary of options available to make(1); only the options
      used most frequently with NetBSD builds are listed here.       used most frequently with NetBSD builds are listed here.
   
        -j njob    Run up to njob make(1) subjobs in parallel.  Makefiles should
                   use .WAIT or have explicit dependancies as necessary to en-
                   force build ordering.  If you see build failures with -j,
                   please save complete build logs so the failures can be ana-
                   lyzed.
   
      -m dir     Specify the default directory for searching for system Make-       -m dir     Specify the default directory for searching for system Make-
                 file segments, mainly the <bsd.*.mk> files.  When building any                  file segments, mainly the <bsd.*.mk> files.  When building any
                 full NetBSD source tree, this should be set to the                  full NetBSD source tree, this should be set to the
Line 348  BUILDING
Line 375  BUILDING
                 dependency changes.                  dependency changes.
   
      dependall  Does a ``make depend'' immediately followed by a ``make all''.       dependall  Does a ``make depend'' immediately followed by a ``make all''.
                 This combined target recurses as an atomic unit, so that the                  This improves cache locality of the build since both passes
                 ``make depend'' phase can participate in make -j parallelism.                  read the source files in their entirety.
   
      includes   Build and install system header files.  Typically needed be-       includes   Build and install system header files.  Typically needed be-
                 fore any system libraries or programs can be built.                  fore any system libraries or programs can be built.
   
      install    Install programs, libraries, and documentation into DESTDIR.       install    Install programs, libraries, and documentation into DESTDIR.
                   Few files will be installed to /dev, /etc, /root or /var in
                   order to prevent user supplied configuration data from being
                   overwritten.
   
      lint       Run lint(1) against the C source code, where appropriate, and       lint       Run lint(1) against the C source code, where appropriate, and
                 generate system-installed lint libraries.                  generate system-installed lint libraries.
Line 404  BUILDING
Line 434  BUILDING
   
      -a arch   Set the value of MACHINE_ARCH to arch.       -a arch   Set the value of MACHINE_ARCH to arch.
   
        -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
                  that the resulting name is of the form ``nbmake-MACHINE-
                  BUILDID''.
   
      -b        Bootstrap ``make'' and create a nbmake-MACHINE script (see be-       -b        Bootstrap ``make'' and create a nbmake-MACHINE script (see be-
                low).                 low).
   
      -d        Build a full distribution.  This differs from a normal build in       -d        Build a full distribution.  This differs from a default build
                that etc files will also be installed.  Note this does not                 in that files will also be installed to /dev, /etc, /root and
                build a ``release''; no release sets are placed in ${RE-                 /var.  Note this does not build a ``release''; no release sets
                LEASEDIR}.                 are placed in ${RELEASEDIR}.  -d is implied by -R.
   
      -j njob   Set the value of NBUILDJOBS to njob.  This provides similar       -j njob   Passed through to make(1).  Makefiles should use .WAIT or have
                functionality to the familiar ``make -j'', but preserves the                 explicit dependancies as necessary to enforce build ordering.
                ordering of the top level ``make build''.                 If you see build failures with -j, please save complete build
                  logs so the failures can be analyzed.
   
      -m mach   Set the value of MACHINE to mach.  This will also override any       -m mach   Set the value of MACHINE to mach.  This will also override any
                value of MACHINE_ARCH in the process environment with a value                 value of MACHINE_ARCH in the process environment with a value
Line 445  BUILDING
Line 482  BUILDING
   
      -D dest   Set the value of DESTDIR to dest.       -D dest   Set the value of DESTDIR to dest.
   
        -M obj    Set MAKEOBJDIRPREFIX to obj.
   
      -O obj    Create an appropriate transform macro for MAKEOBJDIR that will       -O obj    Create an appropriate transform macro for MAKEOBJDIR that will
                place the built object files under obj.  For instance, a set-                 place the built object files under obj.  For instance, a set-
                ting of /usr/obj will place build-time files files under                 ting of /usr/obj will place build-time files under
                /usr/obj/bin, /usr/obj/lib, and so forth.                 /usr/obj/bin, /usr/obj/lib, and so forth.
   
      -R rel    Set the value of RELEASEDIR to rel.  Setting this option will       -R rel    Set the value of RELEASEDIR to rel.  Setting this option will
Line 471  BUILDING
Line 510  BUILDING
      This script can be symlinked into a directory listed in PATH, or called       This script can be symlinked into a directory listed in PATH, or called
      with an absolute path.       with an absolute path.
   
   OBSOLETE VARIABLES
        NBUILDJOBS  Now obsolete.  Use the make(1) option -j, instead.
   
 SEE ALSO  SEE ALSO
      make(1), hier(7), release(7)       make(1), hier(7), release(7)
   
Line 479  HISTORY
Line 521  HISTORY
      current'' development sources between NetBSD 1.5 and NetBSD 1.6.       current'' development sources between NetBSD 1.5 and NetBSD 1.6.
   
 BUGS  BUGS
      Many platforms are not yet using the USE_NEW_TOOLCHAIN system.       A few platforms are not yet using the USE_NEW_TOOLCHAIN system.
   
 NetBSD                           March 4, 2002                               8  NetBSD                            May 3, 2002                                8

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.14

CVSweb <webmaster@jp.NetBSD.org>