| # GN Build Arguments |
| |
| ## All builds |
| |
| ### acpica_debug_output |
| Enable debug output in the ACPI library (used by the ACPI bus driver). |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/acpica/BUILD.gn:9](https://fuchsia.googlesource.com/third_party/acpica/+/15e06b553cd334277b85d8a663ff7b4d8c85b199/BUILD.gn#9) |
| |
| ### active_partition |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:76 |
| |
| ### add_qemu_to_build_archives |
| Whether to include images necessary to run Fuchsia in QEMU in build |
| archives. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:82 |
| |
| ### additional_bootserver_arguments |
| Additional bootserver args to add to pave.sh. New uses of this should be |
| added with caution, and ideally discussion. The present use case is to |
| enable throttling of netboot when specific network adapters are combined |
| with specific boards, due to driver and hardware challenges. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:88 |
| |
| ### all_font_file_paths |
| List of file paths to every font asset. Populated in fonts.gni. |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/fonts/build/font_args.gni:35 |
| |
| ### all_toolchain_variants |
| *These should never be set as a build argument.* |
| It will be set below and passed to other toolchains through toolchain_args |
| (see variant_toolchain.gni). |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/config/BUILDCONFIG.gn:1251 |
| |
| ### always_zedboot |
| Build boot images that prefer Zedboot over local boot (only for EFI). |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:103 |
| |
| ### anv_enable_external_fd |
| TODO(fxbug.dev/67565) - remove once external FD extensions fully supported |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/mesa/src/intel/vulkan/BUILD.gn:26](https://fuchsia.googlesource.com/third_party/mesa/+/0b904d132a94096df16a844d3affd1defff007be/src/intel/vulkan/BUILD.gn#26) |
| |
| ### anv_use_max_ram |
| Give maximum possible memory to Vulkan heap |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/mesa/src/intel/vulkan/BUILD.gn:28](https://fuchsia.googlesource.com/third_party/mesa/+/0b904d132a94096df16a844d3affd1defff007be/src/intel/vulkan/BUILD.gn#28) |
| |
| ### asan_default_options |
| Default [AddressSanitizer](https://clang.llvm.org/docs/AddressSanitizer.html) |
| options (before the `ASAN_OPTIONS` environment variable is read at |
| runtime). This can be set as a build argument to affect most "asan" |
| variants in $variants (which see), or overridden in $toolchain_args in |
| one of those variants. This can be a list of strings or a single string. |
| |
| Note that even if this is empty, programs in this build **cannot** define |
| their own `__asan_default_options` C function. Instead, they can use a |
| sanitizer_extra_options() target in their `deps` and then any options |
| injected that way can override that option's setting in this list. |
| |
| **Current value (from the default):** `["detect_stack_use_after_return=1"]` |
| |
| From //zircon/public/gn/config/instrumentation/sanitizer_default_options.gni:16 |
| |
| ### auto_login_to_guest |
| Whether basemgr should use a random identifier for sessions, leading to |
| a different persistent data location for every session. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/modular/bin/basemgr/BUILD.gn:13 |
| |
| ### auto_update_packages |
| Whether the component loader should automatically update packages. |
| |
| **Current value (from the default):** `true` |
| |
| From //src/sys/sysmgr/BUILD.gn:10 |
| |
| ### avb_algorithm |
| AVB algorithm type.Supported options: |
| SHA256_RSA2048 |
| SHA256_RSA4096 |
| SHA256_RSA8192 |
| SHA512_RSA2048 |
| SHA512_RSA4096 |
| SHA512_RSA8192 |
| |
| **Current value (from the default):** `"SHA512_RSA4096"` |
| |
| From //build/images/vbmeta.gni:33 |
| |
| ### avb_atx_metadata |
| AVB metadata which will be used to validate public key |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/vbmeta.gni:24 |
| |
| ### avb_key |
| a key which will be used to sign VBMETA and images for AVB |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/vbmeta.gni:21 |
| |
| ### base_cache_packages_allow_testonly |
| Whether to allow testonly=true targets in base/cache pacakges. Default to |
| true to allow testonly=true targets. It is preferrable to set to false for |
| production builds to avoid accidental inclusion of testing targets. |
| |
| **Current value (from the default):** `true` |
| |
| From //BUILD.gn:59 |
| |
| ### base_package_labels |
| If you add package labels to this variable, the packages will be included in |
| the 'base' package set, which represents the set of packages that are part |
| of an OTA. These pacakages are updated as an atomic unit during an OTA |
| process and are immutable and are a superset of the TCB (Trusted Computing |
| Base) for a product. These packages are never evicted by the system. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//bundles:kitchen_sink"]` |
| |
| From //out/not-default/args.gn:7 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:27 |
| |
| **Current value for `target_cpu = "x64"`:** `["//bundles:kitchen_sink"]` |
| |
| From //out/not-default/args.gn:7 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:27 |
| |
| ### basic_env_names |
| The list of environment names to include in "basic_envs". |
| |
| **Current value (from the default):** `["emu"]` |
| |
| From //build/testing/environments.gni:14 |
| |
| ### blob_blobfs_maximum_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:98 |
| |
| ### blob_blobfs_minimum_data_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:95 |
| |
| ### blob_blobfs_minimum_inodes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:92 |
| |
| ### blob_layout_format |
| The format blobfs should store blobs in. |
| |
| **Current value (from the default):** `"compact"` |
| |
| From //build/images/args.gni:100 |
| |
| ### blobfs_board_maximum_bytes |
| In addition to reserving space for inodes and data, fs needs additional |
| space for maintaining some internal data structures. So the |
| space required to reserve inodes and data may exceed sum of the space |
| needed for inodes and data. |
| maximum_bytes puts an upper bound on the total bytes reserved for inodes, |
| data bytes and reservation for all other internal fs metadata. |
| An empty string does not put any upper bound. A filesystem may |
| reserve few blocks required for its operations. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:84 |
| |
| ### blobfs_board_minimum_data_bytes |
| Number of bytes to reserve for data in the fs. This is in addition |
| to what is reserved, if any, for the inodes. Data bytes constitutes |
| "usable" space of the fs. |
| An empty string does not reserve any additional space than minimum |
| required for the filesystem. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:71 |
| |
| ### blobfs_board_minimum_inodes |
| minimum_inodes is the number of inodes to reserve for the fs |
| An empty string does not reserve any additional space than minimum |
| required for the filesystem. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:61 |
| |
| ### blobfs_maximum_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:97 |
| |
| ### blobfs_maximum_runtime_bytes |
| blobfs_maximum_runtime_bytes is an upper bound on the partition size on the device. Partitions |
| can grow as needed if there are extra slices available in FVM. This limit prevents the blobfs |
| partition from taking too much space away from other uses. |
| |
| Pass the empty string for no limit. |
| |
| **Current value (from the default):** `""` |
| |
| From //src/storage/fshost/BUILD.gn:16 |
| |
| ### blobfs_minimum_data_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:94 |
| |
| ### blobfs_minimum_inodes |
| TODO(fxbug.dev/67015): Remove these; these are left here to facilitate a |
| soft transition. DO NOT USE THESE VARIABLES. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:91 |
| |
| ### blobfs_page_in_metrics_recording |
| Set this to true when configuring gn args to enable blobfs page-in |
| metrics recording. |
| This will also increase the inspect VMO size for blobfs to 2 MiB, |
| to accommodate the large number of metrics entries. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/storage/blobfs/BUILD.gn:13 |
| |
| ### blobfs_product_maximum_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:85 |
| |
| ### blobfs_product_minimum_data_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:72 |
| |
| ### blobfs_product_minimum_inodes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:62 |
| |
| ### board_bootfs_labels |
| A list of binary labels to include in the ZBI. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//src/connectivity/ethernet/drivers/virtio:virtio_ethernet", "//src/devices/block/drivers/ahci", "//src/devices/block/drivers/virtio:virtio_block", "//src/devices/block/drivers/virtio:virtio_scsi", "//src/devices/misc/drivers/virtio-rng:virtio_rng", "//src/devices/misc/drivers/virtio-socket:virtio_socket", "//src/devices/serial/drivers/virtio-console:virtio_console", "//src/graphics/display/drivers/goldfish-display", "//src/graphics/drivers/virtio:virtio_gpu", "//src/ui/input/drivers/virtio:virtio_input", "//src/devices/board/drivers/qemu-arm64", "//src/devices/rtc/drivers/pl031-rtc", "//src/graphics/display/drivers/fake:fake-display", "//src/devices/bus/drivers/pci:bus-pci", "//src/devices/bus/drivers/pci:bus-pci.proxy", "//src/devices/usb/drivers/xhci-rewrite:xhci", "//src/power/power-manager:base_config", "//src/security/policy/zxcrypt:null"]` |
| |
| From //boards/arm64.gni:19 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:14 |
| |
| **Current value for `target_cpu = "x64"`:** `["//src/connectivity/ethernet/drivers/virtio:virtio_ethernet", "//src/devices/block/drivers/virtio:virtio_block", "//src/devices/block/drivers/virtio:virtio_scsi", "//src/devices/misc/drivers/virtio-rng:virtio_rng", "//src/devices/misc/drivers/virtio-socket:virtio_socket", "//src/devices/serial/drivers/virtio-console:virtio_console", "//src/graphics/display/drivers/goldfish-display", "//src/graphics/drivers/virtio:virtio_gpu", "//src/ui/input/drivers/virtio:virtio_input", "//src/media/audio/drivers/intel-hda/codecs/qemu:qemu-audio-codec", "//boards/kernel_cmdline:serial-legacy", "//src/connectivity/ethernet/drivers/realtek-8111", "//src/devices/bin/acpidump", "//src/devices/block/drivers/ahci", "//src/devices/block/drivers/mbr", "//src/devices/block/drivers/nvme", "//src/devices/block/drivers/pci-sdhci", "//src/devices/block/drivers/sdhci", "//src/devices/board/drivers/x86:platform-bus-x86", "//src/devices/bus/drivers/pci:bus-pci", "//src/devices/bus/drivers/pci:bus-pci.proxy", "//src/devices/i2c/drivers/intel-i2c", "//src/devices/pci/bin:bootfs", "//src/devices/rtc/drivers/intel-rtc", "//src/devices/serial/drivers/intel-serialio", "//src/devices/serial/drivers/uart16550", "//src/devices/usb/drivers/xhci-rewrite:xhci", "//src/graphics/display/drivers/intel-i915", "//src/graphics/display/drivers/simple:simple.amd-kaveri", "//src/graphics/display/drivers/simple:simple.bochs", "//src/graphics/display/drivers/simple:simple.intel", "//src/graphics/display/drivers/simple:simple.nv", "//src/graphics/display/drivers/simple:simple.vmware", "//src/media/audio/bin/ihda", "//src/media/audio/drivers/codecs/alc5514", "//src/media/audio/drivers/codecs/alc5663", "//src/media/audio/drivers/codecs/max98927", "//src/media/audio/drivers/intel-hda/codecs/hdmi:hdmi-audio-codec", "//src/media/audio/drivers/intel-hda/codecs/realtek:realtek-audio-codec", "//src/media/audio/drivers/intel-hda/controller:intel-hda", "//src/power/power-manager:base_config", "//src/ui/input/drivers/i2c-hid", "//src/ui/input/drivers/pc-ps2", "//zircon/third_party/dev/ethernet/e1000", "//src/security/policy/zxcrypt:null", "//src/storage/fshost:gpt_all"]` |
| |
| From //boards/x64.gni:51 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:14 |
| |
| ### board_extra_vbmeta_images |
| Board level extra vbmeta images to be combined into the top-level vbmeta |
| struct. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/vbmeta.gni:40 |
| |
| ### board_has_libvulkan_arm_mali |
| Board files can set this to true if they have a package with a mali libvulkan VCD. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:55 |
| |
| ### board_name |
| Board name used for paving and amber updates. |
| |
| **Current value for `target_cpu = "arm64"`:** `"qemu-arm64"` |
| |
| From //boards/arm64.gni:9 |
| |
| **Overridden from the default:** `""` |
| |
| From //build/board.gni:7 |
| |
| **Current value for `target_cpu = "x64"`:** `"x64"` |
| |
| From //boards/x64.gni:9 |
| |
| **Overridden from the default:** `""` |
| |
| From //build/board.gni:7 |
| |
| ### board_package_labels |
| A list of package labels to include in the 'base' package set. Used by the |
| board definition rather than the product definition. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//garnet/bin/thermd", "//garnet/bin/thermd:config", "//garnet/packages/prod:drivers-support"]` |
| |
| From //boards/arm64.gni:30 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:11 |
| |
| **Current value for `target_cpu = "x64"`:** `["//garnet/bin/thermd", "//garnet/bin/thermd:config", "//garnet/packages/prod:drivers-support", "//src/hwinfo:default_board_config"]` |
| |
| From //boards/x64.gni:62 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:11 |
| |
| ### board_recovery_bootfs_labels |
| A list of binary labels to include in the recovery ZBI. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//src/connectivity/ethernet/drivers/virtio:virtio_ethernet", "//src/devices/block/drivers/ahci", "//src/devices/block/drivers/virtio:virtio_block", "//src/devices/block/drivers/virtio:virtio_scsi", "//src/devices/misc/drivers/virtio-rng:virtio_rng", "//src/devices/misc/drivers/virtio-socket:virtio_socket", "//src/devices/serial/drivers/virtio-console:virtio_console", "//src/graphics/display/drivers/goldfish-display", "//src/graphics/drivers/virtio:virtio_gpu", "//src/ui/input/drivers/virtio:virtio_input", "//src/devices/board/drivers/qemu-arm64", "//src/devices/rtc/drivers/pl031-rtc", "//src/graphics/display/drivers/fake:fake-display", "//src/devices/bus/drivers/pci:bus-pci", "//src/devices/bus/drivers/pci:bus-pci.proxy", "//src/devices/usb/drivers/xhci-rewrite:xhci", "//src/power/power-manager:base_config", "//src/security/policy/zxcrypt:null"]` |
| |
| From //boards/arm64.gni:23 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:25 |
| |
| **Current value for `target_cpu = "x64"`:** `["//src/connectivity/ethernet/drivers/virtio:virtio_ethernet", "//src/devices/block/drivers/virtio:virtio_block", "//src/devices/block/drivers/virtio:virtio_scsi", "//src/devices/misc/drivers/virtio-rng:virtio_rng", "//src/devices/misc/drivers/virtio-socket:virtio_socket", "//src/devices/serial/drivers/virtio-console:virtio_console", "//src/graphics/display/drivers/goldfish-display", "//src/graphics/drivers/virtio:virtio_gpu", "//src/ui/input/drivers/virtio:virtio_input", "//src/media/audio/drivers/intel-hda/codecs/qemu:qemu-audio-codec", "//boards/kernel_cmdline:serial-legacy", "//src/connectivity/ethernet/drivers/realtek-8111", "//src/devices/bin/acpidump", "//src/devices/block/drivers/ahci", "//src/devices/block/drivers/mbr", "//src/devices/block/drivers/nvme", "//src/devices/block/drivers/pci-sdhci", "//src/devices/block/drivers/sdhci", "//src/devices/board/drivers/x86:platform-bus-x86", "//src/devices/bus/drivers/pci:bus-pci", "//src/devices/bus/drivers/pci:bus-pci.proxy", "//src/devices/i2c/drivers/intel-i2c", "//src/devices/pci/bin:bootfs", "//src/devices/rtc/drivers/intel-rtc", "//src/devices/serial/drivers/intel-serialio", "//src/devices/serial/drivers/uart16550", "//src/devices/usb/drivers/xhci-rewrite:xhci", "//src/graphics/display/drivers/intel-i915", "//src/graphics/display/drivers/simple:simple.amd-kaveri", "//src/graphics/display/drivers/simple:simple.bochs", "//src/graphics/display/drivers/simple:simple.intel", "//src/graphics/display/drivers/simple:simple.nv", "//src/graphics/display/drivers/simple:simple.vmware", "//src/media/audio/bin/ihda", "//src/media/audio/drivers/codecs/alc5514", "//src/media/audio/drivers/codecs/alc5663", "//src/media/audio/drivers/codecs/max98927", "//src/media/audio/drivers/intel-hda/codecs/hdmi:hdmi-audio-codec", "//src/media/audio/drivers/intel-hda/codecs/realtek:realtek-audio-codec", "//src/media/audio/drivers/intel-hda/controller:intel-hda", "//src/power/power-manager:base_config", "//src/ui/input/drivers/i2c-hid", "//src/ui/input/drivers/pc-ps2", "//zircon/third_party/dev/ethernet/e1000", "//src/security/policy/zxcrypt:null"]` |
| |
| From //boards/x64.gni:53 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:25 |
| |
| ### board_system_image_deps |
| A list of binary labels to include in the system_image package. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//garnet/packages/prod:drivers-system", "//src/media/audio/bundles:virtual_audio_driver"]` |
| |
| From //boards/arm64.gni:25 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:28 |
| |
| **Current value for `target_cpu = "x64"`:** `["//garnet/packages/prod:drivers-system", "//src/media/audio/bundles:virtual_audio_driver"]` |
| |
| From //boards/x64.gni:57 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:28 |
| |
| ### board_tools |
| List of paths to board-specific tools to include in the build output. |
| |
| Most development tools can just be used in-tree and do not need to be |
| included here. This arg is only meant for tools which may need to be |
| distributed along with the build files, for example tools for flashing |
| from SoC recovery mode. |
| |
| Assets included in this way are included best-effort only and do not form |
| any kind of stable contract for users of the archive. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/args.gni:133 |
| |
| ### board_zedboot_bootfs_labels |
| A list of binary labels to include in the zedboot ZBI. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//src/connectivity/ethernet/drivers/virtio:virtio_ethernet", "//src/devices/block/drivers/ahci", "//src/devices/block/drivers/virtio:virtio_block", "//src/devices/block/drivers/virtio:virtio_scsi", "//src/devices/misc/drivers/virtio-rng:virtio_rng", "//src/devices/misc/drivers/virtio-socket:virtio_socket", "//src/devices/serial/drivers/virtio-console:virtio_console", "//src/graphics/display/drivers/goldfish-display", "//src/graphics/drivers/virtio:virtio_gpu", "//src/ui/input/drivers/virtio:virtio_input", "//src/devices/board/drivers/qemu-arm64", "//src/devices/rtc/drivers/pl031-rtc", "//src/graphics/display/drivers/fake:fake-display", "//src/devices/bus/drivers/pci:bus-pci", "//src/devices/bus/drivers/pci:bus-pci.proxy", "//src/devices/usb/drivers/xhci-rewrite:xhci", "//src/power/power-manager:base_config", "//src/security/policy/zxcrypt:null"]` |
| |
| From //boards/arm64.gni:21 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:22 |
| |
| **Current value for `target_cpu = "x64"`:** `["//src/connectivity/ethernet/drivers/virtio:virtio_ethernet", "//src/devices/block/drivers/virtio:virtio_block", "//src/devices/block/drivers/virtio:virtio_scsi", "//src/devices/misc/drivers/virtio-rng:virtio_rng", "//src/devices/misc/drivers/virtio-socket:virtio_socket", "//src/devices/serial/drivers/virtio-console:virtio_console", "//src/graphics/display/drivers/goldfish-display", "//src/graphics/drivers/virtio:virtio_gpu", "//src/ui/input/drivers/virtio:virtio_input", "//src/media/audio/drivers/intel-hda/codecs/qemu:qemu-audio-codec", "//boards/kernel_cmdline:serial-legacy", "//src/connectivity/ethernet/drivers/realtek-8111", "//src/devices/bin/acpidump", "//src/devices/block/drivers/ahci", "//src/devices/block/drivers/mbr", "//src/devices/block/drivers/nvme", "//src/devices/block/drivers/pci-sdhci", "//src/devices/block/drivers/sdhci", "//src/devices/board/drivers/x86:platform-bus-x86", "//src/devices/bus/drivers/pci:bus-pci", "//src/devices/bus/drivers/pci:bus-pci.proxy", "//src/devices/i2c/drivers/intel-i2c", "//src/devices/pci/bin:bootfs", "//src/devices/rtc/drivers/intel-rtc", "//src/devices/serial/drivers/intel-serialio", "//src/devices/serial/drivers/uart16550", "//src/devices/usb/drivers/xhci-rewrite:xhci", "//src/graphics/display/drivers/intel-i915", "//src/graphics/display/drivers/simple:simple.amd-kaveri", "//src/graphics/display/drivers/simple:simple.bochs", "//src/graphics/display/drivers/simple:simple.intel", "//src/graphics/display/drivers/simple:simple.nv", "//src/graphics/display/drivers/simple:simple.vmware", "//src/media/audio/bin/ihda", "//src/media/audio/drivers/codecs/alc5514", "//src/media/audio/drivers/codecs/alc5663", "//src/media/audio/drivers/codecs/max98927", "//src/media/audio/drivers/intel-hda/codecs/hdmi:hdmi-audio-codec", "//src/media/audio/drivers/intel-hda/codecs/realtek:realtek-audio-codec", "//src/media/audio/drivers/intel-hda/controller:intel-hda", "//src/power/power-manager:base_config", "//src/ui/input/drivers/i2c-hid", "//src/ui/input/drivers/pc-ps2", "//zircon/third_party/dev/ethernet/e1000", "//src/security/policy/zxcrypt:null"]` |
| |
| From //boards/x64.gni:55 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/board.gni:22 |
| |
| ### board_zedboot_cmdline_args |
| List of kernel command line arguments to bake into the zedboot image that are |
| required by this board. See also zedboot_cmdline_args in |
| //build/images/zedboot/BUILD.gn |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/board.gni:19 |
| |
| ### bootfs_only |
| Put the "system image" package in the BOOTFS. Hence what would |
| otherwise be /system/... at runtime is /boot/... instead. |
| |
| **Current value for `target_cpu = "arm64"`:** `true` |
| |
| From //products/bringup.gni:5 |
| |
| **Overridden from the default:** `false` |
| |
| From //build/images/args.gni:14 |
| |
| **Current value for `target_cpu = "x64"`:** `true` |
| |
| From //products/bringup.gni:5 |
| |
| **Overridden from the default:** `false` |
| |
| From //build/images/args.gni:14 |
| |
| ### build_all_vp9_file_decoder_conformance_tests |
| |
| **Current value (from the default):** `false` |
| |
| From //src/media/codec/examples/BUILD.gn:10 |
| |
| ### build_id_format |
| Build ID algorithm to use for Fuchsia-target code. This does not apply |
| to host or guest code. The value is the argument to the linker's |
| `--build-id=...` switch. If left empty (the default), the linker's |
| default format is used. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/config/build_id.gni:10 |
| |
| ### build_info_board |
| Board configuration of the current build |
| |
| **Current value for `target_cpu = "arm64"`:** `"arm64"` |
| |
| From //out/not-default/args.gn:8 |
| |
| **Overridden from the default:** `"qemu-arm64"` |
| |
| From //build/info/info.gni:12 |
| |
| **Current value for `target_cpu = "x64"`:** `"x64"` |
| |
| From //out/not-default/args.gn:8 |
| |
| **Overridden from the default:** `"x64"` |
| |
| From //build/info/info.gni:12 |
| |
| ### build_info_product |
| Product configuration of the current build |
| |
| **Current value for `target_cpu = "arm64"`:** `"bringup"` |
| |
| From //out/not-default/args.gn:9 |
| |
| **Overridden from the default:** `""` |
| |
| From //build/info/info.gni:9 |
| |
| **Current value for `target_cpu = "x64"`:** `"bringup"` |
| |
| From //out/not-default/args.gn:9 |
| |
| **Overridden from the default:** `""` |
| |
| From //build/info/info.gni:9 |
| |
| ### build_info_version |
| Logical version of the current build. If not set, defaults to the timestamp |
| of the most recent update. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/info/info.gni:16 |
| |
| ### build_libvulkan_arm_mali |
| Targets that will be built as mali vulkan ICDS. |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:43 |
| |
| ### build_libvulkan_goldfish |
| |
| **Current value (from the default):** `""` |
| |
| From //src/graphics/lib/goldfish-vulkan/gnbuild/BUILD.gn:13 |
| |
| ### build_libvulkan_img_rgx |
| Targets that will be built as IMG vulkan ICDS. |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:52 |
| |
| ### build_libvulkan_qcom_adreno |
| Targets that will be built as qualcomm vulkan ICDS. |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:49 |
| |
| ### build_libvulkan_vsi_vip |
| Targets that will be built as verisilicon vulkan ICDS. |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:46 |
| |
| ### build_sdk_archives |
| Whether to build SDK tarballs. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/sdk/config.gni:7 |
| |
| ### build_should_trace_actions |
| If enabled, all filesystem activity by actions will be traced and checked |
| against their declared inputs and outputs and depfiles (if present). |
| An action that accesses undeclared inputs or outputs will fail the build. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/BUILDCONFIG.gn:2185 |
| |
| ### build_uefi_disk |
| Generate a UEFI disk image |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:21 |
| |
| ### cache_package_labels |
| If you add package labels to this variable, the packages will be included |
| in the 'cache' package set, which represents an additional set of software |
| that is made available on disk immediately after paving and in factory |
| flows. These packages are not updated with an OTA, but instead are updated |
| ephemerally. This cache of software can be evicted by the system if storage |
| pressure arises or other policies indicate. |
| |
| **Current value for `target_cpu = "arm64"`:** `[]` |
| |
| From //products/bringup.gni:44 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:35 |
| |
| **Current value for `target_cpu = "x64"`:** `[]` |
| |
| From //products/bringup.gni:44 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:35 |
| |
| ### camera_debug |
| |
| **Current value (from the default):** `false` |
| |
| From //src/camera/debug.gni:6 |
| |
| ### camera_gym_configuration_cycle_time_ms |
| |
| **Current value (from the default):** `10000` |
| |
| From //src/camera/bin/camera-gym/BUILD.gn:11 |
| |
| ### camera_gym_enable_root_presenter |
| |
| **Current value (from the default):** `false` |
| |
| From //src/camera/bin/camera-gym/BUILD.gn:12 |
| |
| ### check_production_eligibility |
| Whether to perform check on the build's eligibility for production. |
| If true, base_packages and cache_packages are checked against dependencies |
| on //build/validate:non_production_tag, which is used to tag any |
| non-production GN labels. Build will fail if such dependency is found. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:94 |
| |
| ### chromium_build_dir |
| This variable specifies a chromium build output directory, such as `~/chromium/src/out/fuchsia`, |
| that cast_runner, web_runner, and web_engine will be obtained from. If unset, the prebuilt |
| packages from CIPD will be used. |
| |
| **Current value (from the default):** `""` |
| |
| From //src/chromium/build_args.gni:9 |
| |
| ### clang_embed_bitcode |
| Embed LLVM bitcode as .llvmbc section in ELF files. This is intended |
| primarily for external tools that use bitcode for analysis. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/clang/clang.gni:16 |
| |
| ### clang_lib_dir |
| Path to Clang lib directory. |
| |
| **Current value (from the default):** `"../../prebuilt/third_party/clang/linux-x64/lib"` |
| |
| From //build/images/manifest.gni:12 |
| |
| ### clang_ml_inliner |
| Controls whether to use the ML inliner in Clang to reduce size. Note that |
| the option only takes effect when `optimize` is set to `"size"`. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/compiler.gni:41 |
| |
| ### clang_prefix |
| The default clang toolchain provided by the prebuilt. This variable is |
| additionally consumed by the Go toolchain. |
| |
| **Current value (from the default):** `"../../prebuilt/third_party/clang/linux-x64/bin"` |
| |
| From //build/config/clang/clang.gni:12 |
| |
| ### clang_tool_dir |
| Directory where the Clang toolchain binaries ("clang", "llvm-nm", etc.) are |
| found. If this is "", then the behavior depends on $clang_prefix. |
| This toolchain is expected to support both Fuchsia targets and the host. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/toolchain/zircon/clang.gni:11 |
| |
| ### cobalt_environment |
| Selects the Cobalt environment to send data to. Choices: |
| "LOCAL" - record log data locally to a file |
| "DEVEL" - the non-prod environment for use in testing |
| "PROD" - the production environment |
| |
| **Current value (from the default):** `"PROD"` |
| |
| From //src/cobalt/bin/app/BUILD.gn:15 |
| |
| ### compress_blobs |
| Whether to compress the blobfs image. |
| |
| **Current value (from the default):** `true` |
| |
| From //build/images/args.gni:97 |
| |
| ### concurrent_dart_jobs |
| Maximum number of Dart processes to run in parallel. |
| |
| Dart analyzer uses a lot of memory which may cause issues when building |
| with many parallel jobs e.g. when using goma. To avoid out-of-memory |
| errors we explicitly reduce the number of jobs. |
| |
| **Current value (from the default):** `32` |
| |
| From //build/dart/BUILD.gn:16 |
| |
| ### config_have_heap |
| Tells openweave to include files that require heap access. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:32](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#32) |
| |
| ### crash_diagnostics_dir |
| Clang crash reports directory path. Use empty path to disable altogether. |
| |
| **Current value (from the default):** `"//out/not-default/clang-crashreports"` |
| |
| From //build/config/clang/crash_diagnostics.gni:7 |
| |
| ### crashpad_dependencies |
| |
| **Current value (from the default):** `"fuchsia"` |
| |
| From [//third_party/crashpad/build/crashpad_buildconfig.gni:22](https://chromium.googlesource.com/crashpad/crashpad/+/37dd8f83def8e85cdf1b71528832980021078d86/build/crashpad_buildconfig.gni#22) |
| |
| ### crashpad_use_boringssl_for_http_transport_socket |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/crashpad/util/net/tls.gni:22](https://chromium.googlesource.com/crashpad/crashpad/+/37dd8f83def8e85cdf1b71528832980021078d86/util/net/tls.gni#22) |
| |
| ### current_cpu |
| |
| **Current value (from the default):** `""` |
| |
| ### current_os |
| |
| **Current value (from the default):** `""` |
| |
| ### custom_signing_script |
| If non-empty, the given script will be invoked to produce a signed ZBI |
| image. The given script must accept -z for the input zbi path, and -o for |
| the output signed zbi path. The path must be in GN-label syntax (i.e. |
| starts with //). |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/custom_signing.gni:12 |
| |
| ### custom_signing_script_deps |
| If `custom_signing_script` is not empty, a list of dependencies for the script. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/custom_signing.gni:15 |
| |
| ### custom_signing_script_tools |
| If `custom signing script` is not empty, a list of host tool labels, without |
| a toolchain, that the script depends on. The reason why these are not in |
| `custom_signing_script_deps` is because these definitions are typically in |
| board-specific .gni files where `host_os` or `host_toolchain` are not |
| defined yet. Because these are imported from `args.gn` before `BUILDCONFIG.gn` |
| is actually parsed. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/custom_signing.gni:23 |
| |
| ### dart_default_build_cfg |
| TODO(fxbug.dev/64153) renable aot builds |
| if (dart_force_product) { |
| Product AOT |
| dart_default_build_cfg = dart_release_build_cfg |
| } else if (is_debug) { |
| Non-product JIT |
| |
| **Current value (from the default):** |
| ``` |
| { |
| enable_asserts = true |
| is_aot = false |
| is_product = false |
| platform_name = "dart_runner" |
| runner_dep = "//src/dart:dart_jit_runner" |
| runtime_meta = "//build/dart/meta/jit_runtime" |
| } |
| ``` |
| |
| From //build/dart/config.gni:18 |
| |
| ### dart_force_product |
| Forces all Dart apps to build in product mode which is a |
| stripped down version of the VM running in AOT mode. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/dart/config.gni:10 |
| |
| ### data_partition_manifest |
| Path to manifest file containing data to place into the initial /data |
| partition. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:50 |
| |
| ### debian_guest_earlycon |
| |
| **Current value (from the default):** `false` |
| |
| From //src/virtualization/packages/debian_guest/BUILD.gn:10 |
| |
| ### debian_guest_qcow |
| Package the rootfs as a QCOW image (as opposed to a flat file). |
| |
| **Current value (from the default):** `true` |
| |
| From //src/virtualization/packages/debian_guest/BUILD.gn:9 |
| |
| ### debuginfo |
| * `none` means no debugging information |
| * `backtrace` means sufficient debugging information to symbolize backtraces |
| * `debug` means debugging information suited for debugging |
| |
| **Current value (from the default):** `"debug"` |
| |
| From //build/config/compiler.gni:53 |
| |
| ### dev_bootfs_labels |
| List of labels for objects to include in the ZBI. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/dev.gni:22 |
| |
| ### dev_build_only_deps |
| List of labels for targets that should be built but not included in any |
| build outputs that are part of the build API (e.g. zbi's, package servers). |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/dev.gni:14 |
| |
| ### dev_fuchsia_zbi_kernel_cmdline_golden |
| An optional golden file for fuchsia.zbi kernel cmdline args. If specified, |
| this golden file would be compared against fuchsia.zbi kernel cmdline during |
| build time. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/dev.gni:19 |
| |
| ### dev_recovery_bootfs_labels |
| List of binary labels to include in the recovery ZBI. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/dev.gni:28 |
| |
| ### dev_system_image_deps |
| List of labels for binaries to include in the system image. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/dev.gni:10 |
| |
| ### dev_testonly_in_containers |
| Whether to allow testonly=true targets in fuchsia ZBI or base/cache packages. |
| |
| Possible values are |
| "all": Allow testonly=true target in fuchsia ZBI and base/cache packages. |
| "all_but_base_cache_packages": Do not allow testonly=true target in |
| base/cache packages, but allow in other fuchsia ZBI dependencies. |
| "none": Do not allow testonly=true target in all ZBI dependencies |
| including base/cache packages. |
| |
| Default value is 'none', it is preferable to set to 'all' for production |
| image to avoid accidental inclusion of testing targets. |
| |
| **Current value (from the default):** `"all"` |
| |
| From //build/dev.gni:41 |
| |
| ### dev_zedboot_bootfs_labels |
| List of binary labels to include in the zedboot ZBI. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/dev.gni:25 |
| |
| ### devmgr_config |
| List of arguments to add to /boot/config/devmgr. |
| These come after synthesized arguments to configure blobfs and pkgfs. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/args.gni:18 |
| |
| ### disable_dart_strict_deps |
| Enable all strict deps. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/dart/dart_library.gni:18 |
| |
| ### disable_kernel_pci |
| Disable kernel PCI driver support. A counterpart of the the build |
| flag platform_enable_user_pci in //src/devices/bus/drivers/pci/pci.gni. |
| |
| **Current value (from the default):** `false` |
| |
| From //zircon/kernel/params.gni:58 |
| |
| ### enable_api_diff |
| Detect dart API changes |
| TODO(fxbug.dev/36723, fxbug.dev/6623) Remove this flag once issues are resolved |
| |
| **Current value (from the default):** `false` |
| |
| From //build/dart/dart_library.gni:22 |
| |
| ### enable_dart_analysis |
| Enable all dart analysis |
| |
| **Current value (from the default):** `true` |
| |
| From //build/dart/dart_library.gni:15 |
| |
| ### enable_frame_pointers |
| Controls whether the compiler emits full stack frames for function calls. |
| This reduces performance but increases the ability to generate good |
| stack traces, especially when we have bugs around unwind table generation. |
| It applies only for Fuchsia targets (see below where it is unset). |
| |
| TODO(fxbug.dev/32216): Theoretically unwind tables should be good enough so we can |
| remove this option when the issues are addressed. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/BUILD.gn:26 |
| |
| ### enable_gfx_subsystem |
| |
| **Current value (from the default):** `true` |
| |
| From //src/ui/scenic/bin/BUILD.gn:11 |
| |
| ### enable_input_subsystem |
| |
| **Current value (from the default):** `true` |
| |
| From //src/ui/scenic/bin/BUILD.gn:12 |
| |
| ### enable_lock_dep |
| Enable kernel lock dependency tracking. |
| |
| **Current value (from the default):** `false` |
| |
| From //zircon/kernel/params.gni:34 |
| |
| ### enable_lock_dep_tests |
| Enable kernel lock dependency tracking tests. By default this is |
| enabled when tracking is enabled, but can also be eanbled independently |
| to assess whether the tests build and *fail correctly* when lockdep is |
| disabled. |
| |
| **Current value (from the default):** `false` |
| |
| From //zircon/kernel/params.gni:85 |
| |
| ### enable_mdns_trace |
| Enables the tracing feature of mdns, which can be turned on using |
| "mdns-util verbose". |
| |
| **Current value (from the default):** `false` |
| |
| From //src/connectivity/network/mdns/service/BUILD.gn:14 |
| |
| ### enable_netboot |
| Whether to build the netboot zbi by default. |
| |
| You can still build //build/images:netboot explicitly even if enable_netboot is false. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:55 |
| |
| ### escher_test_for_glsl_spirv_mismatch |
| If true, this enables the |SpirvNotChangedTest| to check if the precompiled |
| shaders on disk are up to date and reflect the current shader source code |
| compiled with the latest shaderc tools/optimizations. People on the Scenic |
| team should build with this flag turned on to make sure that any shader |
| changes that were not run through the precompiler have their updated spirv |
| written to disk. Other teams and CQ do not need to worry about this flag. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/ui/lib/escher/build_args.gni:18 |
| |
| ### escher_use_runtime_glsl |
| Determines whether or not escher will build with the glslang and shaderc |
| libraries. When false, these libraries will not be included in the scenic/ |
| escher binary and as a result shaders will not be able to be compiled at |
| runtime. Precompiled spirv code will be loaded into memory from disk instead. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/ui/lib/escher/build_args.gni:10 |
| |
| ### exclude_testonly_syscalls |
| If true, excludes syscalls with the [testonly] attribute. |
| |
| **Current value (from the default):** `false` |
| |
| From //zircon/vdso/vdso.gni:7 |
| |
| ### expat_build_root |
| |
| **Current value (from the default):** `"//third_party/expat"` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:14 |
| |
| ### experimental_cxx_version |
| **NOTE:** This is for **experimentation only** and should not normally be |
| changed. Set the version of the C++ standard to compile for, 17 or 20. |
| |
| **Current value (from the default):** `17` |
| |
| From //zircon/public/gn/config/experimental_cxx_version.gni:8 |
| |
| ### experimental_wlan_client_mlme |
| Selects the SoftMAC client implementation to use. Choices: |
| false (default) - C++ Client MLME implementation |
| true - Rust Client MLME implementation |
| This argument is temporary until Rust MLME is ready to be used. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/connectivity/wlan/lib/mlme/cpp/BUILD.gn:12 |
| |
| ### extra_manifest_args |
| Extra args to globally apply to the manifest generation script. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/manifest.gni:18 |
| |
| ### extra_package_labels |
| |
| **Current value (from the default):** `[]` |
| |
| From //third_party/cobalt/BUILD.gn:10 |
| |
| ### extra_variants |
| Additional variant toolchain configs to support. |
| This is just added to [`known_variants`](#known_variants). |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/config/BUILDCONFIG.gn:1030 |
| |
| ### extract_minfs_metadata_on_corruption |
| If extract_minfs_metadata_on_corruption is true, fshost extracts minfs metadata on finding it |
| corrupted. Setting this flag to true helps debugging corruptions. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/storage/fshost/BUILD.gn:32 |
| |
| ### fastboot_product |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:77 |
| |
| ### fidl_trace_level |
| 0 = Disable FIDL userspace tracing (default). |
| 1 = Enable FIDL userspace tracing. |
| |
| **Current value (from the default):** `0` |
| |
| From //build/fidl/args.gni:8 |
| |
| ### firmware_prebuilts |
| List of prebuilt firmware blobs to include in update packages. |
| |
| Each entry in the list is a scope containing: |
| * `path`: path to the image (see also `firmware_prebuilts_path_suffix`) |
| * `type`: firmware type, a device-specific unique identifier |
| * `partition` (optional): if specified, the `fastboot flash` partition |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/args.gni:35 |
| |
| ### firmware_prebuilts_path_suffix |
| Suffix to append to all `firmware_prebuilts` `path` variables. |
| |
| Typically this indicates the hardware revision, and is made available so |
| that users can easily switch revisions using a single arg. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:41 |
| |
| ### flutter_default_build_cfg |
| Non-product AOT |
| |
| **Current value (from the default):** |
| ``` |
| { |
| enable_asserts = false |
| is_aot = true |
| is_product = false |
| platform_name = "flutter_runner" |
| runner_dep = "//src/flutter:flutter_aot_runner" |
| runtime_meta = "//build/flutter/meta/aot_runtime" |
| } |
| ``` |
| |
| From //build/flutter/config.gni:22 |
| |
| ### flutter_driver_enabled |
| Enables/Disables flutter driver using '--args=flutter_driver_enabled=[true/false]' |
| in fx set. (Disabled by default) |
| This is effective only on debug builds. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/testing/flutter_driver.gni:9 |
| |
| ### flutter_force_product |
| If set to true, will force the runenrs to be built in |
| product mode which means they will not have an exposed vm service |
| |
| **Current value (from the default):** `false` |
| |
| From //build/flutter/config.gni:10 |
| |
| ### font_catalog_paths |
| |
| **Current value (from the default):** `["//prebuilt/third_party/fonts/fuchsia.font_catalog.json"]` |
| |
| From //src/fonts/build/font_args.gni:17 |
| |
| ### font_pkg_entries |
| Merged contents of .font_pkgs.json files. Populated in fonts.gni. |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/fonts/build/font_args.gni:32 |
| |
| ### font_pkgs_paths |
| Locations of .font_pkgs.json files, which list the locations of font files |
| within the workspace, as well as safe names that are derived from the fonts' |
| file names and can be used to name Fuchsia packages. |
| |
| **Current value (from the default):** `["//prebuilt/third_party/fonts/fuchsia.font_pkgs.json"]` |
| |
| From //src/fonts/build/font_args.gni:22 |
| |
| ### fonts_dir |
| Directory into which all fonts are checked out from CIPD |
| |
| **Current value (from the default):** `"//prebuilt/third_party/fonts"` |
| |
| From //src/fonts/build/font_args.gni:12 |
| |
| ### format_minfs_on_corruption |
| If format_minfs_on_corruption is true (the default), fshost formats minfs partition on finding |
| it corrupted. Set to false to keep the devices in a corrupted state which might be of help to |
| debug issues. |
| |
| **Current value (from the default):** `true` |
| |
| From //src/storage/fshost/BUILD.gn:28 |
| |
| ### fuchsia_sdk_root |
| Consumers of the Fuchsia SDK instantiate templates for various SDK parts at |
| a specific spot within their buildroots. The target name for the specific |
| part is then derived from the part name as specified in the meta.json |
| manifest. Different buildroot instantiate the SDK parts at different |
| locations and then set this variable. GN rules can then prefix this variable |
| name in SDK builds to the name of the SDK part. This flag is meaningless in |
| non-SDK buildroots. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/fuchsia/sdk.gni:17 |
| |
| ### fvm_emmc_partition_size |
| The size in bytes of the FVM partition on the target eMMC devices. |
| Specifying this parameter will lead build to generate a fvm.fastboot.blk |
| suitable for flashing through fastboot for eMMC devices. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:17 |
| |
| ### fvm_ftl_nand_block_count |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:111 |
| |
| ### fvm_ftl_nand_oob_size |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:109 |
| |
| ### fvm_ftl_nand_page_size |
| Specifying these variables will generate a NAND FVM image suitable for |
| directly flashing via fastboot. The NAND characteristics are required |
| in order to properly initialize the FTL metadata in the OOB area. |
| `max_fvm_size` should also be nonzero or else minfs will not have any |
| room to initialize on boot. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:108 |
| |
| ### fvm_ftl_nand_pages_per_block |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:110 |
| |
| ### fvm_image_size |
| The size in bytes of the FVM partition image to create. Normally this is |
| computed to be just large enough to fit the blob and data images. The |
| default value is "", which means to size based on inputs. Specifying a size |
| that is too small will result in build failure. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:12 |
| |
| ### fvm_max_disk_size |
| The max size of the disk where the FVM is written. This is used for |
| preallocating metadata to determine how much the FVM can expand on disk. |
| Only applies to sparse FVM images. At sparse image construction time, the |
| build fails if the inputs are larger than `fvm_max_disk_size`. At paving |
| time, the FVM will be sized to the target's disk size up to |
| `fvm_max_disk_size`. If the size of the disk increases after initial paving, |
| the FVM will resize up to `fvm_max_disk_size`. During paving, if the target |
| FVM has declared a smaller size than `fvm_max_disk_size`, the FVM is |
| reinitialized to the larger size. |
| The default value is "" which sets the max disk size to the size of the disk |
| at pave/format time. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:30 |
| |
| ### fvm_partition |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:75 |
| |
| ### fvm_reserved_slices |
| Number of slices reserved by FVM for internal usage. A reservation |
| partition will be added to the FVM image, containing this many slices. |
| If set to the empty string, then no reservation partition will be added. |
| Set to 1 by default so that we exercise this feature on all product |
| configurations. |
| |
| **Current value (from the default):** `"1"` |
| |
| From //build/images/fvm.gni:44 |
| |
| ### fvm_slice_size |
| The size of the FVM partition images "slice size". The FVM slice size is a |
| minimum size of a particular chunk of a partition that is stored within |
| FVM. A very small slice size may lead to decreased throughput. A very large |
| slice size may lead to wasted space. The selected default size of 8mb is |
| selected for conservation of space, rather than performance. |
| |
| **Current value (from the default):** `"8388608"` |
| |
| From //build/images/fvm.gni:37 |
| |
| ### glm_build_root |
| |
| **Current value (from the default):** `"//third_party/glm"` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:17 |
| |
| ### go_vet_enabled |
| go_vet_enabled |
| [bool] if false, go vet invocations are disabled for all builds. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/go/go_build.gni:22 |
| |
| ### gocache_dir |
| gocache_dir |
| Directory GOCACHE environment variable will be set to. This directory |
| will have build and test results cached, and is safe to be written to |
| concurrently. If overridden, this directory must be a full path. |
| |
| **Current value (from the default):** `"/b/s/w/ir/x/w/out/not-default/dartlang/.gocache"` |
| |
| From //build/go/go_build.gni:18 |
| |
| ### goma_dir |
| Directory containing the Goma source code. This can be a GN |
| source-absolute path ("//...") or a system absolute path. |
| |
| **Current value (from the default):** `"//prebuilt/third_party/goma/linux-x64"` |
| |
| From //build/toolchain/goma.gni:15 |
| |
| ### gpt_image |
| GUID Partition Table (GPT) image. |
| |
| Typically useful for initially flashing a device from zero-state. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:46 |
| |
| ### graphics_compute_generate_debug_shaders |
| Set to true in your args.gn file to generate pre-processed and |
| auto-formatted shaders under the "debug" sub-directory of HotSort |
| and Spinel target generation output directories. |
| |
| These are never used, but can be reviewed manually to verify the |
| impact of configuration parameters, or when modifying a compute |
| shader. |
| |
| Example results: |
| |
| out/default/ |
| gen/src/graphics/lib/compute/ |
| hotsort/targets/hs_amd_gcn3_u64/ |
| comp/ |
| hs_transpose.comp -> unpreprocessed shader |
| debug/ |
| hs_transpose.glsl -> preprocessed shader |
| |
| |
| **Current value (from the default):** `true` |
| |
| From //src/graphics/lib/compute/gn/glsl_shader_rules.gni:28 |
| |
| ### graphics_compute_skip_spirv_opt |
| At times we may want to compare the performance of unoptimized |
| vs. optimized shaders. On desktop platforms, use of spirv-opt |
| doesn't appear to provide major performance improvements but it |
| significantly reduces the size of the SPIR-V modules. |
| |
| Disabling the spirv-opt pass may also be useful in identifying and |
| attributing code generation bugs. |
| |
| |
| **Current value (from the default):** `true` |
| |
| From //src/graphics/lib/compute/gn/glsl_shader_rules.gni:38 |
| |
| ### host_byteorder |
| |
| **Current value (from the default):** `"undefined"` |
| |
| From //build/config/host_byteorder.gni:7 |
| |
| ### host_cpu |
| |
| **Current value (from the default):** `"x64"` |
| |
| ### host_labels |
| If you add labels to this variable, these will be included in the 'host' |
| artifact set, which represents an additional set of host-only software that |
| is produced by the build. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//tools/devshell:fx", "//tools/bindc:host"]` |
| |
| From //products/bringup.gni:48 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:54 |
| |
| **Current value for `target_cpu = "x64"`:** `["//tools/devshell:fx", "//tools/bindc:host"]` |
| |
| From //products/bringup.gni:48 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:54 |
| |
| ### host_os |
| |
| **Current value (from the default):** `"linux"` |
| |
| ### host_tools_dir |
| This is the directory where host tools intended for manual use by |
| developers get installed. It's something a developer might put |
| into their shell's $PATH. Host tools that are just needed as part |
| of the build do not get copied here. This directory is only for |
| things that are generally useful for testing or debugging or |
| whatnot outside of the GN build itself. These are only installed |
| by an explicit install_host_tools() rule (see //build/host.gni). |
| |
| **Current value (from the default):** `"//out/not-default/host-tools"` |
| |
| From //build/host.gni:13 |
| |
| ### icu_disable_thin_archive |
| If true, compile icu into a standalone static library. Currently this is |
| only useful on Chrome OS. |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/icu/config.gni:12](https://fuchsia.googlesource.com/third_party/icu/+/ef02cc27c0faceffc9345e11a35769ae92b836fb/config.gni#12) |
| |
| ### icu_major_version_number |
| Contains the major version number of the ICU library, for dependencies that |
| need different configuration based on the library version. Currently this |
| is only useful in Fuchsia. |
| |
| **Current value (from the default):** `"68"` |
| |
| From [//third_party/icu/version.gni:9](https://fuchsia.googlesource.com/third_party/icu/+/ef02cc27c0faceffc9345e11a35769ae92b836fb/version.gni#9) |
| |
| ### icu_use_data_file |
| Tells icu to load an external data file rather than rely on the icudata |
| being linked directly into the binary. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/icu/config.gni:8](https://fuchsia.googlesource.com/third_party/icu/+/ef02cc27c0faceffc9345e11a35769ae92b836fb/config.gni#8) |
| |
| ### include_devmgr_config_in_vbmeta |
| If true, /config/devmgr config will be included into a vbmeta image |
| instead of bootfs. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/vbmeta.gni:18 |
| |
| ### include_fvm_blob_sparse |
| Include fvm.blob.sparse.blk image into the build if set to true |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:110 |
| |
| ### include_internal_fonts |
| Set to true to include internal fonts in the build. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/fonts/build/font_args.gni:7 |
| |
| ### include_tests_that_fail_on_nuc_asan |
| Whether to include tests that are known to fail on NUC with ASan. |
| Should be set to false in the infra builders that have board == "x64" and |
| "asan" in variants. |
| |
| **Current value (from the default):** `true` |
| |
| From //build/testing/environments.gni:11 |
| |
| ### include_zxdb_large_tests |
| Normally these tests are not built and run because they require large amounts of optional data |
| be downloaded. Set this to true to enable the build for the zxdb_large_tests. |
| See symbols/test_data/README.md for how to download the data required for this test. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/developer/debug/zxdb/BUILD.gn:13 |
| |
| ### inet_config_enable_async_dns_sockets |
| Tells inet to support additionally support async dns sockets. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:17](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#17) |
| |
| ### inet_want_endpoint_dns |
| Tells inet to include support for the corresponding protocol. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:10](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#10) |
| |
| ### inet_want_endpoint_raw |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:11](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#11) |
| |
| ### inet_want_endpoint_tcp |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:12](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#12) |
| |
| ### inet_want_endpoint_tun |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:14](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#14) |
| |
| ### inet_want_endpoint_udp |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:13](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#13) |
| |
| ### is_analysis |
| If set, the build will produce compilation analysis dumps, used for code |
| cross-referencing in code search. The extra work done during analysis |
| is only needed for cross-referencing builds, so we're keeping the flag |
| and the analysis overhead turned off by default. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/BUILDCONFIG.gn:32 |
| |
| ### is_debug |
| Debug build. |
| |
| **Current value for `target_cpu = "arm64"`:** `false` |
| |
| From //out/not-default/args.gn:10 |
| |
| **Overridden from the default:** `true` |
| |
| From //build/config/BUILDCONFIG.gn:35 |
| |
| **Current value for `target_cpu = "x64"`:** `false` |
| |
| From //out/not-default/args.gn:10 |
| |
| **Overridden from the default:** `true` |
| |
| From //build/config/BUILDCONFIG.gn:35 |
| |
| ### kernel_base |
| |
| **Current value (from the default):** `"0xffffffff00000000"` |
| |
| From //zircon/kernel/params.gni:28 |
| |
| ### kernel_debug_level |
| Enables various kernel debugging and diagnostic features. Valid |
| values are between 0-3. The higher the value, the more that are |
| enabled. A value of 0 disables all of them. |
| |
| TODO(fxbug.dev/41790): This value is derived from assert_level. Decouple |
| the two and set kernel_debug_level independently. |
| |
| **Current value (from the default):** `2` |
| |
| From //zircon/kernel/params.gni:70 |
| |
| ### kernel_debug_print_level |
| Controls the verbosity of kernel dprintf messages. The higher the value, |
| the more dprintf messages emitted. Valid values are 0-2 (inclusive): |
| 0 - CRITCAL / ALWAYS |
| 1 - INFO |
| 2 - SPEW |
| |
| **Current value (from the default):** `2` |
| |
| From //zircon/kernel/params.gni:77 |
| |
| ### kernel_extra_defines |
| Extra macro definitions for kernel code, e.g. "DISABLE_KASLR", |
| "ENABLE_KERNEL_LL_DEBUG". |
| |
| **Current value (from the default):** `[]` |
| |
| From //zircon/kernel/params.gni:62 |
| |
| ### kernel_version_git_checkout |
| By default the kernel version string is generated based on the full git |
| revision found by `git rev-parse HEAD` in this checkout directory. |
| |
| **Current value (from the default):** `"//zircon/.."` |
| |
| From //zircon/kernel/lib/version/BUILD.gn:20 |
| |
| ### kernel_version_git_dirty_check |
| If this is true, then the kernel version string generated based on |
| `kernel_version_git_checkout` also adds a "-dirty" suffix if any files in |
| the checkout are modified from what's committed in git. |
| |
| **Current value (from the default):** `true` |
| |
| From //zircon/kernel/lib/version/BUILD.gn:25 |
| |
| ### kernel_version_string |
| Version string embedded in the kernel for `zx_system_get_version_string`. |
| If set to the default "", a string is generated based on the |
| `kernel_version_git_checkout` and `kernel_version_git_dirty_check` |
| settings, which see. |
| |
| **Current value (from the default):** `""` |
| |
| From //zircon/kernel/lib/version/BUILD.gn:16 |
| |
| ### known_variants |
| List of variants that will form the basis for variant toolchains. |
| To make use of a variant, set [`select_variant`](#select_variant). |
| |
| Normally this is not set as a build argument, but it serves to |
| document the available set of variants. |
| See also [`universal_variants`](#universal_variants). |
| Only set this to remove all the default variants here. |
| To add more, set [`extra_variants`](#extra_variants) instead. |
| |
| Each element of the list is one variant, which is a scope defining: |
| |
| `configs` (optional) |
| [list of labels] Each label names a config that will be |
| automatically used by every target built in this variant. |
| For each config `${label}`, there must also be a target |
| `${label}_deps`, which each target built in this variant will |
| automatically depend on. The `variant()` template is the |
| recommended way to define a config and its `_deps` target at |
| the same time. |
| |
| `remove_common_configs` (optional) |
| `remove_shared_configs` (optional) |
| [list of labels] This list will be removed (with `-=`) from |
| the `default_common_binary_configs` list (or the |
| `default_shared_library_configs` list, respectively) after |
| all other defaults (and this variant's configs) have been |
| added. |
| |
| `deps` (optional) |
| [list of labels] Added to the deps of every target linked in |
| this variant (as well as the automatic `${label}_deps` for |
| each label in configs). |
| |
| `name` (required if configs is omitted) |
| [string] Name of the variant as used in |
| [`select_variant`](#select_variant) elements' `variant` fields. |
| It's a good idea to make it something concise and meaningful when |
| seen as e.g. part of a directory name under `$root_build_dir`. |
| If name is omitted, configs must be nonempty and the simple names |
| (not the full label, just the part after all `/`s and `:`s) of these |
| configs will be used in toolchain names (each prefixed by a "-"), |
| so the list of config names forming each variant must be unique |
| among the lists in `known_variants + extra_variants`. |
| |
| `tags` (optional) |
| [list of strings] A list of liberal strings describing properties |
| of the toolchain instances created from this variant scope. See |
| //build/toolchain/variant_tags.gni for the list of available |
| values and their meaning. |
| |
| `toolchain_args` (optional) |
| [scope] Each variable defined in this scope overrides a |
| build argument in the toolchain context of this variant. |
| |
| `host_only` (optional) |
| `target_only` (optional) |
| [scope] This scope can contain any of the fields above. |
| These values are used only for host or target, respectively. |
| Any fields included here should not also be in the outer scope. |
| |
| |
| **Current value (from the default):** |
| ``` |
| [{ |
| configs = ["//build/config/lto"] |
| tags = ["lto"] |
| }, { |
| configs = ["//build/config/lto:thinlto"] |
| tags = ["lto"] |
| }, { |
| configs = ["//build/config/profile"] |
| tags = ["instrumented", "profile", "breaks-gc-sections"] |
| }, { |
| configs = ["//build/config/sanitizers:ubsan"] |
| remove_common_configs = ["//build/config:no_rtti"] |
| tags = ["instrumented", "instrumentation-runtime", "kernel-excluded", "ubsan"] |
| }, { |
| configs = ["//build/config/sanitizers:ubsan", "//build/config/sanitizers:sancov"] |
| remove_common_configs = ["//build/config:no_rtti"] |
| tags = ["instrumented", "instrumentation-runtime", "kernel-excluded", "sancov", "ubsan"] |
| }, { |
| configs = ["//build/config/sanitizers:asan"] |
| host_only = { |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| } |
| tags = ["asan", "instrumentation-runtime", "instrumented", "lsan", "replaces-allocator", "kernel-excluded"] |
| toolchain_args = { } |
| }, { |
| configs = ["//build/config/sanitizers:asan", "//build/config/sanitizers:ubsan"] |
| host_only = { |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| } |
| remove_common_configs = ["//build/config:no_rtti"] |
| tags = ["asan", "instrumentation-runtime", "instrumented", "lsan", "replaces-allocator", "kernel-excluded", "ubsan"] |
| toolchain_args = { } |
| }, { |
| configs = ["//build/config/sanitizers:asan", "//build/config/sanitizers:sancov"] |
| host_only = { |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| } |
| tags = ["asan", "instrumentation-runtime", "instrumented", "lsan", "replaces-allocator", "kernel-excluded", "sancov"] |
| toolchain_args = { } |
| }, { |
| configs = ["//build/config/sanitizers:asan", "//build/config/zircon:no_safestack"] |
| host_only = { |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| } |
| name = "kasan" |
| tags = ["asan", "instrumentation-runtime", "instrumented", "lsan", "replaces-allocator", "kernel-only"] |
| toolchain_args = { } |
| }, { |
| configs = ["//build/config/sanitizers:asan", "//build/config/zircon:no_safestack", "//build/config/sanitizers:sancov"] |
| host_only = { |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| } |
| name = "kasan-sancov" |
| tags = ["asan", "instrumentation-runtime", "instrumented", "lsan", "replaces-allocator", "kernel-only", "sancov"] |
| toolchain_args = { } |
| }, { |
| configs = ["//build/config/sanitizers:asan", "//build/config/fuzzer", "//build/config/sanitizers:rust-asan", "//build/config:icf"] |
| host_only = { |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| } |
| name = "asan-fuzzer" |
| remove_common_configs = ["//build/config:icf"] |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| tags = ["asan", "instrumentation-runtime", "instrumented", "lsan", "replaces-allocator", "kernel-excluded", "fuzzer"] |
| toolchain_args = { |
| asan_default_options = "alloc_dealloc_mismatch=0:check_malloc_usable_size=0:detect_odr_violation=0:max_uar_stack_size_log=16:print_scariness=1:allocator_may_return_null=1:detect_leaks=0:detect_stack_use_after_return=1:malloc_context_size=128:print_summary=1:print_suppressions=0:strict_memcmp=0:symbolize=0" |
| } |
| }, { |
| configs = ["//build/config/fuzzer", "//build/config/sanitizers:ubsan", "//build/config:icf"] |
| name = "ubsan-fuzzer" |
| remove_common_configs = ["//build/config:icf", "//build/config:no_rtti"] |
| remove_shared_configs = ["//build/config:symbol_no_undefined"] |
| tags = ["fuzzer", "instrumented", "instrumentation-runtime", "ubsan"] |
| }, { |
| name = "gcc" |
| tags = ["gcc"] |
| }] |
| ``` |
| |
| From //build/config/BUILDCONFIG.gn:898 |
| |
| ### launch_basemgr_on_boot |
| Indicates whether to include basemgr.cmx in the boot sequence for the |
| product image. |
| |
| **Current value (from the default):** `true` |
| |
| From //src/modular/build/modular_config/modular_config.gni:12 |
| |
| ### linux_runner_extras_tests |
| If `true`, adds additional testonly content to extras.img, which will be |
| built and mounted inside the container at /mnt/chromeos. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/virtualization/packages/biscotti_guest/linux_runner/BUILD.gn:25 |
| |
| ### linux_runner_gateway |
| |
| **Current value (from the default):** `"10.0.0.1"` |
| |
| From //src/virtualization/packages/biscotti_guest/linux_runner/BUILD.gn:20 |
| |
| ### linux_runner_ip |
| Default values for the guest network configuration. |
| |
| These are currently hard-coded to match what is setup in the virtio-net |
| device. |
| |
| See //src/virtualization/bin/vmm/device/virtio_net.cc for more details. |
| |
| **Current value (from the default):** `"10.0.0.2"` |
| |
| From //src/virtualization/packages/biscotti_guest/linux_runner/BUILD.gn:19 |
| |
| ### linux_runner_netmask |
| |
| **Current value (from the default):** `"255.255.255.0"` |
| |
| From //src/virtualization/packages/biscotti_guest/linux_runner/BUILD.gn:21 |
| |
| ### linux_runner_user_extras |
| Point this to the location of external files to be included as extras |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/virtualization/packages/biscotti_guest/linux_runner/BUILD.gn:33 |
| |
| ### linux_runner_volatile_block |
| If `true`, all block devices that would normally load as READ_WRITE will |
| be loaded as VOLATILE_WRITE. This is useful when working on changes to |
| the linux kernel as crashes and panics can sometimes corrupt the images. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/virtualization/packages/biscotti_guest/linux_runner/BUILD.gn:30 |
| |
| ### local_bench |
| Used to enable local benchmarking/fine-tuning when running benchmarks |
| in `fx shell`. Pass `--args=local_bench='true'` to `fx set` in order to |
| enable it. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/developer/fuchsia-criterion/BUILD.gn:14 |
| |
| ### log_startup_sleep |
| |
| **Current value (from the default):** `"30000"` |
| |
| From //garnet/bin/log_listener/BUILD.gn:14 |
| |
| ### lsan_default_options |
| Default [LeakSanitizer](https://clang.llvm.org/docs/LeakSanitizer.html) |
| options (before the `LSAN_OPTIONS` environment variable is read at |
| runtime). This can be set as a build argument to affect most "lsan" |
| variants in $variants (which see), or overridden in $toolchain_args in |
| one of those variants. This can be a list of strings or a single string. |
| |
| Note that even if this is empty, programs in this build **cannot** define |
| their own `__lsan_default_options` C function. Instead, they can use a |
| sanitizer_extra_options() target in their `deps` and then any options |
| injected that way can override that option's setting in this list. |
| |
| **Current value (from the default):** `[]` |
| |
| From //zircon/public/gn/config/instrumentation/sanitizer_default_options.gni:28 |
| |
| ### magma_build_root |
| |
| **Current value (from the default):** `"//src/graphics/lib/magma"` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:13 |
| |
| ### magma_enable_developer_build |
| Enable this to have the msd include a suite of tests and invoke them |
| automatically when the driver starts. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:27 |
| |
| ### magma_enable_tracing |
| Enable this to include fuchsia tracing capability |
| |
| **Current value (from the default):** `true` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:23 |
| |
| ### magma_openvx_include |
| The path to OpenVX headers |
| |
| **Current value (from the default):** `""` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:35 |
| |
| ### magma_openvx_package |
| The path to an OpenVX implementation |
| |
| **Current value (from the default):** `""` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:38 |
| |
| ### magma_python_path |
| |
| **Current value (from the default):** `"/b/s/w/ir/x/w/third_party/mako"` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:20 |
| |
| ### max_blob_contents_size |
| Maximum allowable contents for the /blob in a release mode build. |
| Zero means no limit. |
| contents_size refers to contents stored within the filesystem (regardless |
| of how they are stored). |
| |
| **Current value (from the default):** `"0"` |
| |
| From //build/images/filesystem_limits.gni:10 |
| |
| ### max_blob_image_size |
| Maximum allowable image_size for /blob in a release mode build. |
| Zero means no limit. |
| image_size refers to the total image size, including both contents and |
| metadata. |
| |
| **Current value (from the default):** `"0"` |
| |
| From //build/images/filesystem_limits.gni:16 |
| |
| ### max_data_contents_size |
| Maximum allowable contents_size for /data in a release mode build. |
| Zero means no limit. |
| contents_size refers to contents stored within the filesystem (regardless |
| of how they are stored). |
| |
| **Current value (from the default):** `"0"` |
| |
| From //build/images/filesystem_limits.gni:22 |
| |
| ### max_data_image_size |
| Maximum allowable image_size for /data in a release mode build. |
| Zero means no limit. |
| image_size refers to the total image size, including both contents and |
| metadata. |
| |
| **Current value (from the default):** `"0"` |
| |
| From //build/images/filesystem_limits.gni:28 |
| |
| ### max_fuchsia_zbi_size |
| Maximum allowable size for fuchsia.zbi |
| |
| **Current value for `target_cpu = "arm64"`:** `"16777216"` |
| |
| From //boards/arm64.gni:36 |
| |
| **Overridden from the default:** `"0"` |
| |
| From //build/images/filesystem_limits.gni:31 |
| |
| **Current value for `target_cpu = "x64"`:** `"16777216"` |
| |
| From //boards/x64.gni:69 |
| |
| **Overridden from the default:** `"0"` |
| |
| From //build/images/filesystem_limits.gni:31 |
| |
| ### max_fvm_size |
| Maximum allowable size for the FVM in a release mode build |
| Zero means no limit |
| |
| **Current value (from the default):** `"0"` |
| |
| From //build/images/max_fvm_size.gni:8 |
| |
| ### max_log_disk_usage |
| Controls how many bytes of space on disk are used to persist device logs. |
| Should be a string value that only contains digits. |
| |
| **Current value (from the default):** `"0"` |
| |
| From //garnet/bin/log_listener/BUILD.gn:13 |
| |
| ### max_zedboot_zbi_size |
| Maximum allowable size for zedboot.zbi |
| |
| **Current value for `target_cpu = "arm64"`:** `"16777216"` |
| |
| From //boards/arm64.gni:37 |
| |
| **Overridden from the default:** `"0"` |
| |
| From //build/images/filesystem_limits.gni:34 |
| |
| **Current value for `target_cpu = "x64"`:** `"16777216"` |
| |
| From //boards/x64.gni:70 |
| |
| **Overridden from the default:** `"0"` |
| |
| From //build/images/filesystem_limits.gni:34 |
| |
| ### mbedtls_config_file |
| Configuration file for MbedTLS. |
| |
| **Current value (from the default):** `"mbedtls-config.h"` |
| |
| From [//third_party/openthread/third_party/mbedtls/BUILD.gn:30](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/third_party/mbedtls/BUILD.gn#30) |
| |
| ### mbedtls_deps |
| Extra dependencies for MbedTLS |
| |
| **Current value (from the default):** `["../../src/core:libopenthread_core_config"]` |
| |
| From [//third_party/openthread/third_party/mbedtls/BUILD.gn:33](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/third_party/mbedtls/BUILD.gn#33) |
| |
| ### meta_package_labels |
| A list of labels for meta packages to be included in the monolith. |
| |
| **Current value for `target_cpu = "arm64"`:** `[]` |
| |
| From //products/bringup.gni:40 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/images/args.gni:58 |
| |
| **Current value for `target_cpu = "x64"`:** `[]` |
| |
| From //products/bringup.gni:40 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/images/args.gni:58 |
| |
| ### minfs_board_maximum_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:86 |
| |
| ### minfs_board_minimum_data_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:73 |
| |
| ### minfs_board_minimum_inodes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:63 |
| |
| ### minfs_enable_dirty_cache |
| Set this to true when configuring gn args to enable minfs dirty cache. |
| This is a compile time argument instead of mount time argument because |
| we conditionally want to enable dirty cache only on specific |
| configurations. Once it is enabled, we want the board to run all instances |
| of minfs, including # data and all minfs created to run test, should enable |
| dirty cache. This ensures that we run what we test. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/storage/minfs/BUILD.gn:12 |
| |
| ### minfs_maximum_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:99 |
| |
| ### minfs_maximum_runtime_bytes |
| minfs_maximum_runtime_bytes is an upper bound on the partition size on the device. Partitions |
| can grow as needed if there are extra slices available in FVM. This limit prevents the minfs |
| partition from taking too much space away from other uses. |
| |
| Pass the empty string for no limit. |
| |
| **Current value (from the default):** `""` |
| |
| From //src/storage/fshost/BUILD.gn:23 |
| |
| ### minfs_minimum_data_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:96 |
| |
| ### minfs_minimum_inodes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:93 |
| |
| ### minfs_product_maximum_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:87 |
| |
| ### minfs_product_minimum_data_bytes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:74 |
| |
| ### minfs_product_minimum_inodes |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/fvm.gni:64 |
| |
| ### mini_chromium_is_chromeos_ash |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/crashpad/third_party/mini_chromium/mini_chromium/build/platform.gni:31](https://chromium.googlesource.com/crashpad/crashpad/+/37dd8f83def8e85cdf1b71528832980021078d86/third_party/mini_chromium/mini_chromium/build/platform.gni#31) |
| |
| ### mini_chromium_is_chromeos_lacros |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/crashpad/third_party/mini_chromium/mini_chromium/build/platform.gni:30](https://chromium.googlesource.com/crashpad/crashpad/+/37dd8f83def8e85cdf1b71528832980021078d86/third_party/mini_chromium/mini_chromium/build/platform.gni#30) |
| |
| ### msd_arm_enable_all_cores |
| Enable all 8 cores, which is faster but emits more heat. |
| |
| **Current value (from the default):** `true` |
| |
| From //src/graphics/drivers/msd-arm-mali/src/BUILD.gn:9 |
| |
| ### msd_arm_enable_cache_coherency |
| With this flag set the system tries to use cache coherent memory if the |
| GPU supports it. |
| |
| **Current value (from the default):** `true` |
| |
| From //src/graphics/drivers/msd-arm-mali/src/BUILD.gn:13 |
| |
| ### msd_arm_enable_protected_debug_swap_mode |
| In protected mode, faults don't return as much information so they're much harder to debug. To |
| work around that, add a mode where protected atoms are executed in non-protected mode and |
| vice-versa. |
| |
| NOTE: The memory security ranges should also be set (in TrustZone) to the opposite of normal, so |
| that non-protected mode accesses can only access protected memory and vice versa. Also, |
| growable memory faults won't work in this mode, so larger portions of growable memory should |
| precommitted (which is not done by default). |
| |
| **Current value (from the default):** `false` |
| |
| From //src/graphics/drivers/msd-arm-mali/src/BUILD.gn:23 |
| |
| ### msd_build_root |
| |
| **Current value (from the default):** `"//src/graphics/drivers"` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:15 |
| |
| ### msd_intel_gen_build_root |
| |
| **Current value (from the default):** `"//src/graphics/drivers/msd-intel-gen"` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:16 |
| |
| ### netcfg_autostart |
| |
| **Current value (from the default):** `true` |
| |
| From //src/connectivity/management/BUILD.gn:6 |
| |
| ### netsvc_extra_defines |
| |
| **Current value (from the default):** `[]` |
| |
| From //src/bringup/bin/netsvc/BUILD.gn:23 |
| |
| ### omaha_app_id |
| Default app id will always return no update. |
| |
| **Current value (from the default):** `"fuchsia-test:no-update"` |
| |
| From //src/sys/pkg/bin/omaha-client/BUILD.gn:13 |
| |
| ### openthread_config_assert_enable |
| Enable assertions. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:82](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#82) |
| |
| ### openthread_config_backbone_router_enable |
| Enable backbone router functionality |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:85](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#85) |
| |
| ### openthread_config_border_agent_enable |
| Enable border agent support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:88](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#88) |
| |
| ### openthread_config_border_router_enable |
| Enable border router support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:91](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#91) |
| |
| ### openthread_config_channel_manager_enable |
| Enable channel manager support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:94](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#94) |
| |
| ### openthread_config_channel_monitor_enable |
| Enable channel monitor support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:97](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#97) |
| |
| ### openthread_config_child_supervision_enable |
| Enable child supervision support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:100](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#100) |
| |
| ### openthread_config_coap_api_enable |
| Enable coap api support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:103](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#103) |
| |
| ### openthread_config_coap_observe_api_enable |
| Enable coap observe (RFC7641) api support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:109](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#109) |
| |
| ### openthread_config_coap_secure_api_enable |
| Enable secure coap api support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:106](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#106) |
| |
| ### openthread_config_commissioner_enable |
| Enable commissioner support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:112](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#112) |
| |
| ### openthread_config_deps |
| Extra deps for OpenThread configuration. |
| |
| **Current value (from the default):** `[]` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:38](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#38) |
| |
| ### openthread_config_dhcp6_client_enable |
| Enable DHCP6 client support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:118](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#118) |
| |
| ### openthread_config_dhcp6_server_enable |
| Enable DHCP6 server support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:121](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#121) |
| |
| ### openthread_config_diag_enable |
| Enable diagnostic support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:124](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#124) |
| |
| ### openthread_config_dns_client_enable |
| Enable DNS client support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:127](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#127) |
| |
| ### openthread_config_dua_enable |
| Enable Domain Unicast Address feature for Thread 1.2 |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:133](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#133) |
| |
| ### openthread_config_ecdsa_enable |
| Enable ECDSA support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:130](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#130) |
| |
| ### openthread_config_enable_builtin_mbedtls_management |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:218](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#218) |
| |
| ### openthread_config_file |
| OpenThread config header. |
| |
| **Current value (from the default):** `"<openthread-config-android.h>"` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:35](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#35) |
| |
| ### openthread_config_full_logs |
| Enable full logs |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:205](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#205) |
| |
| ### openthread_config_heap_external_enable |
| Enable external heap support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:139](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#139) |
| |
| ### openthread_config_ip6_fragmentation_enable |
| Enable ipv6 fragmentation support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:142](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#142) |
| |
| ### openthread_config_ip6_slaac_enable |
| Enable support for adding of auto-configured SLAAC addresses by OpenThread |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:193](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#193) |
| |
| ### openthread_config_jam_detection_enable |
| Enable jam detection support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:145](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#145) |
| |
| ### openthread_config_joiner_enable |
| Enable joiner support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:148](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#148) |
| |
| ### openthread_config_legacy_enable |
| Enable legacy network support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:151](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#151) |
| |
| ### openthread_config_link_metrics_enable |
| Enable link metrics |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:154](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#154) |
| |
| ### openthread_config_link_raw_enable |
| Enable link raw service |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:157](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#157) |
| |
| ### openthread_config_log_level_dynamic_enable |
| Enable dynamic log level control |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:160](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#160) |
| |
| ### openthread_config_log_output |
| Log output: none, debug_uart, app, platform |
| |
| **Current value (from the default):** `""` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:79](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#79) |
| |
| ### openthread_config_mac_csl_receiver_enable |
| Enable csl receiver |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:115](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#115) |
| |
| ### openthread_config_mac_filter_enable |
| Enable mac filter support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:163](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#163) |
| |
| ### openthread_config_message_use_heap |
| Enable use built-in heap for message buffers |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:166](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#166) |
| |
| ### openthread_config_mle_long_routes_enable |
| Enable MLE long routes extension (experimental, breaks Thread conformance] |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:169](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#169) |
| |
| ### openthread_config_mlr_enable |
| Enable Multicast Listener Registration feature for Thread 1.2 |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:136](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#136) |
| |
| ### openthread_config_multiple_instance_enable |
| Enable multiple instances |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:175](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#175) |
| |
| ### openthread_config_ncp_spi_enable |
| Enable NCP SPI support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:211](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#211) |
| |
| ### openthread_config_ncp_uart_enable |
| Enable NCP UART support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:214](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#214) |
| |
| ### openthread_config_otns_enable |
| Enable OTNS support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:208](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#208) |
| |
| ### openthread_config_platform_netif_enable |
| Enable platform netif support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:178](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#178) |
| |
| ### openthread_config_platform_udp_enable |
| Enable platform UDP support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:181](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#181) |
| |
| ### openthread_config_reference_device_enable |
| Enable Thread Test Harness reference device support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:184](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#184) |
| |
| ### openthread_config_sntp_client_enable |
| Enable SNTP Client support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:196](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#196) |
| |
| ### openthread_config_thread_version |
| Thread version: 1.1, 1.2 |
| |
| **Current value (from the default):** `""` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:76](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#76) |
| |
| ### openthread_config_time_sync_enable |
| Enable the time synchronization service feature |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:199](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#199) |
| |
| ### openthread_config_tmf_netdata_service_enable |
| Enable support for injecting Service entries into the Thread Network Data |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:187](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#187) |
| |
| ### openthread_config_tmf_network_diag_mtd_enable |
| Enable TMF network diagnostics on MTDs |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:172](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#172) |
| |
| ### openthread_config_udp_forward_enable |
| Enable UDP forward support |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:202](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#202) |
| |
| ### openthread_core_config_deps |
| Extra deps for OpenThread core configuration. |
| |
| **Current value (from the default):** `[]` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:50](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#50) |
| |
| ### openthread_core_config_platform_check_file |
| OpenThread platform-specific config check header |
| |
| **Current value (from the default):** `""` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:47](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#47) |
| |
| ### openthread_enable_core_config_args |
| Configure OpenThread via GN arguments. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:70](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#70) |
| |
| ### openthread_external_mbedtls |
| Use external mbedtls. If blank, internal mbedtls will be used. |
| |
| **Current value (from the default):** `""` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:56](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#56) |
| |
| ### openthread_external_platform |
| Use external platform. |
| |
| **Current value (from the default):** `""` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:53](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#53) |
| |
| ### openthread_package_name |
| Package name for OpenThread. |
| |
| **Current value (from the default):** `"OPENTHREAD"` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:62](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#62) |
| |
| ### openthread_package_version |
| Package version for OpenThread. |
| |
| **Current value (from the default):** `"1.0.0"` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:65](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#65) |
| |
| ### openthread_posix |
| Enable building for POSIX platforms. |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:59](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#59) |
| |
| ### openthread_project_core_config_file |
| OpenThread project-specific core config header |
| |
| **Current value (from the default):** `""` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:44](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#44) |
| |
| ### openthread_project_include_dirs |
| Include directories for project specific configs. |
| |
| **Current value (from the default):** `[]` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:41](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#41) |
| |
| ### openthread_settings_ram |
| Enable volatile-only storage of settings |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openthread/etc/gn/openthread.gni:190](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/etc/gn/openthread.gni#190) |
| |
| ### optimize |
| * `none`: really unoptimized, usually only build-tested and not run |
| * `debug`: "optimized for debugging", light enough to avoid confusion |
| * `default`: default optimization level |
| * `size`: optimized for space rather than purely for speed |
| * `speed`: optimized purely for speed |
| * `sanitizer`: optimized for sanitizers (ASan, etc.) |
| * `profile`: optimized for coverage/profile data collection |
| |
| **Current value (from the default):** `"speed"` |
| |
| From //build/config/compiler.gni:22 |
| |
| ### output_breakpad_syms |
| Sets if we should output breakpad symbols for Fuchsia binaries. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/BUILDCONFIG.gn:38 |
| |
| ### output_gsym |
| Controls whether we should output GSYM files for Fuchsia binaries. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/BUILDCONFIG.gn:41 |
| |
| ### override_recovery_label |
| TODO(comfoltey) remove obsolete label override_recovery_label |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:122 |
| |
| ### persist_logs |
| |
| **Current value (from the default):** `false` |
| |
| From //build/persist_logs.gni:13 |
| |
| ### pkgfs_packages_allowlist |
| |
| **Current value (from the default):** `"//src/security/policy/pkgfs_non_static_pkgs_allowlist_eng.txt"` |
| |
| From //build/images/args.gni:107 |
| |
| ### platform_enable_user_pci |
| |
| **Current value (from the default):** `false` |
| |
| From //src/devices/bus/drivers/pci/pci.gni:10 |
| |
| ### pre_erase_flash |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:78 |
| |
| ### prebuilt_dart_sdk |
| Directory containing prebuilt Dart SDK. |
| This must have in its `bin/` subdirectory `gen_snapshot.OS-CPU` binaries. |
| |
| **Current value (from the default):** `"//prebuilt/third_party/dart/linux-x64"` |
| |
| From //build/dart/dart.gni:8 |
| |
| ### prebuilt_libvulkan_arm_path |
| |
| **Current value (from the default):** `""` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:29 |
| |
| ### prebuilt_libvulkan_img_path |
| The path to a prebuilt libvulkan.so for an IMG GPU. |
| |
| **Current value (from the default):** `""` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:32 |
| |
| ### product_bootfs_labels |
| A list of binary labels to include in ZBIs built for this product. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//build/info:bootfs", "//bundles:bootstrap", "//bundles:debugging", "//bundles:diagnostics-eng", "//bundles/bringup:manual_testing", "//bundles/drivers:bootstrap", "//bundles/drivers:bootstrap-eng", "//bundles/drivers:usb-host-stack", "//bundles/drivers:usb-peripheral-stack", "//bundles/drivers:utils", "//products/kernel_cmdline:blobfs.cache-eviction-policy--NEVER_EVICT", "//products/kernel_cmdline:console.shell--true", "//products/kernel_cmdline:devmgr.log-to-debuglog--true", "//products/kernel_cmdline:kernel.enable-debugging-syscalls--true", "//products/kernel_cmdline:kernel.enable-serial-syscalls--true", "//products/kernel_cmdline:kernel.oom.behavior--jobkill", "//products/kernel_cmdline:netsvc.all-features--true", "//products/kernel_cmdline:netsvc.disable--false", "//src/testing/runtests", "//src/sys/component_manager:component_manager_bootfs_config"]` |
| |
| From //products/bringup.gni:37 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/product.gni:7 |
| |
| **Current value for `target_cpu = "x64"`:** `["//build/info:bootfs", "//bundles:bootstrap", "//bundles:debugging", "//bundles:diagnostics-eng", "//bundles/bringup:manual_testing", "//bundles/drivers:bootstrap", "//bundles/drivers:bootstrap-eng", "//bundles/drivers:usb-host-stack", "//bundles/drivers:usb-peripheral-stack", "//bundles/drivers:utils", "//products/kernel_cmdline:blobfs.cache-eviction-policy--NEVER_EVICT", "//products/kernel_cmdline:console.shell--true", "//products/kernel_cmdline:devmgr.log-to-debuglog--true", "//products/kernel_cmdline:kernel.enable-debugging-syscalls--true", "//products/kernel_cmdline:kernel.enable-serial-syscalls--true", "//products/kernel_cmdline:kernel.oom.behavior--jobkill", "//products/kernel_cmdline:netsvc.all-features--true", "//products/kernel_cmdline:netsvc.disable--false", "//src/testing/runtests", "//src/sys/component_manager:component_manager_bootfs_config"]` |
| |
| From //products/bringup.gni:37 |
| |
| **Overridden from the default:** `[]` |
| |
| From //build/product.gni:7 |
| |
| ### product_include_updates_in_blobfs |
| Include update package in blob.blk. Some products may not need the update |
| package included as part of the blobfs. |
| TODO(fxbug.dev/58645) Remove when no longer needed. |
| |
| **Current value (from the default):** `true` |
| |
| From //build/product.gni:15 |
| |
| ### product_system_image_deps |
| A list of binary labels to include in the system_image package. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/product.gni:10 |
| |
| ### prototype_account_transfer |
| Whether or not prototype account transfer is enabled. |
| NOTE: This is not secure and should NOT be enabled for any products! This |
| is only for use during local development. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/identity/bin/account_manager/BUILD.gn:12 |
| |
| ### recovery_label |
| Allows a product to specify the recovery image used in the zirconr slot. |
| Default recovery image is zedboot. Overriding this value will keep zedboot |
| in the build but will not include it as the default zirconr image. |
| Recovery images can provide an update target by specifying the metadata item |
| "update_target" in the format <target>=<path>. (Such as `update_target = |
| [ "recovery=" + rebase_path(recovery_path, root_build_dir) ]`) |
| Example value: "//build/images/recovery" |
| |
| **Current value (from the default):** `"//build/images/zedboot"` |
| |
| From //build/images/args.gni:119 |
| |
| ### recovery_logo_path |
| Path to file to use for recovery logo |
| |
| **Current value (from the default):** `"//src/recovery/system/res/fuchsia-logo.png"` |
| |
| From //src/recovery/system/system_recovery_args.gni:7 |
| |
| ### run_slow_bssl_tests |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/boringssl/BUILD.gn:15](https://fuchsia.googlesource.com/third_party/boringssl/+/bca4036276214a2ba502a765cbfbd3a3b006535d/BUILD.gn#15) |
| |
| ### rust_cap_lints |
| Sets the maximum lint level. |
| "deny" will make all warnings into errors, "warn" preserves them as warnings, and "allow" will |
| ignore warnings. |
| |
| **Current value (from the default):** `"deny"` |
| |
| From //build/rust/config.gni:54 |
| |
| ### rust_lto |
| Sets the default LTO type for rustc bulids. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/rust/config.gni:46 |
| |
| ### rust_override_lto |
| Overrides the LTO setting for all Rust builds, regardless of |
| debug/release flags or the `with_lto` arg to the rustc_ templates. |
| Valid values are "none", "thin", and "fat". |
| |
| **Current value (from the default):** `""` |
| |
| From //build/rust/config.gni:64 |
| |
| ### rust_override_opt |
| Overrides the optimization level for all Rust builds, regardless of |
| debug/release flags or the `force_opt` arg to the rustc_ templates. |
| Valid values are 0-3, o, and z. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/rust/config.gni:59 |
| |
| ### rust_sysroot |
| Sets a custom base directory for where rust tooling |
| looks for the standard library |
| |
| **Current value (from the default):** `"../../prebuilt/third_party/rust/linux-x64"` |
| |
| From //build/rust/config.gni:43 |
| |
| ### rust_toolchain_triple_suffix |
| Sets the fuchsia toolchain target triple suffix (after arch) |
| |
| **Current value (from the default):** `"fuchsia"` |
| |
| From //build/rust/config.gni:49 |
| |
| ### rust_v0_symbol_mangling |
| Controls whether the rust compiler uses v0 symbol mangling scheme |
| (see https://github.com/rust-lang/rfcs/blob/HEAD/text/2603-rust-symbol-name-mangling-v0.md). |
| The v0 symbol mangling scheme requires upstream LLVM support when demangling, |
| so it is not on by default. |
| TODO(fxbug.dev/57302): Enable v0 mangling by default. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/BUILD.gn:34 |
| |
| ### rustc_lib_dir |
| Path to rustc lib directory. |
| |
| **Current value (from the default):** `"../../prebuilt/third_party/rust/linux-x64/lib"` |
| |
| From //build/images/manifest.gni:15 |
| |
| ### rustc_prefix |
| Sets a custom base directory for `rustc` and `cargo`. |
| This can be used to test custom Rust toolchains. |
| |
| **Current value (from the default):** `"../../prebuilt/third_party/rust/linux-x64/bin"` |
| |
| From //build/rust/config.gni:25 |
| |
| ### rustc_version_description |
| Human-readable identifier for the toolchain version. |
| |
| TODO(tmandry): Make this the same repo/revision info from `rustc --version`. |
| e.g., clang_version_description = read_file("$_rustc_lib_dir/VERSION") |
| |
| **Current value (from the default):** `""` |
| |
| From //build/rust/config.gni:39 |
| |
| ### rustc_version_string |
| This is a string identifying the particular toolchain version in use. Its |
| only purpose is to be unique enough that it changes when switching to a new |
| toolchain, so that recompilations with the new compiler can be triggered. |
| |
| When using the prebuilt, this is ignored and the CIPD instance ID of the |
| prebuilt is used. |
| |
| **Current value (from the default):** `"gH0XPhgIPun0tFV5pRc_8iKk8PBwmxqyKIq5oq6ktUUC"` |
| |
| From //build/rust/config.gni:33 |
| |
| ### scenic_display_frame_number |
| Draws the current frame number in the top-left corner. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/ui/scenic/lib/gfx/BUILD.gn:11 |
| |
| ### scenic_enable_vulkan_validation |
| Include the vulkan validation layers in scenic. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/ui/scenic/BUILD.gn:157 |
| |
| ### scenic_ignore_vsync |
| |
| **Current value (from the default):** `false` |
| |
| From //src/ui/scenic/lib/gfx/BUILD.gn:8 |
| |
| ### scheduler_queue_tracing_enabled |
| Enables scheduler queue tracing for trace-based scheduler performance |
| analysis. |
| |
| **Current value (from the default):** `false` |
| |
| From //zircon/kernel/params.gni:47 |
| |
| ### scheduler_tracing_level |
| The level of detail for scheduler traces when enabled. Values greater than |
| zero add increasing details at the cost of increased trace buffer use. |
| |
| 0 = Default kernel:sched tracing. |
| 1 = Adds duration traces for key scheduler operations. |
| 2 = Adds flow events from wakeup to running state. |
| 3 = Adds detailed internal durations and probes. |
| |
| **Current value (from the default):** `0` |
| |
| From //zircon/kernel/params.gni:43 |
| |
| ### scudo_default_options |
| Default [Scudo](https://llvm.org/docs/ScudoHardenedAllocator.html) options |
| (before the `SCUDO_OPTIONS` environment variable is read at runtime). |
| Scudo is the memory allocator in Fuchsia's C library, so this affects all |
| Fuchsia programs. This can be a list of strings or a single string. |
| |
| This operates similarly to [`asan_default_options`](#asan_default_options) |
| and its cousins for other sanitizers, but is slightly different. If this |
| variable is empty, then no `__scudo_default_options` function is injected |
| into programs at all. Individual targets can use dependencies on |
| sanitizer_extra_options() targets to cause options to be injected, and that |
| will be compatible with any build-wide settings of `scudo_default_options`. |
| Programs **can** define their own `__scudo_default_options` functions, but |
| doing so will break all builds with this variable is set to nonempty, so |
| any program in the build that needs such a setting (which should be only in |
| tests) can use the sanitizer_extra_options() mechanism instead. |
| |
| **Current value (from the default):** `[]` |
| |
| From //zircon/public/gn/config/instrumentation/sanitizer_default_options.gni:60 |
| |
| ### sdk_dirs |
| The directories to search for parts of the SDK. |
| |
| By default, we search the public directories for the various layers. |
| In the future, we'll search a pre-built SDK as well. |
| |
| **Current value (from the default):** `["//garnet/public", "//topaz/public"]` |
| |
| From //build/config/fuchsia/sdk.gni:10 |
| |
| ### sdk_id |
| Identifier for the Core SDK. |
| |
| **Current value (from the default):** `""` |
| |
| From //sdk/config.gni:7 |
| |
| ### select_variant |
| List of "selectors" to request variant builds of certain targets. |
| Each selector specifies matching criteria and a chosen variant. |
| The first selector in the list to match a given target determines |
| which variant is used for that target. |
| |
| Each selector is either a string or a scope. A shortcut selector is |
| a string; it gets expanded to a full selector. A full selector is a |
| scope, described below. |
| |
| A string selector can match a name in |
| [`select_variant_shortcuts`](#select_variant_shortcuts). If it's not a |
| specific shortcut listed there, then it can be the name of any variant |
| described in [`known_variants`](#known_variants) and |
| [`universal_variants`](#universal_variants) (and combinations thereof). |
| A `selector` that's a simple variant name selects for every binary |
| built in the target toolchain: `{ host=false variant=selector }`. |
| |
| If a string selector contains a slash, then it's `"shortcut/filename"` |
| and selects only the binary in the target toolchain whose `output_name` |
| matches `"filename"`, i.e. it adds `output_name=["filename"]` to each |
| selector scope that the shortcut's name alone would yield. |
| |
| The scope that forms a full selector defines some of these: |
| |
| variant (required) |
| [string or `false`] The variant that applies if this selector |
| matches. This can be `false` to choose no variant, or a string |
| that names the variant. See |
| [`known_variants`](#known_variants) and |
| [`universal_variants`](#universal_variants). |
| |
| The rest below are matching criteria. All are optional. |
| The selector matches if and only if all of its criteria match. |
| If none of these is defined, then the selector always matches. |
| |
| The first selector in the list to match wins and then the rest of |
| the list is ignored. To construct more complex rules, use a blocklist |
| selector with `variant=false` before a catch-all default variant, or |
| a list of specific variants before a catch-all false variant. |
| |
| Each "[strings]" criterion is a list of strings, and the criterion |
| is satisfied if any of the strings matches against the candidate string. |
| |
| host |
| [boolean] If true, the selector matches in the host toolchain. |
| If false, the selector matches in the target toolchain. |
| |
| testonly |
| [boolean] If true, the selector matches targets with testonly=true. |
| If false, the selector matches in targets without testonly=true. |
| |
| target_type |
| [strings]: `"executable"`, `"loadable_module"`, or `"driver_module"` |
| |
| output_name |
| [strings]: target's `output_name` (default: its `target name`) |
| |
| label |
| [strings]: target's full label with `:` (without toolchain suffix) |
| |
| name |
| [strings]: target's simple name (label after last `/` or `:`) |
| |
| dir |
| [strings]: target's label directory (`//dir` for `//dir:name`). |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/config/BUILDCONFIG.gn:1241 |
| |
| ### select_variant_canonical |
| *This should never be set as a build argument.* |
| It exists only to be set in `toolchain_args`. |
| See //build/toolchain/clang_toolchain.gni for details. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/config/BUILDCONFIG.gn:1246 |
| |
| ### select_variant_shortcuts |
| List of short names for commonly-used variant selectors. Normally this |
| is not set as a build argument, but it serves to document the available |
| set of short-cut names for variant selectors. Each element of this list |
| is a scope where `.name` is the short name and `.select_variant` is a |
| a list that can be spliced into [`select_variant`](#select_variant). |
| |
| **Current value (from the default):** |
| ``` |
| [{ |
| name = "host_asan" |
| select_variant = [{ |
| host = true |
| variant = "asan" |
| }] |
| }, { |
| name = "host_asan-ubsan" |
| select_variant = [{ |
| host = true |
| variant = "asan-ubsan" |
| }] |
| }, { |
| name = "host_profile" |
| select_variant = [{ |
| host = true |
| variant = "profile" |
| }] |
| }] |
| ``` |
| |
| From //build/config/BUILDCONFIG.gn:1076 |
| |
| ### shaderc_enable_spvc_parser |
| Enables using the parsing built into spvc instead spirv-cross |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/shaderc/shaderc_features.gni:17](https://fuchsia.googlesource.com/third_party/shaderc/+/4162bb13b426dab68ebe411ea7ef05f6343bea95/shaderc_features.gni#17) |
| |
| ### shaderc_spvc_disable_context_logging |
| Disables logging to messages in context struct |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/shaderc/shaderc_features.gni:23](https://fuchsia.googlesource.com/third_party/shaderc/+/4162bb13b426dab68ebe411ea7ef05f6343bea95/shaderc_features.gni#23) |
| |
| ### shaderc_spvc_enable_direct_logging |
| Enables logging directly out to the terminal |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/shaderc/shaderc_features.gni:20](https://fuchsia.googlesource.com/third_party/shaderc/+/4162bb13b426dab68ebe411ea7ef05f6343bea95/shaderc_features.gni#20) |
| |
| ### size_checker_input |
| The input to the size checker. |
| The build system will produce a JSON file to be consumed by the size checker, which |
| will check and prevent integration of subsystems that are over their space allocation. |
| The input consists of the following keys: |
| |
| asset_ext(string array): a list of extensions that should be considered as assets. |
| |
| asset_limit(number): maximum size (in bytes) allocated for the assets. |
| |
| core_limit(number): maximum size (in bytes) allocated for the core system and/or services. |
| This is sort of a "catch all" component that consists of all the area / packages that weren't |
| specified in the components list below. |
| |
| components(object array): a list of component objects. Each object should contain the following keys: |
| |
| component(string): name of the component. |
| |
| src(string array): path of the area / package to be included as part of the component. |
| The path should be relative to the obj/ in the output directory. |
| For example, consider two packages foo and far, built to out/.../obj/some_big_component/foo and out/.../obj/some_big_component/bar. |
| If you want to impose a limit on foo, your src will be ["some_big_component/foo"]. |
| If you want to impose a limit on both foo and far, your src will be ["some_big_component"]. |
| If a package has config-data, those prebuilt blobs actually live under the config-data package. |
| If you wish to impose a limit of those data as well, you should add "build/images/config-data/$for_pkg" to your src. |
| The $for_pkg corresponds to the $for_pkg field in config.gni. |
| |
| limit(number): maximum size (in bytes) allocated for the component. |
| |
| Example: |
| size_checker_input = { |
| asset_ext = [ ".ttf" ] |
| asset_limit = 10240 |
| core_limit = 10240 |
| components = [ |
| { |
| component = "Foo" |
| src = [ "topaz/runtime/foo_runner" ] |
| limit = 10240 |
| }, |
| { |
| component = "Bar" |
| src = [ "build/images" ] |
| limit = 20480 |
| }, |
| ] |
| } |
| |
| **Current value (from the default):** `{ }` |
| |
| From //tools/size_checker/cmd/BUILD.gn:52 |
| |
| ### smp_max_cpus |
| |
| **Current value (from the default):** `16` |
| |
| From //zircon/kernel/params.gni:20 |
| |
| ### spinel_platform_header |
| Platform portability header for spinel. |
| |
| **Current value (from the default):** `"\"spinel_platform.h\""` |
| |
| From [//third_party/openthread/src/lib/spinel/BUILD.gn:32](https://fuchsia.googlesource.com/third_party/openthread/+/7e19f43cca493cd6a7f89768f9ee2d132b94177b/src/lib/spinel/BUILD.gn#32) |
| |
| ### sysmgr_golden_warn_override |
| Used by config_package(). |
| If true, then overrides the value of the sysmgr_golden_warn template |
| parameter to true regardless of whether it is specified on a target. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config.gni:13 |
| |
| ### syzkaller_dir |
| Used by syz-ci to build with own syz-executor source. |
| |
| **Current value (from the default):** `"//third_party/syzkaller"` |
| |
| From //src/testing/fuzzing/syzkaller/BUILD.gn:11 |
| |
| ### target_cpu |
| |
| **Current value for `target_cpu = "arm64"`:** `"arm64"` |
| |
| From //out/not-default/args.gn:11 |
| |
| **Overridden from the default:** `""` |
| |
| **Current value for `target_cpu = "x64"`:** `"x64"` |
| |
| From //out/not-default/args.gn:11 |
| |
| **Overridden from the default:** `""` |
| |
| ### target_os |
| |
| **Current value (from the default):** `""` |
| |
| ### target_sysroot |
| The absolute path of the sysroot that is used with the target toolchain. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/config/sysroot.gni:7 |
| |
| ### termina_disk |
| The termina disk image. |
| |
| Defaults to the disk image from CIPD, but can be overridden to use a |
| custom disk for development purposes. |
| |
| **Current value (from the default):** `"//prebuilt/virtualization/packages/termina_guest/images/arm64/vm_rootfs.img"` |
| |
| From //src/virtualization/packages/termina_guest/BUILD.gn:18 |
| |
| ### termina_kernel |
| The termina kernel image. |
| |
| Defaults to the common linux kernel image from CIPD, but can be overridden to use a |
| custom kernel for development purposes. |
| |
| **Current value (from the default):** `"//prebuilt/virtualization/packages/linux_guest/images/arm64/Image"` |
| |
| From //src/virtualization/packages/termina_guest/BUILD.gn:12 |
| |
| ### test_durations_file |
| A file in containing historical test duration data for this build |
| configuration, used used by testsharder to evenly split tests across |
| shards. It should be set for any builds where testsharder will be run |
| afterwards. |
| |
| **Current value (from the default):** `""` |
| |
| From //BUILD.gn:41 |
| |
| ### thinlto_cache_dir |
| ThinLTO cache directory path. |
| |
| **Current value (from the default):** `"dartlang/thinlto-cache"` |
| |
| From //build/config/lto/config.gni:16 |
| |
| ### thinlto_jobs |
| Number of parallel ThinLTO jobs. |
| |
| **Current value (from the default):** `8` |
| |
| From //build/config/lto/config.gni:13 |
| |
| ### time_trace |
| Whether to export time traces when building with clang. |
| https://releases.llvm.org/9.0.0/tools/clang/docs/ReleaseNotes.html#new-compiler-flags |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/clang/time_trace.gni:8 |
| |
| ### toolchain_variant |
| *This should never be set as a build argument.* |
| It exists only to be set in `toolchain_args`. |
| See //build/toolchain/clang_toolchain.gni for details. |
| This variable is a scope giving details about the current toolchain: |
| `toolchain_variant.base` |
| [label] The "base" toolchain for this variant, *often the |
| right thing to use in comparisons, not `current_toolchain`.* |
| This is the toolchain actually referenced directly in GN |
| source code. If the current toolchain is not |
| `shlib_toolchain` or a variant toolchain, this is the same |
| as `current_toolchain`. In one of those derivative |
| toolchains, this is the toolchain the GN code probably |
| thought it was in. This is the right thing to use in a test |
| like `toolchain_variant.base == target_toolchain`, rather |
| rather than comparing against `current_toolchain`. |
| `toolchain_variant.name` |
| [string] The name of this variant, as used in `variant` fields |
| in [`select_variant`](#select_variant) clauses. In the base |
| toolchain and its `shlib_toolchain`, this is `""`. |
| `toolchain_variant.suffix` |
| [string] This is "-${toolchain_variant.name}", "" if name is empty. |
| `toolchain_variant.is_pic_default` |
| [bool] This is true in `shlib_toolchain`. |
| `toolchain_variant.tags` |
| [list of strings] A list of liberal strings, each one describing a |
| property of this toolchain instance. See |
| //build/toolchain/variant_tags.gni for more details. |
| `toolchain_variant.configs` |
| [list of configs] A list of configs that are added after the default |
| ones to all linkable targets for this toolchain() instance. |
| `toolchain_variant.prefix_configs` |
| [list of configs] A list of configs that are added before the default |
| ones to all linkable targets for this toolchain() instance. |
| `toolchain_variant.remove_common_configs` |
| [list of configs] A list of configs that are removed from all |
| linkable targets for this toolchain() instance. Useful when |
| one of the default configs must not be used. |
| `toolchain_variant.remove_shared_configs` |
| [list of configs] Same a remove_common_configs, but only applies |
| to non-executable (e.g. shared_library()) targets. |
| `toolchain_variant.instrumented` |
| [boolean] A convenience flag that is true iff "instrumented" is |
| part of toolchain_variant.tags. |
| `toolchain_variant.with_shared` |
| [boolean] True iff this toolchain() instance has a secondary |
| toolchain to build ELF shared-library code. |
| |
| The other fields are the variant's effects as defined in |
| [`known_variants`](#known_variants). |
| |
| **Current value (from the default):** |
| ``` |
| { |
| base = "//build/toolchain/fuchsia:arm64" |
| } |
| ``` |
| |
| From //build/config/BUILDCONFIG.gn:140 |
| |
| ### ubsan_default_options |
| Default [UndefinedBehaviorSanitizer](https://clang.llvm.org/docs/UndefinedBehaviorSanitizer.html) |
| options (before the `UBSAN_OPTIONS` environment variable is read at |
| runtime). This can be set as a build argument to affect most "ubsan" |
| variants in $variants (which see), or overridden in $toolchain_args in |
| one of those variants. This can be a list of strings or a single string. |
| |
| Note that even if this is empty, programs in this build **cannot** define |
| their own `__ubsan_default_options` C function. Instead, they can use a |
| sanitizer_extra_options() target in their `deps` and then any options |
| injected that way can override that option's setting in this list. |
| |
| **Current value (from the default):** `["print_stacktrace=1", "halt_on_error=1"]` |
| |
| From //zircon/public/gn/config/instrumentation/sanitizer_default_options.gni:40 |
| |
| ### universal_variants |
| |
| **Current value (from the default):** |
| ``` |
| [{ |
| configs = [] |
| name = "debug" |
| toolchain_args = { |
| is_debug = true |
| } |
| }] |
| ``` |
| |
| From //build/config/BUILDCONFIG.gn:1060 |
| |
| ### universe_package_labels |
| If you add package labels to this variable, the packages will be included |
| in the 'universe' package set, which represents all software that is |
| produced that is to be published to a package repository or to the SDK by |
| the build. The build system ensures that the universe package set includes |
| the base and cache package sets, which means you do not need to redundantly |
| include those labels in this variable. |
| |
| **Current value for `target_cpu = "arm64"`:** `["//tools/net/device-finder:host"]` |
| |
| From //products/bringup.gni:46 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:49 |
| |
| **Current value for `target_cpu = "x64"`:** `["//tools/net/device-finder:host"]` |
| |
| From //products/bringup.gni:46 |
| |
| **Overridden from the default:** `[]` |
| |
| From //BUILD.gn:49 |
| |
| ### unpack_debug_archives |
| To ensure that everything can be built without debug symbols present we |
| gate weather or not these are consumed on a build argument. When set, |
| unpack_debug_archives creates an additional build step that unpacks |
| debug archives in tar.bzip2 format into the .build-id directory |
| |
| **Current value (from the default):** `false` |
| |
| From //build/packages/prebuilt_package.gni:13 |
| |
| ### update_kernels |
| (deprecated) List of kernel images to include in the update (OTA) package. |
| If no list is provided, all built kernels are included. The names in the |
| list are strings that must match the filename to be included in the update |
| package. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/args.gni:27 |
| |
| ### use_cast_runner_canary |
| If true then the most recent canary version of the Cast Runner is used, |
| otherwise the most recently validated version is used. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/cast/BUILD.gn:12 |
| |
| ### use_ccache |
| Set to true to enable compiling with ccache |
| |
| **Current value (from the default):** `false` |
| |
| From //build/toolchain/ccache.gni:9 |
| |
| ### use_chromium_canary |
| Set to use the most recent canary version of prebuilt Chromium components |
| otherwise the most recently validated version is used. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/chromium/BUILD.gn:16 |
| |
| ### use_goma |
| Set to true to enable distributed compilation using Goma. |
| |
| **Current value for `target_cpu = "arm64"`:** `false` |
| |
| From //out/not-default/args.gn:12 |
| |
| **Overridden from the default:** `false` |
| |
| From //build/toolchain/goma.gni:11 |
| |
| **Current value for `target_cpu = "x64"`:** `false` |
| |
| From //out/not-default/args.gn:12 |
| |
| **Overridden from the default:** `false` |
| |
| From //build/toolchain/goma.gni:11 |
| |
| ### use_lto |
| Use link time optimization (LTO). |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/lto/config.gni:7 |
| |
| ### use_netstack3 |
| If true, replaces netstack with netstack3. |
| |
| When set as a GN argument, requires that sysmgr_config_warn_override be set |
| to true to avoid build failures. See that flag's documentation for details. |
| |
| **Current value (from the default):** `false` |
| |
| From //src/connectivity/network/BUILD.gn:10 |
| |
| ### use_null_vulkan_on_host |
| TODO(liyl): Currently non-x64 platforms don't have Vulkan support, |
| so we always use the null Vulkan implementation instead. |
| |
| Global arguments for whether we use a "null" Vulkan implementation on |
| host vulkan_executables and vulkan_tests, so that any attempt to create a |
| VkInstances or VkDevice will fail. |
| |
| This argument will affect all vulkan_{executable/test} build targets. |
| |
| |
| **Current value (from the default):** `false` |
| |
| From //src/lib/vulkan/build/config.gni:40 |
| |
| ### use_prebuilt_ffmpeg |
| Use a prebuilt ffmpeg binary rather than building it locally. See |
| //src/media/lib/ffmpeg/README.md for details. This is ignored when |
| building in variant builds for which there is no prebuilt. In that |
| case, ffmpeg is always built from source so as to be built with the |
| selected variant's config. When this is false (either explicitly or in |
| a variant build) then //third_party/ffmpeg must be in the source tree, |
| which requires: |
| `jiri import -name third_party/ffmpeg -revision HEAD third_party/ffmpeg http://fuchsia.googlesource.com/integration` |
| or, if already importing a different manifest from there, resulting in errors from jiri update, |
| it can work to just git clone (but jiri update won't manage third_party/ffmpeg in this case): |
| mkdir third_party/ffmpeg |
| git clone "sso://fuchsia.googlesource.com/third_party/ffmpeg" third_party/ffmpeg |
| |
| **Current value (from the default):** `true` |
| |
| From //src/media/lib/ffmpeg/BUILD.gn:18 |
| |
| ### use_swiftshader_vulkan_icd_on_host |
| |
| Global arguments for whether we use the SwiftShader Vulkan ICD on host |
| vulkan_executables and vulkan_tests. |
| |
| This argument will affect all vulkan_{executable/test} build targets and |
| it only works when use_null_vulkan_on_host is set to false. |
| |
| |
| **Current value (from the default):** `true` |
| |
| From //src/lib/vulkan/build/config.gni:49 |
| |
| ### use_thinlto |
| Use ThinLTO variant of LTO if use_lto = true. |
| |
| **Current value (from the default):** `true` |
| |
| From //build/config/lto/config.gni:10 |
| |
| ### use_vbmeta |
| If true, then a vbmeta image will be generated for provided ZBI |
| and the paving script will pave vbmeta images to the target device. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/vbmeta.gni:14 |
| |
| ### use_vboot |
| Use vboot images |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/args.gni:10 |
| |
| ### using_fuchsia_sdk |
| Only set in buildroots where targets configure themselves for use with the |
| Fuchsia SDK |
| |
| **Current value (from the default):** `false` |
| |
| From //build/fuchsia/sdk.gni:8 |
| |
| ### vbmeta_a_partition |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:72 |
| |
| ### vbmeta_b_partition |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:73 |
| |
| ### vbmeta_r_partition |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:74 |
| |
| ### vendor_linting |
| Whether libraries under //vendor should be linted. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/fidl/fidl_library.gni:13 |
| |
| ### verify_system_package_entries |
| Whether to check and enforce that contributions to the system image package |
| are coming from the proper board and product file GN arguments |
| (respectively board_system_image_deps and product_system_image_deps), as |
| well as dev_system_image_deps. |
| |
| If this argument is set to false, the verification step can still be |
| manually performed with: |
| ninja out/default obj/build/images/system/verify_system_package_entries.success.stamp |
| |
| **Current value (from the default):** `false` |
| |
| From //build/images/system/BUILD.gn:14 |
| |
| ### virtmagma_debug |
| Enable verbose logging in virtmagma-related code |
| |
| **Current value (from the default):** `false` |
| |
| From //src/graphics/lib/magma/include/virtio/virtmagma_debug.gni:7 |
| |
| ### vm_tracing_level |
| The level of detail for traces emitted by the VM system. Values greater than |
| zero add increasing details at the cost of increased trace buffer use. |
| |
| 0 = Default kernel:* tracing. |
| 1 = Adds flow events for asynchronous page requests. |
| |
| **Current value (from the default):** `0` |
| |
| From //zircon/kernel/params.gni:54 |
| |
| ### vulkan_host_runtime_dir |
| |
| |vulkan_host_runtime_dir| is the path to Vulkan runtime libraries, which |
| contains prebuilt Vulkan loader, Vulkan layers, SwiftShader Vulkan ICD, |
| and descriptor files required to load the libraries. |
| |
| |
| **Current value (from the default):** `"//prebuilt/third_party/vulkan_runtime/linux-x64"` |
| |
| From //src/lib/vulkan/build/config.gni:23 |
| |
| ### vulkan_host_sdk_dir |
| |
| |vulkan_host_sdk_dir| is the path to Vulkan SDK, which contains Vulkan |
| headers and sources to Vulkan loader, layers and tools. |
| |
| |
| **Current value (from the default):** `"//prebuilt/third_party/vulkansdk/linux/x86_64"` |
| |
| From //src/lib/vulkan/build/config.gni:16 |
| |
| ### vulkan_sdk |
| |
| **Current value (from the default):** `""` |
| |
| From //src/graphics/examples/vkproto/common/common.gni:45 |
| |
| ### warn_on_sdk_changes |
| Whether to only warn when an SDK has been modified. |
| If false, any unacknowledged SDK change will cause a build failure. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/sdk/config.gni:11 |
| |
| ### weave_build_legacy_wdm |
| Tells openweave to support legacy WDM mode. |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openweave-core/config.gni:29](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#29) |
| |
| ### weave_build_warm |
| Tells openweave to build WARM libraries. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:26](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#26) |
| |
| ### weave_system_config_use_sockets |
| Tells openweave components to use bsd-like sockets. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:7](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#7) |
| |
| ### weave_with_nlfaultinjection |
| Tells openweave components to support fault injection. |
| |
| **Current value (from the default):** `false` |
| |
| From [//third_party/openweave-core/config.gni:20](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#20) |
| |
| ### weave_with_verhoeff |
| Tells openweave to support Verhoeff checksum. |
| |
| **Current value (from the default):** `true` |
| |
| From [//third_party/openweave-core/config.gni:23](https://fuchsia.googlesource.com/third_party/openweave-core/+/5db9c886c039bd96e829a550c9ce71c8c0ecdf4a/config.gni#23) |
| |
| ### wlancfg_config_type |
| Selects the wlan configuration type to use. Choices: |
| "client" - client mode |
| "ap" - access point mode |
| "" (empty string) - no configuration |
| |
| **Current value (from the default):** `"client"` |
| |
| From //src/connectivity/wlan/wlancfg/BUILD.gn:18 |
| |
| ### zbi_compression |
| Compression setting for ZBI "storage" items. |
| This can be "zstd", optionally followed by ".LEVEL" |
| where `LEVEL` can be an integer or "max". |
| |
| **Current value (from the default):** `"zstd"` |
| |
| From //build/zbi/zbi.gni:12 |
| |
| ### zedboot_devmgr_config |
| List of arguments to populate /boot/config/devmgr in the Zedboot image. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/images/zedboot/zedboot_args.gni:7 |
| |
| ### zircon_a_partition |
| Arguments to `fx flash` script (along with any `firmware_prebuilts` which |
| specify a partition). |
| |
| If `fvm_partition` is provided, the flash script will flash the full OS, |
| recovery + Zircon + FVM + SSH keys. In this case, the bootloader must also |
| support `fastboot oem add-staged-bootloader-file ssh.authorized_keys`. |
| |
| Otherwise, the script will flash the recovery image to all slots, which |
| doesn't require the FVM or SSH keys. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:69 |
| |
| ### zircon_args |
| [Zircon GN build arguments](/docs/gen/zircon_build_arguments.md). |
| The default passes through GOMA/ccache settings and |
| [`select_variant`](#select_variant) shorthand selectors. |
| **Only set this if you want to wipe out all the defaults that |
| propagate from Fuchsia GN to Zircon GN.** The default value |
| folds in [`zircon_extra_args`](#zircon_extra_args), so usually |
| it's better to just set `zircon_extra_args` and leave `zircon_args` alone. |
| Any individual Zircon build argument set in `zircon_extra_args` will |
| silently clobber the default value shown here. |
| |
| **Current value (from the default):** |
| ``` |
| { |
| default_deps = ["//:legacy_unification-arm64"] |
| goma_dir = "/b/s/w/ir/x/w/prebuilt/third_party/goma/linux-x64" |
| output_gsym = false |
| use_ccache = false |
| use_goma = false |
| variants = [] |
| } |
| ``` |
| |
| From //BUILD.gn:84 |
| |
| ### zircon_asserts |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/fuchsia/BUILD.gn:136 |
| |
| ### zircon_b_partition |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:70 |
| |
| ### zircon_build_root |
| |
| **Current value (from the default):** `"//zircon"` |
| |
| From //src/graphics/lib/magma/gnbuild/magma.gni:18 |
| |
| ### zircon_compdb_filter |
| Compilation database filter. Gets passed to --export-compile-commands=<filter>. |
| |
| **Current value (from the default):** `"default"` |
| |
| From //build/zircon/build_args.gni:33 |
| |
| ### zircon_extra_args |
| [Zircon GN build arguments](/docs/gen/zircon_build_arguments.md). |
| This is included in the default value of [`zircon_args`](#zircon_args) so |
| you can set this to add things there without wiping out the defaults. |
| When you set `zircon_args` directly, then this has no effect at all. |
| Arguments you set here override any arguments in the default |
| `zircon_args`. There is no way to append to a value from the defaults. |
| Note that for just setting simple (string-only) values in Zircon GN's |
| [`variants`](/docs/gen/zircon_build_arguments.md#variants), the |
| default [`zircon_args`](#zircon_args) uses a `variants` value derived from |
| [`select_variant`](#select_variant) so for simple cases there is no need |
| to explicitly set Zircon's `variants` here. |
| |
| **Current value for `target_cpu = "arm64"`:** `{ }` |
| |
| From //out/not-default/args.gn:4 |
| |
| **Overridden from the default:** `{ }` |
| |
| From //build/zircon/build_args.gni:17 |
| |
| **Current value for `target_cpu = "x64"`:** `{ }` |
| |
| From //out/not-default/args.gn:4 |
| |
| **Overridden from the default:** `{ }` |
| |
| From //build/zircon/build_args.gni:17 |
| |
| ### zircon_extra_deps |
| Additional Zircon GN labels to include in the Zircon build. |
| |
| **Current value (from the default):** `[]` |
| |
| From //build/zircon/build_args.gni:21 |
| |
| ### zircon_kernel_disable_asserts |
| Forcibly disable all assertions for the Zircon kernel. If this is set, the |
| default is to use the value of zx_assert_level to control assertions when |
| building the kernel. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/zircon/build_args.gni:26 |
| |
| ### zircon_optimize |
| Zircon optimization level. Same acceptable values as `optimize`. |
| Note that this will be ignored, in favor of the global `optimize` variable |
| if the latter is one of: "none", "sanitizer", "profile" or "size". |
| |
| **Current value (from the default):** `"default"` |
| |
| From //build/config/zircon/levels.gni:18 |
| |
| ### zircon_r_partition |
| |
| **Current value (from the default):** `""` |
| |
| From //build/images/args.gni:71 |
| |
| ### zircon_toolchain |
| *This should never be set as a build argument.* |
| It exists only to be set in `toolchain_args`. |
| For Zircon toolchains, this will be a scope whose schema |
| is documented in //build/toolchain/zircon/zircon_toolchain.gni. |
| For all other toolchains, this will be false. |
| |
| This allows testing for a Zircon-specific toolchain with: |
| |
| if (zircon_toolchain != false) { |
| // code path for Zircon-specific toolchains |
| } else { |
| // code path for non-Zircon ones. |
| } |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/BUILDCONFIG.gn:157 |
| |
| ### zircon_tracelog |
| Where to emit a tracelog from Zircon's GN run. No trace will be produced if |
| given the empty string. Path can be source-absolute or system-absolute. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/zircon/build_args.gni:30 |
| |
| ### zvb_partition_name |
| Partition name from where image will be verified |
| |
| **Current value (from the default):** `"zircon"` |
| |
| From //build/images/vbmeta.gni:36 |
| |
| ### zx_assert_level |
| Controls which asserts are enabled. |
| |
| `ZX_ASSERT` is always enabled. |
| |
| * 0 disables standard C `assert()` and `ZX_DEBUG_ASSERT`. |
| * 1 disables `ZX_DEBUG_ASSERT`. Standard C `assert()` remains enabled. |
| * 2 enables all asserts. |
| |
| **Current value (from the default):** `2` |
| |
| From //build/config/zircon/levels.gni:13 |
| |
| ## `target_cpu = "arm64"` |
| |
| ### amlogic_decoder_firmware_path |
| Path to the amlogic decoder firmware file. Overrides the default in the build. |
| |
| **Current value (from the default):** `""` |
| |
| From //src/media/drivers/amlogic_decoder/BUILD.gn:12 |
| |
| ### arm_float_abi |
| The ARM floating point mode. This is either the string "hard", "soft", or |
| "softfp". An empty string means to use the default one for the |
| arm_version. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/config/arm.gni:20 |
| |
| ### arm_optionally_use_neon |
| Whether to enable optional NEON code paths. |
| |
| **Current value (from the default):** `false` |
| |
| From //build/config/arm.gni:31 |
| |
| ### arm_tune |
| The ARM variant-specific tuning mode. This will be a string like "armv6" |
| or "cortex-a15". An empty string means to use the default for the |
| arm_version. |
| |
| **Current value (from the default):** `""` |
| |
| From //build/config/arm.gni:25 |
| |
| ### arm_use_neon |
| Whether to use the neon FPU instruction set or not. |
| |
| **Current value (from the default):** `true` |
| |
| From //build/config/arm.gni:28 |
| |
| ### arm_version |
| |
| **Current value (from the default):** `8` |
| |
| From //build/config/arm.gni:12 |
| |