mirror of
https://github.com/volatilityfoundation/volatility3.git
synced 2026-08-21 05:52:22 +02:00
Mike Auty
dfcbd78a8a
With agreement from @attrc and @imhlv2, I'm removing the useless validate method from the object. It defaulted to returning inaccurate information (validity undetermined, but validate returned True as if validation had happened) and is better handled by individual classes implementing is_valid (which seems the preferred nomenclature) and throwing exceptions if it's called on a class that doesn't have it.
87 lines
2.9 KiB
Python
87 lines
2.9 KiB
Python
# 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
|
|
#
|
|
"""A list of potential exceptions that volatility can throw.
|
|
|
|
These include exceptions that can be thrown on errors by the symbol
|
|
space or symbol tables, and by layers when an address is invalid. The
|
|
:class:`PagedInvalidAddressException` contains information about the
|
|
size of the invalid page.
|
|
"""
|
|
from typing import Dict
|
|
|
|
from volatility.framework import interfaces
|
|
|
|
|
|
class VolatilityException(Exception):
|
|
"""Class to allow filtering of all VolatilityExceptions."""
|
|
|
|
|
|
class PluginVersionException(VolatilityException):
|
|
"""Class to allow determining that a required plugin has an invalid
|
|
version."""
|
|
|
|
|
|
class PluginRequirementException(VolatilityException):
|
|
"""Class to allow plugins to indicate that a requirement has not been
|
|
fulfilled."""
|
|
|
|
|
|
class SymbolError(VolatilityException):
|
|
"""Thrown when a symbol lookup has failed."""
|
|
|
|
|
|
class InvalidAddressException(VolatilityException):
|
|
"""Thrown when an address is not valid in the space it was requested."""
|
|
|
|
def __init__(self, layer_name: str, invalid_address: int, *args) -> None:
|
|
super().__init__(*args)
|
|
self.invalid_address = invalid_address
|
|
self.layer_name = layer_name
|
|
|
|
|
|
class PagedInvalidAddressException(InvalidAddressException):
|
|
"""Thrown when an address is not valid in the paged space in which it was
|
|
request.
|
|
|
|
Includes the invalid address and the number of bits of the address
|
|
that are invalid
|
|
"""
|
|
|
|
def __init__(self, layer_name: str, invalid_address: int, invalid_bits: int, entry: int, *args) -> None:
|
|
super().__init__(layer_name, invalid_address, *args)
|
|
self.invalid_bits = invalid_bits
|
|
self.entry = entry
|
|
|
|
|
|
class SwappedInvalidAddressException(PagedInvalidAddressException):
|
|
"""Thrown when an address is not valid in the paged space in which it was
|
|
requested, but expected to be in swap space.
|
|
|
|
Includes the swap lookup
|
|
"""
|
|
|
|
def __init__(self, layer_name: str, invalid_address: int, invalid_bits: int, entry: int, swap_offset: int,
|
|
*args) -> None:
|
|
super().__init__(layer_name, invalid_address, invalid_bits, entry, *args)
|
|
self.swap_offset = swap_offset
|
|
|
|
|
|
class SymbolSpaceError(VolatilityException):
|
|
"""Thrown when an error occurs dealing with Symbolspaces and SymbolTables."""
|
|
|
|
|
|
class LayerException(VolatilityException):
|
|
"""Thrown when an error occurs dealing with memory and layers."""
|
|
|
|
def __init__(self, layer_name: str, *args) -> None:
|
|
super().__init__(*args)
|
|
self.layer_name = layer_name
|
|
|
|
|
|
class UnsatisfiedException(VolatilityException):
|
|
|
|
def __init__(self, unsatisfied: Dict[str, interfaces.configuration.RequirementInterface]) -> None:
|
|
super().__init__()
|
|
self.unsatisfied = unsatisfied
|