Skip to content

Commit 660ebf4

Browse files
roareetesitura
andauthored
Expand explanations of data collected (#45)
* Expand explanations of data collected * Update README.md Co-authored-by: tes <tesitura@users.noreply.github.com> --------- Co-authored-by: tes <tesitura@users.noreply.github.com>
1 parent f7642bf commit 660ebf4

File tree

1 file changed

+55
-11
lines changed

1 file changed

+55
-11
lines changed

README.md

Lines changed: 55 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -40,17 +40,61 @@ Now androidqf should be executing and creating an acquisition folder at the same
4040

4141
The following data can be extracted:
4242

43-
1. (Optional) A full backup or backup of SMS and MMS messages.
44-
2. The output of the getprop shell command, providing build information and configuration parameters.
45-
3. All system settings.
46-
4. The output of the ps shell command, providing a list of all running processes.
47-
5. The list of system's services.
48-
6. A copy of all the logs from the system.
49-
7. The output of the dumpsys shell command, providing diagnostic information about the device.
50-
8. A list of all packages installed and related distribution files.
51-
9. (Optional) Copy of all installed APKs or of only those not marked as system apps.
52-
10. A list of files on the system.
53-
11. A copy of the files available in temp folders.
43+
| Data | Optional? | Output path(s) |
44+
|------|-----------|----------------|
45+
| A full backup or backup of SMS and MMS messages. | :white_check_mark: | `backup.ab` |
46+
| The output of the getprop shell command, providing build information and configuration parameters. | | `getprop.txt` |
47+
| All system settings | | `settings_*.txt` |
48+
| The output of the ps shell command, providing a list of all running processes. | | `processes.txt` |
49+
| The list of system's services. | | `services.txt` |
50+
| A copy of all the logs from the system. | | `logs/`, `logcat.txt` |
51+
| The output of the dumpsys shell command, providing diagnostic information about the device. | | `dumpsys.txt` |
52+
| A list of all packages installed and related distribution files. | | `packages.json` |
53+
| Copy of all installed APKs or of only those not marked as system apps. || `apks/*` |
54+
| A list of files on the system. | | `files.json` |
55+
| A copy of the files available in temp folders. | | `tmp/*` |
56+
| A bug report containing system and app-specific logs, with no private data included. | | `bugreport.zip` |
57+
58+
### About optional data collection
59+
60+
#### Backup
61+
62+
The following options are presented when running an androidqf collection:
63+
64+
```
65+
Would you like to take a backup of the device?
66+
...
67+
? Backup:
68+
▸ Only SMS
69+
Everything
70+
No backup
71+
```
72+
73+
These options refers to data collected from the device by running the `adb backup` command in the background. If `No backup` is selected, the `adb backup` command is not run.
74+
75+
| Option | Explanation |
76+
|--------|-------------|
77+
| Only SMS | `adb backup com.android.providers.telephony` is run. Only data from `com.android.providers.telephony` is collected. This includes the SMS database. |
78+
| Everything | `adb backup -all` is run. This requests backups of only apps that have explicitly allowed backups of their data via this method. Since Android 12+, this method doesn’t extract anything for almost all apps.|
79+
| No backup | `adb backup` is not run |
80+
81+
### Downloading copies of apps
82+
83+
```
84+
Would you like to download copies of all apps or only non-system ones?
85+
86+
? Download:
87+
▸ All
88+
Only non-system packages
89+
Do not download any
90+
```
91+
92+
| Option | Explanation |
93+
|--------|-------------|
94+
| All | All installed packages will be retrieved from the phone |
95+
| Only non-system packages | Don't download any packages listed in `adb pm list packages -s` |
96+
| Do not download any | Don't download any packages |
97+
5498

5599
## Encryption & Potential Threats
56100

0 commit comments

Comments
 (0)