tree: 3ba83d29f80c810402b6dfe3f670e9a28ef7a8a7 [search]
  1. device-discovery.md
  2. interface-configuration.md
  3. README.md
  4. ssh-daemon.md
docs/development/tools/ffx/workflows/network-connectivity/README.md

Network connectivity troubleshoot playbook

This playbook is intended to help diagnose connectivity and discovery issues between your local Linux host machine and a connected Fuchsia target device (including physical devices over USB or network, emulators, and remote instances).

The playbook is split into the following three parts, where each part represents a category of related issues:

  • Part 1: Interface configuration (USB enumeration, udev permissions, and CDC network interfaces)
  • Part 2: Device discovery (mDNS, USB Fastboot, USB VSOCK, emulators, manual targets, Fastboot files, GCE, and UART)
  • Part 3: SSH daemon (SSH authentication and Remote Control Service connectivity)

When diagnosing network connectivity issues, it’s often one of these three categories that is impeding connection. The approaches in this playbook are explored using available Linux command line tools without going through any ffx workflows.

Lastly, many of the command arguments and example outputs (for instance, interface names, IP addresses, etc.) will be different on your machine. Be sure to substitute the command arguments with the actual values on your machine when necessary.