用于管理系统中块设备的类，对设备进行挂载、卸载等操作，以及获取其基本属性更多...

#include <dblockdevice.h>

类 Dtk::Mount::DBlockDevice 继承关系图:

[图例]

Dtk::Mount::DBlockDevice 的协作图:

Public 类型
enum	PartitionTableType { InvalidPT , MBR , GPT , UnknownPT }
	磁盘分区类型更多...

Public 槽
void	format (const QString &type, const QVariantMap &options)
	格式化设备

QList< QPair< QString, QVariantMap > >	getSecretConfiguration (const QVariantMap &options)
	获取包含加密信息的配置信息

void	addConfigurationItem (const QPair< QString, QVariantMap > &item, const QVariantMap &options)
	添加新的配置项

void	removeConfigurationItem (const QPair< QString, QVariantMap > &item, const QVariantMap &options)
	移除配置项

void	updateConfigurationItem (const QPair< QString, QVariantMap > &oldItem, const QPair< QString, QVariantMap > &newItem, const QVariantMap &options)
	更新配置项

int	openDevice (const QString &mode, const QVariantMap &options)
	打开设备

int	openForBackup (const QVariantMap &options)
	以只读方式打开设备以便可以按字节镜像设备内容，仅在设备未使用时该方法操作有效

int	openForBenchmark (const QVariantMap &options)
	打开设备以便可以对设备进行跑分操作

int	openForRestore (const QVariantMap &options)
	打开一个可写设备，用于还原设备数据，仅在设备未使用是该方法有效

void	rescan (const QVariantMap &options)
	重新扫描设备

QString	mount (const QVariantMap &options)
	挂载设备

void	unmount (const QVariantMap &options)
	卸载设备

void	setLabel (const QString &label, const QVariantMap &options)
	设置磁盘卷标

void	changePassphrase (const QString &passphrase, const QString &newPassphrase, const QVariantMap &options)
	修改磁盘密码

void	lock (const QVariantMap &options)
	给加密设备上锁

QString	unlock (const QString &passphrase, const QVariantMap &options)
	给加密设备解锁

QString	cleartextDevice ()
	获取加密设备对应的明文设备对象路径

信号
void	hasFileSystemChanged (bool hasFileSystem)
	通知文件系统的有无发生变化

void	hasPartitionChanged (bool hasPartition)
	通知分区有无状态发生变化

void	isEncryptedChanged (bool isEncrypted)
	通知加密状态发生变化

void	configurationChanged (QList< QPair< QString, QVariantMap > > configuration)
	通知配置列表发生变化

void	cryptoBackingDeviceChanged (QString cryptoBackingDevice)
	通知加密设备路径发生变化

void	hintAutoChanged (bool hintAuto)
	通知自动开启属性变化

void	hintIconNameChanged (QString hintIconName)
	通知磁盘建议图标名称变化

void	hintIgnoreChanged (bool hintIgnore)
	通知磁盘忽略属性变化

void	hintNameChanged (QString hintName)
	通知磁盘建议名称发生变化

void	hintPartitionableChanged (bool hintPartitionable)
	通知磁盘可分区属性发生变化

void	hintSymbolicIconNameChanged (QString hintSymbolicIconName)
	通知磁盘建议符号图标名称发生变化

void	idLabelChanged (QString idLabel)
	通知磁盘卷标发生变化

void	idTypeChanged (QString idType)
	通知磁盘 idType 发生变化

void	fsTypeChanged (QString fsType)
	通知磁盘文件系统类型发生变化

void	idUUIDChanged (QString idUUID)
	通知磁盘 UUID 发生变化

void	idUsageChanged (QString idUsage)
	通知磁盘 idUsage 发生变化

void	idVersionChanged (QString idVersion)
	通知磁盘文件系统版本发生变化

void	mDRaidChanged (QString mDRaid)
	通知磁盘阵列属性发生变化

void	mDRaidMemberChanged (QString mDRaidMember)
	通知磁盘阵列成员发生变化

void	preferredDeviceChanged (QByteArray preferredDevice)
	通知磁盘最佳设备描述符发生变化

void	readOnlyChanged (bool readOnly)
	通知磁盘只读属性发生变化

void	sizeChanged (quint64 size)
	通知磁盘大小发生变化

void	symlinksChanged (QByteArrayList symlinks)
	通知磁盘设备链接发生变化

