""" Created on 7 May 2013 @author: mike """ from volatility.framework.interfaces.configuration import GenericRequirement # Intentionally reimport namespace_join so it's accessible from the main config module class InstanceRequirement(GenericRequirement): instance_type = bool def validate_input(self, value, context): if not isinstance(value, self.instance_type): raise TypeError(self.name + " input only accepts " + self.instance_type.__name__ + " type") class IntRequirement(InstanceRequirement): instance_type = int class StringRequirement(InstanceRequirement): # TODO: Maybe add string length limits? instance_type = str class TranslationLayerRequirement(GenericRequirement): """Class maintaining the limitations on what sort of address spaces are acceptable""" # TODO: derive acceptable OSes from the address_space information # TODO: derive acceptable arches from the available layers def __init__(self, name, layer_type, os_type, architectures, *args, **kwargs): GenericRequirement.__init__(self, name, *args, **kwargs) self.layer_type = layer_type self.os = os_type self.arches = architectures def validate_input(self, value, context): """Validate that the value is a valid layer name and that the layer adheres to the requirements""" if value not in context.memory: raise IndexError((value or "") + " is not a memory layer") class ChoiceRequirement(GenericRequirement): """Allows one from a choice of strings """ def __init__(self, choices, *args, **kwargs): GenericRequirement.__init__(self, *args, **kwargs) if not isinstance(choices, list) or any([not isinstance(choice, str) for choice in choices]): raise TypeError("ChoiceRequirement takes a list of strings as choices") self._choices = choices def validate_input(self, value, context): """Validates the provided value to ensure it is one of the available choices""" if value not in self._choices: raise ValueError("Value is not within the set of available choices") class ListRequirement(GenericRequirement): def __init__(self, min_elements, max_elements, element_type, *args, **kwargs): GenericRequirement.__init__(self, *args, **kwargs) if isinstance(element_type, ListRequirement): raise TypeError("ListRequirements cannot contain ListRequirements") self.element_type = self._type_check(element_type, GenericRequirement) self.min_elements = min_elements self.max_elements = max_elements def validate_input(self, value, context): """Check the types on each of the returned values and then call the element type's check for each one""" self._type_check(value, list) if not all([self._type_check(element, self.element_type) for element in value]): raise TypeError("At least one element in the list is not of the correct type.") if not (self.min_elements <= len(value) <= self.max_elements): raise TypeError("List option provided more or less elements than allowed.") [self.element_type.validate_input(element, context) for element in value]