move out Tainting capabilities

volatility3/framework/symbols/linux/__init__.py

@@ -11,7 +11,6 @@ from volatility3.framework import constants, exceptions, interfaces, objects
 from volatility3.framework.objects import utility
 from volatility3.framework.symbols import intermed
 from volatility3.framework.symbols.linux import extensions
-from volatility3.framework.constants import linux as linux_constants
 
 
 class LinuxKernelIntermedSymbols(intermed.IntermediateSymbolTable):
@@ -831,123 +830,3 @@ class PageCache:
             page = self.vmlinux.object("page", offset=page_addr, absolute=True)
             if page:
                 yield page
-
-
-class Tainting:
-    """Tainted kernel and modules parsing capabilities.
-
-    Relevant kernel functions:
-        - modules: module_flags_taint
-        - kernel: print_tainted
-    """
-
-    def __init__(
-        self,
-        context: interfaces.context.ContextInterface,
-        kernel_module_name: str,
-    ):
-        self.kernel = context.modules[kernel_module_name]
-
-    @property
-    def kernel_taint_flags_list(
-        self,
-    ) -> Optional[List[interfaces.objects.ObjectInterface]]:
-        if self.kernel.has_symbol("taint_flags"):
-            return list(self.kernel.object_from_symbol("taint_flags"))
-        return None
-
-    def _module_flags_taint_pre_4_10_rc1(
-        self, taints: int, is_module: bool = False
-    ) -> str:
-        """Convert the module's taints value to a 1-1 character mapping.
-        Relies on statically defined taints mappings in the framework.
-
-        Args:
-            taints: The taints value, represented by an integer
-            is_module: Indicates if the taints value is associated with a built-in/LKM module
-
-        Returns:
-            The raw taints string.
-        """
-        taints_string = ""
-        for char, taint_flag in linux_constants.TAINT_FLAGS.items():
-            if is_module and is_module != taint_flag.module:
-                continue
-
-            if taints & taint_flag.shift:
-                taints_string += char
-
-        return taints_string
-
-    def _module_flags_taint_post_4_10_rc1(
-        self, taints: int, is_module: bool = False
-    ) -> str:
-        """Convert the module's taints value to a 1-1 character mapping.
-        Relies on kernel symbol embedded taints definitions.
-
-            struct taint_flag {
-                char c_true;		/* character printed when tainted */
-                char c_false;		/* character printed when not tainted */
-                bool module;		/* also show as a per-module taint flag */
-            };
-
-        Args:
-            taints: The taints value, represented by an integer
-            is_module: Indicates if the taints value is associated with a built-in/LKM module
-
-        Returns:
-            The raw taints string.
-        """
-        taints_string = ""
-        for i, taint_flag in enumerate(self.kernel_taint_flags_list):
-            if is_module and is_module != taint_flag.module:
-                continue
-            c_true = chr(taint_flag.c_true)
-            c_false = chr(taint_flag.c_false)
-            if taints & (1 << i):
-                taints_string += c_true
-            elif c_false != " ":
-                taints_string += c_false
-
-        return taints_string
-
-    def get_taints_as_plain_string(self, taints: int, is_module: bool = False) -> str:
-        """Convert the taints value to a 1-1 character mapping.
-
-        Args:
-            taints: The taints value, represented by an integer
-            is_module: Indicates if the taints value is associated with a built-in/LKM module
-            s
-        Returns:
-            The raw taints string.
-
-        Documentation:
-            - module_flags_taint kernel function
-        """
-
-        if self.kernel_taint_flags_list:
-            return self._module_flags_taint_post_4_10_rc1(taints, is_module)
-        return self._module_flags_taint_pre_4_10_rc1(taints, is_module)
-
-    def get_taints_parsed(self, taints: int, is_module: bool = False) -> List[str]:
-        """Convert the taints string to a 1-1 descriptor mapping.
-
-        Args:
-            taints: The taints value, represented by an integer
-            is_module: Indicates if the taints value is associated with a built-in/LKM module
-
-        Returns:
-            A comprehensive (user-friendly) taint descriptor list.
-
-        Documentation:
-            - module_flags_taint kernel function
-        """
-        comprehensive_taints = []
-        for character in self.get_taints_as_plain_string(taints, is_module):
-            taint_flag = linux_constants.TAINT_FLAGS.get(character)
-            if not taint_flag:
-                comprehensive_taints.append(f"<UNKNOWN_TAINT_CHAR_{character}>")
-            elif taint_flag.when_present:
-                comprehensive_taints.append(taint_flag.desc)
-
-        return comprehensive_taints