void	userspaceMountOptionsChanged (QStringList userspaceMountOptions)
	通知磁盘用户态挂载选项发生变化

void	ptTypeChanged ()
	通知磁盘分区类型发生变化

void	mountPointsChanged (const QByteArrayList &mountPoints)
	通知磁盘设备挂载点发生变化

void	childConfigurationChanged (QList< QPair< QString, QVariantMap > > childConfiguration)
	通知磁盘子配置列表发生变化

void	cleartextDeviceChanged (const QString &cleartextDevice)
	通知磁盘明文设备内容发生变化

Public 成员函数
bool	isValid () const
	判断设备是否为有效设备，若构造时传入了无效的路径，则返回 False

void	setWatchChanges (bool watchChanges)
	设置是否监听设备属性变化

bool	watchChanges () const
	获取当前设备监听状态

QString	path () const
	获取设备路径，该路径在构造对象时传入

QList< QPair< QString, QVariantMap > >	configuration () const
	获取设备配置列表

QString	cryptoBackingDevice () const
	获取设备的加密块设备

QByteArray	device () const
	获取块设备在系统中的设备描述符

quint64	deviceNumber () const
	获取设备对应的 dev_t 设备号

QString	drive () const
	获取设备对应的磁盘驱动器路径

bool	hintAuto () const
	获取设备是否应自动启动

QString	hintIconName () const
	获取用于展示设备的图标名称

bool	hintIgnore () const
	获取设备是否应被忽略

QString	hintName () const
	用于展示设备的磁盘名称

bool	hintPartitionable () const
	获取设备是否可分区，软盘、光驱和 LVM 逻辑卷除外

QString	hintSymbolicIconName () const
	获取用于展示设备的符号图标

bool	hintSystem () const
	获取设备是否为系统内置磁盘

QString	id () const
	获取设备唯一标识符

QString	idLabel () const
	获取磁盘卷标，通常用于显示磁盘名称

QString	idType () const
	通常情况下，用于获取设备文件系统，但在 idUsage 为非 fileSystem 时，有其他表意

QString	idUUID () const
	获取设备 UUID

QString	idUsage () const
	获取设备 ID 用途

QString	idVersion () const
	设备文件系统版本或其他结构属性

QString	mDRaid () const
	如果是阵列设备，该函数返回设备的阵列对象路径

QString	mDRaidMember () const
	如果设备是阵列成员，则返回阵列对象路径

QByteArray	preferredDevice () const
	获取最佳设备路径，例如，对于设备 /dev/mapper/mpathk，对应的路径为 /dev/dm-9

bool	readOnly () const
	获取是否为只读设备

quint64	size () const
	获取块设备大小

QByteArrayList	symlinks () const
	获取设备对应的链接列表

QStringList	userspaceMountOptions () const
	获取挂载时的参数列表

bool	canSetLabel () const
	获取磁盘能否设置卷标

bool	hasFileSystem () const
	获取设备是否有文件系统

bool	hasPartition () const
	获取设备是否有分区

bool	isEncrypted () const
	获取设备是否是加密设备

bool	isLoopDevice () const
	获取设备是否是回环设备

QByteArrayList	mountPoints () const
	获取设备挂载点列表

PartitionTableType	partitionTableType () const
	获取设备分区表类型

QList< QPair< QString, QVariantMap > >	childConfiguration () const
	获取设备子配置列表

静态 Public 成员函数
static bool	hasFileSystem (const QString &path)
	获取设备是否有文件系统

static bool	hasPartition (const QString &path)
	获取设备是否有分区

static bool	isEncrypted (const QString &path)
	获取设备是否是加密

static bool	isLoopDevice (const QString &path)
	获取是否为回环设备

Protected 成员函数
	DBlockDevice (const QString &path, QObject *parent=nullptr)

	DBlockDevice (DBlockDevicePrivate &dd, const QString &path, QObject *parent=nullptr)

Protected 属性
QScopedPointer< DBlockDevicePrivate >	d_ptr

属性
QString	path

bool	watchChanges

bool	hasFileSystem

bool	hasPartition

bool	isEncrypted

bool	isLoopDevice

QListQPair< QString, QVariantMap >	configuration

QString	cryptoBackingDevice

QByteArray	device

quint64	deviceNumber

QString	drive

bool	hintAuto

QString	hintIconName

bool	hintIgnore

QString	hintName

bool	hintPartitionable

