62 lines
1.7 KiB
Markdown
62 lines
1.7 KiB
Markdown
|
# `device-finder`
|
||
|
|
|
||
|
|
`device-finder` is the command line tool for device discovery. It uses mDNS to
|
||
|
|
find Fuchsia devices.
|
||
|
|
|
||
|
|
Currently only Linux is supported. For Mac users see the section
|
||
|
|
[for Mac Users](#for_mac_users).
|
||
|
|
|
||
|
|
## For Linux Users
|
||
|
|
|
||
|
|
### Finding all Devices
|
||
|
|
|
||
|
|
The simplest way to get all the devices on the network by their address is to
|
||
|
|
run
|
||
|
|
|
||
|
|
```
|
||
|
|
$ ./device-finder list
|
||
|
|
192.168.42.156
|
||
|
|
```
|
||
|
|
|
||
|
|
This will give you the addresses of all Fuchsia devices on the network. If you'd
|
||
|
|
like to get their hostnames as well as their addresses, you can include the
|
||
|
|
`-full` flag.
|
||
|
|
|
||
|
|
### Finding devices by hostname
|
||
|
|
|
||
|
|
If you'd like to find your device by its unique hostname (e.g.
|
||
|
|
`lunch-feta-stool-woozy`) you can use the `resolve` command:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ ./device-finder resolve lunch-feta-stool-woozy
|
||
|
|
192.168.42.156
|
||
|
|
```
|
||
|
|
|
||
|
|
### Finding the Interface Connected to the Device
|
||
|
|
|
||
|
|
To find the interface connected to the device, include the `-local` flag to
|
||
|
|
either the `list` command or the `resolve` command, which will give you the
|
||
|
|
address that the Fuchsia device can use to connect to your host.
|
||
|
|
|
||
|
|
## For Mac Users
|
||
|
|
|
||
|
|
For those on Mac hosts, you can use the included `dns-sd` command to find your
|
||
|
|
device. Here's an example command along with the output you should see when a
|
||
|
|
device is on your network:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ dns-sd -B _fuchsia._udp .
|
||
|
|
Browsing for _fuchsia._udp
|
||
|
|
DATE: ---Fri 14 Dec 2018---
|
||
|
|
15:28:21.447 ...STARTING...
|
||
|
|
Timestamp A/R Flags if Domain Service Type Instance Name
|
||
|
|
15:28:21.448 Add 2 7 local. _fuchsia._udp. quake-agile-lurk-even
|
||
|
|
```
|
||
|
|
|
||
|
|
Mac does not support the equivalent of a `local` flag as described above in the
|
||
|
|
`device-finder` docs.
|
||
|
|
|
||
|
|
## For additional help
|
||
|
|
|
||
|
|
For additional help using any of the `device-finder` subcommands, run the subcommand with the `-help` flag.
|