anaconda/anaconda-40.22.3.13/pyanaconda/modules/storage/devicetree/handler_interface.py

#
# DBus interface for the device tree handler
#
# Copyright (C) 2019 Red Hat, Inc.
#
# This copyrighted material is made available to anyone wishing to use,
# modify, copy, or redistribute it subject to the terms and conditions of
# the GNU General Public License v.2, or (at your option) any later version.
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY expressed or implied, including the implied warranties of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
# Public License for more details.  You should have received a copy of the
# GNU General Public License along with this program; if not, write to the
# Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
# 02110-1301, USA.  Any Red Hat trademarks that are incorporated in the
# source code or documentation are not subject to the GNU General Public
# License and may only be used or replicated with the express permission of
# Red Hat, Inc.
#
from dasbus.server.interface import dbus_interface
from pyanaconda.modules.common.base.base_template import InterfaceTemplate
from dasbus.typing import *  # pylint: disable=wildcard-import
from pyanaconda.modules.common.constants.interfaces import DEVICE_TREE_HANDLER
from pyanaconda.modules.common.containers import TaskContainer

__all__ = ["DeviceTreeHandlerInterface"]


@dbus_interface(DEVICE_TREE_HANDLER.interface_name)
class DeviceTreeHandlerInterface(InterfaceTemplate):
    """DBus interface for the device tree handler."""

    def MountDevice(self, device_name: Str, mount_point: Str, options: Str):
        """Mount a filesystem on the device.

        :param device_name: a name of the device
        :param mount_point: a path to the mount point
        :param options: a string with mount options or an empty string to use defaults
        :raise: MountFilesystemError if mount fails
        """
        self.implementation.mount_device(device_name, mount_point, options)

    def UnmountDevice(self, device_name: Str, mount_point: Str):
        """Unmount a filesystem on the device.

        :param device_name: a name of the device
        :param mount_point: a path to the mount point
        :raise: MountFilesystemError if unmount fails
        """
        self.implementation.unmount_device(device_name, mount_point)

    def UnlockDevice(self, device_name: Str, passphrase: Str) -> Bool:
        """Unlock a device.

        :param device_name: a name of the device
        :param passphrase: a passphrase
        :return: True if success, otherwise False
        """
        return self.implementation.unlock_device(device_name, passphrase)

    def FindUnconfiguredLUKS(self) -> List[Str]:
        """Find all unconfigured LUKS devices.

        Returns a list of devices that require to set up
        a passphrase to complete their configuration.

        :return: a list of device names
        """
        return self.implementation.find_unconfigured_luks()

    def SetDevicePassphrase(self, device_name: Str, passphrase: Str):
        """Set a passphrase of the unconfigured LUKS device.

        :param device_name: a name of the device
        :param passphrase: a passphrase
        """
        self.implementation.set_device_passphrase(device_name, passphrase)

    def GetDeviceMountOptions(self, device_name: Str) -> Str:
        """Get mount options of the specified device.

        :param device_name: a name of the device
        :return: a string with options
        """
        return self.implementation.get_device_mount_options(device_name)

    def SetDeviceMountOptions(self, device_name: Str, mount_options: Str):
        """Set mount options of the specified device.

        Specifies a free form string of options to be used when
        mounting the filesystem. This string will be copied into
        the /etc/fstab file of the installed system.

        :param device_name: a name of the device
        :param mount_options: a string with options
        """
        self.implementation.set_device_mount_options(device_name, mount_options)

    def FindDevicesWithTask(self) -> ObjPath:
        """Find new devices.

        The task will populate the device tree with new devices.

        :return: a path to the task
        """
        return TaskContainer.to_object_path(
            self.implementation.find_devices_with_task()
        )

    def FindOpticalMedia(self) -> List[Str]:
        """Find all devices with mountable optical media.

        :return: a list of device names
        """
        return self.implementation.find_optical_media()

    def FindMountablePartitions(self) -> List[Str]:
        """Find all mountable partitions.

        :return: a list of device names
        """
        return self.implementation.find_mountable_partitions()

    def FindExistingSystemsWithTask(self) -> ObjPath:
        """Find existing GNU/Linux installations.

        The task will update data about existing installations.

        :return: a path to the task
        """
        return TaskContainer.to_object_path(
            self.implementation.find_existing_systems_with_task()
        )

    def MountExistingSystemWithTask(self, device_name: Str, read_only: Bool) -> ObjPath:
        """Mount existing GNU/Linux installation.

        :param device_name: a name of the root device
        :param read_only: mount the system in read-only mode
        :return: a path to the task
        """
        return TaskContainer.to_object_path(
            self.implementation.mount_existing_system_with_task(device_name, read_only)
        )