QString	hintSymbolicIconName

bool	hintSystem

QString	id

QString	idLabel

QString	idType

QString	idUUID

QString	idUsage

QString	idVersion

QString	mDRaid

QString	mDRaidMember

QByteArray	preferredDevice

bool	readOnly

quint64	size

QByteArrayList	symlinks

QStringList	userspaceMountOptions

QByteArrayList	mountPoints

PartitionTableType	partitionTableType

QListQPair< QString, QVariantMap >	childConfiguration

QString	cleartextDevice

友元
DExpected< DBlockDevice * >	DDeviceManager::createBlockDevice (const QString &path, QObject *parent)

DExpected< DBlockDevice * >	DDeviceManager::createBlockDeviceByDevicePath (const QByteArray &path, QObject *parent)

详细描述

用于管理系统中块设备的类，对设备进行挂载、卸载等操作，以及获取其基本属性

成员枚举类型说明

◆ PartitionTableType

enum Dtk::Mount::DBlockDevice::PartitionTableType

磁盘分区类型

枚举值
InvalidPT	未初始化的值
MBR	MBR 分区类型
GPT	GPT 分区类型
UnknownPT	未知分区类型

成员函数说明

◆ addConfigurationItem

void DBlockDevice::addConfigurationItem	(	const QPair< QString, QVariantMap > &	item,
		const QVariantMap &	options
	)

slot

添加新的配置项

参数

[in]	item	添加的配置项
[in]	options	除标准参数外暂未使用

参见: QList<QPair<QString, QVariantMap> > DBlockDevice::getSecretConfiguration(const QVariantMap &options); QList< QPair<QString, QVariantMap> > DBlockDevice::configuration() const; DBlockDevice::removeConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options); void DBlockDevice::updateConfigurationItem(const QPair<QString, QVariantMap> &oldItem, const QPair<QString, QVariantMap> &newItem, const QVariantMap &options)

◆ canSetLabel()

bool DBlockDevice::canSetLabel ( ) const

获取磁盘能否设置卷标

返回: 能否设置卷标

参见: void DBlockDevice::setLabel(const QString &label, const QVariantMap &options)

◆ changePassphrase

void DBlockDevice::changePassphrase	(	const QString &	passphrase,
		const QString &	newPassphrase,
		const QVariantMap &	options
	)

slot

修改磁盘密码

参数

[in]	passphrase	旧密码
[in]	newPassphrase	新密码
[in]	options	设置选项

注解: 参数包括：; > old_keyfile_contents(string/stringlist); > new_keyfile_contents(string/stringlist)

◆ childConfiguration()

QList< QPair< QString, QVariantMap > > DBlockDevice::childConfiguration ( ) const

获取设备子配置列表

返回: 设备子配置列表

◆ childConfigurationChanged

void DBlockDevice::childConfigurationChanged ( QList< QPair< QString, QVariantMap > > childConfiguration )

signal

通知磁盘子配置列表发生变化

参数

[out] childConfiguration 新的子配置列表

◆ cleartextDevice

QString DBlockDevice::cleartextDevice ( )

slot

获取加密设备对应的明文设备对象路径

返回: 明文设备路径

参见: QString DBlockDevice::unlock(const QString &passphrase, const QVariantMap &options)

◆ cleartextDeviceChanged

void DBlockDevice::cleartextDeviceChanged ( const QString & cleartextDevice )

signal

通知磁盘明文设备内容发生变化

参数

[out] cleartextDevice 新的明文设备路径

◆ configuration()

QList< QPair< QString, QVariantMap > > DBlockDevice::configuration ( ) const

获取设备配置列表

返回: 设备配置列表

参见: void DBlockDevice::addConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options); DBlockDevice::removeConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options); void DBlockDevice::updateConfigurationItem(const QPair<QString, QVariantMap> &oldItem, const QPair<QString, QVariantMap> &newItem, const QVariantMap &options)

◆ configurationChanged

void DBlockDevice::configurationChanged ( QList< QPair< QString, QVariantMap > > configuration )

signal

通知配置列表发生变化

参数

[out] configuration 新的配置列表

◆ cryptoBackingDevice()

QString DBlockDevice::cryptoBackingDevice ( ) const

获取设备的加密块设备

返回: 设备加密块设备路径

返回值

非空字符串	具体路径
/	未知或者非加密设备

