:py:mod:`dissect.target.exceptions`
===================================

.. py:module:: dissect.target.exceptions




Module Contents
---------------

.. py:exception:: Error(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Exception`


   Generic dissect.target error.


   .. py:attribute:: __extra__
      :value: None



.. py:exception:: FatalError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   An error occurred that cannot be resolved.


   .. py:method:: emit_last_message(emitter: collections.abc.Callable) -> None


.. py:exception:: TargetError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A target error occurred.


.. py:exception:: LoaderError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A loader error occurred.


.. py:exception:: PluginError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A plugin error occurred.


.. py:exception:: ContainerError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A container error occurred.


.. py:exception:: VolumeSystemError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A volume system error occurred.


.. py:exception:: FilesystemError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A filesystem error occurred.


.. py:exception:: InvalidTaskError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A invalid XML file.


.. py:exception:: RegistryKeyNotFoundException(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   The registry was not found.


.. py:exception:: UnsupportedPluginError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`PluginError`


   The requested plugin is not supported by the target.


   .. py:method:: root_cause_str() -> str

      Often with this type of Error, the root cause is more descriptive for the user.



.. py:exception:: PluginNotFoundError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`PluginError`


   Plugin cannot be found.


.. py:exception:: FileNotFoundError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`FilesystemError`, :py:obj:`FileNotFoundError`


   The requested path could not be found.


   .. py:attribute:: errno
      :value: 2


      POSIX exception code


.. py:exception:: IsADirectoryError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`FilesystemError`, :py:obj:`IsADirectoryError`


   The entry is a directory.


   .. py:attribute:: errno
      :value: 21


      POSIX exception code


.. py:exception:: NotADirectoryError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`FilesystemError`, :py:obj:`NotADirectoryError`


   The entry is not a directory.


   .. py:attribute:: errno
      :value: 20


      POSIX exception code


.. py:exception:: NotASymlinkError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`FilesystemError`


   The entry is not a symlink.


   .. py:attribute:: errno
      :value: 22



.. py:exception:: SymlinkRecursionError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`FilesystemError`


   A symlink loop is detected for the entry.


   .. py:attribute:: errno
      :value: 40



.. py:exception:: RegistryError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   A registry error occurred.


.. py:exception:: RegistryKeyNotFoundError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`RegistryError`


   The requested registry key could not be found.


.. py:exception:: RegistryValueNotFoundError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`RegistryError`


   The requested registry value could not be found.


.. py:exception:: HiveUnavailableError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`RegistryError`


   The requested hive is unavailable.


.. py:exception:: RegistryCorruptError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`RegistryError`


   The registry is corrupt.


.. py:exception:: ConfigurationParsingError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`Error`


   An error occurred during configuration parsing.


.. py:exception:: TargetPathNotFoundError(message: str | None = None, extra: list[Exception] | None = None)

   Bases: :py:obj:`TargetError`


   The path to the target does not exist.