Add mac_vfsevents

2026-09-13 21:27:39 +02:00 · 2020-10-24 23:12:10 +01:00
parent 13ad03f49e
commit 1c709aa09c
1 changed files with 76 additions and 0 deletions
@@ -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())