参见: bool DBlockDevice::isEncrypted() const

◆ cryptoBackingDeviceChanged

void DBlockDevice::cryptoBackingDeviceChanged ( QString cryptoBackingDevice )

signal

通知加密设备路径发生变化

参数

[out] cryptoBackingDevice 新的加密设备路径

◆ device()

QByteArray DBlockDevice::device ( ) const

获取块设备在系统中的设备描述符

返回: 设备描述符

参见: QByteArray DBlockDevice::preferredDevice() const

◆ deviceNumber()

quint64 DBlockDevice::deviceNumber ( ) const

获取设备对应的 dev_t 设备号

返回: 设备号

◆ drive()

QString DBlockDevice::drive ( ) const

获取设备对应的磁盘驱动器路径

返回: 驱动设备路径

参见: Dtk::Mount::DDiskDrive

◆ format

void DBlockDevice::format	(	const QString &	type,
		const QVariantMap &	options
	)

slot

格式化设备

参数

[in]	type	期望格式化的文件系统类型
[in]	options	格式化参数

注解: 参数包括：; > label(string) 卷标; > take-ownership(bool) 获取所有权; > encrypt.passphrase(string/stringlist) 密码; > encrypt.type(string) 加密类型; > erase(string) 擦除内容; > no-block(bool); > update-partition-type(bool) 更新分区

◆ fsTypeChanged

void DBlockDevice::fsTypeChanged ( QString fsType )

signal

通知磁盘文件系统类型发生变化

参数

[out] fsType 新的文件系统类型

◆ getSecretConfiguration

QList< QPair< QString, QVariantMap > > DBlockDevice::getSecretConfiguration ( const QVariantMap & options )

slot

获取包含加密信息的配置信息

参数

[in] options 除标准参数外暂未使用

返回: 配置列表

参见: QList< QPair<QString, QVariantMap> > DBlockDevice::configuration() const; void DBlockDevice::addConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options); DBlockDevice::removeConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options); void DBlockDevice::updateConfigurationItem(const QPair<QString, QVariantMap> &oldItem, const QPair<QString, QVariantMap> &newItem, const QVariantMap &options)

◆ hasFileSystem() [1/2]

bool DBlockDevice::hasFileSystem ( ) const

获取设备是否有文件系统

返回: 是否有文件系统

参见: static bool DBlockDevice::hasFileSystem(const QString &path)

◆ hasFileSystem() [2/2]

static bool DBlockDevice::hasFileSystem ( const QString & path )

static

获取设备是否有文件系统

参数

[in] path 设备路径

返回: 是否有文件系统

参见: bool DBlockDevice::hasFileSystem() const

◆ hasFileSystemChanged

void DBlockDevice::hasFileSystemChanged ( bool hasFileSystem )

signal

通知文件系统的有无发生变化

参数

[out] hasFileSystem 新的文件系统存在状态

◆ hasPartition() [1/2]

bool DBlockDevice::hasPartition ( ) const

获取设备是否有分区

返回: 设备是否有分区

参见: static bool DBlockDevice::hasPartition(const QString &path)

◆ hasPartition() [2/2]

static bool DBlockDevice::hasPartition ( const QString & path )

static

获取设备是否有分区

参数

[in] path 设备路径

返回: 设备是否有分区

参见: bool DBlockDevice::hasPartition() const

◆ hasPartitionChanged

void DBlockDevice::hasPartitionChanged ( bool hasPartition )

signal

通知分区有无状态发生变化

参数

[out] hasPartition 新的分区存在状态

◆ hintAuto()

bool DBlockDevice::hintAuto ( ) const

获取设备是否应自动启动

返回: 设备是否应自动启动

◆ hintAutoChanged

void DBlockDevice::hintAutoChanged ( bool hintAuto )

signal

通知自动开启属性变化

参数

[out] hintAuto 新的自动开启属性值

◆ hintIconName()

QString DBlockDevice::hintIconName ( ) const

获取用于展示设备的图标名称

返回: 图标名称或空

◆ hintIconNameChanged

void DBlockDevice::hintIconNameChanged ( QString hintIconName )

signal

通知磁盘建议图标名称变化

参数

[out] hintIconName 新的建议图标名称

◆ hintIgnore()

bool DBlockDevice::hintIgnore ( ) const

获取设备是否应被忽略

返回: 设备是否应被忽略

