~ubuntu-branches/ubuntu/lucid/udisks/lucid

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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
OVERVIEW
========

The udisks project provides

 o  A storage daemon that implements well-defined D-Bus interfaces
    that can be used to query and manipulate storage devices.

 o  a command-line tool, udisks(1), that can be used to query and
    use the daemon

LICENSE
=======

See the COPYING file for the license.

VERSIONING and ABI STABILITY
============================

The udisks version number consists of three numbers separated by a .

 o  Major number indicating the feature version

 o  Minor number indicating the ABI for the current feature version

 o  Sub number indicating ABI additions

The ABI is guaranteed to be stable only when the major and minor
number does not change. For example, an application expecting version
1.0.12 will work with any 1.0.x release (such as 1.0.99) as long as
e.g. x >= 12.

The udisks version number can be obtained at compile time using
pkg-config(1):

 $ pkg-config --modversion udisks
 1.0.0

or any of the autoconf macros.

At run-time, the udisks version number can be obtained by querying the
DaemonVersion property (of type 's') on the org.freedesktop.UDisks
interface on the object /org/freedesktop/UDisks owned by the
well-known name org.freedesktop.UDisks on the D-Bus system message
bus. This property is guaranteed to always exist and contain the
version number no matter what the ABI version is:

 $ dbus-send --system                             \
             --print-reply                        \
             --dest=org.freedesktop.UDisks        \
             /org/freedesktop/UDisks              \
             org.freedesktop.DBus.Properties.Get  \
             string:org.freedesktop.UDisks        \
             string:DaemonVersion
  method return sender=:1.172 -> dest=:1.186 reply_serial=2
     variant       string "1.0.0"

BUGS and DEVELOPMENT
====================

Please report bugs via the freedesktop.org bugzilla at

 http://bugs.freedesktop.org/enter_bug.cgi?product=udisks

For feature development use the devkit-devel mailing list (need to be
subsribed to post)

 http://lists.freedesktop.org/archives/devkit-devel

See the HACKING file for details on code style.