Library for managing partitions. Common code for KDE Partition Manager and other projects. https://www.kde.org/applications/system/kdepartitionmanager/
Перейти к файлу
Andrius Štikonas 83a865411d ExternalCommandHelper::ReadData should not follow symlinks.
Resolve all symlinks in the userspace application and make sure
that helper only deals with root owned path in /dev but not in
/dev/shm.
2022-06-20 00:03:18 +01:00
.reuse Only run partitioning commands from trusted prefixes. 2022-03-20 21:07:17 +00:00
LICENSES REUSE: licensing information for misc files. 2020-10-01 00:51:30 +01:00
src ExternalCommandHelper::ReadData should not follow symlinks. 2022-06-20 00:03:18 +01:00
test Tests: Fix backend loading for tests 2022-06-12 16:14:51 -05:00
.gitignore SPDX: Use CC0 for .gitignore. 2020-10-05 22:00:33 +01:00
.gitlab-ci.yml Fix path to reuse-lint yaml file. 2022-03-21 18:54:53 +00:00
.kde-ci.yml Add additional dependencies of KPMCore 2021-11-21 16:40:25 +13:00
.krazy REUSE: licensing information for misc files. 2020-10-01 00:51:30 +01:00
CMakeLists.txt Only run partitioning commands from trusted prefixes. 2022-03-20 21:07:17 +00:00
INSTALL.md REUSE: licensing information for misc files. 2020-10-01 00:51:30 +01:00
KPMcoreConfig.cmake.in Also remove INCLUDE_INSTALL_DIR in KPMcoreConfig.cmake file. 2022-01-20 19:10:58 +00:00
README.md set cmake interface dir on the target 2021-11-23 10:14:58 +01:00
metainfo.yaml add metainfo file 2021-11-24 10:31:41 +00:00

README.md

KPMcore

KPMcore, the KDE Partition Manager core, is a library for examining and modifying partitions, disk devices, and filesystems on a Linux system. It provides a unified programming interface over top of (external) system-manipulation tools.

KPMcore is a library for examining and manipulating all facets of storage devices on a system:

  • raw disk devices
  • partition tables on a device
  • filesystems within a partition

There are multiple backends so that KPMcore can support different operating systems, although the only functional backend is the one for Linux systems:

  • sfdisk backend (Linux)
  • null backend

Using KPMcore

Most of the usage information on KPMcore is included in the API documentation; this section contains only high-level usage information.

Finding KPMcore with CMake

KPMcore supports CMake as (meta-)build system and installs suitable CMake support files. Typical use of of KPMcore in a CMakeLists.txt looks like this:

    find_package( KPMcore 3.2 REQUIRED )
    target_link_libraries( target kpmcore )

There are no imported targets defined for KPMcore.

Initialization

An application must initialize the library and load a suitable backend before using KPMcore functions. By convention, the environment variable KPMCORE_BACKEND names a backend, and typical initialization code will look like this (or use the class KPMCoreInitializer from test/helpers.h):

    #include <backend/corebackendmanager.h>
    #include <QDebug>

    bool initKPMcore()
    {
        static bool inited = false;
        if ( inited ) return true;

        QByteArray env = qgetenv( "KPMCORE_BACKEND" );
        auto backendName = env.isEmpty() ? CoreBackendManager::defaultBackendName() : env;
        if ( !CoreBackendManager::self()->load( backendName ) )
        {
            qWarning() << "Failed to load backend plugin" << backendName;
            return false;
        }
        inited = true;
        return true;
    }

This code uses the environment variable if set, and otherwise falls back to a default backend suitable for the current platform.

Calling KPMcore functions before the library is initialized will result in undefined behavior.

Devices

After the backend is initialized you can scan for available devices. If you only want devices from the loaded backend you can call

    QList<Device*> devices = backend->scanDevices( excludeReadOnly );

where bool option excludeReadOnly specifies whether to exclude read only devices.

KPMcore device scanner

Alternatively, you can use KPMcore device scanner

    #include <core/device.h>
    #include <core/devicescanner.h>
    #include <core/operationstack.h>

    // First create operationStack with another QObject as parent, we will use nullptr here.
    OperationStack *operationStack = new OperationStack(nullptr);
    DeviceScanner *deviceScanner = new DeviceScanner(nullptr, *operationStack);
    deviceScanner->scan(); // use start() for scanning in the background thread
    QList<Device*> devices = operationStack->previewDevices();

Then deviceScanner scans for the devices in a background thread. After scanning is complete DeviceScanner::finished() signal will be emitted. Then the devices can accessed using operationStack->previewDevices().