|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| data/ | H | 04-Feb-2021 | - | 3,627 | 1,102 |
| doc/ | H | 03-May-2022 | - | 6,593 | 6,038 |
| m4/ | H | 04-Feb-2021 | - | 125 | 114 |
| modules/ | H | 04-Feb-2021 | - | 21,195 | 13,376 |
| packaging/ | H | 04-Feb-2021 | - | 638 | 487 |
| po/ | H | 04-Feb-2021 | - | 204,585 | 169,596 |
| src/ | H | 04-Feb-2021 | - | 53,595 | 37,400 |
| tools/ | H | 04-Feb-2021 | - | 3,737 | 3,213 |
| udisks/ | H | 03-May-2022 | - | 4,930 | 3,161 |
| .gitignore | H A D | 04-Feb-2021 | 1.5 KiB | 90 | 88 |
| AUTHORS | H A D | 04-Feb-2021 | 3.9 KiB | 103 | 100 |
| COPYING | H A D | 04-Feb-2021 | 43.2 KiB | 849 | 696 |
| HACKING | H A D | 04-Feb-2021 | 4 KiB | 119 | 83 |
| Makefile.am | H A D | 04-Feb-2021 | 2.8 KiB | 90 | 70 |
| NEWS | H A D | 04-Feb-2021 | 111.8 KiB | 2,922 | 2,446 |
| README.md | H A D | 04-Feb-2021 | 2.9 KiB | 104 | 64 |
| TRANSLATING | H A D | 04-Feb-2021 | 732 | 23 | 15 |
| acinclude.m4 | H A D | 04-Feb-2021 | 10.4 KiB | 320 | 283 |
| autogen.sh | H A D | 04-Feb-2021 | 767 | 34 | 23 |
| configure.ac | H A D | 04-Feb-2021 | 27 KiB | 853 | 740 |
| zanata.xml | H A D | 04-Feb-2021 | 2 KiB | 78 | 9 |
README.md
1CI status
2=========
3
4<img alt="CI status" src="https://fedorapeople.org/groups/storage_apis/statuses/udisks-master.svg" width="100%" height="300ex" />
5
6
7OVERVIEW
8========
9
10The UDisks project provides a daemon, tools and libraries to access and
11manipulate disks, storage devices and technologies.
12
13For API stability and intended audience of UDisks, see the API STABILITY and
14AUDIENCE section of the `udisks(8)` man page (`doc/man/udisks.xml` in the
15tarball and git repository).
16
17
18LICENSE
19=======
20
21See the COPYING file for the license. In a nutshell, the daemon and tools are
22licensed under the GPLv2 (or later) and libraries are licensed under LGPLv2 (or
23later).
24
25
26INSTALLATION
27============
28
29UDisks has several dependencies listed in `packaging/udisks2.spec`.
30
31If you run rpm based distro, install the dependencies by:
32
33 # dnf builddep -y packaging/udisks2.spec
34
35AUTOTOOLS
36---------
37
38To configure and install the UDisks, perform following tasks:
39
40 $ ./autogen.sh
41
42Additional functionality of UDisks for monitoring and management is split
43into several modules: *BCache, BTRFS, iSCSI, libStorageManagement, LVM2, LVM
44Cache and zRAM*. By default, no additional module will be built.
45
46To build UDisks with (a) chosen module(s), provide or leave these
47configuration options for the `configure` script:
48
49 $ ./configure --enable-bcache --enable-btrfs --enable-iscsi
50 --enable-lsm --enable-lvm2 --enable-lvmcache
51 --enable-zram
52
53It is possible to enable all the modules at once:
54
55 $ ./configure --enable-modules
56
57The actual build and installation:
58
59 $ make
60 # make install
61
62RELEASES
63========
64
65Releases of UDisks are available in compressed tarballs from
66
67 https://github.com/storaged-project/udisks/releases
68
69
70BUGS and DEVELOPMENT
71====================
72
73Please report bugs via the GitHub's issues tracker at
74
75 https://github.com/storaged-project/udisks/issues
76
77 ### Running out of development source tree
78 If you would like to run out of the source tree for development without installing,
79 please do the following below.
80
81 **Note: Assuming you are in the base of the source tree and
82 you don't have udisks already installed**
83
84 * Build the source `$ ./autogen.sh --enable-modules --enable-debug && make`
85 * To run the daemon and splunk around with dbus clients
86 * copy the needed files, policy kit, dbus config, and udev rules
87 ```
88 sudo cp data/*.policy /usr/share/polkit-1/actions/
89 sudo cp modules/*/data/*.policy /usr/share/polkit-1/actions/
90
91 sudo cp data/org.freedesktop.UDisks2.conf /usr/share/dbus-1/system.d/
92
93 sudo cp data/80-udisks2.rules /usr/lib/udev/rules.d/
94 ```
95 * Get the udev rules to run `sudo udevadm control --reload && udevadm trigger && udevadm settle`
96 * Start the daemon `# ./udisksd --debug --uninstalled --force-load-modules`
97 * Start a client, eg. `# d-feet`
98
99 ### Run the unit tests
100
101 `./autogen.sh --enable-modules --enable-debug && make && make ci`
102
103
104