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_MOUNT_OPTIONS
41 Additional mount options to be appended to the existing mount
42 options. Format is a comma separated list of options to pass to
43 mount.
44
45 UDISKS_MOUNT_OPTIONS_ALLOW
46 If set, this restricts the options allowed in mount. Format is a
47 comma separated list of possible options allowed to be passed to
48 mount (e.g.
49 "exec,noexec,nodev,nosuid,atime,noatime,nodiratime,ro,rw,sync,dirsync,uid=,gid=")
50
51 The ID_DRIVE_* properties are used to describe what kind of physical
52 media can be used in a device. These are typically set on the main
53 block device (e.g. /dev/sdb) and more than one these properties can be
54 set if the device supports multiple kinds of media.
55
56 ID_DRIVE_EJECTABLE
57 Whether the media in the drive is physically ejectable. Only set
58 this to 1 (or 0) if the drive truly uses (or doesn´t) ejectable
59 media. In particular, it is not necessary to set this for e.g. iPod
60 or Kindle devices where it is necessary to send a command via
61 eject(1) since the desktop user session will offer this option for
62 removable devices regardless of whether they are ejectable. If this
63 property is not set, a heuristic will be used to determine if the
64 media is ejectable (drives using optical, Zip or Jaz media are
65 considered ejectable).
66
67 ID_DRIVE_DETACHABLE
68 Whether the device is detachable. It is only meaningful to set this
69 to 0 (to avoid marking a device as detachable) since the code for
70 detaching the device is part of udisks itself. If this property is
71 not set, a heuristic will be used to determine if the drive is
72 detachable (currently only devices connected through USB are
73 detachable).
74
75 ID_DRIVE_CAN_SPINDOWN
76 Whether the device can spin down. It is only meaningful to set this
77 to 0 (to avoid marking a device as being capable of spinning down)
78 since the code for spinning down the device is part of udisks
79 itself. If this property is not set, a heuristic will be used to
80 determine if the drive can spin down (currently only ATA devices,
81 including those USB devices with a SAT layer) can be spun down).
82
83 ID_DRIVE_FLASH
84 The device is compatible with flash.
85
86 ID_DRIVE_FLASH_CF
87 The device is compatible with Compact Flash.
88
89 ID_DRIVE_FLASH_MS
90 The device is compatible with Memory Stick.
91
92 ID_DRIVE_FLASH_SM
93 The device is compatible with SmartMedia.
94
95 ID_DRIVE_FLASH_SD
96 The device is compatible with SecureDigital.
97
98 ID_DRIVE_FLASH_SDHC
99 The device is compatible with High-Capicity SecureDigital.
100
101 ID_DRIVE_FLASH_MMC
102 The device is compatible with MultiMediaCard.
103
104 ID_DRIVE_FLOPPY
105 The device is compatible with floppy disk.
106
107 ID_DRIVE_FLOPPY_ZIP
108 The device is compatible with Zip.
109
110 ID_DRIVE_FLOPPY_JAZ
111 The device is compatible with Jaz.
112
113 The ID_DRIVE_MEDIA_* properties describe the current media in a device.
114 As with the ID_DRIVE_* properties, these properties are typically set
115 on the main block device (e.g. /dev/sdb). Typically only one of these
116 properties are set.
117
118 ID_DRIVE_MEDIA_FLASH
119 The physical media currently inserted into the device is flash.
120
121 ID_DRIVE_MEDIA_FLASH_CF
122 The physical media currently inserted into the device is Compact
123 Flash.
124
125 ID_DRIVE_MEDIA_FLASH_MS
126 The physical media currently inserted into the device is Memory
127 Stick.
128
129 ID_DRIVE_MEDIA_FLASH_SM
130 The physical media currently inserted into the device is
131 SmartMedia.
132
133 ID_DRIVE_MEDIA_FLASH_SD
134 The physical media currently inserted into the device is
135 SecureDigital.
136
137 ID_DRIVE_MEDIA_FLASH_SDHC
138 The physical media currently inserted into the device is
139 High-Capicity SecureDigital.
140
141 ID_DRIVE_MEDIA_FLASH_MMC
142 The physical media currently inserted into the device is
143 MultiMediaCard.
144
145 ID_DRIVE_MEDIA_FLOPPY
146 The physical media currently inserted into the device is floppy
147 disk.
148
149 ID_DRIVE_MEDIA_FLOPPY_ZIP
150 The physical media currently inserted into the device is Zip.
151
152 ID_DRIVE_MEDIA_FLOPPY_JAZ
153 The physical media currently inserted into the device is Jaz.
154
156 TODO: write me.
157
159 Written by David Zeuthen david@fubar.dk with a lot of help from many
160 others.
161
163 Please send bug reports to either the distribution bug tracker or the
164 upstream bug tracker at
165 http://bugs.freedesktop.org/enter_bug.cgi?product=udisks.
166
168 udev(7), polkit(8), udisks-daemon(8), udisks-tcp-bridge(1), udisks(1)
169
170
171
172udisks March 2008 UDISKS(7)