1<!-- Copyright 2016 The Chromium Authors. All rights reserved.
2     Use of this source code is governed by a BSD-style license that can be
3     found in the LICENSE file.
4-->
5
6# Devil: Persistent Device List
7
8## What is it?
9
10A persistent device list that stores all expected devices between builds. It
11is used by non-swarmed bots to detect any missing/extra devices attached to
12them.
13
14This will be no longer needed when all bots are switched over to swarming.
15
16## Bots
17
18The list is usually located at:
19
20  - `~/.android/known_devices.json`.
21
22Look at recipes listed below in order to find more up to date location.
23
24## Local Runs
25
26The persistent device list is unnecessary for local runs. It is only used on the
27bots that upload data to the perf dashboard.
28
29## Where it is used
30
31The persistent device list is used in the
32[chromium_android](https://cs.chromium.org/chromium/build/scripts/slave/recipe_modules/chromium_android/api.py?q=known_devices_file)
33recipe module, and consumed by the
34[device_status.py](https://cs.chromium.org/chromium/src/third_party/catapult/devil/devil/android/tools/device_status.py?q=\-\-known%5C-devices%5C-file)
35script among others.
36