Top | ![]() |
![]() |
![]() |
![]() |
org.freedesktop.UDisks.Deviceorg.freedesktop.UDisks.Device — Device interface |
JobCancel() PartitionTableCreate(in's'scheme, in'as'options) PartitionDelete(in'as'options) PartitionCreate(in't'offset, in't'size, in's'type, in's'label, in'as'flags, in'as'options, in's'fstype, in'as'fsoptions, out'o'created_device) PartitionModify(in's'type, in's'label, in'as'flags) FilesystemCreate(in's'fstype, in'as'options) FilesystemSetLabel(in's'new_label) FilesystemMount(in's'filesystem_type, in'as'options, out's'mount_path) FilesystemUnmount(in'as'options) FilesystemCheck(in'as'options, out'b'is_clean) FilesystemListOpenFiles(out'a(uus)'processes) LuksUnlock(in's'passphrase, in'as'options, out'o'cleartext_device) LuksLock(in'as'options) LuksChangePassphrase(in's'current_passphrase, in's'new_passphrase) LinuxMdAddSpare(in'o'component, in'as'options) LinuxMdExpand(in'ao'components, in'as'options) LinuxMdRemoveComponent(in'o'component, in'as'options) LinuxMdStop(in'as'options) LinuxLvm2LVStop(in'as'options) LinuxMdCheck(in'as'options, out't'number_of_errors) DriveInhibitPolling(in'as'options, out's'cookie) DriveUninhibitPolling(in's'cookie) DrivePollMedia() DriveEject(in'as'options) DriveDetach(in'as'options) DriveSetSpindownTimeout(in'i'timeout_seconds, in'as'options, out's'cookie) DriveUnsetSpindownTimeout(in's'cookie) DriveAtaSmartRefreshData(in'as'options) DriveAtaSmartInitiateSelftest(in's'test, in'as'options) DriveBenchmark(in'b'do_write_benchmark, in'as'options, out'a(td)'read_transfer_rate_results, out'a(td)'write_transfer_rate_results, out'a(td)'access_time_results)
Changed() JobChanged('b'job_in_progress, 'b'job_is_cancellable, 's'job_id, 'u'job_initiated_by_uid, 'd'job_percentage)
Objects implementing org.freedesktop.UDisks.Device also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties
'NativePath'read's' 'DeviceDetectionTime'read't' 'DeviceMediaDetectionTime'read't' 'DeviceMajor'read'x' 'DeviceMinor'read'x' 'DeviceFile'read's' 'DeviceFilePresentation'read's' 'DeviceFileById'read'as' 'DeviceFileByPath'read'as' 'DeviceIsSystemInternal'read'b' 'DeviceIsPartition'read'b' 'DeviceIsPartitionTable'read'b' 'DeviceIsRemovable'read'b' 'DeviceIsMediaAvailable'read'b' 'DeviceIsMediaChangeDetected'read'b' 'DeviceIsMediaChangeDetectionPolling'read'b' 'DeviceIsMediaChangeDetectionInhibitable'read'b' 'DeviceIsMediaChangeDetectionInhibited'read'b' 'DeviceIsReadOnly'read'b' 'DeviceIsDrive'read'b' 'DeviceIsOpticalDisc'read'b' 'DeviceIsMounted'read'b' 'DeviceMountPaths'read'as' 'DeviceMountedByUid'read'u' 'DeviceIsLuks'read'b' 'DeviceIsLuksCleartext'read'b' 'DeviceIsLinuxMdComponent'read'b' 'DeviceIsLinuxMd'read'b' 'DeviceIsLinuxLvm2LV'read'b' 'DeviceIsLinuxLvm2PV'read'b' 'DeviceIsLinuxDmmpComponent'read'b' 'DeviceIsLinuxDmmp'read'b' 'DeviceIsLinuxLoop'read'b' 'DeviceSize'read't' 'DeviceBlockSize'read't' 'DevicePresentationHide'read'b' 'DevicePresentationNopolicy'read'b' 'DevicePresentationName'read's' 'DevicePresentationIconName'read's' 'DeviceAutomountHint'read's' 'JobInProgress'read'b' 'JobId'read's' 'JobInitiatedByUid'read'u' 'JobIsCancellable'read'b' 'JobPercentage'read'd' 'IdUsage'read's' 'IdType'read's' 'IdVersion'read's' 'IdUuid'read's' 'IdLabel'read's' 'LuksHolder'read'o' 'LuksCleartextSlave'read'o' 'LuksCleartextUnlockedByUid'read'u' 'PartitionSlave'read'o' 'PartitionScheme'read's' 'PartitionType'read's' 'PartitionLabel'read's' 'PartitionUuid'read's' 'PartitionFlags'read'as' 'PartitionNumber'read'i' 'PartitionOffset'read't' 'PartitionSize'read't' 'PartitionAlignmentOffset'read't' 'PartitionTableScheme'read's' 'PartitionTableCount'read'i' 'DriveVendor'read's' 'DriveModel'read's' 'DriveRevision'read's' 'DriveSerial'read's' 'DriveWwn'read's' 'DriveRotationRate'read'u' 'DriveWriteCache'read's' 'DriveConnectionInterface'read's' 'DriveConnectionSpeed'read't' 'DriveMediaCompatibility'read'as' 'DriveMedia'read's' 'DriveIsMediaEjectable'read'b' 'DriveCanDetach'read'b' 'DriveCanSpindown'read'b' 'DriveIsRotational'read'b' 'DriveAdapter'read'o' 'DrivePorts'read'ao' 'DriveSimilarDevices'read'ao' 'OpticalDiscIsBlank'read'b' 'OpticalDiscIsAppendable'read'b' 'OpticalDiscIsClosed'read'b' 'OpticalDiscNumTracks'read'u' 'OpticalDiscNumAudioTracks'read'u' 'OpticalDiscNumSessions'read'u' 'DriveAtaSmartIsAvailable'read'b' 'DriveAtaSmartTimeCollected'read't' 'DriveAtaSmartStatus'read's' 'DriveAtaSmartBlob'read'ay' 'LinuxMdComponentLevel'read's' 'LinuxMdComponentPosition'read'i' 'LinuxMdComponentNumRaidDevices'read'i' 'LinuxMdComponentUuid'read's' 'LinuxMdComponentName'read's' 'LinuxMdComponentHomeHost'read's' 'LinuxMdComponentVersion'read's' 'LinuxMdComponentHolder'read'o' 'LinuxMdComponentState'read'as' 'LinuxMdState'read's' 'LinuxMdLevel'read's' 'LinuxMdUuid'read's' 'LinuxMdHomeHost'read's' 'LinuxMdName'read's' 'LinuxMdNumRaidDevices'read'i' 'LinuxMdVersion'read's' 'LinuxMdSlaves'read'ao' 'LinuxMdIsDegraded'read'b' 'LinuxMdSyncAction'read's' 'LinuxMdSyncPercentage'read'd' 'LinuxMdSyncSpeed'read't' 'LinuxLvm2PVUuid'read's' 'LinuxLvm2PVNumMetadataAreas'read'u' 'LinuxLvm2PVGroupName'read's' 'LinuxLvm2PVGroupUuid'read's' 'LinuxLvm2PVGroupSize'read't' 'LinuxLvm2PVGroupUnallocatedSize'read't' 'LinuxLvm2PVGroupSequenceNumber'read't' 'LinuxLvm2PVGroupExtentSize'read't' 'LinuxLvm2PVGroupPhysicalVolumes'read'as' 'LinuxLvm2PVGroupLogicalVolumes'read'as' 'LinuxLvm2LVName'read's' 'LinuxLvm2LVUuid'read's' 'LinuxLvm2LVGroupName'read's' 'LinuxLvm2LVGroupUuid'read's' 'LinuxDmmpComponentHolder'read'o' 'LinuxDmmpName'read's' 'LinuxDmmpSlaves'read'ao' 'LinuxDmmpParameters'read's' 'LinuxLoopFilename'read's'
This interface provides information about a block device on
a UNIX-like system. In addition to just providing
information, methods can be invoked to perform operations on
the block device. Objects implementing this interface have
object paths prefixed with /devices/
followed by a sanitized representation of the base name of
their native path. As the D-Bus specification greatly limits
what characters can be used in object paths, this doesn't
necessarily map one to one with the native basename; for
example the native
path /sys/devices/virtual/block/dm-0
will
be represented as /devices/dm_0
.
Most methods on this interface take an array of strings
for options that can affect what the method does. Some of
these options are literal strings (such
as noatime
) while some are encoded in the
form of a key/value pair (such
as label=
).
A general note about properties: the set of values
returned can be expected to grow in the future as both
hardware and operating system capabilities evolve. Care
has been taken to namespace values so applications can
properly fall back (see e.g.
DriveMediaCompatibility
)
and export both general and specific properties (such as
IdUsage
vs.
IdType
).
In general an empty string in a property means not
set. Since the empty string is not a valid object path we
use the "/" to mean "not set" for object paths.
Cancels a job in progress.
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
Creates a new partition table. The following partition table schemes are supported:
|
The scheme of the partition table to create. |
|
No options are currently supported. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device or a partition on it are busy |
|
if the operation failed |
|
if the job was cancelled |
non-system-internal
devicesystem-internal
deviceDeletes a partition, removing it from the enclosing partition table.
|
No options are currently supported. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
non-system-internal
devicesystem-internal
devicePartitionCreate (in't'offset, in't'size, in's'type, in's'label, in'as'flags, in'as'options, in's'fstype, in'as'fsoptions, out'o'created_device)
Create a new partition and, optionally, create a file system on it. The partition won't necessarily be created at the exact location requested due to disk geometry constraints.
|
Where on the device to create the partition. |
|
Size of the partitition to create. |
|
The type of the partition to create. Valid types depends
on the partitioning scheme used:
|
|
The label to use for the partition. Leave blank if the
partition table scheme is mbr .
|
|
Flags to use for the partition. Valid flags depends on the
partitioning scheme used:
|
|
Currently unused. |
|
The file system to create in new partition. Leave
blank to skip creating a file system. See the
FilesystemCreate() method
for details.
|
|
Options to use for file system creation. See the
FilesystemCreate() method
for details.
|
|
The object path of the newly added partition. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
non-system-internal
devicesystem-internal
deviceModifies meta data for a partition, such as type, label and flags. TODO: Consider allowing changing offset and size. Or maybe that should be a separate method.
|
The type of the partition to create. See the type parameter of the
PartitionCreate() method
for details on valid types.
|
|
The label to use for the partition. See the label parameter of the
PartitionCreate() method
for details on valid labels.
|
|
Flags to use for the partition. See the flags parameter of the
PartitionCreate() method
for details on valid flags
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the enclosing partition table device is busy |
|
if the operation failed |
|
if the job was cancelled |
non-system-internal
devicesystem-internal
device
Create a file system on a device. If
the luks_encrypt=
option is passed then an
LUKS encrypted block device will be created, then unlocked and
the file system will be created on the corresponding
cleartext device.
|
The type of file system to
create. Pass empty to not create a file
system and just clear the areas of the device known to host
file system signatures. Use @TODO@ to get a list of file systems that can
be created.
|
|
To set the label on the file system use
the label=NAME option. Labels may not be
supported for all file systems and the allowed length of a
label may vary (see @TODO@). To create the file system on
an LUKS encrypted block device, pass
the luks_encrypt= option with the value
set to the passphrase to use. For file systems with the
concept of owners (e.g.
ext3 ), the options take_ownership_uid= and
take_ownership_gid= are supported and can be used to set the
initial owner of the created file system.
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
|
if mkfs for this type is not available |
non-system-internal
devicesystem-internal
device
Changes the file system label. See the options
parameter of
FilesystemCreate()
method for details of what valid labels are valid.
|
New label for file system. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy and changing the label requires an unmounted file system |
|
if the operation failed |
|
if the job was cancelled |
|
if the label changing tool for this file system type is not available |
non-system-internal
devicesystem-internal
device
Mount the device. If the device is referenced in the
system-wide /etc/fstab
file, the given
parameters are all ignored and the device will be
attempted to be mounted as the calling user.
|
File system type to use. |
|
Mount Options. Valid mount options include mount options accepted by the native mount program. The option auth_no_user_interaction can be used to avoid user interaction (e.g. authentication dialogs) when checking whether the caller is authorized. |
|
Where the device was mounted. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
|
if an invalid or malformed mount option was given |
|
if the kernel driver for this file system type is not available |
non-system-internal
devicesystem-internal
device
Unmount the device. If the device is referenced in the
system-wide /etc/fstab
file (both at
mount time and when this method is invoked), the device
will be attempted to be unmounted as the calling user.
|
Unmount options. Valid options currently include only 'force'. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
|
if an invalid or malformed unmount option was given |
Perform a non-interactive file system check.
|
Currently unused. |
|
Returns TRUE if the file system is clean, FALSE if there are errors on the file system. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is mounted and the file system doesn't support online file system checking. See TODO for how to determine if a file system supports online fsck |
|
if the operation failed |
|
if the job was cancelled |
non-system-internal
device.system-internal
device.List open files on a mounted file system.
|
An array of triples (pid , uid , command line for the process
image) for processes currently having open files on the given mounted file system.
Note that this operation is not run as a job.
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is mounted and the file system doesn't support online file system checking. See TODO for how to determine if a file system supports online fsck |
|
if the operation failed |
non-system-internal
device.system-internal
device.Sets up a cleartext device using the given device as backing store.
|
Passphrase for unlocking the cleartext data. |
|
Currently unused. |
|
The cleartext device created. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
Tears down the cleartext device set up using
e.g. the LuksUnlock()
method.
|
Currently unused. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
Change the passphrase used to unlock a LUKS encrypted device.
|
The current passphrase. |
|
The new passphrase. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device is busy |
|
if the operation failed |
|
if the job was cancelled |
non-system-internal
devicesystem-internal
deviceAdds a component to a Linux md RAID array. Existing data on the given component will be erased.
|
Object path of the component to add |
|
Currently unused. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
component to add is busy |
|
if the operation failed |
|
if the job was cancelled |
Grows the Linux md RAID array with the given components.
|
Object paths of the components to use for growing the array |
|
Currently unused. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
component to add is busy |
|
if the operation failed |
|
if the job was cancelled |
Removes a component from a Linux md RAID array. The component will be removed and then the signatures on the component will be scrubbed.
|
The component to remove from the array. |
|
No options are currently supported. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
component to add is busy |
|
if the operation failed |
|
if the job was cancelled |
Stops a Linux md RAID array.
|
Currently unused. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
|
if the job was cancelled |
Stops a Linux LVM2 Logical Volume.
|
Currently unused. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
|
if the job was cancelled |
Checks a Linux md RAID array and returns the number of
sectors/page with errors found/fixed. This can only be done if the
property
LinuxMdSyncAction
is idle.
|
Use the repair option to fix any problems encountered.
|
|
Number of mismatched sectors/pages found (or fixed if the repair option is used).
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
|
if the job was cancelled |
Inhibits the daemon from polling the device for media changes.
|
Inhibit options. Currently no options are recognized. |
|
A cookie that can be used in the
DriveUninhibitPolling() method
to stop inhibiting polling of the device.
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
Uninhibits daemon from polling the device for media changes.
|
A cookie obtained from the
DriveInhibitPolling() method.
|
Polls the drive for media. This is typically only useful when the
DeviceIsMediaChangeDetected
property
is FALSE.
Ejects media from the device. If the unmount option is given, the device might have mounted file systems, which will be unmounted before ejection.
|
Eject options. Valid options currently include only 'unmount'. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device or a dependent device (e.g. partition or cleartext luks device) is busy (e.g. mounted) |
|
if the operation failed |
|
if the job was cancelled |
|
if an invalid or malformed option was given |
Detachs the device by e.g. powering down the physical port
it is connected to. Note that not all devices or ports are
capable of this. Check the
DriveCanDetach
property before attempting to invoke this method.
Note that the physical port a drive belongs to may be located inside the physical casing - for example, some netbooks provide a SD card drive connect through USB. As such, users of this method should be careful – don't automatically invoke this method if the user presses e.g. an Eject button in the UI. Instead, provide e.g. a "Safely Remove Drive" option.
|
Detach options. Currently no options are recognized. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the device or a dependent device (e.g. partition or cleartext luks device) is busy (e.g. mounted) |
|
if the operation failed |
|
if the job was cancelled |
|
if an invalid or malformed option was given |
DriveSetSpindownTimeout (in'i'timeout_seconds, in'as'options, out's'cookie)
Configures spindown timeout for the drive.
Check the
DriveCanSpindown
property before attempting to invoke this method.
Caution should be exercised when using this method, see
the SPINNING DOWN DISKS section in the
udisks(1)
man page before using it.
|
Number of seconds before the drive should be spun down. |
|
Options related to setting spindown timeout. Currently no options are recognized. |
|
A cookie that can be used in the
DriveUnsetSpindownTimeout() method
to unset the spindown timeout of the device.
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
|
if an invalid or malformed option was given |
Unsets spindown timeout for the drive.
|
A cookie obtained from the
DriveSetSpindownTimeout() method.
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
Refreshes the ATA SMART data for the given drive. Note that this operation is not run as a job.
|
The option nowakeup can be passed to
avoid spinning up the disk if it's in a low-power mode.
The option simulate= can be used to pass a path to
a blob with libatasmart data to use instead of reading it from the disk.
The simulate= option can only be used by the super user.
|
|
if the caller lacks the appropriate PolicyKit authorization |
|
If the disk is sleeping and the nowakeup option was passed |
|
if the operation failed |
Runs a ATA SMART self test on the drive.
|
The name of the test to run; supported values are 'short' (usually less than ten minutes), 'extended' (usually tens of minutes) and 'conveyance' (usually a few minutes). |
|
Currently unused. |
|
if the caller lacks the appropriate PolicyKit authorization |
|
if the operation failed |
|
if the job was cancelled |
DriveBenchmark (in'b'do_write_benchmark, in'as'options, out'a(td)'read_transfer_rate_results, out'a(td)'write_transfer_rate_results, out'a(td)'access_time_results)
Benchmarks the drive.
|
If TRUE, write performance will be benchmarked in addition to read performance. Note that benchmarking write performance will scribble zeros in various parts of the drive and can only be used on a drive where the contents are completely unrecognized (e.g. no partition table and device). Use this option with caution. |
|
Currently unused. |
|
An array of pairs where the first element is the offset and the second element is the measured read transfer rate (in bytes/sec) at the given offset. |
|
An array of pairs where the first element is the offset and the second element is the measured read transfer rate (in bytes/sec) at the given offset. This is an empty array unless write benchmarking has been requested. |
|
An array of pairs where the first element is the offset and the second element the amount of time (in seconds) it took to seek to the position. |
Something on the device changed. Changes in job state wont
trigger this signal; see the JobChanged()
signal.
JobChanged ('b'job_in_progress, 'b'job_is_cancellable, 's'job_id, 'u'job_initiated_by_uid, 'd'job_percentage)
Emitted when a job on a device changes. Clients should listen to this signal to avoid polling the daemon for job state.
|
Whether a job is currently in progress. |
|
Whether the job is cancellable. |
|
The identifier of the job. |
|
The UNIX user id of the user who initiated the job. |
|
Percentage completed of the job (between 0 and 100, negative if unknown). |
OS specific native path of the device. On Linux this is the sysfs path, for example /sys/devices/pci0000:00/0000:00:1f.2/host2/target2:0:1/2:0:1:0/block/sda
.
The point in time (seconds since the Epoch Jan 1, 1970 0:00 UTC) when the device was detected by the daemon.
The point in time (seconds since the Epoch Jan 1, 1970 0:00 UTC) when the media currently in the device was detected by the daemon or 0 if the device has no media.
Major for the device or -1 if not set.
Major for the device or -1 if not set.
UNIX special device file for device. Example: /dev/sda
.
Either the value of the
DeviceFile
property, otherwise the preferred device file (typically a symlink to the value of the
DeviceFile
property) to present in user interface.
Example: /dev/mapper/mpathb
or
/dev/vg_phobos/lv_root
.
Symlinks to UNIX special device file that are stable and uniquely identifies the device.
Example: /dev/disk/by-id/scsi-SATA_ST910021AS_3MH05AVA
,
/dev/disk/by-id/ata-ST910021AS_3MH05AVA
.
Symlinks to UNIX special device file that uniquely identifies the port/partition the device
is plugged into. Example: /dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:1:0
TRUE if the device is considered system internal. Typically, system internal devices include non-removable internal hard disks and other drives that are not easily added/removed by a local console user. The heuristic typically used is that only devices on removable media and devices connected via Firewire, USB, eSATA and SDIO are considered external.
TRUE if the device is a partition. See the properties starting with partition- for details.
TRUE if the device contains a partition table. See partition- properties for details.
TRUE if the device contains removable media.
TRUE if media is available in the device.
TRUE if media changes are detected.
TRUE if media changes are detected through the host polling the device, e.g. waking up every two seconds to revalidate the media. This typically keeps the device in a high power state and uses cycles on the CPU. As an example, SATA AN capable optical drives does not need polling.
'DeviceIsMediaChangeDetectionInhibitable'read'b'
TRUE if it is possible to inhibit media detection on the device (to avoid keeping the device in a high power state and waking up the host).
TRUE if media detection is inhibited (to avoid keeping the device in a high power state and waking up the host).
TRUE if the device read-only.
TRUE if the device is a drive. See the drive- properties for details.
TRUE if the device is an optical drive and an optical disc is inserted. See the optical-disc- properties for details.
TRUE if the device is mounted.
A list of paths in the root namespace where the root of the device is mounted.
This property is only valid if
DeviceIsMounted
is TRUE.
The UNIX user id of the user who mounted the device. Set to 0 if
not mounted by udisks.
This property is only valid if
DeviceIsMounted
is TRUE.
TRUE if device is an LUKS encrypted device. See Lucks properties for details.
TRUE if device is a cleartext device backed by a LUKS encrypted device. See LucksCleartext properties for details.
TRUE if the device is a Linux md RAID component. See LinuxMdComponent properties for details.
TRUE if the device is a Linux md RAID array. See LinuxMd properties for details.
TRUE if the device is a Linux LVM2 logical volume. See LinuxLvm2LV properties for details.
TRUE if the device is a Linux LVM2 physical. See LinuxLvm2PV properties for details.
TRUE if the device is a component (e.g. active path) of a Linux dm-multipath device.
TRUE if the device is a Linux dm-multipath device.
TRUE if the device is a Linux loop device.
The size of the device in bytes.
The block size of the device in bytes.
A hint if the device should be hidden from the user interface.
A hint if the device (or e.g. the multi-disk device that the device is part of) shouldn't be automatically mounted / assembled.
The name to use when presenting the device to an end user.
The icon to use when presenting the device to an end user. If set, must be a name following the freedesktop.org icon theme specification.
A hint to the desktop that indicates if a device should be automounted. Possible values are:
An empty string is interpreted to mean that there is no hint - the desktop auto-mounter should make its own decision of whether to auto-mount the device.
The job properties specify if a job initiated via the udisks daemon is currently in progress.
This property is used to identify the job and maps 1-1 with the names of the method calls on this interface, e.g. 'FilesystemCreate' and so on.
The UNIX user id of the user who initiated the job.
Whether the job can be cancelled
using JobCancel()
method.
Percentage completed of the job (between 0 and 100, negative if unknown).
A result of probing for signatures on the block device; known values are:
If blank, no known signature was detected. This doesn't necessarily mean the device contains no structured data; it only means that no signature known to the probing code was detected.
This property contains more information about the result
of probing the block device. It's value depends of the
value the
IdUsage
property:
ext3
, vfat
)crypto_LUKS
mbr
(for the
Master Boot Record
scheme),
gpt
(for the
GUID Partition Table
scheme),
apm
(for the
Apple Partition Map
scheme).
LVM1_member
(for Linux LVM1 components),
LVM2_member
(for Linux LVM2 components),
linux_raid_member
(for Linux md (Software RAID) components)
swap
(for swap space),
suspend
(data used when resuming from STD)
The version of the
detected file system (or other identified data structure) identified by the
IdUsage
and
IdType
properties.
The UUID (universally unique identifier) of the
detected file system (or other identified data structure) identified by the
IdUsage
and
IdType
properties.
The user-visible label of the
detected file system (or other identified data structure) identified by the
IdUsage
and
IdType
properties.
The cleartext device that is using the LUKS device.
This property is only valid if
DeviceIsLuks
is TRUE.
The encrypted LUKS device backing a crypto cleartext device.
This property is only valid if
DeviceIsLuksCleartext
is TRUE.
The UNIX user id of the user who unlocked the LUKS device. Set to 0 if
not unlocked by udisks.
This property is only valid if
DeviceIsLuksCleartext
is TRUE.
The object path of the partition table the partition is part of.
This property is only valid if
DeviceIsPartition
is TRUE.
The scheme of the partition table this partition is part of.
See the scheme
parameter of the
PartitionTableCreate()
method
for details on known partitioning schemes.
This property is only valid if
DeviceIsPartition
is TRUE.
The type of the partition.
See the type
parameter of the
PartitionCreate()
method
for details on known partitioning types.
This property is only valid if
DeviceIsPartition
is TRUE.
The label of the partition.
See the label
parameter of the
PartitionCreate()
method
for details on partition labels.
This property is only valid if
DeviceIsPartition
is TRUE.
The UUID of the partition.
See the uuid
parameter of the
PartitionCreate()
method
for details on partition UUID's.
This property is only valid if
DeviceIsPartition
is TRUE.
Partition flags.
See the flags
parameter of the
PartitionCreate()
method
for details on partition flags.
This property is only valid if
DeviceIsPartition
is TRUE.
Number of the partition. Typically partition numbers start at 1 and are identical
to the numbers used by the kernel. Note that partitions may not be sequentially
numbered.
This property is only valid if
DeviceIsPartition
is TRUE.
Offset in bytes where the partition is located on the enclosing partition table device (see
PartitionSlave
).
This property is only valid if
DeviceIsPartition
is TRUE.
Size of the partition in bytes.
This property is only valid if
DeviceIsPartition
is TRUE.
The amount of bytes the beginning of the partition is offset
from the disk's natural alignment.
This property is only valid if
DeviceIsPartition
is TRUE.
The scheme of the partition table.
See the scheme
parameter of the
PartitionTableCreate()
method
for details on known partitioning schemes.
This property is only valid if
DeviceIsPartitionTable
is TRUE.
Number of partitions in the partition table.
This property is only valid if
DeviceIsPartitionTable
is TRUE.
Name of the vendor of the drive, for example MATSHITA
or BELKIN
.
This property is only valid if
DeviceIsDrive
is TRUE.
Name of the model of the drive, for example ST910021AS
or USB 2 HS-CF
.
This property is only valid if
DeviceIsDrive
is TRUE.
Revision of the drive, for example 3.07
or 1.95
.
This property is only valid if
DeviceIsDrive
is TRUE.
The serial number of the drive or blank if unknown.
Examples: 3MH05AVA
, A0000001B900
.
This property is only valid if
DeviceIsDrive
is TRUE.
The World Wide Name
in hex (without a leading "0x") or blank if the drive has no WWN.
Example: 50014ee0016eb572
.
This property is only valid if
DeviceIsDrive
is TRUE.
The rotational rate of the disk (e.g. 4200, 5400, 5900, 7200, 10000, 15000) in rounds
per minute or 0 if unknown.
This property is only valid if
DeviceIsDrive
is TRUE and
DriveIsRotational
is TRUE.
Whether the write cache is enabled, known values include "enabled" and "disabled" and
the blank string if unknown.
This property is only valid if
DeviceIsDrive
is TRUE.
The interface through which the drive is connected. Known values include:
This property is only valid if
DeviceIsDrive
is TRUE.
The nominal speed of the connection interface in bits per
second. If unknown this property is set to 0.
This property is only valid if
DeviceIsDrive
is TRUE.
An array of media types that can be used in the drive. This property is sometimes set using quirk files if the hardware isn't capable of precisely reporting it. Known values include:
This property is only valid if
DeviceIsDrive
is TRUE.
The type of media currently in the drive (blank if no media is available). Known
values include the ones listed for the
DriveMediaCompatibility
property.
This property is only valid if
DeviceIsDrive
is TRUE.
TRUE only if the media can be physically ejected by issuing a command
from the host to the drive (e.g. optical and Zip drives).
This property is only valid if
DeviceIsDrive
is TRUE.
TRUE only if the drive is capable of being detached by
e.g. powering down the port it is connected to.
This property is only valid if
DeviceIsDrive
is TRUE.
TRUE only if the drive is capable of being put into
a standby mode (typically powering down the spindle motor).
This property is only valid if
DeviceIsDrive
is TRUE.
TRUE if the disk uses rotational media, such as a hard disk.
This property is only valid if
DeviceIsDrive
is TRUE.
The object of the storage adapter for the drive or "/" if no adapter exists.
This property is only valid if
DeviceIsDrive
is TRUE.
The object paths of the ports for the drive or empty if no ports exist.
This property is only valid if
DeviceIsDrive
is TRUE.
An array of object paths for devices with similar serial number and/or WWN.
Typically all drives with similar serial number and/or WWN
are configured as a multipath device (for example via the
Linux device-mapper target cf.
DeviceIsLinuxDmmp
and
DeviceIsLinuxDmmpComponent
)
but in some cases the OS needs manual configuration.
Presentation-level software can (and should) display a
warning when this property is non-empty and the device
isn't a multipath component or multipath device e.g. when both
DeviceIsLinuxDmmpComponent
) and
DeviceIsLinuxDmmp
)
is FALSE.
This property is only valid if
DeviceIsDrive
is TRUE.
TRUE only if the disc is appendable.
This property is only valid if
DeviceIsOpticalDisc
is TRUE.
TRUE only if the disc is appendable.
This property is only valid if
DeviceIsOpticalDisc
is TRUE.
TRUE only if the disc is appendable.
This property is only valid if
DeviceIsOpticalDisc
is TRUE.
Number of tracks on the disc.
This property is only valid if
DeviceIsOpticalDisc
is TRUE.
Number of audio tracks on the disc.
This property is only valid if
DeviceIsOpticalDisc
is TRUE.
Number of sessions on the disc.
This property is only valid if
DeviceIsOpticalDisc
is TRUE.
TRUE if the disk is capable of reporting SMART data, FALSE otherwise.
The point in time (seconds since the Epoch Jan 1, 1970
0:00 UTC) when ATA SMART data was collected.
This property is only valid if
DriveAtaSmartTimeCollected
is greater than zero.
The overall assessment for the disk. Is one of the following strings
GOOD,
BAD_ATTRIBUTES_IN_THE_PAST (At least one pre-fail attribute is exceeded its threshold in the past),
BAD_SECTOR (At least one bad sector),
BAD_ATTRIBUTE_NOW (At least one pre-fail attribute is exceeding its threshold now),
BAD_SECTOR_MANY (Many bad sectors)),
BAD_STATUS (Smart Self Assessment negative)
or empty if some error occured trying to determine the result.
This property is only valid if
DriveAtaSmartTimeCollected
is greater than zero.
A blob containing the ATA SMART data. This blob can be used with libatasmart to get
more information.
This property is only valid if
DriveAtaSmartTimeCollected
is greater than zero.
The RAID level of the array the component is part of. Known values include
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The zero-based position of the component or -1 if not part of a running array.
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The number of component devices in the array the component is part of.
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The UUID of the array the component is part of.
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The name of the array the component is part of. Blank if the array
doesn't have a name (e.g. pre-1.0 meta data).
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The home host of the array the component is part of, e.g. where it was created. Blank if the array
has pre-1.0 meta data.
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The version of superblock of the component.
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The holder of the component or "/" if the component isn't claimed by any array.
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE.
The state of the component (contents of md/dev-XXX/state file).
This property is only valid if
DeviceIsLinuxMdComponent
is TRUE and
DeviceIsLinuxMdComponentHolder
is non-empty.
The state of the array (contents of the md/array_state file).
This property is only valid if
DeviceIsLinuxMd
is TRUE.
The RAID level of the array. For known values see the
LinuxMdComponentLevel
property.
This property is only valid if
DeviceIsLinuxMd
is TRUE.
The UUID of the array.
This property is only valid if
DeviceIsLinuxMd
is TRUE.
The home host of the array, e.g. where if was created. Blank if the array
has pre-1.0 meta data.
DeviceIsLinuxMd
is TRUE.
The name of the array. Blank if the array
doesn't have a name (e.g. pre-1.0 meta data).
DeviceIsLinuxMd
is TRUE.
Number of component devices in the array.
This property is only valid if
DeviceIsLinuxMd
is TRUE.
Metadata version used in the components.
This property is only valid if
DeviceIsLinuxMd
is TRUE.
An array of object paths for components currently part of the array.
This property is only valid if
DeviceIsLinuxMd
is TRUE.
TRUE only if the array is running in degraded mode.
This property is only valid if
DeviceIsLinuxMd
is TRUE.
The operation currently pending on the array. Known values include
This property is only valid if
DeviceIsLinuxMd
is TRUE.
The progress of the current sync operation.
This property is only valid if
DeviceIsLinuxMd
is TRUE and the value of the property
LinuxMdSyncAction
is not idle
.
The speed of the sync operation in bytes per second.
This property is only valid if
DeviceIsLinuxMd
is TRUE and the value of the property
LinuxMdSyncAction
is not idle
.
The UUID of the PV.
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The number of metadata areas on the PV.
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The name of the volume group (that this physical volume belongs to).
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The UUID of the volume group (that this physical volume belongs to).
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The size of the volume group (that this physical volume belongs to) in bytes.
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The unallocated size of the volume group (that this physical volume belongs to) in bytes.
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The sequence number for the volume group (that this physical volume belongs to).
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The extent size for the volume group (that this physical volume belongs to) in bytes.
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The physical volumes that belongs to the volume group (that this physical volume belongs to).
Each element is a semicolon separated list of key/value pairs. The only known key/value
type as this point is uuid for the UUID of the physical volume.
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The logical volumes that belongs to the volume group (that this physical volume belongs to).
Each element is a semicolon separated list of key/value pairs. The only known key/value
types as this point are
uuid (for the UUID of the logical volume),
name (for the name of the logical volume),
size (for the size of the logical volume) and
active (whether the logical volume is active).
This property is only valid if
DeviceIsLinuxLvm2PV
is TRUE.
The name of the logical volume.
This property is only valid if
DeviceIsLinuxLvm2LV
is TRUE.
The UUID of the logical volume.
This property is only valid if
DeviceIsLinuxLvm2LV
is TRUE.
The name of volume group the logical volume belongs to.
This property is only valid if
DeviceIsLinuxLvm2LV
is TRUE.
The UUID of the volume group the logical volume belongs to.
This property is only valid if
DeviceIsLinuxLvm2LV
is TRUE.
The object path of the multi-path device the component is currently part of.
This property is only valid if
DeviceIsLinuxDmmpComponent
is TRUE.
The symbolic name for the multipath device, e.g. mpathb
.
This property is only valid if
DeviceIsLinuxDmmp
is TRUE.
The object paths of currently active component devices, e.g. paths.
This property is only valid if
DeviceIsLinuxDmmp
is TRUE.
The parameters/configuration for the multipath device.
This property is only valid if
DeviceIsLinuxDmmp
is TRUE.
The file backing the loop device.
This property is only valid if
DeviceIsLinuxLoop
is TRUE.