1UDISKS(7) udisks UDISKS(7)
2
6 udisks - Storage Management
7
9 udisks provides an interface to enumerate storage devices and perform
10 operations on them. Any application can access the
11 org.freedesktop.UDisks service on the system message bus. Some
12 operations (such as formatting disks etc.) is restricted using polkit.
13
15 On Linux, udisks relies on recent versions of udev(7) and the kernel.
16 Influential device properties in the udev database include:
17 UDISKS_PRESENTATION_HIDE
19 If set to 1 this is a hint to presentation level software that the
20 device should not be shown to the user.
21 UDISKS_PRESENTATION_NOPOLICY
23 If set to 1 this is a hint to presentation level software that the
24 device should not be automounted or autoassembled (for e.g.
25 components of a multi-disk device).
26 UDISKS_DISABLE_POLLING
28 If set to 1 this will disable the polling of drives for media
29 changes, for devices which do not send out media notifications by
30 themselves (this mostly affects CD drives). Some CD drives cause
31 bad effects such as very high CPU usage when being polled.
32 UDISKS_PRESENTATION_NAME
34 The name to user for the device when presenting it to the user.
35 UDISKS_PRESENTATION_ICON_NAME
37 The icon to use when presenting the device to the user. If set, the
38 name must follow the freedesktop.org icon theme specification.
39 The ID_DRIVE_* properties are used to describe what kind of physical
41 media can be used in a device. These are typically set on the main
42 block device (e.g. /dev/sdb) and more than one these properties can be
43 set if the device supports multiple kinds of media.
44 ID_DRIVE_EJECTABLE
46 Whether the media in the drive is physically ejectable. Only set
47 this to 1 (or 0) if the drive truly uses (or doesn´t) ejectable
48 media. In particular, it is not necessary to set this for e.g. iPod
49 or Kindle devices where it is necessary to send a command via
50 eject(1) since the desktop user session will offer this option for
51 removable devices regardless of whether they are ejectable. If this
52 property is not set, a heuristic will be used to determine if the
53 media is ejectable (drives using optical, Zip or Jaz media are
54 considered ejectable).
55 ID_DRIVE_DETACHABLE
57 Whether the device is detachable. It is only meaningful to set this
58 to 0 (to avoid marking a device as detachable) since the code for
59 detaching the device is part of udisks itself. If this property is
60 not set, a heuristic will be used to determine if the drive is
61 detachable (currently only devices connected through USB are
62 detachable).
63 ID_DRIVE_CAN_SPINDOWN
65 Whether the device can spin down. It is only meaningful to set this
66 to 0 (to avoid marking a device as being capable of spinning down)
67 since the code for spinning down the device is part of udisks
68 itself. If this property is not set, a heuristic will be used to
69 determine if the drive can spin down (currently only ATA devices,
70 including those USB devices with a SAT layer) can be spun down).
71 ID_DRIVE_FLASH
73 The device is compatible with flash.
74 ID_DRIVE_FLASH_CF
76 The device is compatible with Compact Flash.
77 ID_DRIVE_FLASH_MS
79 The device is compatible with Memory Stick.
80 ID_DRIVE_FLASH_SM
82 The device is compatible with SmartMedia.
83 ID_DRIVE_FLASH_SD
85 The device is compatible with SecureDigital.
86 ID_DRIVE_FLASH_SDHC
88 The device is compatible with High-Capicity SecureDigital.
89 ID_DRIVE_FLASH_MMC
91 The device is compatible with MultiMediaCard.
92 ID_DRIVE_FLOPPY
94 The device is compatible with floppy disk.
95 ID_DRIVE_FLOPPY_ZIP
97 The device is compatible with Zip.
98 ID_DRIVE_FLOPPY_JAZ
100 The device is compatible with Jaz.
101 The ID_DRIVE_MEDIA_* properties describe the current media in a device.
103 As with the ID_DRIVE_* properties, these properties are typically set
104 on the main block device (e.g. /dev/sdb). Typically only one of these
105 properties are set.
106 ID_DRIVE_MEDIA_FLASH
108 The physical media currently inserted into the device is flash.
109 ID_DRIVE_MEDIA_FLASH_CF
111 The physical media currently inserted into the device is Compact
112 Flash.
113 ID_DRIVE_MEDIA_FLASH_MS
115 The physical media currently inserted into the device is Memory
116 Stick.
117 ID_DRIVE_MEDIA_FLASH_SM
119 The physical media currently inserted into the device is
120 SmartMedia.
121 ID_DRIVE_MEDIA_FLASH_SD
123 The physical media currently inserted into the device is
124 SecureDigital.
125 ID_DRIVE_MEDIA_FLASH_SDHC
127 The physical media currently inserted into the device is
128 High-Capicity SecureDigital.
129 ID_DRIVE_MEDIA_FLASH_MMC
131 The physical media currently inserted into the device is
132 MultiMediaCard.
133 ID_DRIVE_MEDIA_FLOPPY
135 The physical media currently inserted into the device is floppy
136 disk.
137 ID_DRIVE_MEDIA_FLOPPY_ZIP
139 The physical media currently inserted into the device is Zip.
140 ID_DRIVE_MEDIA_FLOPPY_JAZ
142 The physical media currently inserted into the device is Jaz.
143
145 TODO: write me.
146
148 Written by David Zeuthen david@fubar.dk with a lot of help from many
149 others.
150
152 Please send bug reports to either the distribution bug tracker or the
153 upstream bug tracker at
154 http://bugs.freedesktop.org/enter_bug.cgi?product=udisks.
155
157 udev(7), polkit(8), udisks-daemon(8), udisks-tcp-bridge(1), udisks(1)
158udisks March 2008 UDISKS(7)