NAME<\/a> udisks \u2212 Disk Manager<\/p>\n udisks provides interfaces to enumerate and perform operations on disks and storage devices. Any application (including unprivileged ones) can access the udisksd<\/b>(8) daemon via the name org.freedesktop.UDisks2<\/i> on the system message bus<\/font><\/b> [1]<\/font><\/small> . In addition to the D\u2212Bus API, a library, libudisks2 is also provided. This library can be used from C\/C++ and any high\u2212level language with<\/font> GObjectIntrospection<\/font><\/b> [2]<\/font><\/small> support such as Javascript and Python. udisks is only indirectly involved in what devices and objects are shown in the user interface.<\/font><\/p>\n By default, logged\u2212in users in active log\u2212in sessions are permitted to perform operations (for example, mounting, unlocking or modifying) on devices attached to the seat their session is on. Access\u2212control is fine\u2212grained and based on polkit<\/b>(8), see the \u201cAuthorization Checks\u201d chapter in the udisks documentation for more information. Note that the x\u2212udisks\u2212auth option can be used in the \/etc\/fstab and \/etc\/crypttab files to specify that additional authorization is required to mount resp. unlock the device (typically requiring the user to authenticate as an administrator).<\/font><\/p>\n At start\u2212up and when a drive is connected, udisksd<\/b>(8) will apply configuration stored in the file \/etc\/udisks2\/IDENTIFIER.conf where IDENTIFIER<\/i> is the value of the Drive:Id property for the drive. If the file changes on disk its new contents will also be applied to the drive. Typically, users or administrators will never need to edit drive configuration files as they are effectively managed through graphical applications such as gnome-disks<\/b>(1). Manually editing configuration files is however supported \u2014 the file format is a simple .ini\u2212like format<\/i> (see the<\/font> Desktop Entry Specification<\/font><\/b> [3]<\/font><\/small> for the exact syntax). New groups and keys may be added in the future.<\/font><\/p>\n ATA group<\/b> StandbyTimeout<\/b><\/font><\/p>\n The standby timeout. A value of zero means “timeouts are disabled”: the device will not automatically enter standby mode. Values from 1 to 240 specify multiples of 5 seconds, yielding timeouts from 5 seconds to 20 minutes. Values from 241 to 251 specify from 1 to 11 units of 30 minutes, yielding timeouts from 30 minutes to 5.5 hours. A value of 252 signifies a timeout of 21 minutes. A value of 253 sets a vendor\u2212defined timeout period between 8 and 12 hours, and the value 254 is reserved. 255 is interpreted as 21 minutes plus 15 seconds. Note that some older drives may have very different interpretations of these values. This is similar to the \u2212S<\/b> option in hdparm<\/b>(8).<\/font><\/p>\n APMLevel<\/b><\/font><\/p>\n The Advanced Power Management level. A low value means aggressive power management and a high value means better performance. Possible settings range from values 1 through 127 (which permit spin\u2212down), and values 128 through 254 (which do not permit spin\u2212down). The highest degree of power management is attained with a setting of 1, and the highest I\/O performance with a setting of 254. A value of 255 can be used to disable Advanced Power Management altogether on the drive (not all drives support disabling it, but most do). This is similar to the \u2212B<\/b> option in hdparm<\/b>(8).<\/font><\/p>\n AAMLevel<\/b><\/font><\/p>\n The Automatic Acoustic Management level. Most modern harddisk drives have the ability to speed down the head movements to reduce their noise output. The possible values are between 0 and 254. 128 is the most quiet (and therefore slowest) setting and 254 the fastest (and loudest). Some drives have only two levels (quiet \/ fast), while others may have different levels between 128 and 254. At the moment, most drives only support 3 options, off, quiet, and fast. These have been assigned the values 0, 128, and 254 at present, respectively, but integer space has been incorporated for future expansion, should this change. This is similar to the \u2212M<\/b> option in hdparm<\/b>(8).<\/font><\/p>\n WriteCacheEnabled<\/b><\/font><\/p>\n A boolean specifying whether to enable or disable the Write Cache. Valid values for this key are \u201ctrue\u201d and \u201cfalse\u201d. This is similar to the \u2212W<\/b> option in hdparm<\/b>(8). This key was added in 2.1.<\/font><\/p>\n ReadLookaheadEnabled<\/b><\/font><\/p>\n A boolean specifying whether to enable or disable the Read Look\u2212ahead. Valid values for this key are \u201ctrue\u201d and \u201cfalse\u201d. This is similar to the \u2212A<\/b> option in hdparm<\/b>(8). This key was added in 2.6.0.<\/font><\/p>\n udisks relies on recent versions of udev<\/b>(7) and the Linux kernel. Influential device properties in the udev database include:<\/font><\/p>\n UDISKS_SYSTEM<\/b><\/font><\/p>\n If set, this overrides the value of the HintSystem property.<\/font><\/p>\n UDISKS_IGNORE<\/b><\/font><\/p>\n If set, this overrides the value of the HintIgnore property.<\/font><\/p>\n UDISKS_AUTO<\/b><\/font><\/p>\n If set, this overrides the value of the HintAuto property.<\/font><\/p>\n UDISKS_CAN_POWER_OFF<\/b><\/font><\/p>\n If set, this overrides the value of the CanPowerOff property.<\/font><\/p>\n UDISKS_NAME<\/b><\/font><\/p>\n The name to use for the device when presenting it in an user interface. This corresponds to the HintName property.<\/font><\/p>\n UDISKS_ICON_NAME<\/b><\/font><\/p>\n The icon to use for the device when presenting it in an user interface. If set, the name must adhere to the<\/font> freedesktop.org icon theme specification<\/font><\/b> [4]<\/font><\/small> . This corresponds to the HintIconName property.<\/font><\/p>\n UDISKS_SYMBOLIC_ICON_NAME<\/b><\/font><\/p>\n The icon to use for the device when presenting it in an user interface using a symbolic icon. If set, the name must adhere to the<\/font> freedesktop.org icon theme specification<\/font><\/b> [4]<\/font><\/small> . This corresponds to the HintSymbolicIconName property.<\/font><\/p>\n UDISKS_FILESYSTEM_SHARED<\/b><\/font><\/p>\n If set to 1, the filesystem on the device will be mounted in a shared directory (e.g. \/media\/VolumeName) instead of a private directory (e.g. \/run\/media\/$USER\/VolumeName) when the Filesystem.Mount() method is handled.<\/font><\/p>\n ID_SEAT<\/b><\/font><\/p>\n The physical seat the device is attached to. If unset or set to the empty string, \u201cseat0\u201d (the first seat) is assumed.<\/font><\/p>\n udisks guarantees a stable D\u2212Bus API within the same major version and this guarantee also extends to the client\u2212side library libudisks2. Additionally, several major versions of udisks can be installed and operate at the same time although interoperability may be limited \u2212 for example, a device mounted using the udisks N.x API may require additional authorization if attempting to unmount it through the the (N\u22121).x API.<\/font><\/p>\n The udisks developers do not anticipate breaking API but does reserve the right to do so and if it happens, promises to bump the major version and ensure the new major version of udisks is parallel\u2212installable with any older major version. However, note that programs, man pages and other artifacts may change name (for example, adopt a \u201c2\u201d suffix) to make room for the next major version. Therefore, applications can not rely on tools like e.g. udisksctl<\/b>(1) to be available. Additionally, there is no guarantee that the options, command\u2212line switches etc. of command\u2212line tools or similar will remain stable.<\/font><\/p>\n Instead, applications should only use the D\u2212Bus API, the libudisks2 library or tools such as dbus-send<\/b>(1) or gdbus<\/b>(1) to interact with udisksd<\/b>(8).<\/font><\/p>\n The intended audience of udisks include operating system developers working on the higher\u2212level parts of the operating system, for example the desktop shell (such as<\/font> GNOME<\/font><\/b> [5]<\/font><\/small> ) and disk management applications (e.g. GNOME’s<\/font> Disks<\/font><\/b> [6]<\/font><\/small> application). Software on this level typically depend on a specific (major) version of udisks and may even have support for previous versions of udisks or alternative interfaces performing the same role as udisks.<\/font><\/p>\n While udisks indeed provides a stable API and a clear upgrade path, it may not be an appropriate dependency for third party applications. For example, if the operating system switches to udisks version N.x and an application is still using the udisks (N\u22121).x API, the application will not work unless udisks (N\u22121).x is installed. While this situation is still workable (since both udisks N.x and udisks (N\u22121).x can be installed) it may not be desirable to ask the user to install the old version \u2212 in fact, the operating system vendor may not even provide a packaged version of the old version. Hence, if an application does not want to tie itself to a specific version of the operating system, it should not use udisks.<\/font><\/p>\n Viable alternatives to udisks are APIs that are guaranteed to be around for longer time\u2212frames, including:<\/font><\/p>\n \u2022 Low\u2212level APIs and commands such as e.g.<\/font> sysfs<\/font><\/b> [7]<\/font><\/small> ,<\/font> libudev<\/font><\/b> [8]<\/font><\/small> ,<\/font> \/proc\/self\/mountinfo<\/font><\/b> [9]<\/font><\/small> and<\/font> util\u2212linux<\/font><\/b> [10]<\/font><\/small> .<\/font><\/p>\n \u2022 High\u2212level APIs such as<\/font> GVolumeMonitor<\/font><\/b> [11]<\/font><\/small> .<\/font><\/p>\n In particular, for desktop applications it is a much better idea to use something like GVolumeMonitor since it will make the application show the same devices as the desktop shell (e.g. file manager, file chooser and so on) is showing.<\/font><\/p>\n This man page was originally written for UDisks2 by David Zeuthen Please send bug reports to either the distribution bug tracker or the upstream bug tracker at<\/font> https:\/\/github.com\/storaged-project\/udisks\/issues<\/font><\/b>.<\/font><\/p>\n udev<\/b>(7), polkit<\/b>(8), udisksd<\/b>(8), udisksctl<\/b>(1), umount.udisks2<\/b>(8), gnome-disks<\/b>(1)<\/font><\/p>\n 1.<\/font><\/p>\n<\/td>\n system message bus<\/font><\/p>\n<\/td>\n http:\/\/www.freedesktop.org\/wiki\/Software\/dbus<\/font><\/p>\n 2.<\/font><\/p>\n<\/td>\n GObjectIntrospection<\/font><\/p>\n<\/td>\n https:\/\/live.gnome.org\/GObjectIntrospection<\/font><\/p>\n 3.<\/font><\/p>\n<\/td>\n Desktop Entry Specification<\/font><\/p>\n<\/td>\n http:\/\/freedesktop.org\/wiki\/Specifications\/desktop-entry-spec<\/font><\/p>\n 4.<\/font><\/p>\n<\/td>\n freedesktop.org icon theme specification<\/font><\/p>\n<\/td>\n http:\/\/www.freedesktop.org\/wiki\/Specifications\/icon-theme-spec<\/font><\/p>\n 5.<\/font><\/p>\n<\/td>\n GNOME<\/font><\/p>\n<\/td>\n http:\/\/www.gnome.org<\/font><\/p>\n 6.<\/font><\/p>\n<\/td>\n Disks<\/font><\/p>\n<\/td>\n https:\/\/live.gnome.org\/Design\/Apps\/Disks<\/font><\/p>\n 7.<\/font><\/p>\n<\/td>\n sysfs<\/font><\/p>\n<\/td>\n http:\/\/en.wikipedia.org\/wiki\/Sysfs<\/font><\/p>\n 8.<\/font><\/p>\n<\/td>\n libudev<\/font><\/p>\n<\/td>\n https:\/\/www.freedesktop.org\/software\/systemd\/man\/libudev.html<\/font><\/p>\n 9.<\/font><\/p>\n<\/td>\n \/proc\/self\/mountinfo<\/font><\/p>\n<\/td>\n http:\/\/www.kernel.org\/doc\/Documentation\/filesystems\/proc.txt<\/font><\/p>\n 10.<\/font><\/p>\n<\/td>\n util-linux<\/font><\/p>\n<\/td>\n http:\/\/en.wikipedia.org\/wiki\/Util-linux<\/font><\/p>\n 11.<\/font><\/p>\n<\/td>\n GVolumeMonitor<\/font><\/p>\n<\/td>\n http:\/\/developer.gnome.org\/gio\/stable\/volume_mon.html<\/font><\/p>\n udisks \u2212 Disk Manager <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,4,272],"class_list":["post-3126","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-man8","tag-udisks"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3126","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3126"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3126\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3126"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3126"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3126"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
DESCRIPTION<\/a>
ACCESS CONTROL<\/a>
DRIVE CONFIGURATION<\/a>
DEVICE INFORMATION<\/a>
API STABILITY<\/a>
AUDIENCE<\/a>
AUTHOR<\/a>
BUGS<\/a>
SEE ALSO<\/a>
NOTES<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
DESCRIPTION <\/a> <\/h2>\n
ACCESS CONTROL <\/a> <\/h2>\n
DRIVE CONFIGURATION <\/a> <\/h2>\n
The ATA group is for settings that apply to drives using the ATA command\u2212set. The following keys are supported:<\/font><\/p>\nDEVICE INFORMATION <\/a> <\/h2>\n
API STABILITY <\/a> <\/h2>\n
AUDIENCE <\/a> <\/h2>\n
AUTHOR <\/a> <\/h2>\n
BUGS <\/a> <\/h2>\n
SEE ALSO <\/a> <\/h2>\n
NOTES <\/a> <\/h2>\n
\n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n \n
\n <\/td>\n \n <\/td>\n \n <\/td>\n<\/tr>\n<\/table>\n
\n","protected":false},"excerpt":{"rendered":"