1UDISKS(7) udisks UDISKS(7)
2
3
4
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
18 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
22 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
27 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
33 UDISKS_PRESENTATION_NAME
34 The name to user for the device when presenting it to the user.
35
36 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
40 UDISKS_AUTOMOUNT_HINT
41 A variable to influence whether a device should be automounted.
42 Possible values include "always" (to hint that a device should
43 always be automounted) and "never" (to hint that a device should
44 never be automounted). Note that this is only a hint - the
45 auto-mounter might not honor it.
46
47 UDISKS_SYSTEM_INTERNAL
48 If set, this will override the usual bus type based detection of
49 whether a device is considered "system internal". "0" means
50 "removable" (i. e. eligible for automounting, and normal users can
51 mount), any other value means "system internal" (i. e. no
52 automounting, and only administrators can mount).
53
54 The ID_DRIVE_* properties are used to describe what kind of physical
55 media can be used in a device. These are typically set on the main
56 block device (e.g. /dev/sdb) and more than one these properties can be
57 set if the device supports multiple kinds of media.
58
59 ID_DRIVE_EJECTABLE
60 Whether the media in the drive is physically ejectable. Only set
61 this to 1 (or 0) if the drive truly uses (or doesn't) ejectable
62 media. In particular, it is not necessary to set this for e.g. iPod
63 or Kindle devices where it is necessary to send a command via
64 eject(1) since the desktop user session will offer this option for
65 removable devices regardless of whether they are ejectable. If this
66 property is not set, a heuristic will be used to determine if the
67 media is ejectable (drives using optical, Zip or Jaz media are
68 considered ejectable).
69
70 ID_DRIVE_DETACHABLE
71 Whether the device is detachable. It is only meaningful to set this
72 to 0 (to avoid marking a device as detachable) since the code for
73 detaching the device is part of udisks itself. If this property is
74 not set, a heuristic will be used to determine if the drive is
75 detachable (currently only devices connected through USB are
76 detachable).
77
78 ID_DRIVE_CAN_SPINDOWN
79 Whether the device can spin down. It is only meaningful to set this
80 to 0 (to avoid marking a device as being capable of spinning down)
81 since the code for spinning down the device is part of udisks
82 itself. If this property is not set, a heuristic will be used to
83 determine if the drive can spin down (currently only ATA devices,
84 including those USB devices with a SAT layer) can be spun down).
85
86 ID_DRIVE_FLASH
87 The device is compatible with flash.
88
89 ID_DRIVE_FLASH_CF
90 The device is compatible with Compact Flash.
91
92 ID_DRIVE_FLASH_MS
93 The device is compatible with Memory Stick.
94
95 ID_DRIVE_FLASH_SM
96 The device is compatible with SmartMedia.
97
98 ID_DRIVE_FLASH_SD
99 The device is compatible with SecureDigital.
100
101 ID_DRIVE_FLASH_SDHC
102 The device is compatible with High-Capicity SecureDigital.
103
104 ID_DRIVE_FLASH_MMC
105 The device is compatible with MultiMediaCard.
106
107 ID_DRIVE_FLOPPY
108 The device is compatible with floppy disk.
109
110 ID_DRIVE_FLOPPY_ZIP
111 The device is compatible with Zip.
112
113 ID_DRIVE_FLOPPY_JAZ
114 The device is compatible with Jaz.
115
116 The ID_DRIVE_MEDIA_* properties describe the current media in a device.
117 As with the ID_DRIVE_* properties, these properties are typically set
118 on the main block device (e.g. /dev/sdb). Typically only one of these
119 properties are set.
120
121 ID_DRIVE_MEDIA_FLASH
122 The physical media currently inserted into the device is flash.
123
124 ID_DRIVE_MEDIA_FLASH_CF
125 The physical media currently inserted into the device is Compact
126 Flash.
127
128 ID_DRIVE_MEDIA_FLASH_MS
129 The physical media currently inserted into the device is Memory
130 Stick.
131
132 ID_DRIVE_MEDIA_FLASH_SM
133 The physical media currently inserted into the device is
134 SmartMedia.
135
136 ID_DRIVE_MEDIA_FLASH_SD
137 The physical media currently inserted into the device is
138 SecureDigital.
139
140 ID_DRIVE_MEDIA_FLASH_SDHC
141 The physical media currently inserted into the device is
142 High-Capicity SecureDigital.
143
144 ID_DRIVE_MEDIA_FLASH_MMC
145 The physical media currently inserted into the device is
146 MultiMediaCard.
147
148 ID_DRIVE_MEDIA_FLOPPY
149 The physical media currently inserted into the device is floppy
150 disk.
151
152 ID_DRIVE_MEDIA_FLOPPY_ZIP
153 The physical media currently inserted into the device is Zip.
154
155 ID_DRIVE_MEDIA_FLOPPY_JAZ
156 The physical media currently inserted into the device is Jaz.
157
159 TODO: write me.
160
162 Written by David Zeuthen <david@fubar.dk> with a lot of help from many
163 others.
164
166 Please send bug reports to either the distribution bug tracker or the
167 upstream bug tracker at
168 http://bugs.freedesktop.org/enter_bug.cgi?product=udisks.
169
171 udev(7), polkit(8), udisks-daemon(8), udisks-tcp-bridge(1), udisks(1)
172
173
174
175udisks March 2008 UDISKS(7)