From 1c709aa09c1ce14fc1f88c5423f0fef8ff56ae06 Mon Sep 17 00:00:00 2001
From: Andrew Case <acase@volexity.com>
Date: Wed, 21 Oct 2020 18:37:03 -0500
Subject: [PATCH] Add mac_vfsevents

---
 volatility/framework/plugins/mac/vfsevents.py | 76 +++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 volatility/framework/plugins/mac/vfsevents.py

diff --git a/volatility/framework/plugins/mac/vfsevents.py b/volatility/framework/plugins/mac/vfsevents.py
new file mode 100644
index 000000000..05ddaff21
--- /dev/null
+++ b/volatility/framework/plugins/mac/vfsevents.py
@@ -0,0 +1,76 @@
+# This file is opyright 2020 Volatility Foundation and licensed under the Volatility Software License 1.0
+# which is available at https://www.volatilityfoundation.org/license/vsl-v1.0
+#
+
+import logging
+
+from typing import Iterable, Callable, Tuple
+
+from volatility.framework import renderers, interfaces, constants, exceptions, contexts
+from volatility.framework.configuration import requirements
+from volatility.framework.objects import utility
+
+class VFSevents(interfaces.plugins.PluginInterface):
+    """ Lists processes that are filtering file system events """ 
+
+    event_types = ["CREATE_FILE", 
+                   "DELETE", 
+                   "STAT_CHANGED", 
+                   "RENAME", 
+                   "CONTENT_MODIFIED", 
+                   "EXCHANGE", 
+                   "FINDER_INFO_CHANGED", 
+                   "CREATE_DIR", 
+                   "CHOWN",
+                   "XATTR_MODIFIED", 
+                   "XATTR_REMOVED", 
+                   "DOCID_CREATED", 
+                   "DOCID_CHANGED"]
+
+    @classmethod
+    def get_requirements(cls):
+        return [
+            requirements.TranslationLayerRequirement(name = 'primary',
+                                                     description = 'Memory layer for the kernel',
+                                                     architectures = ["Intel32", "Intel64"]),
+            requirements.SymbolTableRequirement(name = "darwin", description = "Mac kernel"),
+        ]
+
+    def _generator(self):
+        """
+        Lists the registered VFS event watching processes
+        Also lists which event(s) a process is registered for
+        """
+
+        kernel = contexts.Module(self.context, self.config['darwin'], self.config['primary'], 0)
+    
+        watcher_table = kernel.object_from_symbol("watcher_table")
+
+        for watcher in watcher_table:
+            if watcher == 0:
+                continue
+    
+            task_name = utility.array_to_string(watcher.proc_name)
+            task_pid = watcher.pid
+
+            events = []
+
+            try:
+                event_array = kernel.object(object_type = "array",
+                                  offset = watcher.event_list,
+                                  count = 13,
+                                  subtype = kernel.get_type("unsigned char"))
+            
+            except exceptions.InvalidAddressException:
+                continue
+
+            for i, event in enumerate(event_array):
+                if event == 1:
+                    events.append(self.event_types[i])
+
+            if events != []:
+                yield (0, (task_name, task_pid, ",".join(events)))
+
+    def run(self):
+        return renderers.TreeGrid([("Name", str), ("PID", int), ("Events", str)], 
+                                  self._generator())