action_pool_depth
Current value (from the default) = -1
From //build/toolchain/BUILD.gn:10
Pool for non goma tasks.
aec_untrusted_delay_for_testing
Current value (from the default) = false
From //modules/audio_processing/BUILD.gn:18
Disables the usual mode where we trust the reported system delay
values the AEC receives. The corresponding define is set appropriately
in the code, but it can be force-enabled here for testing.
android_full_debug
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:50
Normally, Android builds are lightly optimized, even for debug builds, to
keep binary size down. Setting this flag to true disables such optimization
apm_debug_dump
Current value (from the default) = false
From //webrtc.gni:97
Selects whether debug dumps for the audio processing module
should be generated.
archive_seed_corpus
Current value (from the default) = true
From //build/config/sanitizers/sanitizers.gni:118
When true, seed corpora archives are built.
asan_globals
Current value (from the default) = true
From //build/config/sanitizers/sanitizers.gni:161
Detect overflow/underflow for global objects.
Mac: http://crbug.com/352073
asan_use_blacklist
Current value (from the default) = true
From //build/config/sanitizers/sanitizers.gni:110
Use blacklists from tools/memory/asan when compiling with asan.
auto_profile_path
Current value (from the default) = ""
From //build/config/compiler/BUILD.gn:94
AFDO (Automatic Feedback Directed Optimizer) is a form of profile-guided
optimization that GCC supports. It used by ChromeOS in their official
builds. To use it, set auto_profile_path to the path to a file containing
the needed gcov profiling data.
binutils_path
Current value (from the default) = "../../third_party/binutils/Linux_x64/Release/bin"
From //build/config/compiler/BUILD.gn:59
build_libsrtp_tests
Current value (from the default) = false
From //third_party/libsrtp/BUILD.gn:10
Tests may not be appropriate for some build environments, e.g. Windows.
Rather than enumerate valid options, we just let clients ask for them.
build_with_mozilla
Current value (from the default) = false
From //webrtc.gni:121
Enable to use the Mozilla internal settings.
cast_is_debug
Current value (from the default) = true
From //build/config/chromecast_build.gni:16
If true, IS_CAST_DEBUG_BUILD() will evaluate to 1 in version.h. Otherwise,
it will evaluate to 0. Overriding this when is_debug=false is useful for
doing engineering builds.
cc_wrapper
Current value (from the default) = ""
From //build/toolchain/cc_wrapper.gni:36
Set to "ccache", "icecc" or "distcc". Probably doesn't work on windows.
chrome_pgo_phase
Current value (from the default) = 0
From //build/config/compiler/pgo/pgo.gni:13
Specify the current PGO phase.
Here's the different values that can be used:
0 : Means that PGO is turned off.
1 : Used during the PGI (instrumentation) phase.
2 : Used during the PGO (optimization) phase.
TODO(sebmarchand): Add support for the PGU (update) phase.
chromecast_branding
Current value (from the default) = "public"
From //build/config/chromecast_build.gni:20
chromecast_branding is used to include or exclude Google-branded components.
Set it to "public" for a Chromium build.
clang_base_path
Current value (from the default) = "//third_party/llvm-build/Release+Asserts"
From //build/config/clang/clang.gni:14
clang_sample_profile_path
Current value (from the default) = ""
From //build/config/compiler/BUILD.gn:101
Path to an AFDO profile to use while building with clang, if any. Empty
implies none.
clang_use_chrome_plugins
Current value (from the default) = true
From //build/config/clang/clang.gni:12
Indicates if the build should use the Chrome-specific plugins for enforcing
coding guidelines, etc. Only used when compiling with Clang.
clang_use_default_sample_profile
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:109
Some configurations have default sample profiles. If this is true and
clang_sample_profile_path is empty, we'll fall back to the default.
We currently only have default profiles for Chromium in-tree, so we disable
this by default for all downstream projects, since these profiles are likely
nonsensical for said projects.
clang_version
Current value (from the default) = "9.0.0"
From //build/toolchain/toolchain.gni:45
Clang compiler version. Clang files are placed at version-dependent paths.
compiler_timing
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:113
Turn this on to have the compiler output extra timing information.
compute_build_timestamp
Current value (from the default) = "compute_build_timestamp.py"
From //build/timestamp.gni:17
This should be the filename of a script that prints a single line
containing an integer that's a unix timestamp in UTC.
This timestamp is used as build time and will be compiled into
other code.
This argument may look unused. Before removing please check with the
chromecast team to see if they still use it internally.
concurrent_links
Current value (from the default) = -1
From //build/toolchain/concurrent_links.gni:19
Limit the number of concurrent links; we often want to run fewer
links at once than we do compiles, because linking is memory-intensive.
The default to use varies by platform and by the amount of memory
available, so we call out to a script to get the right value.
coverage_instrumentation_input_file
Current value (from the default) = ""
From //build/config/coverage/coverage.gni:22
The path to the coverage instrumentation input file should be a source root
absolute path (e.g. //out/Release/coverage_instrumentation_input.txt), and
the file consists of multiple lines where each line represents a path to a
source file, and the paths must be relative to the root build directory.
e.g. ../../base/task/post_task.cc for build directory 'out/Release'.
current_cpu
Current value (from the default) = ""
(Internally set; try `gn help current_cpu`.)
current_os
Current value (from the default) = ""
(Internally set; try `gn help current_os`.)
custom_toolchain
Current value (from the default) = ""
From //build/config/BUILDCONFIG.gn:144
Allows the path to a custom target toolchain to be injected as a single
argument, and set as the default toolchain.
dcheck_always_on
Current value (from the default) = false
From //build/config/dcheck_always_on.gni:14
Set to true to enable dcheck in Release builds.
dcheck_is_configurable
Current value (from the default) = false
From //build/config/dcheck_always_on.gni:9
Enables DCHECKs to be built-in, but to default to being non-fatal/log-only.
DCHECKS can then be set as fatal/non-fatal via the DCheckIsFatal feature.
See crbug.com/596231 for details on how this is used.
disable_libfuzzer
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:93
Helper variable for testing builds with disabled libfuzzer.
Not for client use.
enable_cast_renderer
Current value (from the default) = false
From //build/config/chromecast_build.gni:47
enable_full_stack_frames_for_profiling
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:67
Compile in such a way as to make it possible for the profiler to unwind full
stack frames. Setting this flag has a large effect on the performance of the
generated code than just setting profiling, but gives the profiler more
information to analyze.
Requires profiling to be set to true.
enable_iterator_debugging
Current value (from the default) = false
From //build/config/BUILD.gn:37
When set (the default) enables C++ iterator debugging in debug builds.
Iterator debugging is always off in release builds (technically, this flag
affects the "debug" config, which is always available but applied by
default only in debug builds).
Iterator debugging is generally useful for catching bugs. But it can
introduce extra locking to check the state of an iterator against the state
of the current object. For iterator- and thread-heavy code, this can
significantly slow execution - two orders of magnitude slowdown has been
seen (crbug.com/903553) and iterator debugging also slows builds by making
generation of snapshot_blob.bin take ~40-60 s longer. Therefore this
defaults to off.
enable_precompiled_headers
Current value (from the default) = true
From //build/config/pch.gni:11
Precompiled header file support is by default available,
but for distributed build system uses (like goma) or when
doing official builds.
enable_profiling
Current value (from the default) = false
From //build/config/compiler/compiler.gni:44
Compile in such a way as to enable profiling of the generated code. For
example, don't omit the frame pointer and leave in symbols.
fatal_linker_warnings
Current value (from the default) = true
From //build/config/compiler/BUILD.gn:83
Enable fatal linker warnings. Building Chromium with certain versions
of binutils can cause linker warning.
See: https://bugs.chromium.org/p/chromium/issues/detail?id=457359
force_local_build_id
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:135
By default only the binaries in official builds get build IDs.
full_wpo_on_official
Current value (from the default) = false
From //build/config/compiler/compiler.gni:172
generate_linker_map
Current value (from the default) = false
From //build/toolchain/toolchain.gni:26
Used for binary size analysis.
generate_order_files
Current value (from the default) = false
From //build/config/chrome_build.gni:17
Turn this on to generate order files. See
https://chromium.googlesource.com/chromium/src/+/master/docs/win_order_files.md
gold_path
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:71
When we are going to use gold we need to find it.
This is initialized below, after use_gold might have been overridden.
goma_dir
Current value (from the default) = "C:\src\goma\goma-win64"
From //build/toolchain/goma.gni:19
Absolute directory containing the gomacc.exe binary.
gtest_enable_absl_printers
Current value = true
From //.gn:82
Overridden from the default = false
From //third_party/googletest/BUILD.gn:9
If true, it assumes that //third_party/abseil-cpp is an available dependency.
has_gomacc_path
Current value (from the default) = false
From //build/toolchain/goma.gni:14
This flag is for ChromeOS compiler wrapper.
By passing gomacc path via GOMACC_PATH environment variable, ChromeOS'
compiler wrapper invokes gomacc inside it.
host_byteorder
Current value (from the default) = "undefined"
From //build/config/host_byteorder.gni:9
host_cpu
Current value (from the default) = "x64"
(Internally set; try `gn help host_cpu`.)
host_os
Current value (from the default) = "win"
(Internally set; try `gn help host_os`.)
host_pkg_config
Current value (from the default) = ""
From //build/config/linux/pkg_config.gni:36
A optional pkg-config wrapper to use for tools built on the host.
host_toolchain
Current value (from the default) = ""
From //build/config/BUILDCONFIG.gn:148
This should not normally be set as a build argument. It's here so that
every toolchain can pass through the "global" value via toolchain_args().
icu_use_data_file
Current value (from the default) = true
From //third_party/icu/config.gni:15
Tells icu to load an external data file rather than rely on the icudata
being linked directly into the binary.
This flag is a bit confusing. As of this writing, icu.gyp set the value to
0 but common.gypi sets the value to 1 for most platforms (and the 1 takes
precedence).
TODO(GYP) We'll probably need to enhance this logic to set the value to
true or false in similar circumstances.
ios_deployment_target
Current value = "10.0"
From //.gn:66
Overridden from the default = "11.0"
From //build/config/ios/ios_sdk_overrides.gni:10
Version of iOS that we're targeting.
is_asan
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:12
Compile for Address Sanitizer to find memory bugs.
is_cast_audio_only
Current value (from the default) = false
From //build/config/chromecast_build.gni:23
Set this true for an audio-only Chromecast build.
is_cast_desktop_build
Current value (from the default) = false
From //build/config/chromecast_build.gni:39
True if Chromecast build is targeted for linux desktop. This type of build
is useful for testing and development, but currently supports only a subset
of Cast functionality. Though this defaults to true for x86 Linux devices,
this should be overriden manually for an embedded x86 build.
TODO(slan): Remove instances of this when x86 is a fully supported platform.
is_cast_using_cma_backend
Current value (from the default) = true
From //build/config/chromecast_build.gni:27
If true, use cast CMA backend instead of default chromium media pipeline.
TODO(sanfin): Remove this flag when all builds enable CMA.
is_cfi
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:59
Compile with Control Flow Integrity to protect virtual calls and casts.
See http://clang.llvm.org/docs/ControlFlowIntegrity.html
TODO(pcc): Remove this flag if/when CFI is enabled in all official builds.
is_chrome_branded
Current value (from the default) = false
From //build/config/chrome_build.gni:9
Select the desired branding flavor. False means normal Chromium branding,
true means official Google Chrome branding (requires extra Google-internal
resources).
is_chromecast
Current value (from the default) = false
From //build/config/chromecast_build.gni:11
Set this true for a Chromecast build. Chromecast builds are supported on
Linux and Android.
is_clang
Current value (from the default) = true
From //build/config/BUILDCONFIG.gn:137
Set to true when compiling with the Clang compiler.
is_component_build
Current value = false
From //.gn:62
Overridden from the default = true
From //build/config/BUILDCONFIG.gn:165
Component build. Setting to true compiles targets declared as "components"
as shared libraries loaded dynamically. This speeds up development time.
When false, components will be linked statically.
For more information see
https://chromium.googlesource.com/chromium/src/+/master/docs/component_build.md
is_debug
Current value = true
From //out/Default/args.gn:1
Overridden from the default = true
From //build/config/BUILDCONFIG.gn:155
Debug build. Enabling official builds automatically sets is_debug to false.
is_desktop_linux
Current value (from the default) = false
From //build/config/BUILDCONFIG.gn:134
Whether we're a traditional desktop unix.
is_hwasan
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:17
Compile for Hardware-Assisted Address Sanitizer to find memory bugs
(android/arm64 only).
See http://clang.llvm.org/docs/HardwareAssistedAddressSanitizerDesign.html
is_lsan
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:20
Compile for Leak Sanitizer to find leaks.
is_msan
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:23
Compile for Memory Sanitizer to find uninitialized reads.
is_multi_dll_chrome
Current value (from the default) = true
From //build/config/chrome_build.gni:13
Break chrome.dll into multple pieces based on process type. Only available
on Windows.
is_official_build
Current value (from the default) = false
From //build/config/BUILDCONFIG.gn:131
Set to enable the official build level of optimization. This has nothing
to do with branding, but enables an additional level of optimization above
release (!is_debug). This might be better expressed as a tri-state
(debug, release, official) but for historical reasons there are two
separate flags.
is_tsan
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:26
Compile for Thread Sanitizer to find threading bugs.
is_ubsan
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:30
Compile for Undefined Behaviour Sanitizer to find various types of
undefined behaviour (excludes vptr checks).
is_ubsan_no_recover
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:33
Halt the program if a problem is detected.
is_ubsan_null
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:36
Compile for Undefined Behaviour Sanitizer's null pointer checks.
is_ubsan_security
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:89
Enables core ubsan security features. Will later be removed once it matches
is_ubsan.
is_ubsan_vptr
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:39
Compile for Undefined Behaviour Sanitizer's vptr checks.
is_win_fastlink
Current value (from the default) = false
From //build/config/compiler/compiler.gni:67
Tell VS to create a PDB that references information in .obj files rather
than copying it all. This should improve linker performance. mspdbcmf.exe
can be used to convert a fastlink pdb to a normal one.
libcxx_abi_unstable
Current value (from the default) = true
From //build/config/c++/BUILD.gn:17
lldb pretty printing only works when libc++ is built in the __1 (or __ndk1)
namespaces. For pretty printing to work out-of-the-box on Mac (where lldb
is primarily used), this flag is set to false to build with the __1
namespace (to maintain ABI compatibility, this implies building without
_LIBCPP_ABI_UNSTABLE). This is not necessary on non-component builds
because we leave the ABI version set to __1 in that case because libc++
symbols are not exported.
TODO(thomasanderson): Set this to true by default once rL352899 is available
in MacOS's lldb.
libcxx_is_shared
Current value (from the default) = false
From //build/config/c++/c++.gni:39
WARNING: Setting this to a non-default value is highly discouraged.
If true, libc++ will be built as a shared library; otherwise libc++ will be
linked statically. Setting this to something other than the default is
unsupported and can be broken by libc++ rolls. Note that if this is set to
true, you must also set libcxx_abi_unstable=false, which is bad for
performance and memory use.
libcxx_svn_revision
Current value (from the default) = "358423"
From //buildtools/deps_revisions.gni:8
The libc++ svn revision that belongs to the git hash in DEPS. Used to cause
full rebuilds on libc++ rolls.
libyuv_disable_jpeg
Current value (from the default) = false
From //third_party/libyuv/libyuv.gni:15
libyuv_include_tests
Current value (from the default) = true
From //third_party/libyuv/libyuv.gni:14
libyuv_symbols_visible
Current value (from the default) = false
From //third_party/libyuv/BUILD.gn:19
When building a shared library using a target in WebRTC or
Chromium projects that depends on libyuv, setting this flag
to true makes libyuv symbols visible inside that library.
libyuv_use_gflags
Current value = false
From //.gn:80
Overridden from the default = true
From //third_party/libyuv/BUILD.gn:14
Set to false to disable building with gflags.
libyuv_use_mmi
Current value (from the default) = false
From //third_party/libyuv/libyuv.gni:22
libyuv_use_msa
Current value (from the default) = false
From //third_party/libyuv/libyuv.gni:20
libyuv_use_neon
Current value (from the default) = false
From //third_party/libyuv/libyuv.gni:17
linux_use_bundled_binutils
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:57
llvm_force_head_revision
Current value (from the default) = false
From //build/toolchain/toolchain.gni:18
If this is set to true, or if LLVM_FORCE_HEAD_REVISION is set to 1
in the environment, we use the revision in the llvm repo to determine
the CLANG_REVISION to use, instead of the version hard-coded into
//tools/clang/scripts/update.py. This should only be used in
conjunction with setting LLVM_FORCE_HEAD_REVISION in the
environment when `gclient runhooks` is run as well.
mac_sdk_min
Current value = "10.12"
From //.gn:64
Overridden from the default = "10.13"
From //build/config/mac/mac_sdk_overrides.gni:12
mips_use_mmi
Current value (from the default) = false
From //build/config/mips.gni:13
MIPS MultiMedia Instruction compilation flag.
msan_track_origins
Current value (from the default) = 2
From //build/config/sanitizers/sanitizers.gni:44
Track where uninitialized memory originates from. From fastest to slowest:
0 - no tracking, 1 - track only the initial allocation site, 2 - track the
chain of stores leading from allocation site to use site.
msvc_use_absolute_paths
Current value (from the default) = false
From //build/config/win/BUILD.gn:47
Use absolute file paths in the compiler diagnostics and (for non-clang)
__FILE__ macro if needed. Note that enabling this makes your build
dependent your checkout's path, which means you won't get to use goma's
global cache, and without clang your builds won't be deterministic.
msvs_xtree_patched
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:77
Whether the VS xtree header has been patched to disable warning 4702. If
it has, then we don't need to disable 4702 (unreachable code warning).
The patch is preapplied to the internal toolchain and hence all bots.
optimize_for_fuzzing
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:97
Optimize for coverage guided fuzzing (balance between speed and number of
branches). Can be also used to remove non-determinism and other issues.
pgo_data_path
Current value (from the default) = ""
From //build/config/compiler/pgo/pgo.gni:16
When using chrome_pgo_phase = 2, read profile data from this path.
pkg_config
Current value (from the default) = ""
From //build/config/linux/pkg_config.gni:33
A pkg-config wrapper to call instead of trying to find and call the right
pkg-config directly. Wrappers like this are common in cross-compilation
environments.
Leaving it blank defaults to searching PATH for 'pkg-config' and relying on
the sysroot mechanism to find the right .pc files.
proprietary_codecs
Current value (from the default) = false
From //build/config/features.gni:29
Enables proprietary codecs and demuxers; e.g. H264, AAC, MP3, and MP4.
We always build Google Chrome and Chromecast with proprietary codecs.
Note: this flag is used by WebRTC which is DEPSed into Chrome. Moving it
out of //build will require using the build_overrides directory.
ro_segment_workaround_for_valgrind
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:118
Set to true to pass --no-rosegment to lld. This is a workaround
for a KI issue in Valgrind,
https://bugs.kde.org/show_bug.cgi?id=384727
rtc_audio_device_plays_sinus_tone
Current value (from the default) = false
From //webrtc.gni:168
When set to true, replace the audio output with a sinus tone at 440Hz.
The ADM will ask for audio data from WebRTC but instead of reading real
audio samples from NetEQ, a sinus tone will be generated and replace the
real audio samples.
rtc_build_examples
Current value (from the default) = true
From //webrtc.gni:103
Set this to false to skip building examples.
rtc_build_json
Current value (from the default) = true
From //webrtc.gni:215
Disable these to not build components which can be externally provided.
rtc_build_libevent
Current value (from the default) = false
From //webrtc.gni:226
rtc_build_libsrtp
Current value (from the default) = true
From //webrtc.gni:216
rtc_build_libvpx
Current value (from the default) = true
From //webrtc.gni:217
rtc_build_opus
Current value (from the default) = true
From //webrtc.gni:219
rtc_build_ssl
Current value (from the default) = true
From //webrtc.gni:220
rtc_build_tools
Current value (from the default) = true
From //webrtc.gni:106
Set this to false to skip building tools.
rtc_build_usrsctp
Current value (from the default) = true
From //webrtc.gni:221
rtc_build_with_neon
Current value (from the default) = false
From //webrtc.gni:145
rtc_builtin_ssl_root_certificates
Current value (from the default) = true
From //webrtc.gni:65
Setting this to false will require the API user to pass in their own
SSLCertificateVerifier to verify the certificates presented from a
TLS-TURN server. In return disabling this saves around 100kb in the binary.
rtc_enable_android_aaudio
Current value (from the default) = false
From //webrtc.gni:125
Enable use of Android AAudio which requires Android SDK 26 or above and
NDK r16 or above.
rtc_enable_bwe_test_logging
Current value (from the default) = false
From //webrtc.gni:100
Set this to true to enable BWE test logging.
rtc_enable_external_auth
Current value (from the default) = false
From //webrtc.gni:93
Enable when an external authentication mechanism is used for performing
packet authentication for RTP packets instead of libsrtp.
rtc_enable_libevent
Current value (from the default) = false
From //webrtc.gni:225
rtc_enable_protobuf
Current value (from the default) = true
From //webrtc.gni:209
Enables the use of protocol buffers for debug recordings.
rtc_enable_sctp
Current value (from the default) = true
From //webrtc.gni:212
Set this to disable building with support for SCTP data channels.
rtc_enable_symbol_export
Current value (from the default) = false
From //webrtc.gni:41
Setting this to true will make RTC_EXPORT (see rtc_base/system/rtc_export.h)
expand to code that will manage symbols visibility.
rtc_exclude_field_trial_default
Current value (from the default) = false
From //webrtc.gni:53
rtc_exclude_metrics_default
Current value (from the default) = false
From //webrtc.gni:60
Setting this to true will define WEBRTC_EXCLUDE_METRICS_DEFAULT which
will tell the pre-processor to remove the default definition of symbols
needed to use metrics. In that case a new implementation needs to be
provided.
rtc_include_builtin_audio_codecs
Current value (from the default) = true
From //webrtc.gni:183
When set to false, builtin audio encoder/decoder factories and all the
audio codecs they depend on will not be included in libwebrtc.{a|lib}
(they will still be included in libjingle_peerconnection_so.so and
WebRTC.framework)
rtc_include_builtin_video_codecs
Current value (from the default) = true
From //webrtc.gni:189
When set to false, builtin video encoder/decoder factories and all the
video codecs they depends on will not be included in libwebrtc.{a|lib}
(they will still be included in libjingle_peerconnection_so.so and
WebRTC.framework)
rtc_include_ilbc
Current value (from the default) = true
From //webrtc.gni:68
Include the iLBC audio codec?
rtc_include_internal_audio_device
Current value (from the default) = true
From //webrtc.gni:241
Chromium uses its own IO handling, so the internal ADM is only built for
standalone WebRTC.
rtc_include_opus
Current value (from the default) = true
From //webrtc.gni:71
Disable this to avoid building the Opus audio codec.
rtc_include_pulse_audio
Current value (from the default) = true
From //webrtc.gni:237
Excluded in Chromium since its prerequisites don't require Pulse Audio.
rtc_include_tests
Current value (from the default) = true
From //webrtc.gni:244
Include tests in standalone checkout.
rtc_jsoncpp_root
Current value (from the default) = "//third_party/jsoncpp/source/include"
From //webrtc.gni:82
Used to specify an external Jsoncpp include path when not compiling the
library that comes with WebRTC (i.e. rtc_build_json == 0).
rtc_libvpx_build_vp9
Current value (from the default) = true
From //webrtc.gni:218
rtc_link_pipewire
Current value (from the default) = false
From //webrtc.gni:118
Set this to link PipeWire directly instead of using the dlopen.
rtc_opus_support_120ms_ptime
Current value (from the default) = true
From //webrtc.gni:75
Enable this if the Opus version upon which WebRTC is built supports direct
encoding of 120 ms packets.
rtc_opus_variable_complexity
Current value (from the default) = false
From //webrtc.gni:78
Enable this to let the Opus audio codec change complexity on the fly.
rtc_prefer_fixed_point
Current value (from the default) = false
From //webrtc.gni:89
Selects fixed-point code where possible.
rtc_sanitize_coverage
Current value (from the default) = ""
From //webrtc.gni:137
Set to "func", "block", "edge" for coverage generation.
At unit test runtime set UBSAN_OPTIONS="coverage=1".
It is recommend to set include_examples=0.
Use llvm's sancov -html-report for human readable reports.
See http://clang.llvm.org/docs/SanitizerCoverage.html .
rtc_ssl_root
Current value (from the default) = ""
From //webrtc.gni:86
Used to specify an external OpenSSL include path when not compiling the
library that comes with WebRTC (i.e. rtc_build_ssl == 0).
rtc_use_dummy_audio_file_devices
Current value (from the default) = false
From //webrtc.gni:162
By default, use normal platform audio support or dummy audio, but don't
use file-based audio playout and record.
rtc_use_gtk
Current value (from the default) = true
From //webrtc.gni:234
Build sources requiring GTK. NOTICE: This is not present in Chrome OS
build environments, even if available for Chromium builds.
rtc_use_h264
Current value (from the default) = false
From //webrtc.gni:158
rtc_use_lto
Current value (from the default) = false
From //webrtc.gni:130
Link-Time Optimizations.
Executes code generation at link-time instead of compile-time.
https://gcc.gnu.org/wiki/LinkTimeOptimization
rtc_use_metal_rendering
Current value (from the default) = false
From //webrtc.gni:177
Determines whether Metal is available on iOS/macOS.
rtc_use_pipewire
Current value (from the default) = false
From //webrtc.gni:115
Set this to use PipeWire on the Wayland display server.
By default it's only enabled on desktop Linux (excludes ChromeOS) and
only when using the sysroot as PipeWire is not available in older and
supported Ubuntu and Debian distributions.
rtc_use_x11
Current value (from the default) = false
From //webrtc.gni:109
Set this to false to skip building code that requires X11.
rtc_win_undef_unicode
Current value (from the default) = false
From //webrtc.gni:197
When set to true and in a standalone build, it will undefine UNICODE and
_UNICODE (which are always defined globally by the Chromium Windows
toolchain).
This is only needed for testing purposes, WebRTC wants to be sure it
doesn't assume /DUNICODE and /D_UNICODE but that it explicitly uses
wide character functions.
safe_browsing_mode
Current value (from the default) = 1
From //build/config/features.gni:44
sample_profile_is_accurate
Current value (from the default) = false
From //build/config/compiler/compiler.gni:103
Whether we should consider the profile we're using to be accurate. Accurate
profiles have the benefit of (potentially substantial) binary size
reductions, by instructing the compiler to optimize cold and uncovered
functions heavily for size. This often comes at the cost of performance.
sanitizer_coverage_flags
Current value (from the default) = ""
From //build/config/sanitizers/sanitizers.gni:107
Value for -fsanitize-coverage flag. Setting this causes
use_sanitizer_coverage to be enabled.
This flag is not used for libFuzzer (use_libfuzzer=true). Instead, we use:
-fsanitize=fuzzer-no-link
Default value when unset and use_fuzzing_engine=true:
trace-pc-guard
Default value when unset and use_sanitizer_coverage=true:
trace-pc-guard,indirect-calls
strip_absolute_paths_from_debug_symbols
Current value (from the default) = true
From //build/config/compiler/compiler.gni:198
strip_debug_info
Current value (from the default) = false
From //build/config/compiler/compiler.gni:40
Android-only: Strip the debug info of libraries within lib.unstripped to
reduce size. As long as symbol_level > 0, this will still allow stacks to be
symbolized.
symbol_level
Current value (from the default) = -1
From //build/config/compiler/compiler.gni:35
How many symbols to include in the build. This affects the performance of
the build since the symbols are large and dealing with them is slow.
2 means regular build with symbols.
1 means minimal symbols, usually enough for backtraces only. Symbols with
internal linkage (static functions or those in anonymous namespaces) may not
appear when using this level.
0 means no symbols.
-1 means auto-set according to debug/release and platform.
system_libdir
Current value (from the default) = "lib"
From //build/config/linux/pkg_config.gni:47
CrOS systemroots place pkgconfig files at <systemroot>/usr/share/pkgconfig
and one of <systemroot>/usr/lib/pkgconfig or <systemroot>/usr/lib64/pkgconfig
depending on whether the systemroot is for a 32 or 64 bit architecture.
When build under GYP, CrOS board builds specify the 'system_libdir' variable
as part of the GYP_DEFINES provided by the CrOS emerge build or simple
chrome build scheme. This variable permits controlling this for GN builds
in similar fashion by setting the `system_libdir` variable in the build's
args.gn file to 'lib' or 'lib64' as appropriate for the target architecture.
target_cpu
Current value (from the default) = ""
(Internally set; try `gn help target_cpu`.)
target_os
Current value (from the default) = ""
(Internally set; try `gn help target_os`.)
target_sysroot
Current value (from the default) = ""
From //build/config/sysroot.gni:13
The absolute path of the sysroot that is applied when compiling using
the target toolchain.
target_sysroot_dir
Current value (from the default) = "//build/linux"
From //build/config/sysroot.gni:16
The absolute path to directory containing linux sysroot images
target_winuwp_family
Current value (from the default) = "app"
From //build/config/win/BUILD.gn:32
possible values:
"app" - Windows Store Applications
"phone" - Windows Phone Applications
"system" - Windows Drivers and Tools
"server" - Windows Server Applications
"desktop" - Windows Desktop Applications
target_winuwp_version
Current value (from the default) = "10"
From //build/config/win/BUILD.gn:24
possible values for target_winuwp_version:
"10" - Windows UWP 10
"8.1" - Windows RT 8.1
"8.0" - Windows RT 8.0
thin_lto_enable_optimizations
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:132
toolkit_views
Current value (from the default) = true
From //build/config/ui.gni:38
True means the UI is built using the "views" framework.
treat_warnings_as_errors
Current value (from the default) = true
From //build/config/compiler/BUILD.gn:46
Default to warnings as errors for default workflow, where we catch
warnings with known toolchains. Allow overriding this e.g. for Chromium
builds on Linux that could use a different version of the compiler.
With GCC, warnings in no-Chromium code are always not treated as errors.
use_afl
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:85
Compile for fuzzing with AFL.
use_allocator
Current value (from the default) = "none"
From //build/config/allocator.gni:28
Memory allocator to use. Set to "none" to use default allocator.
use_allocator_shim
Current value (from the default) = false
From //build/config/allocator.gni:31
Causes all the allocations to be routed via allocator_shim.cc.
use_aura
Current value (from the default) = true
From //build/config/ui.gni:30
Indicates if Aura is enabled. Aura is a low-level windowing library, sort
of a replacement for GDI or GTK.
use_cfi_cast
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:65
Enable checks for bad casts: derived cast and unrelated cast.
TODO(krasin): remove this, when we're ready to add these checks by default.
https://crbug.com/626794
use_cfi_diag
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:74
Print detailed diagnostics when Control Flow Integrity detects a violation.
use_cfi_icall
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:70
Enable checks for indirect function calls via a function pointer.
TODO(pcc): remove this when we're ready to add these checks by default.
https://crbug.com/701919
use_cfi_recover
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:78
Let Control Flow Integrity continue execution instead of crashing when
printing diagnostics (use_cfi_diag = true).
use_clang_coverage
Current value (from the default) = false
From //build/config/coverage/coverage.gni:15
Enable Clang's Source-based Code Coverage.
use_clang_diagnostics_format
Current value (from the default) = false
From //build/config/win/BUILD.gn:41
Set this to use clang-style diagnostics format instead of MSVC-style, which
is useful in e.g. Emacs compilation mode.
E.g.:
Without this, clang emits a diagnostic message like this:
foo/bar.cc(12,34): error: something went wrong
and with this switch, clang emits it like this:
foo/bar.cc:12:34: error: something went wrong
use_custom_libcxx
Current value (from the default) = true
From //build/config/c++/c++.gni:14
use_custom_libcxx_for_host
Current value (from the default) = false
From //build/config/c++/c++.gni:25
Use libc++ instead of stdlibc++ when using the host_cpu toolchain, even if
use_custom_libcxx is false. This is useful for cross-compiles where a custom
toolchain for the target_cpu has been set as the default toolchain, but
use_custom_libcxx should still be true when building for the host. The
expected usage is to set use_custom_libcxx=false and
use_custom_libcxx_for_host=true in the passed in buildargs.
use_cxx11
Current value = true
From //.gn:73
Overridden from the default = false
From //build/config/compiler/BUILD.gn:97
Allow projects that wish to stay on C++11 to override Chromium's default.
use_cxx11_on_android
Current value = false
From //.gn:76
Overridden from the default = true
From //build/config/compiler/BUILD.gn:140
C++11 may not be an option if Android test infrastructure is used.
use_dbus
Current value (from the default) = false
From //build/config/features.gni:50
use_debug_fission
Current value (from the default) = "default"
From //build/config/compiler/compiler.gni:56
use_debug_fission: whether to use split DWARF debug info
files. This can reduce link time significantly, but is incompatible
with some utilities such as icecc and ccache. Requires gold and
gcc >= 4.8 or clang.
http://gcc.gnu.org/wiki/DebugFission
This is a placeholder value indicating that the code below should set
the default. This is necessary to delay the evaluation of the default
value expression until after its input values such as use_gold have
been set, e.g. by a toolchain_args() block.
use_dummy_lastchange
Current value (from the default) = false
From //build/util/lastchange.gni:9
use_ghash
Current value (from the default) = true
From //build/config/compiler/BUILD.gn:122
Turn this on to use ghash feature of lld for faster debug link on Windows.
http://blog.llvm.org/2018/01/improving-link-time-on-windows-with.html
use_gio
Current value (from the default) = false
From //build/config/features.gni:52
use_glib
Current value (from the default) = false
From //build/config/ui.gni:33
Whether we should use glib, a low level C utility library.
use_gold
Current value (from the default) = false
From //build/config/compiler/compiler.gni:184
use_goma
Current value (from the default) = false
From //build/toolchain/goma.gni:9
Set to true to enable distributed compilation using Goma.
use_icf
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:156
Set to true to use icf, Identical Code Folding.
icf=all is broken in older golds, see
https://sourceware.org/bugzilla/show_bug.cgi?id=17704
See also https://crbug.com/663886
`linux_use_bundled_binutils` is to avoid breaking Linux distros which may
still have a buggy gold.
chromeos binutils has been patched with the fix, so always use icf there.
The bug only affects x86 and x64, so we can still use ICF when targeting
other architectures.
lld doesn't have the bug.
use_incremental_wpo
Current value (from the default) = false
From //build/config/compiler/compiler.gni:71
Whether or not we should turn on incremental WPO. Only affects the VS
Windows build.
use_libfuzzer
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:82
Compile for fuzzing with LLVM LibFuzzer.
See http://www.chromium.org/developers/testing/libfuzzer
use_libjpeg_turbo
Current value (from the default) = true
From //third_party/libjpeg.gni:11
Uses libjpeg_turbo as the jpeg implementation. Has no effect if
use_system_libjpeg is set.
use_lld
Current value (from the default) = true
From //build/config/compiler/compiler.gni:178
Set to true to use lld, the LLVM linker.
use_locally_built_instrumented_libraries
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:53
Use dynamic libraries instrumented by one of the sanitizers instead of the
standard system libraries. Set this flag to build the libraries from source.
use_new_tcmalloc
Current value (from the default) = false
From //build/config/allocator.gni:37
Use the new tcmalloc. It's relevant only when use_allocator == "tcmalloc".
use_ozone
Current value (from the default) = false
From //build/config/ui.gni:26
Indicates if Ozone is enabled. Ozone is a low-level library layer for Linux
that does not require X11. Enabling this feature disables use of glib, x11,
Pango, and Cairo.
use_partition_alloc
Current value (from the default) = true
From //build/config/allocator.gni:34
Partition alloc is included by default except iOS.
use_prebuilt_instrumented_libraries
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:49
Use dynamic libraries instrumented by one of the sanitizers instead of the
standard system libraries. Set this flag to download prebuilt binaries from
GCS.
use_rtti
Current value (from the default) = false
From //build/config/compiler/BUILD.gn:88
Build with C++ RTTI enabled. Chromium builds without RTTI by default,
but some sanitizers are known to require it, like CFI diagnostics
and UBsan variants.
use_sanitizer_configs_without_instrumentation
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:115
When enabled, only relevant sanitizer defines are set, but compilation
happens with no extra flags. This is useful when in component build
enabling sanitizers only in some of the components.
use_sanitizer_coverage
Current value (from the default) = false
From //build/config/sanitizers/sanitizers.gni:155
use_sysroot
Current value (from the default) = true
From //build/config/sysroot.gni:18
use_system_freetype
Current value (from the default) = false
From //build/config/freetype/freetype.gni:13
Blink needs a recent and properly build-configured FreeType version to
support OpenType variations, color emoji and avoid security bugs. By default
we ship and link such a version as part of Chrome. For distributions that
prefer to keep linking to the version the system, FreeType must be newer
than version 2.7.1 and have color bitmap support compiled in. WARNING:
System FreeType configurations other than as described WILL INTRODUCE TEXT
RENDERING AND SECURITY REGRESSIONS.
use_system_harfbuzz
Current value (from the default) = false
From //third_party/harfbuzz-ng/harfbuzz.gni:11
Blink uses a cutting-edge version of Harfbuzz; most Linux distros do not
contain a new enough version of the code to work correctly. However,
ChromeOS chroots (i.e, real ChromeOS builds for devices) do contain a
new enough version of the library, and so this variable exists so that
ChromeOS can build against the system lib and keep binary sizes smaller.
use_system_libjpeg
Current value (from the default) = false
From //third_party/libjpeg.gni:7
Uses system libjpeg. If true, overrides use_libjpeg_turbo.
use_thin_lto
Current value (from the default) = false
From //build/config/compiler/compiler.gni:62
Enables support for ThinLTO, which links 3x-10x faster than full LTO. See
also http://blog.llvm.org/2016/06/thinlto-scalable-and-incremental-lto.html
TODO(thakis): Re-add `|| (is_android && is_official_build)` once lld and
resource whitelist generation can coexist again, https://crbug.com/960881
use_udev
Current value (from the default) = false
From //build/config/features.gni:48
libudev usage. This currently only affects the content layer.
use_xcode_clang
Current value (from the default) = false
From //build/toolchain/toolchain.gni:23
Compile with Xcode version of clang instead of hermetic version shipped
with the build. Used on iOS to ship official builds (as they are built
with the version of clang shipped with Xcode).
using_mismatched_sample_profile
Current value (from the default) = false
From //build/config/compiler/compiler.gni:78
Whether we're using a sample profile collected on an architecture different
than the one we're compiling for.
It's currently not possible to collect AFDO profiles on anything but
x86{,_64}.
v8_current_cpu
Current value (from the default) = "x64"
From //build/config/v8_target_cpu.gni:60
This argument is declared here so that it can be overridden in toolchains.
It should never be explicitly set by the user.
v8_target_cpu
Current value (from the default) = ""
From //build/config/v8_target_cpu.gni:33
This arg is used when we want to tell the JIT-generating v8 code
that we want to have it generate for an architecture that is different
than the architecture that v8 will actually run on; we then run the
code under an emulator. For example, we might run v8 on x86, but
generate arm code and run that under emulation.
This arg is defined here rather than in the v8 project because we want
some of the common architecture-specific args (like arm_float_abi or
mips_arch_variant) to be set to their defaults either if the current_cpu
applies *or* if the v8_current_cpu applies.
As described below, you can also specify the v8_target_cpu to use
indirectly by specifying a `custom_toolchain` that contains v8_$cpu in the
name after the normal toolchain.
For example, `gn gen --args="custom_toolchain=...:clang_x64_v8_arm64"`
is equivalent to setting --args=`v8_target_cpu="arm64"`. Setting
`custom_toolchain` is more verbose but makes the toolchain that is
(effectively) being used explicit.
v8_target_cpu can only be used to target one architecture in a build,
so if you wish to build multiple copies of v8 that are targeting
different architectures, you will need to do something more
complicated involving multiple toolchains along the lines of
custom_toolchain, above.
visual_studio_path
Current value (from the default) = "C:\Program Files (x86)\Microsoft Visual Studio 14.0"
From //build/config/win/visual_studio_version.gni:10
Path to Visual Studio. If empty, the default is used which is to use the
automatic toolchain in depot_tools. If set, you must also set the
visual_studio_version and wdk_path.
visual_studio_path = "C:\Program Files (x86)\Microsoft Visual Studio 14.0"
visual_studio_version
Current value (from the default) = "2015"
From //build/config/win/visual_studio_version.gni:14
Version of Visual Studio pointed to by the visual_studio_path.
Currently always "2015".
wdk_path
Current value (from the default) = "C:\Program Files (x86)\Windows Kits\10"
From //build/config/win/visual_studio_version.gni:18
Directory of the Windows driver kit. If visual_studio_path is empty, this
will be auto-filled.
win_linker_timing
Current value (from the default) = false
From //build/config/win/BUILD.gn:18
Turn this on to have the linker output extra timing information.
windows_sdk_path
Current value (from the default) = "C:\Program Files (x86)\Windows Kits\10"
From //build/config/win/visual_studio_version.gni:23
Full path to the Windows SDK, not including a backslash at the end.
This value is the default location, override if you have a different
installation location.
