You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+6-9Lines changed: 6 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,9 +3,10 @@ tl;dr: an open-source version of `% sfltool dumpbtm`
3
3
4
4
```
5
5
% ./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
+
...
9
10
10
11
========================
11
12
Records for UID 501 : 1CAA5D2B-A526-49E2-9A6F-58CACBDF0AFB
@@ -39,7 +40,7 @@ Opened /private/var/db/com.apple.backgroundtaskmanagement/BackgroundItems-v4.btm
39
40
Parent Identifier: Adobe Creative Cloud
40
41
```
41
42
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).
43
44
44
45
```
45
46
% chmod +x dumpBTM
@@ -48,7 +49,7 @@ Note: If you're running the pre-built binary, though signed, it's not notarized
48
49
49
50
Also, make sure you give Terminal "Full Disk Access" (a requirment to read the `BackgroundItems-v4.btm` file).
50
51
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`.
52
53
53
54
This file is a serialized binary propertly list. You can dump it via Apple's `sfltool`, specifying the `dumpbtm` command line flag.
54
55
@@ -62,7 +63,3 @@ The latter point is most notable as this allow you to now add such logic into se
62
63
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).
63
64
64
65
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)" 😓).
0 commit comments