注解: 一般的，磁盘管理器类应用（深度磁盘管理器或分区编辑器）在打开的状态下，所有的块设备的该标识都返回 True，此时期望磁盘不被上层应用显示，以免影响磁盘管理操作。; 深度文件管理器监听该字段，当变为 False 时，从用户界面中移除该磁盘显示；并且，若磁盘接入时，该磁盘字段为 True，则不执行自动挂载。

◆ hintIgnoreChanged

void DBlockDevice::hintIgnoreChanged ( bool hintIgnore )

signal

通知磁盘忽略属性变化

参数

[out] hintIgnore 新的忽略属性

◆ hintName()

QString DBlockDevice::hintName ( ) const

用于展示设备的磁盘名称

返回: 磁盘名称或空

◆ hintNameChanged

void DBlockDevice::hintNameChanged ( QString hintName )

signal

通知磁盘建议名称发生变化

参数

[out] hintName 新的建议名称

◆ hintPartitionable()

bool DBlockDevice::hintPartitionable ( ) const

获取设备是否可分区，软盘、光驱和 LVM 逻辑卷除外

返回: 设备是否可分区

◆ hintPartitionableChanged

void DBlockDevice::hintPartitionableChanged ( bool hintPartitionable )

signal

通知磁盘可分区属性发生变化

参数

[out] hintPartitionable 新的可分区属性

◆ hintSymbolicIconName()

QString DBlockDevice::hintSymbolicIconName ( ) const

获取用于展示设备的符号图标

返回: 设备符号图标或空字符串

◆ hintSymbolicIconNameChanged

void DBlockDevice::hintSymbolicIconNameChanged ( QString hintSymbolicIconName )

signal

通知磁盘建议符号图标名称发生变化

参数

[out] hintSymbolicIconName 新的符号图标名称

◆ hintSystem()

bool DBlockDevice::hintSystem ( ) const

获取设备是否为系统内置磁盘

返回: 是否为系统内置磁盘

注解: 通常情况下，该字段与 removable 互斥，一般来说，通过主板内置接口如 sata、pcie 接入的设备，该字段为 True

◆ id()

QString DBlockDevice::id ( ) const

获取设备唯一标识符

返回: 设备唯一标识符

◆ idLabel()

QString DBlockDevice::idLabel ( ) const

获取磁盘卷标，通常用于显示磁盘名称

返回: 磁盘卷标

参见: QString DBlockDevice::hintName() const; void DBlockDevice::setLabel(const QString &label, const QVariantMap &options)

◆ idLabelChanged

void DBlockDevice::idLabelChanged ( QString idLabel )

signal

通知磁盘卷标发生变化

参数

[out] idLabel 新的卷标名称

◆ idType()

QString DBlockDevice::idType ( ) const

通常情况下，用于获取设备文件系统，但在 idUsage 为非 fileSystem 时，有其他表意

返回: 设备文件系统

参见: QString DBlockDevice::idUsage() const

◆ idTypeChanged

void DBlockDevice::idTypeChanged ( QString idType )

signal

通知磁盘 idType 发生变化

参数

[out] idType 新的 idType 名称

◆ idUsage()

QString DBlockDevice::idUsage ( ) const

获取设备 ID 用途

返回: 设备签名用途

返回值

filesystem	可变的文件系统
crypto	LUKS 类设备
raid	RAID 类设备
other	其他类型设备

参见: QString DBlockDevice::idType() const

◆ idUsageChanged

void DBlockDevice::idUsageChanged ( QString idUsage )

signal

通知磁盘 idUsage 发生变化

参数

[out] idUsage 新的类型

◆ idUUID()

QString DBlockDevice::idUUID ( ) const

获取设备 UUID

返回: 设备 UUID

◆ idUUIDChanged

void DBlockDevice::idUUIDChanged ( QString idUUID )

signal

通知磁盘 UUID 发生变化

参数

[out] idUUID 新的 UUID

◆ idVersion()

QString DBlockDevice::idVersion ( ) const

设备文件系统版本或其他结构属性

返回: 版本信息或空

◆ idVersionChanged

void DBlockDevice::idVersionChanged ( QString idVersion )

signal

通知磁盘文件系统版本发生变化

参数

[out] idVersion 新的文件系统版本

◆ isEncrypted() [1/2]

bool DBlockDevice::isEncrypted ( ) const

获取设备是否是加密设备

返回: 是否是加密设备

