Skip to content

Commit 0b4d083

Browse files
Update README.md
1 parent 42b22a7 commit 0b4d083

1 file changed

Lines changed: 6 additions & 9 deletions

File tree

README.md

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@ tl;dr: an open-source version of `% sfltool dumpbtm`
33

44
```
55
% ./dumpBTM
6-
dumpBTM v0.95
7-
Dumps (unserializes) BackgroundItems-v4.btm
8-
Opened /private/var/db/com.apple.backgroundtaskmanagement/BackgroundItems-v4.btm
6+
Dumps (unserializes) BackgroundItems-v*.btm
7+
8+
Opened /private/var/db/com.apple.backgroundtaskmanagement/BackgroundItems-v7.btm
9+
...
910
1011
========================
1112
Records for UID 501 : 1CAA5D2B-A526-49E2-9A6F-58CACBDF0AFB
@@ -39,7 +40,7 @@ Opened /private/var/db/com.apple.backgroundtaskmanagement/BackgroundItems-v4.btm
3940
Parent Identifier: Adobe Creative Cloud
4041
```
4142

42-
Note: If you're running the pre-built binary, though signed, it's not notarized (Apple doesn't support notarized commandline tools). So, after making it executable, remove the quarantine attributue to make it runnable (via Terminal).
43+
Note: If you're running the pre-built binary, though signed, it's not notarized (Apple doesn't support notarized commandline tools). So after making it executable, remove the quarantine attributue to make it runnable (via Terminal).
4344

4445
```
4546
% chmod +x dumpBTM
@@ -48,7 +49,7 @@ Note: If you're running the pre-built binary, though signed, it's not notarized
4849

4950
Also, make sure you give Terminal "Full Disk Access" (a requirment to read the `BackgroundItems-v4.btm` file).
5051

51-
In macOS Ventura (13), Apple consolidated persistent items (login items, launch agents/daemons) in a new file: `BackgroundItems-v4.btm` (found in `/private/var/db/com.apple.backgroundtaskmanagement/`).
52+
In macOS Ventura (13), Apple consolidated persistent items (login items, launch agents/daemons) in a new file: `BackgroundItems-v*.btm`, found in `/private/var/db/com.apple.backgroundtaskmanagement/`. On macOS 13.0 this file is named `BackgroundItems-v*.btm` whereas on macOS 13.1 it's `BackgroundItems-v7.btm`.
5253

5354
This file is a serialized binary propertly list. You can dump it via Apple's `sfltool`, specifying the `dumpbtm` command line flag.
5455

@@ -62,7 +63,3 @@ The latter point is most notable as this allow you to now add such logic into se
6263
You can also then monitor this file for changes to detect new persistence events (as now you can parse/unserialize its contents via this project's code).
6364

6465
Note: Such monitoring was supposed to be accomplished via the Endpoint Security `ES_EVENT_TYPE_NOTIFY_BTM_LAUNCH_ITEM_ADD` event ...but this event is broken (See: "[Endpoint Security Event: ES_EVENT_TYPE_NOTIFY_BTM_LAUNCH_ITEM_ADD is ...broken?](https://developer.apple.com/forums/thread/720468)" 😓).
65-
66-
67-
68-

0 commit comments

Comments
 (0)