Makefile - variables

  • Revision slug: How_Mozilla's_build_system_works/Makefile_-_variables
  • Revision title: Makefile - variables
  • Revision id: 38322
  • Created:
  • Creator: Joey Armstrong
  • Is current revision? No
  • Comment 10 words removed

Revision Content

This page lists makefile variables of interest.

Variable name Description
ADD_TO_DEF_FILE  
CSRCS A list of C source files to compile.
PARALLEL_DIRS A list of directories to recursively traverse.
STATIC_DIRS  
EXPAND_MOZLIBNAME  
EXPORTS A list of exported header files and sources to install for external use.
EXTRA_DSO_LIBS  
GARBAGE A "clean target" macro containing a list of files to remove.
GARBAGE_DIRS A "clean target" macro containing a list of directories to remove.
LIBOBJS  
LOCAL_INCLUDES Allow use of MOZ_OBJDIR in .mozconfig with older gcc on BeOS
NO_PROFILE_GUIDED_OPTIMIZE Inhibit PGO builds
OBJS  
MODULE Instructs the build system where to install exported headers
SIMPLE_PROGRAMS  
TIER  Build order dependencies - subdirectories for make to traverse prior to building current.
XPIDLSRCS  
configure.sh Variables    Description Description
BUILD_PROJECT_ARG    command line / environment override command line /environment override
CONFIGURE_ENV_ARGS    command line / environment override command line / environment override
Directory Variable  
DIRS A list of subdirectories to build recursively
PARALLEL_DIRS A list of subdirectories to build recursively that may be threaded
STATIC_DIRS  
MOZ_ Variable Description
MOZ_AUTO_DEPS  
MOZ_BUILD_PROJECTS Build multiple projects in the same sandbox.  Dest=$(MOZ_OBJDIR)/$project
MOZ_CURRENT_PROJECT  
MOZ_DEBUG  
MOZ_PREFLIGHT_ALL  
MOZ_WIDGET_TOOLKIT  

Test Variable

Description
ENABLE_TESTS  
TESTING_ENABLED Boolean value that should wrapper all unit tests allowing them to be disabled on demand.
XPC_SHELL_TESTS  
Compiler Variable Description
GNU_CC Defined if the gcc compiler is available
MODULE_OPTIMIZE_FLAGS Additional flags for enabling compiler optimizations (-O2)
SOLARIS_SUNPRO_CC Sun Studio compiler

SUPRESS_DEFAULT_RULES

OS_ Variable Description
OS_ARCH Platform type
OS_TARGET Target binary type if building on an intermediate platform (building mobile binaries on linux)
HOST_ Variable Description
HOST_CMSRCS A list of .m sources to compile
HOST_CMMSRCS A list of .mm sources to compile
HOST_OBJS  
HOST_OS_ARCH ARCH of real platform a target platform is being built on (building mobile binaries on linux)

Revision Source