参见: QString DBlockDevice::cryptoBackingDevice() const; static bool DBlockDevice::isEncrypted(const QString &path)

◆ isEncrypted() [2/2]

static bool DBlockDevice::isEncrypted ( const QString & path )

static

获取设备是否是加密

参数

[in] path 设备路径

返回: 设备是否加密

参见: QString DBlockDevice::cryptoBackingDevice() const; bool DBlockDevice::isEncrypted(const QString &path)

◆ isEncryptedChanged

void DBlockDevice::isEncryptedChanged ( bool isEncrypted )

signal

通知加密状态发生变化

参数

[out] isEncrypted 新的加密状态

◆ isLoopDevice() [1/2]

bool DBlockDevice::isLoopDevice ( ) const

获取设备是否是回环设备

返回: 是否是回环设备

参见: static bool DBlockDevice::isLoopDevice(const QString &path)

◆ isLoopDevice() [2/2]

static bool DBlockDevice::isLoopDevice ( const QString & path )

static

获取是否为回环设备

参数

[in] path 设备路径

返回: 是否为回环设备

参见: bool DBlockDevice::isLoopDevice() const

◆ isValid()

bool DBlockDevice::isValid ( ) const

判断设备是否为有效设备，若构造时传入了无效的路径，则返回 False

返回: 设备是否有效

◆ lock

void DBlockDevice::lock ( const QVariantMap & options )

slot

给加密设备上锁

参数

[in] options 除标准参数外暂未使用

参见: QString DBlockDevice::unlock(const QString &passphrase, const QVariantMap &options)

◆ mDRaid()

QString DBlockDevice::mDRaid ( ) const

如果是阵列设备，该函数返回设备的阵列对象路径

返回: 阵列设备路径或 “/”

◆ mDRaidChanged

void DBlockDevice::mDRaidChanged ( QString mDRaid )

signal

通知磁盘阵列属性发生变化

参数

[out] mDRaid 新的阵列属性

◆ mDRaidMember()

QString DBlockDevice::mDRaidMember ( ) const

如果设备是阵列成员，则返回阵列对象路径

返回: 阵列对象路径或 “/”

◆ mDRaidMemberChanged

void DBlockDevice::mDRaidMemberChanged ( QString mDRaidMember )

signal

通知磁盘阵列成员发生变化

参数

[out] mDRaidMember 新的阵列成员

◆ mount

QString DBlockDevice::mount ( const QVariantMap & options )

slot

挂载设备

参数

[in] options 挂载参数

返回: 挂载成功返回挂载点否则返回空字符串

注解: 参数包括：; > fstype(string) 文件系统类型; > options(string) 其他选项（通用 mount 挂载选项）

参见: void DBlockDevice::unmount(const QVariantMap &options); QByteArrayList DBlockDevice::mountPoints() const; void DBlockDevice::mountPointsChanged(const QByteArrayList &mountPoints)

◆ mountPoints()

QByteArrayList DBlockDevice::mountPoints ( ) const

获取设备挂载点列表

返回: 设备挂载点列表

◆ mountPointsChanged

void DBlockDevice::mountPointsChanged ( const QByteArrayList & mountPoints )

signal

通知磁盘设备挂载点发生变化

参数

[out] mountPoints 新的挂载点列表

◆ openDevice

int DBlockDevice::openDevice	(	const QString &	mode,
		const QVariantMap &	options
	)

slot

打开设备

参数

[in]	mode	“r” 只读，“w” 只写，“rw” 读写
[in]	options	参数列表

返回: 打开的文件描述符

参见: int DBlockDevice::openForBackup(const QVariantMap &options); int DBlockDevice::openDevice(const QString &mode, const QVariantMap &options); int DBlockDevice::openForBenchmark(const QVariantMap &options); int DBlockDevice::openForRestore(const QVariantMap &options)

◆ openForBackup

int DBlockDevice::openForBackup ( const QVariantMap & options )

slot

以只读方式打开设备以便可以按字节镜像设备内容，仅在设备未使用时该方法操作有效

参数

[in] options 除标准参数外暂未使用

返回: 打开的文件描述符

参见: int DBlockDevice::openDevice(const QString &mode, const QVariantMap &options); int DBlockDevice::openForBenchmark(const QVariantMap &options); int DBlockDevice::openForRestore(const QVariantMap &options)

◆ openForBenchmark

