Usage: ffx [-c <config>] [-e <env>] [-t <target>] [-T <timeout>] [-v] [<command>] [<args>] Fuchsia's developer tool
Options:
-c, --config override default configuration -e, --env override default environment settings -t, --target apply operations across single or multiple targets -T, --timeout override default proxy timeout -v, --verbose use verbose output --help display usage information
Commands:
component Discover and manage components config View and switch default and user configurations daemon Interact with/control the ffx daemon doctor Run common checks for the ffx tool and host environment vdl Start and manage Fuchsia emulators overnet Interact with the Overnet mesh package Create and publish Fuchsia packages platform Manage platform build prerequisites scrutiny Audit the security of Fuchsia sdk Modify or query the installed SDKs self-test Execute the ffx self-test (e2e) suite target Interact with a target device or emulator trace Interact with the tracing subsystem version Print out ffx tool and daemon versions debug Start a debugging session.
Usage: ffx component <command> [<args>] Discover and manage components
Options:
--help display usage information
Commands:
knock Connect to a service on the target list List all components run Run a component on the target select Lists components matching a selector test Run test suite
Usage: ffx component knock <selector> Connect to a service on the target
Options:
--help display usage information Examples: To connect to a service: $ ffx component knock 'core/appmgr:out:fuchsia.hwinfo.Product' Notes: Knock verifies the existence of a service exposed by a component by attempting to connect to it. The command expects a <selector> with the following format: `<component moniker>:(in|out|exposed)[:<service name>].` Note that wildcards can be used but must match exactly one service. The `component select` command can be used to explore the component topology to compose the correct selector for use in `component knock`. Error codes: 1 Failed to connect to service
Usage: ffx component list List all components
Options:
--help display usage information Examples: To list all components in the topology: $ ffx component list Notes: Lists all the components on the running target. The command outputs a tree of all v1 and v2 components on the system. If the command fails or times out, ensure RCS is running on the target. This can be verified by running `ffx target list` and seeing the status on the RCS column. Error codes: 1 The command has timed out
Usage: ffx component run <url> [<args...>] Run a component on the target
Options:
--help display usage information Examples: To run the 'hello_world_rust' component: $ ffx component run \ fuchsia-pkg://fuchsia.com/hello_world_rust#meta/hello_world_rust.cmx To run the Remote Control Service: $ ffx component run \ fuchsia-pkg://fuchsia.com/remote-control#meta/remote-control-runner.cmx Notes: Runs a specified v1 component on the target. The <url> must follow the format: `fuchsia-pkg://fuchsia.com/<package>#meta/<component>.cmx`.
Usage: ffx component select <selector> Lists components matching a selector
Options:
--help display usage information Examples: To show services exposed by remote-control: $ ffx component select remote-control:expose:*' Or to show all services offered by v1 components: $ ffx component select core/appmgr:out:* Notes: Component select allows for looking up various services exposed by the component. The command expects a <selector> with the following format: `<component moniker>:(in|out|exposed)[:<service name>]` Wildcards may be used anywhere in the selector. Error codes: 1 No matching component paths found
Usage: ffx component test <test_url> [-t <timeout>] [--test-filter <test-filter>] [--list] [--run-disabled] [--parallel <parallel>] [--count <count>] Run test suite
Options:
-t, --timeout test timeout --test-filter a glob pattern for matching tests --list list tests in the suite --run-disabled run tests that have been marked disabled/ignored --parallel run tests in parallel --count number of times to run the test [default = 1] --help display usage information Notes: Runs a test or suite implementing the `fuchsia.test.Suite` protocol. Note that if running multiple iterations of a test and an iteration times out, no further iterations will be executed.
Usage: ffx config <command> [<args>] View and switch default and user configurations
Options:
--help display usage information
Commands:
env list environment settings get display config values set set config settings remove remove config for a given level add add config value the end of an array analytics enable or disable analytics
Usage: ffx config add <name> <value> [-l <level>] [-b <build-dir>] add config value the end of an array
Options:
-l, --level config level. Possible values are "user", "build", "global". Defaults to "user". -b, --build-dir an optional build directory to associate the build config provided - use used for "build" configs --help display usage information Notes: This will always add to the end of an array. Adding to a subtree is not supported. If the current value is not an array, it will convert the value to an array. If you want to insert a value in a different position, consider editing the configuration file directly. Configuration file locations can be found by running `ffx config env get` command.
Usage: ffx config analytics <command> [<args>] enable or disable analytics
Options:
--help display usage information
Commands:
enable enable analytics disable disable analytics show show analytics
Usage: ffx config analytics disable disable analytics
Options:
--help display usage information
Usage: ffx config analytics enable enable analytics
Options:
--help display usage information
Usage: ffx config analytics show show analytics
Options:
--help display usage information
Usage: ffx config env [<command>] [<args>] list environment settings
Options:
--help display usage information
Commands:
set set environment settings get list environment for a given level
Usage: ffx config env get [<level>] list environment for a given level
Options:
--help display usage information
Usage: ffx config env set <file> [-l <level>] [-b <build-dir>] set environment settings
Options:
-l, --level config level. Possible values are "user", "build", "global". Defaults to "user". -b, --build-dir an optional build directory to associate the build config provided - use used for "build" configs --help display usage information
Usage: ffx config get [<name>] [-p <process>] [-s <select>] [-b <build-dir>] [-o <output>] display config values
Options:
-p, --process how to process results. Possible values are "raw", "sub", and "sub_flat". Defaults to "raw". Currently only supported if a name is given. -s, --select how to collect results. Possible values are "first" and "all". Defaults to "first". If the value is "first", the first value found in terms of priority is returned. If the value is "all", all values across all configuration levels are aggregrated and returned. Currently only supported if a name is given. -b, --build-dir an optional build directory to associate the build config provided - use used for "build" configs -o, --output [DEPRECATED] The output type will always be JSON. --help display usage information Error codes: 2 No value found
Usage: ffx config remove <name> [-l <level>] [-b <build-dir>] remove config for a given level
Options:
-l, --level config level. Possible values are "user", "build", "global". Defaults to "user". -b, --build-dir an optional build directory to associate the build config provided - use used for "build" configs --help display usage information Notes: This will remove the entire value for the given name. If the value is a subtree or array, the entire subtree or array will be removed. If you want to remove a specific value from an array, consider editing the configuration file directly. Configuration file locations can be found by running `ffx config env get` command.
Usage: ffx config set <name> <value> [-l <level>] [-b <build-dir>] set config settings
Options:
-l, --level config level. Possible values are "user", "build", "global". Defaults to "user". -b, --build-dir an optional build directory to associate the build config provided - use used for "build" configs --help display usage information
Usage: ffx daemon <command> [<args>] Interact with/control the ffx daemon
Options:
--help display usage information
Commands:
crash crash the daemon echo run echo test against the daemon log Dumps the daemon log start run as daemon stop stops a running daemon
Usage: ffx daemon crash crash the daemon
Options:
--help display usage information
Usage: ffx daemon echo [<text>] run echo test against the daemon
Options:
--help display usage information
Usage: ffx daemon log Dumps the daemon log
Options:
--help display usage information
Usage: ffx daemon start run as daemon
Options:
--help display usage information
Usage: ffx daemon stop stops a running daemon
Options:
--help display usage information
Usage: ffx debug [<socket_location>] Start a debugging session.
Options:
--help display usage information
Usage: ffx doctor [--retry-count <retry-count>] [--retry-delay <retry-delay>] [--force-daemon-restart] [--record] [--record-output <record-output>] Run common checks for the ffx tool and host environment
Options:
--retry-count number of times to retry failed connection attempts. --retry-delay timeout delay when attempting to connect to the daemon or RCS --force-daemon-restart if true, forces a daemon restart, even if the connection appears to be working --record if true, generates an output zip file that can be attached to a monorail issue --record-output sets the output directory for doctor records. Only valid when --record is provided. Defaults to the current directory --help display usage information
Usage: ffx overnet <command> [<args>] Interact with the Overnet mesh
Options:
--help display usage information
Commands:
list-peers List known peer nodes list-links List links on a particular peer host-pipe Use stdin/stdout as a link to another overnet instance full-map Construct a detailed graphviz map of the Overnet mesh - experts only!
Usage: ffx overnet full-map --exclude-self <exclude-self> Construct a detailed graphviz map of the Overnet mesh - experts only!
Options:
--exclude-self if set, exclude the onet tool from output --help display usage information
Usage: ffx overnet host-pipe Use stdin/stdout as a link to another overnet instance
Options:
--help display usage information
Usage: ffx overnet list-links <nodes> List links on a particular peer
Options:
--help display usage information
Usage: ffx overnet list-peers List known peer nodes
Options:
--help display usage information
Usage: ffx package <command> [<args>] Create and publish Fuchsia packages
Options:
--help display usage information
Commands:
build Builds a package. Entries may be specified as: - <dst>=<src>: Place the file at path <src> into the package at path <dst>. - @<manifest-file>: Read each line of this file as an entry. This is not recursive; you can't put another @<manifest-file> export export a package archive import import a package archive
Usage: ffx package build [<entries...>] [--source-dir <source-dir>] [--hash-out <hash-out>] [--depfile <depfile>] Builds a package. Entries may be specified as: - <dst>=<src>: Place the file at path <src> into the package at path <dst>. - @<manifest-file>: Read each line of this file as an entry. This is not recursive; you can't put another @<manifest-file>
Options:
--source-dir base directory for the <src> part of entries; defaults to the current directory --hash-out write the package hash to this file instead of stdout --depfile write a gcc-format depfile for use in build systems --help display usage information
Usage: ffx platform <command> [<args>] Manage platform build prerequisites
Options:
--help display usage information
Commands:
preflight Evaluate suitability for building and running Fuchsia
Usage: ffx platform preflight Evaluate suitability for building and running Fuchsia
Options:
--help display usage information
Usage: ffx scrutiny <command> [<args>] Audit the security of Fuchsia
Options:
--help display usage information
Commands:
shell Run the scrutiny shell
Usage: ffx scrutiny shell [<command>] Run the scrutiny shell
Options:
--help display usage information
Usage: ffx sdk <command> [<args>] Modify or query the installed SDKs
Options:
--help display usage information
Commands:
version Retrieve the version of the current SDK
Usage: ffx sdk version Retrieve the version of the current SDK
Options:
--help display usage information
Usage: ffx self-test [--timeout <timeout>] [--case-timeout <case-timeout>] [--include-target <include-target>] Execute the ffx self-test (e2e) suite
Options:
--timeout maximum runtime of entire test suite in seconds --case-timeout maximum run time of a single test case in seconds --include-target include target interaction tests --help display usage information
Usage: ffx target <command> [<args>] Interact with a target device or emulator
Options:
--help display usage information
Commands:
add Make the daemon aware of a specific target default Manage the default target flash Flash an image to a target device get-ssh-address Get the target's ssh address list List all targets log off Powers off a target reboot Reboots a target remove Make the daemon forget a specific target status Display status information for the target update Update base system software on target Notes: The `target` subcommand contains various commands for target management and interaction. Typically, this is the entry workflow for users, allowing for target discovery and provisioning before moving on to `component` or `session` workflows once the system is up and running on the target. Most of the commands depend on the RCS (Remote Control Service) on the target.
Usage: ffx target add <addr> Make the daemon aware of a specific target
Options:
--help display usage information Examples: To add a remote target forwarded via ssh: $ ffx target add 127.0.0.1:8022 Or to add a target using its IPV6: $ ffx target add fe80::32fd:38ff:fea8:a00a Notes: Manually add a target based on its IP address. The command accepts IPV4 or IPV6 addresses, including a port number: `<addr> = <ip addr:port>`. Typically, the daemon automatically discovers targets as they come online. However, manually adding a target allows for specifying a port number or address, often used for remote workflows.
Usage: ffx target default <command> [<args>] Manage the default target
Options:
--help display usage information
Commands:
get Get the default configured target set Set the default target unset Clears the default configured target Examples: For one-off overrides for the default use `--target` option: $ ffx --target <target name> <subcommand> Or use the `--config` option: $ ffx --config target.default=<target name> <subcommand> Notes: Manages the default configured target for all operations. The default target is designated by a `*` next to the name. This is an alias for the `target.default` configuration key.
Usage: ffx target default get Get the default configured target
Options:
--help display usage information Notes: Returns the default configured target from the 'User Configuration'. Returns an empty string if no default is configured.
Usage: ffx target default set <nodename> [-l <level>] [-b <build-dir>] Set the default target
Options:
-l, --level config level, such as 'user', 'build', or 'global' -b, --build-dir optional directory to associate the provided build config --help display usage information Examples: To set the default target: $ ffx target default set <target name> To set the 'target.default` key at the global configuration: $ ffx target default set -l global <target name> To specify a default target for a specific build directory: $ ffx target default set -l build -b ~/fuchsia/out <target name> Notes: Sets the `target.default` configuration key. By default sets the key in the 'User Configuration'. Can be used in conjuction with `ffx target list` to list the names of the discovered targets. After setting the default target, `ffx target list` will mark the default with a `*` in the output list.
Usage: ffx target default unset [-l <level>] [-b <build-dir>] Clears the default configured target
Options:
-l, --level config level, such as 'user', 'build', or 'global' -b, --build-dir optional directory to associate the provided build config --help display usage information Examples: To clear the default target: $ ffx target default unset To clear the `target.default` key from global configuration: $ ffx target default unset -l global To specify a specific build directory: $ ffx target default unset -l build -b ~/fuchsia/out Notes: Clears the `target.default` configuration key. By default clears the 'User Configuration'. Returns a warning if the key is already empty.
Usage: ffx target flash <manifest> [<product>] [--oem-stage <oem-stage>] Flash an image to a target device
Options:
--oem-stage oem staged file - can be supplied multiple times --help display usage information Examples: To flash a specific image: $ ffx target flash ~/fuchsia/out/flash.json fuchsia To include SSH keys as well: $ ffx target flash --oem-stage add-staged-bootloader-file ssh.authorized_keys, ~/fuchsia/.ssh/authorized_keys ~/fuchsia/out/default/flash.json fuchsia Notes: Flases an image to a target device using the fastboot protocol. Requires a specific <manifest> file and <product> name as an input. This is only applicable to a physical device and not an emulator target. The target device is typically connected via a micro-USB connection to the host system. The <manifest> format is a JSON file generated when building a fuchsia <product> and can be found in the build output directory. The `--oem-stage` option can be supplied multiple times for several OEM files. The format expects a single OEM command to execute after staging the given file. The format for the `--oem-stage` parameter is a comma separated pair: '<OEM_COMMAND>,<FILE_TO_STAGE>'
Usage: ffx target get-ssh-address [-t <timeout>] Get the target's ssh address
Options:
-t, --timeout the timeout in seconds [default = 1.0] --help display usage information Notes: Return the SSH address of the default target defined in the `target.default` key. By default this comes from the 'User Configuration'. The command takes a <timeout> value in seconds with a default of `1.0` and overrides the value in the `target.interaction.timeout` key. Error codes: 1 Timeout while getting ssh address
Usage: ffx target list [<nodename>] [-f <format>] List all targets
Options:
-f, --format determines the output format for the list operation --help display usage information Examples: To list targets in short form: $ ffx target list --format s fe80::4415:3606:fb52:e2bc%zx-f80ff974f283 pecan-guru-clerk-rhyme To list targets with only their addresses: $ ffx target list --format a fe80::4415:3606:fb52:e2bc%zx-f80ff974f283 Notes: List all targets that the daemon currently has in memory. This includes manually added targets. The daemon also proactively discovers targets as they come online. Use `ffx target list` to always get the latest list of targets. The default target is marked with a '*' next to the node name. The table has the following columns: NAME = The name of the target. TYPE = The product type of the target, currently always 'Unknown'. STATE = The high-level state of the target, currently always 'Unknown'. AGE = Shows the last time the daemon was able to discover the target. ADDRS/IP = The discovered and known addresses of the target. RCS = Indicates if the Remote Control Service is running on the target. The NAME column shows the target's advertised name. When the target is in early boot state such as fastboot, shows 'FastbootDevice' with the `product` and `serial` attributes instead. By default, the `list` command outputs in a tabular format. To override the format, pass `--format` and can take the following options: 'simple' , 'tabular|table|tab', 'addresses|addrs|addr', 'json|JSON' or in short form 's', 't', 'a', 'j'.
Usage: ffx target log <command> [<args>]
Options:
--help display usage information
Commands:
watch Watches for and prints logs from a target. Optionally dumps recent logs first. dump Dumps all logs from a target.
Usage: ffx target log dump Dumps all logs from a target.
Options:
--help display usage information
Unrecognized argument: recent
Usage: ffx target log watch [--dump <dump>] Watches for and prints logs from a target. Optionally dumps recent logs first.
Options:
--dump if true, dumps recent logs before printing new ones. --help display usage information
Usage: ffx target off Powers off a target
Options:
--help display usage information Notes: Power off a target. Uses the 'fuchsia.hardware.power.statecontrol.Admin' FIDL API to send the power off command. The 'fuchsia.hardware.power.statecontrol.Admin' is exposed via the 'appmgr' component. To verify that the target exposes this service, `ffx component select` or `ffx component knock` can be used. Error codes: 1 Timeout while powering off target.
Usage: ffx target reboot [-b] [-r] Reboots a target
Options:
-b, --bootloader reboot to bootloader -r, --recovery reboot to recovery --help display usage information Notes: Reboot a target. Uses the 'fuchsia.hardware.power.statecontrol.Admin' FIDL API to send the reboot command. By default, target boots fully. This behavior can be overrided by passing in either `--bootloader` or `--recovery` to boot into the bootloader or recovery, respectively. The 'fuchsia.hardware.power.statecontrol.Admin' is exposed via the 'appmgr' component. To verify that the target exposes this service, `ffx component select` or `ffx component knock` can be used. Error codes: 1 Timeout while powering off target.
Usage: ffx target remove <id> Make the daemon forget a specific target
Options:
--help display usage information Examples: To remove a target by its target name: $ ffx target remove correct-horse-battery-staple Or to remove a target using its IP address: $ ffx target remove fe80::32fd:38ff:fea8:a00a Notes: IP addresses are matched by their full string representation. for best results, copy the exact address from ffx target list.
Usage: ffx target status [--desc] [--label] [--json] [--version] Display status information for the target
Options:
--desc display descriptions of entries --label display label of entries --json formats output as json objects --version display version --help display usage information Notes: Displays a detailed runtime status information about the target. The default output is intended for a human reader. This output can be decorated with machine readable labels (--label) and descriptions of each field (--desc). The 'label' fields in the machine readable output (--json) will remain stable across software updates and is not localized (compare to 'title' which may change or be localized). The 'value' field will be one of: 'null', 'bool', 'string', or a list of strings. Error codes: 1 Timeout retrieving target status.
Usage: ffx target update <command> [<args>] Update base system software on target
Options:
--help display usage information
Commands:
channel View and manage update channels check-now Check and perform the system update operation force-install Trigger the system updater manually Notes: This command interfaces with system update services on the target.
Usage: ffx target update channel <command> [<args>] View and manage update channels
Options:
--help display usage information
Commands:
get-current Return the currently configured update channel get-next Return the next or target update channel set Sets the update channel list List the known update channels Notes: Channel management commands and operations. Interfaces directly with the 'fuchsia.update.channelcontrol.ChannelControl' service on the target system.
Usage: ffx target update channel get-current Return the currently configured update channel
Options:
--help display usage information Notes: For developer product configurations, this is by default 'devhost'. Error codes: 1 Timeout while getting update channel.
Usage: ffx target update channel get-next Return the next or target update channel
Options:
--help display usage information Notes: Returns the next or target channel. This differs from `get` when the next successful update changes the configured update channel on the system. Error codes: 1 Timeout while getting update channel.
Usage: ffx target update channel list List the known update channels
Options:
--help display usage information Notes: This lists all the known next or target update channels on the system. Returns an empty list if no other update channels are configured. Error codes: 1 Timeout while getting list of update channel.
Usage: ffx target update channel set <channel> Sets the update channel
Options:
--help display usage information Examples: To list all the known update channels: $ ffx target update channel list Then, use a valid channel from the list: $ ffx target update channel set <channel> Notes: Sets the next or target update channel on the device. When paired with `ffx target update check-now`, ensures the update is check against the next or target channel. When the update is successful, next or target channel becomes the current channel. Use `ffx target update channel list` to list known system update channels. Error codes: 1 Timeout while setting update channel.
Usage: ffx target update check-now [--service-initiated] [--monitor] Check and perform the system update operation
Options:
--service-initiated the update check was initiated by a service, in the background. --monitor monitor for state update. --help display usage information Examples: To check for update and monitor progress: $ ffx target update check-now --monitor Notes: Triggers an update check operation and performs the update if available. Interfaces using the 'fuchsia.update Manager' protocol with the system update service on the target. The command takes in an optional `--monitor` switch to watch the progress of the update. The output is displayed in `stdout`. The command also takes an optional `--service-initiated` switch to indicate a separate service has initiated a check for update.
Usage: ffx target update force-install <update_pkg_url> [--reboot <reboot>] Trigger the system updater manually
Options:
--reboot automatically trigger a reboot into the new system --help display usage information Examples: With a known update package URL, trigger an update: $ ffx target update force-install fuchsia-pkg://fuchsia.com/update Also trigger a reboot after update: $ ffx target update force-install fuchsia-pkg://fuchsia.com/update --reboot Notes: Directly invoke the system updater to install the provided update, bypassing any update checks. Interfaces using the 'fuchsia.update.installer' protocol to update the system. Requires an <update_pkg_url> in the following format: `fuchsia-pkg://fuchsia.com/update` Takes an optional `--reboot <true|false>` to trigger a system reboot after update has been successfully applied.
Usage: ffx trace <command> [<args>] Interact with the tracing subsystem
Options:
--help display usage information
Commands:
list-providers List the target's trace providers record Record a trace
Usage: ffx trace list-providers List the target's trace providers
Options:
--help display usage information
Usage: ffx trace record [--buffer-size <buffer-size>] [--categories <categories>] [--duration <duration>] [--output <output>] Record a trace
Options:
--buffer-size size of per-provider trace buffer in MB. Defaults to 4. --categories comma-separated list of categories to enable. Defaults to "app,audio,benchmark,blobfs,gfx,input,kernel:meta, kernel:sched,ledger,magma,minfs,modular,view,flutter, dart,dart:compiler,dart:dart,dart:debugger,dart:embedder, dart:gc,dart:isolate,dart:profiler,dart:vm" --duration duration of trace capture in seconds. Defaults to 10 seconds. --output name of output trace file. Defaults to trace.fxt. --help display usage information
Usage: ffx vdl [--sdk] <command> [<args>] Start and manage Fuchsia emulators
Options:
--sdk running in fuchsia sdk (not inside the fuchsia code repository) --help display usage information
Commands:
start Starting Fuchsia Emulator kill Killing Fuchsia Emulator
Usage: ffx vdl kill [-d <vdl-path>] [--launched-proto <launched-proto>] Killing Fuchsia Emulator
Options:
-d, --vdl-path device_launcher binary location. Defaults to looking in prebuilt/vdl/device_launcher --launched-proto required, file containing device_launcher process artifact location. --help display usage information
Usage: ffx vdl start [-H] [-N] [--host-gpu] [--software-gpu] [--hidpi-scaling] [-u <upscript>] [--packages-to-serve <packages-to-serve>] [-p <pointing-device>] [-w <window-width>] [-h <window-height>] [-s <image-size>] [-f <device-proto>] [-e <aemu-path>] [--aemu-version <aemu-version>] [-d <vdl-path>] [--vdl-version <vdl-version>] [-x <grpcwebproxy>] [-X <grpcwebproxy-path>] [--grpcwebproxy-version <grpcwebproxy-version>] [-v <sdk-version>] [--gcs-bucket <gcs-bucket>] [--image-name <image-name>] [-l <emulator-log>] [--port-map <port-map>] [--vdl-output <vdl-output>] [--nointeractive] Starting Fuchsia Emulator
Options:
-H, --headless bool, run emulator in headless mode. -N, --tuntap bool, run emulator with emulated nic via tun/tap. --host-gpu bool, run emulator with host GPU acceleration, this doesn't work on remote-desktop with --headless. --software-gpu bool, run emulator without host GPU acceleration, default. --hidpi-scaling bool, enable pixel scaling on HiDPI devices. -u, --upscript path to tun/tap upscript, this script will be executed before booting up FEMU. --packages-to-serve comma separated string of fuchsia package urls, extra packages to serve after starting FEMU. -p, --pointing-device set pointing device used on emulator: mouse or touch screen. Allowed values are "touch", "mouse". Default is "touch". -w, --window-width emulator window width. Default to 1280. -h, --window-height emulator window height. Default to 800. -s, --image-size extends storage size to <size> bytes. Default is "2G". -f, --device-proto path to fuchsia virtual device configuration, if not specified a generic one will be generated. -e, --aemu-path path to aemu location. When running in fuchsia repo, defaults to looking in prebuilt/third_party/aemu/PLATFORM. When running in fuchsia sdk, defaults to looking in $HOME/.fuchsia/femu. --aemu-version label used to download AEMU from CIPD. Default is "integration". Download only happens if aemu binary cannot be found from known paths. -d, --vdl-path device_launcher binary location. When running in fuchsia repo, defaults to looking in prebuilt/vdl/device_launcher. When running in fuchsia sdk, defaults to looking in directory containing `fvdl`. --vdl-version label used to download vdl from CIPD. Default is "latest". Download only happens if vdl (device_launcher) binary cannot be found from known paths. -x, --grpcwebproxy enable WebRTC HTTP service on port, if set to 0 a random port will be picked -X, --grpcwebproxy-path location of grpcwebproxy, When running in fuchsia repo, defaults to looking in prebuilt/third_party/grpcwebproxy When running in fuchsia sdk, defaults to looking in $HOME/.fuchsia/femu. --grpcwebproxy-version label used to download grpcwebproxy from CIPD. Default is "latest". Download only happens if --grpcwebproxy is set and grpcwebproxy binary cannot be found from known paths or path specified by --grpcwebproxy_path. -v, --sdk-version fuchsia sdk ID used to fetch from gcs, if specified, the emulator will launch with fuchsia sdk files fetched from gcs. To find the latest version run `gsutil cat gs://fuchsia/development/LATEST_LINUX`. --gcs-bucket gcs bucket name. Default is "fuchsia". --image-name image file name used to fetch from gcs. Default is "qemu-x64". To view availabe image names run `gsutil ls -l gs://fuchsia/development/$(gsutil cat gs://fuchsia/development/LATEST_LINUX)/images`. -l, --emulator-log file path to store emulator log. Default is a temp file that is deleted after `fvdl` exits. --port-map host port mapping for user-networking mode. This flag will be ignored if --tuntap is used. If not specified, an ssh port on host will be randomly picked and forwarded. ex: hostfwd=tcp::<host_port>-:<guest_port>,hostfwd=tcp::<host_port>-:<guest_port> --vdl-output file destination to write `device_launcher` output. Required for --nointeractive mode. Default is a temp file that is deleted after `fvdl` exits. Specify this flag if you plan to use the `kill` subcommand. --nointeractive bool, turn off interactive mode. if turned off, fvdl will not land user in ssh console. A ssh port will still be forwarded. User needs to specify --vdl-output flag with this mode, and manually call the `kill` subcommand to perform clean shutdown. --help display usage information
Usage: ffx version [-v] Print out ffx tool and daemon versions
Options:
-v, --verbose if true, includes details about both ffx and the daemon --help display usage information