volatility3/volatility3/framework/plugins/windows/ssdt.py

# 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
#

import os
from typing import Any, Iterator, List, Tuple

from volatility3.framework import constants, interfaces
from volatility3.framework import contexts
from volatility3.framework import exceptions, symbols
from volatility3.framework import renderers
from volatility3.framework.configuration import requirements
from volatility3.framework.interfaces import plugins
from volatility3.framework.renderers import format_hints
from volatility3.plugins.windows import modules


class SSDT(plugins.PluginInterface):
    """Lists the system call table."""

    _required_framework_version = (2, 0, 0)
    _version = (1, 0, 0)

    @classmethod
    def get_requirements(cls) -> List[interfaces.configuration.RequirementInterface]:
        return [
            requirements.ModuleRequirement(
                name="kernel",
                description="Windows kernel",
                architectures=["Intel32", "Intel64"],
            ),
            requirements.PluginRequirement(
                name="modules", plugin=modules.Modules, version=(2, 0, 0)
            ),
        ]

    @classmethod
    def build_module_collection(
        cls,
        context: interfaces.context.ContextInterface,
        layer_name: str,
        symbol_table: str,
    ) -> contexts.ModuleCollection:
        """Builds a collection of modules.

        Args:
            context: The context to retrieve required elements (layers, symbol tables) from
            layer_name: The name of the layer on which to operate
            symbol_table: The name of the table containing the kernel symbols

        Returns:
            A Module collection of available modules based on `Modules.list_modules`
        """

        mods = modules.Modules.list_modules(context, layer_name, symbol_table)
        context_modules = []

        for mod in mods:
            try:
                module_name_with_ext = mod.BaseDllName.get_string()
            except exceptions.InvalidAddressException:
                # there's no use for a module with no name?
                continue

            module_name = os.path.splitext(module_name_with_ext)[0]

            symbol_table_name = None
            if module_name in constants.windows.KERNEL_MODULE_NAMES:
                symbol_table_name = symbol_table

            context_module = contexts.SizedModule.create(
                context=context,
                module_name=module_name,
                layer_name=layer_name,
                offset=mod.DllBase,
                size=mod.SizeOfImage,
                symbol_table_name=symbol_table_name,
            )

            context_modules.append(context_module)

        return contexts.ModuleCollection(context_modules)

    def _generator(self) -> Iterator[Tuple[int, Tuple[int, int, Any, Any]]]:
        kernel = self.context.modules[self.config["kernel"]]

        layer_name = kernel.layer_name
        collection = self.build_module_collection(
            self.context, layer_name, kernel.symbol_table_name
        )

        kvo = self.context.layers[layer_name].config["kernel_virtual_offset"]
        ntkrnlmp = self.context.module(
            kernel.symbol_table_name, layer_name=layer_name, offset=kvo
        )

        # this is just one way to enumerate the native (NT) service table.
        # to do the same thing for the Win32K service table, we would need Win32K.sys symbol support
        ## we could also find nt!KeServiceDescriptorTable (NT) and KeServiceDescriptorTableShadow (NT, Win32K)
        service_table_address = ntkrnlmp.get_symbol("KiServiceTable").address
        service_limit_address = ntkrnlmp.get_symbol("KiServiceLimit").address
        service_limit = ntkrnlmp.object(object_type="int", offset=service_limit_address)

        # on 32-bit systems the table indexes are 32-bits and contain pointers (unsigned)
        # on 64-bit systems the indexes are also 32-bits but they're offsets from the
        # base address of the table and can be negative, so we need a signed data type
        is_kernel_64 = symbols.symbol_table_is_64bit(
            self.context, kernel.symbol_table_name
        )
        if is_kernel_64:
            array_subtype = "long"

            def kvo_calculator(func: int) -> int:
                return kvo + service_table_address + (func >> 4)

            find_address = kvo_calculator
        else:
            array_subtype = "unsigned long"

            def passthrough(func: int) -> int:
                return func

            find_address = passthrough

        functions = ntkrnlmp.object(
            object_type="array",
            offset=service_table_address,
            subtype=ntkrnlmp.get_type(array_subtype),
            count=service_limit,
        )

        for idx, function_obj in enumerate(functions):
            function = find_address(function_obj)
            module_symbols = collection.get_module_symbols_by_absolute_location(
                function
            )

            for module_name, symbol_generator in module_symbols:
                symbols_found = False

                for symbol in symbol_generator:
                    symbols_found = True
                    yield (
                        0,
                        (
                            idx,
                            format_hints.Hex(function),
                            module_name,
                            symbol.split(constants.BANG)[1],
                        ),
                    )

                if not symbols_found:
                    yield (
                        0,
                        (
                            idx,
                            format_hints.Hex(function),
                            module_name,
                            renderers.NotAvailableValue(),
                        ),
                    )

    def run(self) -> renderers.TreeGrid:
        return renderers.TreeGrid(
            [
                ("Index", int),
                ("Address", format_hints.Hex),
                ("Module", str),
                ("Symbol", str),
            ],
            self._generator(),
        )