mirror of
https://github.com/volatilityfoundation/volatility3.git
synced 2026-08-17 20:35:40 +02:00
97 lines
3.4 KiB
Python
97 lines
3.4 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 InvalidDataException(VolatilityException):
|
|
"""Thrown when an object contains some data known to be invalid for that structure"""
|
|
|
|
def __init__(self, invalid_object: object, *args) -> None:
|
|
super().__init__(invalid_object, *args)
|
|
self._invalid_object = invalid_object
|
|
|
|
|
|
class SymbolSpaceError(VolatilityException):
|
|
"""Thrown when an error occurs dealing with Symbols and Symbolspaces"""
|
|
|
|
|
|
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 StructureException(VolatilityException):
|
|
"""Thrown when an error occurs dealing with an expected structure type"""
|
|
|
|
|
|
class MissingStructureException(VolatilityException):
|
|
"""Thrown when an error occurs due to an expected structure not being present"""
|
|
|
|
|
|
class UnsatisfiedException(VolatilityException):
|
|
|
|
def __init__(self, unsatisfied: Dict[str, interfaces.configuration.RequirementInterface]) -> None:
|
|
super().__init__()
|
|
self.unsatisfied = unsatisfied
|