| # fx list-build-artifacts |
| |
| Builds and returns a list of a desired set of build artifacts |
| |
| ```none |
| usage: fx list-build-artifacts [--build] [--allow-empty | --expect-one] [FILTERS...] MODE |
| |
| Builds and returns a list of paths to special sets of build artifacts within |
| the GN graph relative to the build directory. |
| |
| --build build the artifacts as well as returning a list of them |
| --allow-empty do not fail if no such artifacts are found |
| --expect-one fail if zero or more than one artifacts are found. This |
| option is mutually exclusive from `--allow-empty`. |
| --name filter the set of artifacts to pick out the particular one of |
| the same name |
| --os filter the set of artifacts by intended operating system: one |
| of `fuchsia`, `linux`, or `mac`. Defaults to $HOST_OS when |
| the mode is `tools.` |
| --cpu filter the set of artifacts by intended architecture: one of |
| `x64` or `arm64`. Defaults to $HOST_CPU when the mode is |
| `tools`. |
| --type filter the set of artifacts by type. |
| |
| MODE One of the following: |
| `images` -- returns the list of images |
| `pave`-- returns the list of images needed to pave; |
| `pave-zedboot`-- returns the list of images needed to pave |
| zedboot; |
| `netboot`-- returns the list of images needed to netboot |
| `flash`-- returns the list of images needed to flash |
| `mkzedboot` -- returns the list of images needed to mkzedboot |
| `tools` -- returns the list of host tools |
| `boot-tests`-- returns the list of boot tests |
| `generated-sources`-- returns the list of generated sources |
| (e.g., FIDL and Banjo bindings). |
| |
| ``` |
| |
| [list-build-artifacts source code](https://cs.opensource.google/fuchsia/fuchsia/+/main:tools/devshell/list-build-artifacts) |