<p>This page lists makefile variables of interest.</p>
<table class="standard-table" style="width: 1219px; height: 332px;"> <thead> <tr> <th>Variable name</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>ADD_TO_DEF_FILE</td> <td> </td> </tr> <tr> <td>CSRCS</td> <td>A list of C source files to compile.</td> </tr> <tr> <td><a href="/en/PARALLEL_DIRS" title="en/PARALLEL DIRS">PARALLEL_DIRS</a></td> <td>A list of directories to recursively traverse.</td> </tr> <tr> <td><a href="/en/STATIC_DIRS" title="en/STATIC DIRS">STATIC_DIRS</a></td> <td> </td> </tr> <tr> <td>EXPAND_MOZLIBNAME</td> <td> </td> </tr> <tr> <td>EXPORTS</td> <td>A list of exported header files and sources to install for external use.</td> </tr> <tr> <td>EXTRA_DSO_LIBS</td> <td> </td> </tr> <tr> <td><code>GARBAGE</code></td> <td>A "clean target" macro containing a list of files to remove.</td> </tr> <tr> <td><code>GARBAGE_DIRS</code></td> <td>A "clean target" macro containing a list of directories to remove.</td> </tr> <tr> <td>LIBOBJS</td> <td> </td> </tr> <tr> <td>LOCAL_INCLUDES</td> <td>Allow use of MOZ_OBJDIR in .mozconfig with older gcc on BeOS</td> </tr> <tr> <td>NO_PROFILE_GUIDED_OPTIMIZE</td> <td>Inhibit PGO builds</td> </tr> <tr> <td>OBJS</td> <td> </td> </tr> <tr> <td><a href="/MODULE" title="MODULE">MODULE</a></td> <td>Instructs the build system where to install exported headers</td> </tr> <tr> <td>SIMPLE_PROGRAMS</td> <td> </td> </tr> <tr> <td><a href="/TIER" title="TIER">TIER</a></td> <td> Build order dependencies - subdirectories for make to traverse prior to building current.</td> </tr> <tr> <td>XPIDLSRCS</td> <td> </td> </tr> </tbody>
</table>
<table border="1" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">configure.sh Variables    Description</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr> <td>BUILD_PROJECT_ARG    command line / environment override</td> <td>command line /environment override</td> </tr> <tr> <td>CONFIGURE_ENV_ARGS    command line / environment override</td> <td>command line / environment override</td> </tr> </tbody>
</table>
<table border="1" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">Directory Variable</th> <th scope="col"> </th> </tr> </thead> <tbody> <tr> <td><a href="/en/DIRS" title="en/DIRS">DIRS</a></td> <td>A list of subdirectories to build recursively</td> </tr> <tr> <td>PARALLEL_DIRS</td> <td>A list of subdirectories to build recursively that may be threaded</td> </tr> <tr> <td>STATIC_DIRS</td> <td> </td> </tr> </tbody>
</table>
<table border="1" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">MOZ_ Variable</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr> <td>MOZ_AUTO_DEPS</td> <td> </td> </tr> <tr> <td><a href="/en/Configuring_Build_Options" title="en/Configuring Build Options">MOZ_BUILD_PROJECTS</a></td> <td>Build multiple projects in the same sandbox.  Dest=$(MOZ_OBJDIR)/$project</td> </tr> <tr> <td>MOZ_CURRENT_PROJECT</td> <td> </td> </tr> <tr> <td>MOZ_DEBUG</td> <td> </td> </tr> <tr> <td>MOZ_PREFLIGHT_ALL</td> <td> </td> </tr> <tr> <td>MOZ_WIDGET_TOOLKIT</td> <td> </td> </tr> </tbody>
</table>
<table border="1" cellpadding="1" cellspacing="1" class="standard-table" style="width: 747px; height: 41px;"> <thead> <tr> <th scope="col"> <p>Test Variable</p> </th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr> <td>ENABLE_TESTS</td> <td> </td> </tr> <tr> <td><a href="/TESTING_ENABLED" title="TESTING ENABLED">TESTING_ENABLED</a></td> <td>Boolean value that should wrapper all unit tests allowing them to be disabled on demand.</td> </tr> <tr> <td>XPC_SHELL_TESTS</td> <td> </td> </tr> </tbody>
</table>
<table border="1" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">Compiler Variable</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr> <td>GNU_CC</td> <td>Defined if the gcc compiler is available</td> </tr> <tr> <td>MODULE_OPTIMIZE_FLAGS</td> <td>Additional flags for enabling compiler optimizations (-O2)</td> </tr> <tr> <td>SOLARIS_SUNPRO_CC</td> <td>Sun Studio compiler</td> </tr> </tbody>
</table>
<p>SUPRESS_DEFAULT_RULES</p>
<table border="1" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">OS_ Variable</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr> <td>OS_ARCH</td> <td>Platform type</td> </tr> <tr> <td>OS_TARGET</td> <td>Target binary type if building on an intermediate platform (building mobile binaries on linux)</td> </tr> </tbody>
</table>
<table border="1" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">HOST_ Variable</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr> <td>HOST_CMSRCS</td> <td>A list of .m sources to compile</td> </tr> <tr> <td>HOST_CMMSRCS</td> <td>A list of .mm sources to compile</td> </tr> <tr> <td>HOST_OBJS</td> <td> </td> </tr> <tr> <td>HOST_OS_ARCH</td> <td>ARCH of real platform a target platform is being built on (building mobile binaries on linux)</td> </tr> </tbody>
</table>
Revert to this revision