int DBlockDevice::openForBenchmark ( const QVariantMap & options )

slot

打开设备以便可以对设备进行跑分操作

参数

[in] options 除标准参数外暂未使用

返回: 打开的文件描述符

参见: int DBlockDevice::openForBackup(const QVariantMap &options); int DBlockDevice::openDevice(const QString &mode, const QVariantMap &options); int DBlockDevice::openForRestore(const QVariantMap &options)

◆ openForRestore

int DBlockDevice::openForRestore ( const QVariantMap & options )

slot

打开一个可写设备，用于还原设备数据，仅在设备未使用是该方法有效

参数

[in] options 除标准参数外暂未使用

返回: 打开的文件描述符

参见: int DBlockDevice::openForBackup(const QVariantMap &options); int DBlockDevice::openDevice(const QString &mode, const QVariantMap &options); int DBlockDevice::openForBenchmark(const QVariantMap &options)

◆ partitionTableType()

PartitionTableType DBlockDevice::partitionTableType ( ) const

获取设备分区表类型

返回: 设备分区表类型

参见: Dtk::Mount::DBlockDevice::PartitionTableType

◆ path()

QString DBlockDevice::path ( ) const

获取设备路径，该路径在构造对象时传入

返回: 设备路径

◆ preferredDevice()

QByteArray DBlockDevice::preferredDevice ( ) const

获取最佳设备路径，例如，对于设备 /dev/mapper/mpathk，对应的路径为 /dev/dm-9

返回: 最佳设备路径

参见: QByteArray DBlockDevice::device() const

◆ preferredDeviceChanged

void DBlockDevice::preferredDeviceChanged ( QByteArray preferredDevice )

signal

通知磁盘最佳设备描述符发生变化

参数

[out] preferredDevice 新的最佳设备描述符

◆ readOnly()

bool DBlockDevice::readOnly ( ) const

获取是否为只读设备

返回: 是否为只读设备

◆ readOnlyChanged

void DBlockDevice::readOnlyChanged ( bool readOnly )

signal

通知磁盘只读属性发生变化

参数

[out] readOnly 新的只读属性

◆ removeConfigurationItem

void DBlockDevice::removeConfigurationItem	(	const QPair< QString, QVariantMap > &	item,
		const QVariantMap &	options
	)

slot

移除配置项

参数

[in]	item	要移除的配置项
[in]	options	除标准参数外暂未使用

参见: QList<QPair<QString, QVariantMap> > DBlockDevice::getSecretConfiguration(const QVariantMap &options); QList< QPair<QString, QVariantMap> > DBlockDevice::configuration() const; void DBlockDevice::addConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options); void DBlockDevice::updateConfigurationItem(const QPair<QString, QVariantMap> &oldItem, const QPair<QString, QVariantMap> &newItem, const QVariantMap &options)

◆ rescan

void DBlockDevice::rescan ( const QVariantMap & options )

slot

重新扫描设备

参数

[in] options 除标准参数外暂未使用

◆ setLabel

void DBlockDevice::setLabel	(	const QString &	label,
		const QVariantMap &	options
	)

slot

设置磁盘卷标

参数

[in]	label	新的磁盘卷标
[in]	options	参数

参见: bool DBlockDevice::canSetLabel() const; void DBlockDevice::idLabelChanged(QString idLabel); QString DBlockDevice::idLabel() const

◆ setWatchChanges()

void DBlockDevice::setWatchChanges ( bool watchChanges )

设置是否监听设备属性变化

参数

[in] watchChanges 开关标识

参见: bool DBlockDevice::watchChanges() const

◆ size()

quint64 DBlockDevice::size ( ) const

获取块设备大小

返回: 块设备大小

◆ sizeChanged

void DBlockDevice::sizeChanged ( quint64 size )

signal

通知磁盘大小发生变化

参数

[out] size 新的磁盘大小

◆ symlinks()

QByteArrayList DBlockDevice::symlinks ( ) const

获取设备对应的链接列表

返回: 设备链接列表

参见: QByteArray DBlockDevice::device() const

◆ symlinksChanged

void DBlockDevice::symlinksChanged ( QByteArrayList symlinks )

signal

通知磁盘设备链接发生变化

参数

[out] symlinks 新的设备链接列表

◆ unlock

QString DBlockDevice::unlock	(	const QString &	passphrase,
		const QVariantMap &	options
	)

