[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.36 and 1.43

version 1.36, 2003/07/03 05:52:47 version 1.43, 2003/08/19 12:53:30
Line 37  REQUIREMENTS
Line 37  REQUIREMENTS
   
 FILES  FILES
    Source tree layout     Source tree layout
   
      doc/BUILDING.mdoc       doc/BUILDING.mdoc
                     This document (in -mdoc troff format; the original copy).                      This document (in -mdoc troff format; the original copy).
   
Line 103  CONFIGURATION
Line 102  CONFIGURATION
      MAKEOBJDIR        Directory to use as the .OBJDIR for the current direc-       MAKEOBJDIR        Directory to use as the .OBJDIR for the current direc-
                        tory.  Used only if MAKEOBJDIRPREFIX is not defined.                         tory.  Used only if MAKEOBJDIRPREFIX is not defined.
                        MAKEOBJDIR can only be provided in the environment or                         MAKEOBJDIR can only be provided in the environment or
                        via the -M flag of build.sh.                         via the -O flag of build.sh.
   
      MAKEOBJDIRPREFIX  Top level directory of the object directory tree.  If       MAKEOBJDIRPREFIX  Top level directory of the object directory tree.  If
                        this is defined, ${MAKEOBJDIRPREFIX}/${.CURDIR} is used                         this is defined, ${MAKEOBJDIRPREFIX}/${.CURDIR} is used
Line 234  CONFIGURATION
Line 233  CONFIGURATION
   
                  Default: ``yes''                   Default: ``yes''
   
        MKUNPRIVED  Can be set to ``yes'' or ``no''.  Indicates whether an un-
                    privileged install will occur.  The user, group, permissions,
                    and file flags, will not be set on the installed item; in-
                    stead the information will be appended to a file called
                    METALOG in DESTDIR.  The contents of METALOG is used during
                    the generation of the distribution tar files to ensure that
                    the appropriate file ownership is stored.
   
                    Default: ``no''
   
        MKUPDATE    Can be set to ``yes'' or ``no''.  Indicates whether all in-
                    stall operations intended to write to DESTDIR will compare
                    file timestamps before installing, and skip the install phase
                    if the destination files are up-to-date.  This also has im-
                    plications on full builds (see next subsection).
   
                    Default: ``no''
   
      TOOLDIR     Directory to hold the host tools, once built.  This directory       TOOLDIR     Directory to hold the host tools, once built.  This directory
                  should be unique to a given host system and NetBSD source                   should be unique to a given host system and NetBSD source
                  tree.  (However, multiple targets may share the same TOOLDIR;                   tree.  (However, multiple targets may share the same TOOLDIR;
                  the target-dependent files have unique names.)  If unset, a                   the target-dependent files have unique names.)  If unset, a
                  default based on the uname(1) information of the host plat-                   default based on the uname(1) information of the host plat-
                  form will be created in the .OBJDIR of src/tools.                   form will be created in the .OBJDIR of src.
   
                  Default: Unset.  
   
      UNPRIVED    If set, then an unprivileged install will occur.  The user,  
                  group, permissions, and file flags, will not be set on the  
                  installed item; instead the information will be appended to a  
                  file called METALOG in DESTDIR.  The contents of METALOG is  
                  used during the generation of the distribution tar files to  
                  ensure that the appropriate file ownership is stored.  
   
                  Default: Unset.  
   
      UPDATE      If set, then all install operations intended to write to  
                  DESTDIR will compare file timestamps before installing, and  
                  skip the install phase if the destination files are up-to-  
                  date.  This also has implications on full builds (see next  
                  subsection).  
   
                  Default: Unset.                   Default: Unset.
   
Line 298  CONFIGURATION
Line 298  CONFIGURATION
   
                       Default: ``no''                        Default: ``no''
   
        MKUPDATE         Can be set to ``yes'' or ``no''.  If set, then in addi-
                         tion to the effects described for MKUPDATE=yes above,
                         this implies the effects of NOCLEANDIR (i.e., ``make
                         cleandir'' is avoided).
   
                         Default: ``no''
   
      NBUILDJOBS       Now obsolete.  Use the make(1) option -j, instead (see       NBUILDJOBS       Now obsolete.  Use the make(1) option -j, instead (see
                       below)                        below)
   
Line 324  CONFIGURATION
Line 331  CONFIGURATION
                       cause the system include files have changed.  However,                        cause the system include files have changed.  However,
                       this option should not be used when updating the entire                        this option should not be used when updating the entire
                       NetBSD source tree arbitrarily; it is suggested to use                        NetBSD source tree arbitrarily; it is suggested to use
                       UPDATE in that case.                        MKUPDATE=yes in that case.
   
                       Default: Unset.                        Default: Unset.
   
Line 336  CONFIGURATION
Line 343  CONFIGURATION
                       Note: build.sh will provide a default of releasedir (in                        Note: build.sh will provide a default of releasedir (in
                       the top-level .OBJDIR) unless run in `expert' mode                        the top-level .OBJDIR) unless run in `expert' mode
   
      UPDATE           If set, then in addition to the effects described for  
                       UPDATE above, this implies the effects of NOCLEANDIR  
                       (i.e., ``make cleandir'' is avoided).  
   
 BUILDING  BUILDING
    "make" command line options     "make" command line options
      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
Line 520  BUILDING
Line 523  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 idenfitier to the name of the ``make'' wrapper script so
                that the resulting name is of the form ``nbmake-MACHINE-                 that the resulting name is of the form
                BUILDID''.                 ``nbmake-MACHINE-BUILDID''.
   
      -D dest   Set the value of DESTDIR to dest.       -D dest   Set the value of DESTDIR to dest.
   
      -E        Set `expert' mode.  This overrides various sanity checks, and       -E        Set `expert' mode.  This overrides various sanity checks, and
                allows: DESTDIR does not have to be set to a non-root path for                 allows: DESTDIR does not have to be set to a non-root path for
                builds, and UNPRIVED does not have to be set when building as a                 builds, and MKUNPRIVED=yes does not have to be set when build-
                non-root user.                 ing as a non-root user.
   
                Note: It is highly recommended that you know what you are doing                 Note: It is highly recommended that you know what you are doing
                when you use this option.                 when you use this option.
Line 538  BUILDING
Line 541  BUILDING
                If you see build failures with -j, please save complete build                 If you see build failures with -j, please save complete build
                logs so the failures can be analyzed.                 logs so the failures can be analyzed.
   
      -M obj    Set MAKEOBJDIRPREFIX to obj.       -M obj    Set MAKEOBJDIRPREFIX to obj.  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.  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 569  BUILDING
Line 572  BUILDING
      -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 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, /usr/obj/usr.bin, and so forth.
                  Unsets MAKEOBJDIRPREFIX.
   
      -o        Set the value of MKOBJDIRS to ``no''.  Otherwise, it will be       -o        Set the value of MKOBJDIRS to ``no''.  Otherwise, it will be
                automatically set to ``yes'' (which is opposite to the default                 automatically set to ``yes'' (which is opposite to the default
Line 585  BUILDING
Line 589  BUILDING
                ``make'' will only be rebuilt as needed (when the source files                 ``make'' will only be rebuilt as needed (when the source files
                for make(1) change).                 for make(1) change).
   
      -U        Set the UNPRIVED variable.       -U        Set MKUNPRIVED=yes.
   
      -u        Set the UPDATE variable.       -u        Set MKUPDATE=yes.
   
      -V var=[value]       -V var=[value]
                Set the variable var to value (which is optional).                 Set the environment variable var to an optional value.  This is
                  propagated to the nbmake wrapper.
   
      -w wrapper       -w wrapper
                Create the nbmake wrapper script (see below) in a custom loca-                 Create the nbmake wrapper script (see below) in a custom loca-
Line 598  BUILDING
Line 603  BUILDING
                place the wrapper in PATH automatically.  Note that wrapper is                 place the wrapper in PATH automatically.  Note that wrapper is
                the full name of the file, not just a directory name.                 the full name of the file, not just a directory name.
   
        -Z var    Unset ("zap") the environment variable var.  This is propagated
                  to the nbmake wrapper.
   
    The "nbmake-MACHINE" wrapper script     The "nbmake-MACHINE" wrapper script
      If using the build.sh script to build NetBSD, a nbmake-MACHINE script       If using the build.sh script to build NetBSD, a nbmake-MACHINE script
      will be created in TOOLDIR/bin upon the first build to assist in building       will be created in TOOLDIR/bin upon the first build to assist in building
Line 606  BUILDING
Line 614  BUILDING
      nbmake-MACHINE can be invoked in lieu of make(1), and will instead call       nbmake-MACHINE can be invoked in lieu of make(1), and will instead call
      the up-to-date version of ``nbmake'' installed into TOOLDIR/bin with sev-       the up-to-date version of ``nbmake'' installed into TOOLDIR/bin with sev-
      eral key variables pre-set, including MACHINE, MACHINE_ARCH, and TOOLDIR.       eral key variables pre-set, including MACHINE, MACHINE_ARCH, and TOOLDIR.
        build.sh will also set variables specified with -V, and unset variables
        specified with -Z.
   
      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.
   
Line 631  EXAMPLES
Line 642  EXAMPLES
   
           Using unprivileged mode, build a complete release to DESTDIR and            Using unprivileged mode, build a complete release to DESTDIR and
           RELEASEDIR directories that build.sh selects (and will display).            RELEASEDIR directories that build.sh selects (and will display).
           UPDATE (-u) is set to prevent the ``make cleandir'', so that if this            MKUPDATE=yes (-u) is set to prevent the ``make cleandir'', so that
           is run after example 2, it doesn't need to redo that portion of the            if this is run after example 2, it doesn't need to redo that portion
           release build.            of the release build.
   
 OBSOLETE VARIABLES  OBSOLETE VARIABLES
      NBUILDJOBS  Use the make(1) option -j, instead.       NBUILDJOBS  Use the make(1) option -j, instead.
Line 652  HISTORY
Line 663  HISTORY
 BUGS  BUGS
      A few platforms are not yet using this build system.       A few platforms are not yet using this build system.
   
 NetBSD                           July 3, 2003                               10  NetBSD                          August 7, 2003                          NetBSD

Legend:
Removed from v.1.36  
changed lines
  Added in v.1.43

CVSweb <webmaster@jp.NetBSD.org>