mirror of
https://github.com/volatilityfoundation/volatility3.git
synced 2026-08-23 06:42:21 +02:00
66 lines
2.4 KiB
Python
66 lines
2.4 KiB
Python
'''
|
|
Created on 6 May 2013
|
|
|
|
@author: mike
|
|
'''
|
|
|
|
import copy
|
|
from volatility.framework import validity
|
|
from volatility.framework.interfaces import context as context_module
|
|
|
|
class ObjectInterface(validity.ValidityRoutines):
|
|
""" A base object required to be the ancestor of every object used in volatility """
|
|
def __init__(self, context, layer_name, offset, structure_name, size, parent = None):
|
|
# Since objects are likely to be instantiated often,
|
|
# we're only checking that a context is a context
|
|
# Everything else may be wrong, but that will get caught later on
|
|
self._context = self.type_check(context, context_module.ContextInterface)
|
|
self._parent = None if not parent else self.type_check(parent, ObjectInterface)
|
|
self._offset = offset
|
|
self._layer_name = layer_name
|
|
self._structure_name = structure_name
|
|
self._size = size
|
|
|
|
def write(self, value):
|
|
"""Writes the new value into the format at the offset the object currently resides at"""
|
|
|
|
def cast(self, new_structure_name):
|
|
"""Returns a new object at the offset and from the layer that the current object inhabits"""
|
|
object_template = self._context.symbol_space.resolve(new_structure_name)
|
|
return object_template(context = self._context, layer_name = self._layer_name, offset = self._offset)
|
|
|
|
class Template(object):
|
|
"""Class for all Factories that take offsets, and data layers and produce objects
|
|
|
|
This is effectively a class for currying object calls
|
|
"""
|
|
def __init__(self, structure_name: str = None, **kwargs):
|
|
"""Stores the keyword arguments for later use"""
|
|
self._kwargs = kwargs
|
|
self._structure_name = structure_name
|
|
|
|
@property
|
|
def structure_name(self):
|
|
"""Returns the name of the particular symbol"""
|
|
return self._structure_name
|
|
|
|
@property
|
|
def arguments(self):
|
|
"""Returns the keyword arguments stored earlier"""
|
|
return copy.deepcopy(self._kwargs)
|
|
|
|
def update_arguments(self, **newargs):
|
|
"""Updates the keyword arguments"""
|
|
self._kwargs.update(newargs)
|
|
|
|
def __call__(self, context: context_module.ContextInterface, layer_name: str, offset: int, parent: ObjectInterface = None):
|
|
"""Constructs the object
|
|
|
|
:param context:
|
|
:param layer_name:
|
|
:param offset:
|
|
:param parent:
|
|
|
|
:return O Returns: an object adhereing to the Object interface
|
|
"""
|