summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTao Bao <tbao@google.com>2019-09-28 02:30:45 +0200
committerandroid-build-merger <android-build-merger@google.com>2019-09-28 02:30:45 +0200
commit586fed8db28f28f865f95d742c4ce893c381e12e (patch)
tree27a692480ab326c53072a5205c4755c9523e0737
parentMerge "minadbd: Export minadbd/types.h to libinstall." am: ffa9ffbd2b (diff)
parentMerge "minadbd: Update README.md." (diff)
downloadandroid_bootable_recovery-586fed8db28f28f865f95d742c4ce893c381e12e.tar
android_bootable_recovery-586fed8db28f28f865f95d742c4ce893c381e12e.tar.gz
android_bootable_recovery-586fed8db28f28f865f95d742c4ce893c381e12e.tar.bz2
android_bootable_recovery-586fed8db28f28f865f95d742c4ce893c381e12e.tar.lz
android_bootable_recovery-586fed8db28f28f865f95d742c4ce893c381e12e.tar.xz
android_bootable_recovery-586fed8db28f28f865f95d742c4ce893c381e12e.tar.zst
android_bootable_recovery-586fed8db28f28f865f95d742c4ce893c381e12e.zip
-rw-r--r--minadbd/README.md32
1 files changed, 24 insertions, 8 deletions
diff --git a/minadbd/README.md b/minadbd/README.md
index 5a0a067de..9a1958309 100644
--- a/minadbd/README.md
+++ b/minadbd/README.md
@@ -1,8 +1,24 @@
-minadbd is now mostly built from libadbd. The fuse features are unique to
-minadbd, and services.c has been modified as follows:
-
- - all services removed
- - all host mode support removed
- - `sideload_service()` added; this is the only service supported. It
- receives a single blob of data, writes it to a fixed filename, and
- makes the process exit.
+minadbd
+=======
+
+`minadbd` is analogous to the regular `adbd`, but providing the minimal services to support
+recovery-specific use cases. Generally speaking, `adbd` = `libadbd` + `libadbd_services`, whereas
+`minadbd` = `libadbd` + `libminadbd_services`.
+
+Although both modules may be installed into the recovery image, only one of them, or none, can be
+active at any given time.
+
+- The start / stop of `adbd` is managed via system property `sys.usb.config`, when setting to `adb`
+ or `none` respectively. Upon starting recovery mode, `adbd` is started in debuggable builds by
+ default; otherwise `adbd` will stay off at all times in user builds. See the triggers in
+ `bootable/recovery/etc/init.rc`.
+
+- `minadbd` is started by `recovery` as needed.
+ - When requested to start `minadbd`, `recovery` stops `adbd` first, if it's running; it then forks
+ and execs `minadbd` in a separate process.
+ - `minadbd` talks to host-side `adb` server to get user requests.
+ - `minadbd` handles some requests directly, e.g. querying device properties for rescue service.
+ - `minadbd` communicates with `recovery` to fulfill requests regarding package installation. See
+ the comments in `bootable/recovery/install/adb_install.cpp` for the IPC protocol between
+ `recovery` and `minadbd`.
+ - Upon exiting `minadbd`, `recovery` restarts `adbd` if it was previously running.