slot

给加密设备解锁

参数

[in]	passphrase	解锁密码
[in]	options	参数列表

返回: 解锁成功后返回明文设备的对象路径否则返回空

参见: void DBlockDevice::lock(const QVariantMap &options)

注解: 参数列表：; > keyfile_contents(stringlist) 秘钥文件内容; > read-only(bool) 只读

参见: QString DBlockDevice::cleartextDevice()

◆ unmount

void DBlockDevice::unmount ( const QVariantMap & options )

slot

卸载设备

参数

[in] options 卸载参数

注解: 参数包括：; > force(bool) 强制卸载

参见: QString DBlockDevice::mount(const QVariantMap &options)

◆ updateConfigurationItem

void DBlockDevice::updateConfigurationItem	(	const QPair< QString, QVariantMap > &	oldItem,
		const QPair< QString, QVariantMap > &	newItem,
		const QVariantMap &	options
	)

slot

更新配置项

参数

[in]	oldItem	要移除的配置项
[in]	newItem	添加的配置项
[in]	options	除标准参数外暂未使用

参见: QList<QPair<QString, QVariantMap> > DBlockDevice::getSecretConfiguration(const QVariantMap &options); QList< QPair<QString, QVariantMap> > DBlockDevice::configuration() const; void DBlockDevice::addConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options); DBlockDevice::removeConfigurationItem(const QPair<QString, QVariantMap> &item, const QVariantMap &options)

◆ userspaceMountOptions()

QStringList DBlockDevice::userspaceMountOptions ( ) const

获取挂载时的参数列表

返回: 挂载参数列表

◆ userspaceMountOptionsChanged

void DBlockDevice::userspaceMountOptionsChanged ( QStringList userspaceMountOptions )

signal

通知磁盘用户态挂载选项发生变化

参数

[out] userspaceMoutnOptions 新的用户态挂载参数列表

◆ watchChanges()

bool DBlockDevice::watchChanges ( ) const

获取当前设备监听状态

返回: 设备监听状态

参见: void DBlockDevice::setWatchChanges(bool watchChanges)

该类的文档由以下文件生成:

include/dtkmount/dblockdevice.h
docs/dtkmount/dblockdevice.zh_CN.dox

Public 类型

Public 槽

信号

Public 成员函数

静态 Public 成员函数

Protected 成员函数

Protected 属性

属性

友元

详细描述

成员枚举类型说明

◆ PartitionTableType

成员函数说明

◆ addConfigurationItem

◆ canSetLabel()

◆ changePassphrase

◆ childConfiguration()

◆ childConfigurationChanged

◆ cleartextDevice

◆ cleartextDeviceChanged

◆ configuration()

◆ configurationChanged

◆ cryptoBackingDevice()

◆ cryptoBackingDeviceChanged

◆ device()

◆ deviceNumber()

◆ drive()

◆ format

◆ fsTypeChanged

◆ getSecretConfiguration

◆ hasFileSystem() [1/2]

◆ hasFileSystem() [2/2]

◆ hasFileSystemChanged

◆ hasPartition() [1/2]

◆ hasPartition() [2/2]

◆ hasPartitionChanged

◆ hintAuto()

◆ hintAutoChanged

◆ hintIconName()

◆ hintIconNameChanged

◆ hintIgnore()

◆ hintIgnoreChanged

◆ hintName()

◆ hintNameChanged

◆ hintPartitionable()

◆ hintPartitionableChanged

◆ hintSymbolicIconName()

◆ hintSymbolicIconNameChanged

◆ hintSystem()

◆ id()

◆ idLabel()

◆ idLabelChanged

◆ idType()

◆ idTypeChanged

◆ idUsage()

◆ idUsageChanged

◆ idUUID()

◆ idUUIDChanged

◆ idVersion()

◆ idVersionChanged

◆ isEncrypted() [1/2]

◆ isEncrypted() [2/2]

◆ isEncryptedChanged

◆ isLoopDevice() [1/2]

◆ isLoopDevice() [2/2]

◆ isValid()

◆ lock

◆ mDRaid()

◆ mDRaidChanged

◆ mDRaidMember()

◆ mDRaidMemberChanged

◆ mount

◆ mountPoints()

◆ mountPointsChanged

◆ openDevice

◆ openForBackup

◆ openForBenchmark

◆ openForRestore

◆ partitionTableType()

◆ path()