# This file is Copyright 2019 Volatility Foundation and licensed under the Volatility Software License 1.0
# which is available at https://www.volatilityfoundation.org/license/vsl-v1.0
#
from volatility3.framework import renderers
from volatility3.framework.configuration import requirements
from volatility3.framework.interfaces import plugins
from volatility3.framework.objects import utility
from volatility3.plugins.mac import pslist
[docs]class PsTree(plugins.PluginInterface):
"""Plugin for listing processes in a tree based on their parent process
ID."""
_required_framework_version = (2, 0, 0)
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self._processes = {}
self._levels = {}
self._children = {}
[docs] @classmethod
def get_requirements(cls):
return [
requirements.ModuleRequirement(
name="kernel",
description="Kernel module for the OS",
architectures=["Intel32", "Intel64"],
),
requirements.PluginRequirement(
name="pslist", plugin=pslist.PsList, version=(3, 0, 0)
),
]
def _find_level(self, pid):
"""Finds how deep the pid is in the processes list."""
seen = set([])
seen.add(pid)
level = 0
proc = self._processes.get(pid, None)
while (
proc is not None
and proc.vol.offset != 0
and proc.p_ppid != 0
and proc.p_ppid not in seen
):
ppid = int(proc.p_ppid)
child_list = self._children.get(ppid, set([]))
child_list.add(proc.p_pid)
self._children[ppid] = child_list
proc = self._processes.get(ppid, None)
level += 1
self._levels[pid] = level
def _generator(self):
"""Generates the tree list of processes"""
list_tasks = pslist.PsList.get_list_tasks(
self.config.get("pslist_method", pslist.PsList.pslist_methods[0])
)
for proc in list_tasks(self.context, self.config["kernel"]):
self._processes[proc.p_pid] = proc
# Build the child/level maps
for pid in self._processes:
self._find_level(pid)
def yield_processes(pid):
proc = self._processes[pid]
row = (proc.p_pid, proc.p_ppid, utility.array_to_string(proc.p_comm))
yield (self._levels[pid] - 1, row)
for child_pid in self._children.get(pid, []):
yield from yield_processes(child_pid)
for pid in self._levels:
if self._levels[pid] == 1:
yield from yield_processes(pid)
[docs] def run(self):
return renderers.TreeGrid(
[("PID", int), ("PPID", int), ("COMM", str)], self._generator()
)