Makefile - variables

Note: Non-functional links can be fixed by inserting en/.

Variable name	Description
ADD_TO_DEF_FILE
CPP_SOURCES
CPP_UNIT_TESTS	A list of source files to compile as unit tests.
CSRCS	A list of C source files to compile.
DEFINES	Additional preprocessor defines for C++
EXPAND_MOZLIBNAME
EXPORTS	A list of exported header files and sources to install for external use.
EXPORTS_NAMESPACES	Exported package include directory: dist/include/${namespace}
EXPORTS_${namespace}	A list of exports/headers that should be copied into the exported namespace directory.
EXTRA_COMPONENTS	nsDefaultCLH.manifest, JavaScript XPCOMM files
EXTRA_DSO_LIBS
EXTRA_DSO_LDOPTS
EXTRA_JS_MODULES
EXTRA_PP_COMPONENTS	XPCOMM files to pre-process before installation.
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.
GLOBAL_DEPS	A list of common dependencies (Makefile.in, autoconf.mk) that will force rebuilding.
LIBOBJS
HAVE_DTRACE	Sun Microsystem's dynamic tracing environment is available.
LOCAL_INCLUDES	Allow use of MOZ_OBJDIR in .mozconfig with older GNU gcc on BeOS.
MODULE
MODULE_NAME
NO_DIST_INSTALL	Inhibit generating and copying exports/install targets into $(MOZ_OBJDIR)/dist/install.
.NS_PRINTING
OBJS
OBJ_SUFFIX	Filename suffix to use when writing object files.
MODULE	Instructs the build system where to install exported headers.
SIMPLE_PROGRAMS
SUPPRESS_DEFAULT_RULES	Inhibit processing of Makefile TIER targets/directory processing will be unordered.
TIER	Build order dependencies - subdirectories for make to traverse prior to building current.
XPIDL_MODULE	Module name to use when generating .xpt files, default to MODULE.
XPIDLSRCS	Internal: A list of .idl files to generate exported headers from.
XPIDL_NAME	Name of extension to build see also

configure.sh Variables	Description
BUILD_PROJECT_ARG	Command line/environment override
CONFIGURE_ENV_ARGS	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 built concurrently.
STATIC_DIRS	Subdirectories containing static makefiles that are not autogenerated.
TEST_DIRS	A list of directories containing test makefiles
TOOL_DIRS	A list of directories to process makefile 'tool' targets in.

MOZ_ Variable	Description
MOZ_AUTO_DEPS
MOZ_BUILD_APP
MOZ_BUILD_PROJECTS	Build multiple projects in the same sandbox.  Dest=$(MOZ_OBJDIR)/$project
MOZ_CURRENT_PROJECT
MOZ_DEBUG
MOZ_ENABLE_XREMOTE
MOZ_FEEDS
MOZ_HELP_VIEWER
MOZ_NATIVE_NSPR
MOZ_METRO
MOZ_PKG_MAINFEST
MOZ_PREFLIGHT_ALL
MOZ_RDF
MOZ_TOOLKIT_SEARCH
MOZ_URL_CLASSIFIER
MOZ_WIDGET_TOOLKIT	Android, BeOS, Cocoa, GTK2, OS2, Qt, Windows
MOZ_XPCTOOLS
MOZ_XUL
MOZ_X11

Test Variable	Description
ENABLE_TESTS	Boolean value that should wrapper all unit tests to allow disabling on demand[1].
PYTHON_UNIT_TESTS	List of python scripts to check exit status for make check
XPC_SHELL_TESTS
NO_XPCSHELL_MANIFEST_CHECK	Inhibit validating manifest files when running xpcshell tests.

Compiler Variable	Description
GNU_CC	Defined if the GNU gcc compiler is available.
MODULE_OPTIMIZE_FLAGS	Additional flags for enabling or overriding compiler optimizations(-O2).
SOLARIS_SUNPRO_CC	Sun Studio compiler

Export Variables	Description
AUTOCFG_JS_EXPORTS
EXPORTS	A list of exported headers and source files for external use.
HAS_EXTRA_EXPORTS
PREF_JS_EXPORTS	JavaScript preferences file to export[1].
SDK_HEADERS

Makefile Generation	Description
NO_MAKEFILE_RULE [pending]	Inhibit Makefile.in deps that would allow $obj/Makefile to be generated.
NO_SUBMAKEFILE_RULE [pending/redundant?]	Inhibit Makefile generation within subdirectories.

NO_ Variable	Description
NO_PROFILE_GUIDED_OPTIMIZE	Inhibit PGO builds
NO_DIST_INSTALL

Note: Values will be appended to the EXPORT variable when present.

OS_ Variable	Description
OS_ARCH	Platform type
OS_TARGET	Target binary type if building on an intermediate platform(building mobile binaries on GNU/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 GNU/Linux).

Distribution/Release variables

Variable	Description
DIST	Top level distribution directory for install/packaging/repacking.
DIST_FILES	A list of files copied into the distribution archive(~application.ini).
DIST_CHROME_FILES	Exists in rules.mk but not referenced by mozilla-central.  Deprecated?
FINAL_TARGET	Directory to install distributed content.  default=$(DIST)/bin
XPI_NAME	If set FINAL_TARGET=$(DIST)/xpi-stage/$(XPI_NAME)
DIST_SUBDIR	If set FINAL_TARGET will be $(DIST)/bin/$(DIST_SUBDIR)  [ metro build ]

l10n.mk and localization

Variable	Description
EN_US_BINARY_URL	Server URL from which wget will FTP binaries.
L10NBASEDIR
MOZ_CHROME_MULTILOCALE	A list of locale names to process
MOZ_CHROME_FILE_FORMAT	both, file, jar, omni, symlink
PACKAGER_NO_LIBS	Hack to allow one makefile to include another without pulling in libs:: target definitions.
STAGEDIST	Local staging directory for localization and packaging.

 

Todo:

xpcom/xpinstall variables: https://developer.mozilla.org/en/Adding_XPCOM_components_to_Mozilla_build_system