FM / udisks2

/usr/share/doc/udisks2

Name	Size	Mode	Actions
AUTHORS.gz	1959	0644	edit dl rm
changelog.Debian.gz	1405	0644	edit dl rm
copyright	1302	0644	edit dl rm
NEWS.gz	33179	0644	edit dl rm
README.md	2953	0644	edit dl rm

Edit: /usr/share/doc/udisks2/README.md (2953B)

CI status
=========

OVERVIEW
========

The UDisks project provides a daemon, tools and libraries to access and
manipulate disks, storage devices and technologies.

For API stability and intended audience of UDisks, see the API STABILITY and
AUDIENCE section of the `udisks(8)` man page (`doc/man/udisks.xml` in the
tarball and git repository).

LICENSE
=======

See the COPYING file for the license. In a nutshell, the daemon and tools are
licensed under the GPLv2 (or later) and libraries are licensed under LGPLv2 (or
later).

INSTALLATION
============

UDisks has several dependencies listed in `packaging/udisks2.spec`.

If you run rpm based distro, install the dependencies by:

# dnf builddep -y packaging/udisks2.spec

AUTOTOOLS
---------

To configure and install the UDisks, perform following tasks:

$ ./autogen.sh

Additional functionality of UDisks for monitoring and management is split
into several modules: *BCache, BTRFS, iSCSI, libStorageManagement, LVM2, LVM
Cache and zRAM*. By default, no additional module will be built.

To build UDisks with (a) chosen module(s), provide or leave these
configuration options for the `configure` script:

$ ./configure --enable-bcache --enable-btrfs --enable-iscsi
                  --enable-lsm --enable-lvm2 --enable-lvmcache
                  --enable-zram

It is possible to enable all the modules at once:

$ ./configure --enable-modules

The actual build and installation:

$ make
    # make install

RELEASES
========

Releases of UDisks are available in compressed tarballs from

https://github.com/storaged-project/udisks/releases

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

Please report bugs via the GitHub's issues tracker at

https://github.com/storaged-project/udisks/issues

### Running out of development source tree
 If you would like to run out of the source tree for development without installing,
 please do the following below.

**Note: Assuming you are in the base of the source tree and
 you don't have udisks already installed**

* Build the source `$ ./autogen.sh --enable-modules --enable-debug && make`
 * To run the daemon and splunk around with dbus clients
   * copy the needed files, policy kit, dbus config, and udev rules
     ```
     sudo cp data/*.policy /usr/share/polkit-1/actions/
     sudo cp modules/*/data/*.policy /usr/share/polkit-1/actions/

sudo cp data/org.freedesktop.UDisks2.conf /usr/share/dbus-1/system.d/

sudo cp data/80-udisks2.rules /usr/lib/udev/rules.d/
     ```
   * Get the udev rules to run `sudo udevadm control --reload && udevadm trigger && udevadm settle`
 * Start the daemon `# ./udisksd --debug --uninstalled --force-load-modules`
 * Start a client, eg. `# d-feet`

### Run the unit tests

`./autogen.sh --enable-modules --enable-debug && make && make ci`

cmd: