core-admin-client/qubesadmin/exc.py
Marta Marczykowska-Górecka ad2a6e3408
Better information on error in qvm-remove
If qvm-remove fails because the VM is in use, it will display
information about where it is used.

fixes QubesOS/qubes-issues#3193
2018-07-20 00:21:47 +02:00

152 lines
4.3 KiB
Python

# -*- encoding: utf8 -*-
#
# The Qubes OS Project, http://www.qubes-os.org
#
# Copyright (C) 2017 Marek Marczykowski-Górecki
# <marmarek@invisiblethingslab.com>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation; either version 2.1 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License along
# with this program; if not, see <http://www.gnu.org/licenses/>.
'''Exception hierarchy.'''
class QubesException(Exception):
'''Base exception for all Qubes-related errors.'''
def __init__(self, message_format, *args, **kwargs):
# TODO: handle translations
super(QubesException, self).__init__(
message_format % tuple(int(d) if d.isdigit() else d for d in args),
**kwargs)
class QubesVMNotFoundError(QubesException, KeyError):
'''Domain cannot be found in the system'''
class QubesVMError(QubesException):
'''Some problem with domain state.'''
class QubesVMNotStartedError(QubesVMError):
'''Domain is not started.
This exception is thrown when machine is halted, but should be started
(that is, either running or paused).
'''
class QubesVMNotRunningError(QubesVMNotStartedError):
'''Domain is not running.
This exception is thrown when machine should be running but is either
halted or paused.
'''
class QubesVMNotPausedError(QubesVMNotStartedError):
'''Domain is not paused.
This exception is thrown when machine should be paused, but is not.
'''
class QubesVMNotSuspendedError(QubesVMError):
'''Domain is not suspended.
This exception is thrown when machine should be suspended but is either
halted or running.
'''
class QubesVMNotHaltedError(QubesVMError):
'''Domain is not halted.
This exception is thrown when machine should be halted, but is not (either
running or paused).
'''
class QubesVMShutdownTimeout(QubesVMError):
''' Domain shutdown haven't completed in expected timeframe'''
class QubesNoTemplateError(QubesVMError):
'''Cannot start domain, because there is no template'''
class QubesVMInUseError(QubesVMError):
'''VM is in use, cannot remove.'''
class QubesValueError(QubesException, ValueError):
'''Cannot set some value, because it is invalid, out of bounds, etc.'''
pass
class QubesPropertyValueError(QubesValueError):
'''Cannot set value of qubes.property, because user-supplied value is wrong.
'''
class QubesNoSuchPropertyError(QubesException, AttributeError):
'''Requested property does not exist
'''
class QubesNotImplementedError(QubesException, NotImplementedError):
'''Thrown at user when some feature is not implemented'''
class BackupCancelledError(QubesException):
'''Thrown at user when backup was manually cancelled'''
class QubesMemoryError(QubesException, MemoryError):
'''Cannot start domain, because not enough memory is available'''
class QubesFeatureNotFoundError(QubesException, KeyError):
'''Feature not set for a given domain'''
class QubesTagNotFoundError(QubesException, KeyError):
'''Tag not set for a given domain'''
class StoragePoolException(QubesException):
''' A general storage exception '''
class QubesDaemonCommunicationError(QubesException, IOError):
'''Error while communicating with qubesd, may mean insufficient
permissions as well'''
class DeviceAlreadyAttached(QubesException, KeyError):
'''Trying to attach already attached device'''
pass
# pylint: disable=too-many-ancestors
class QubesDaemonNoResponseError(QubesDaemonCommunicationError):
'''Got empty response from qubesd'''
class QubesPropertyAccessError(QubesException, AttributeError):
'''Failed to read/write property value, cause is unknown (insufficient
permissions, no such property, invalid value, other)'''
def __init__(self, prop):
super(QubesPropertyAccessError, self).__init__(
'Failed to access \'%s\' property' % prop)