summaryrefslogtreecommitdiff
path: root/Software/udisks.mdwn
blob: ed667ce5ee9d8817ab78194bcee17a6ae7de8b7a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# udisks

The udisks project provides: 

* a daemon, udisksd, that implements well-defined D-Bus interfaces that can be used to query and manipulate storage devices. 
* a command-line tool, udisksctl, that can be used to query and use the daemon 
The actions that a user can perform using udisks are restricted using [[polkit|Software/PolicyKit]]. 


## Download

The latest version can be downloaded from [[https://github.com/storaged-project/udisks/releases]]. Older versions are available at [[http://udisks.freedesktop.org/releases/]]. 


## Documentation

There is [[online documentation|http://storaged.org/doc/udisks2-api/]] available, which documents the D-Bus API and the command-line tools provided by udisks. 


## Bugs

When [[filing bugs against udisks|https://github.com/storaged-project/udisks/issues]], please include 

* the output of 'udisksctl dump' 
* the output of 'udevadm info --export-db' (as root) 
* the output of 'cat /proc/self/mountinfo' 
* the output of 'cat /etc/fstab' 
* the version of udisks, gvfs and libatasmart 
      * On Fedora/RHEL this is the output of 'rpm -q udisks2 gvfs libatasmart' 
If the bugs is related to the GNOME desktop please also include 

* the output of 'gvfs-mount -li' captured from the desktop session as the user (not root) 
If the bug happens when plugging in a device or activating a device also include 

* the output of 'udisksctl monitor' 
* the output of 'gvfs-mount -oi' captured from the desktop session as the user (not root) 
* the output of 'udevadm monitor --udev --property' (as root) 
while plugging in or activating the device. 

If the bug is related to ATA SMART include (replace /dev/sda with the device for the disk in question) 

* the output of 'skdump /dev/sda' (as root) 
* the binary file skdump-output obtained via 'skdump --save=skdump-output /dev/sda' (as root) 

## Hacking

Join the [[mailing list|http://lists.freedesktop.org/mailman/listinfo/devkit-devel]] to get involved with feature development. 

Development happens [[on GitHub|https://github.com/storaged-project/udisks]].

---

 [[CategoryHalReplacement|CategoryHalReplacement]]