1UDISKS(7)                           udisks                           UDISKS(7)
2
3
4

NAME

6       udisks - Storage Management
7

DESCRIPTION

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

DEVICE INFORMATION

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

REMOTE CLIENTS

156       TODO: write me.
157

AUTHOR

159       Written by David Zeuthen david@fubar.dk with a lot of help from many
160       others.
161

BUGS

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

SEE ALSO

168       udev(7), polkit(8), udisks-daemon(8), udisks-tcp-bridge(1), udisks(1)
169
170
171
172udisks                            March 2008                         UDISKS(7)
Impressum