![]() |
![]() |
![]() |
UDisks Reference Manual | ![]() |
---|
udisksudisks — storage management |
udisks provides an interface to enumerate and perform operations on storage devices. Any application can access the udisksd(8) daemon via the name org.freedesktop.UDisks2 on the system message bus. Some operations (such as formatting disks etc.) are restricted using polkit(8).
By default, logged-in users in active log-in sessions are
permitted to mount and unlock devices attached to the local
console. To lock down globally, configure the
polkit(8)
authorizations for the actions
filesystem-mount
,
filesystem-mount-system
,
encrypted-unlock
and
encrypted-unlock-system
, all in the
org.freedesktop.udisks2
namespace.
Note that the actions ending in -system
typically requires administrator authentication and are used for
devices not considered "removable" (devices considered
"removable" include USB attached storage, Flash media, optical
discs etc.). The udev property UDISKS_SYSTEM
can be used to override this on a per-device basis, see below.
To lock down access on a per-device basis, use the option
x-udisks-auth
in the
/etc/fstab
file and the option
x-udisks-auth
in the
/etc/crypttab
file.
On Linux, udisks relies on recent versions of udev(7) and the Linux kernel. Influential device properties in the udev database include:
|
If set, this overrides the value of the HintSystem property. |
|
If set, this overrides the value of the HintIgnore property. |
|
If set, this overrides the value of the HintAuto property. |
|
The name to use for the device when presenting it in an user interface. This corresponds to the HintName property. |
|
The icon to use for the device when presenting it in an user interface. If set, the name must adhere to the freedesktop.org icon theme specification. This corresponds to the HintIconName property. |
For media and drive identification, the output of the probers supplied by udev(7) (such as cdrom_id, ata_id and scsi_id) are used in addition to the following properties:
|
The device is a thumb-drive with non-removable media (e.g. a USB stick). |
|
The device is compatible with flash. |
|
The device is compatible with Compact Flash. |
|
The device is compatible with Memory Stick. |
|
The device is compatible with SmartMedia. |
|
The device is compatible with SecureDigital. |
|
The device is compatible with High-Capacity SecureDigital. |
|
The device is compatible with Extended-Capacity SecureDigital. |
|
The device is compatible with MultiMediaCard. |
|
The device is compatible with floppy disk. |
|
The device is compatible with Zip. |
|
The device is compatible with Jaz. |
While the ID_DRIVE_*
properties describe what
kind of media the drive accepts (more than one property can be
set) and correspond to the MediaCompatibility
property, the ID_DRIVE_MEDIA_*
properties
describe the current media in a device (typically only one of
these properties are set) and correspond to the Media
property:
|
The physical media currently inserted into the device is flash. |
|
The physical media currently inserted into the device is Compact Flash. |
|
The physical media currently inserted into the device is Memory Stick. |
|
The physical media currently inserted into the device is SmartMedia. |
|
The physical media currently inserted into the device is SecureDigital. |
|
The physical media currently inserted into the device is High-Capacity SecureDigital. |
|
The physical media currently inserted into the device is Extended-Capacity SecureDigital. |
|
The physical media currently inserted into the device is MultiMediaCard. |
|
The physical media currently inserted into the device is floppy disk. |
|
The physical media currently inserted into the device is Zip. |
|
The physical media currently inserted into the device is Jaz. |
Please send bug reports to either the distribution bug tracker or the upstream bug tracker at http://bugs.freedesktop.org/enter_bug.cgi?product=udisks.