[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.105.4.1 and 1.106

version 1.105.4.1, 2014/08/10 07:27:15 version 1.106, 2014/05/21 13:12:19
Line 151  CONFIGURATION
Line 151  CONFIGURATION
      otherwise specified, these variables may be set in either the process       otherwise specified, these variables may be set in either the process
      environment or the make(1) configuration file specified by MAKECONF.       environment or the make(1) configuration file specified by MAKECONF.
   
      BUILDID     Identifier for the build.  If set, this should be a short       BUILDID     Identifier for the build.  The identifier will be appended to
                  string that is suitable for use as part of a file or                   object directory names, and can be consulted in the make(1)
                  directory name.  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                   configuration file in order to set additional build
                  parameters, such as compiler flags.  It will also be used as                   parameters, such as compiler flags.
                  part of the kernel version string, which can be printed by  
                  ``uname -v''.  
   
                  Default: Unset.  
   
      BUILDINFO   This may be a multi-line string containing information about  
                  the build.  This will appear in DESTDIR/etc/release, and it  
                  will be stored in the buildinfo variable in any kernels that  
                  are built.  When such kernels are booted, the sysctl(7)  
                  kern.buildinfo variable will report this value.  The string  
                  may contain backslash escape sequences, such as ``\\''  
                  (representing a backslash character) and ``\n'' (representing  
                  a newline).  
   
                  Default: Unset.  
   
      BUILDSEED   GCC uses random numbers when compiling C++ code.  This       BUILDSEED   GCC uses random numbers when compiling C++ code.  This
                  variable seeds the gcc random number generator using the                   variable seeds the gcc random number generator using the
Line 846  BUILDING
Line 829  BUILDING
   
      live-image    Perform ``make live-image''.       live-image    Perform ``make live-image''.
   
      list-arch     Prints a list of valid MACHINE and MACHINE_ARCH settings,  
                    the default MACHINE_ARCH for each MACHINE, and aliases for  
                    MACHINE/MACHINE_ARCH pairs, and then exits.  The -m or -a  
                    options (or both) may be used to specify glob patterns that  
                    will be used to narrow the list of results; for example,  
                    ``build.sh -m 'evm*' -a '*arm*' list-arch'' will list all  
                    known MACHINE/MACHINE_ARCH values in which either MACHINE  
                    or ALIAS matches the pattern `evb*', and MACHINE_ARCH  
                    matches the pattern `*arm*'.  
   
      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:
   
      -a arch   Set the value of MACHINE_ARCH to arch.  See the -m option for       -a arch   Set the value of MACHINE_ARCH to arch.
                more information.  
   
      -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
Line 919  BUILDING
Line 891  BUILDING
                relative path.  If the directory does not already exist,                 relative path.  If the directory does not already exist,
                build.sh will create it.                 build.sh will create it.
   
      -m mach   Set the value of MACHINE to mach, unless the mach argument is       -m mach   Set the value of MACHINE to mach, except in some special cases
                an alias that refers to a MACHINE/MACHINE_ARCH pair, in which                 listed below.  This will also override any value of
                case both MACHINE and MACHINE_ARCH are set from the alias.                 MACHINE_ARCH in the process environment with a value deduced
                Such aliases are interpreted entirely by build.sh; they are not                 from mach, unless -a is specified.  All cross builds require
                used by any other part of the build system.  The MACHINE_ARCH                 -m, but if unset on a NetBSD host, the host's value of MACHINE
                setting implied by mach will override any value of MACHINE_ARCH                 will be detected and used automatically.
                in the process environment, but will not override a value set  
                by the -a option.  All cross builds require -m, but if unset on                 Some machines support multiple values for MACHINE_ARCH.  The
                a NetBSD host, the host's value of MACHINE will be detected and                 following special cases for the mach argument are defined to
                used automatically.                 set the listed values of MACHINE and MACHINE_ARCH:
   
                See the list-arch operation for a way to get a list of valid                       mach          MACHINE    MACHINE_ARCH
                MACHINE and MACHINE_ARCH settings.                       evbarm        evbarm     (not set)
                        evbarm-eb     evbarm     armeb
                        evbarm-el     evbarm     arm
                        evbmips       evbmips    (not set)
                        evbmips-eb    evbmips    mipseb
                        evbmips-el    evbmips    mipsel
                        evbsh3        evbsh3     (not set)
                        evbsh3-eb     evbsh3     sh3eb
                        evbsh3-el     evbsh3     sh3el
                        sbmips        sbmips     (not set)
                        sbmips-eb     sbmips     mipseb
                        sbmips-el     sbmips     mipsel
   
      -N noiselevel       -N noiselevel
                Set the ``noisyness'' level of the build, by setting                 Set the ``noisyness'' level of the build, by setting
Line 963  BUILDING
Line 946  BUILDING
                by the values of several variables and by the location of the                 by the values of several variables and by the location of the
                source directory.                 source directory.
   
                Note that placing the obj directory location outside of the  
                default source tree hierarchy makes it easier to manually clear  
                out old files in the event the ``make cleandir'' operation is  
                unable to do so.  (See CAVEATS below.)  
   
                Note also that use of one of -M or -O is the only means of  
                building multiple machine architecture userlands from the same  
                source tree without cleaning between builds (in which case, one  
                would specify distinct obj locations for each).  
   
      -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''.  This default is opposite to the                 automatically set to ``yes''.  This default is opposite to the
                behaviour when not using build.sh.                 behaviour when not using build.sh.
Line 1074  HISTORY
Line 1047  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
      USE_NEW_TOOLCHAIN, and re-worked to TOOLCHAIN_MISSING after that.       USE_NEW_TOOLCHAIN, and re-worked to TOOLCHAIN_MISSING after that.
   
 CAVEATS  NetBSD                         November 8, 2012                         NetBSD
      After significant updates to third-party components in the source tree,  
      the ``make cleandir'' operation may be insufficient to clean out old  
      files in object directories.  Instead, one may have to manually remove  
      the files.  Consult the UPDATING file for notices concerning this.  
   
 NetBSD                          August 7, 2014                          NetBSD  

Legend:
Removed from v.1.105.4.1  
changed lines
  Added in v.1.106

CVSweb <webmaster@jp.NetBSD.org>