source: general/genlib/libblockdev.xml@ ca31bd3

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since ca31bd3 was ca31bd3, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Package updates.

Update to xorg-server-1.20.13.
Update to mesa-21.1.6.
Update to libstatgrab-0.92.1.
Update to libblockdev-2.26.

  • Property mode set to 100644
File size: 5.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libblockdev-download-http
8 "https://github.com/storaged-project/libblockdev/releases/download/&libblockdev-version;-1/libblockdev-&libblockdev-version;.tar.gz">
9 <!ENTITY libblockdev-download-ftp " ">
10 <!ENTITY libblockdev-md5sum "d022c1ebb9b9a838c1a8c8b2b781b69d">
11 <!ENTITY libblockdev-size "912 KB">
12 <!ENTITY libblockdev-buildsize "12 MB">
13 <!ENTITY libblockdev-time "0.2 SBU">
14]>
15
16<sect1 id="libblockdev" xreflabel="libblockdev-&libblockdev-version;">
17 <?dbhtml filename="libblockdev.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>libblockdev-&libblockdev-version;</title>
24
25 <indexterm zone="libblockdev">
26 <primary sortas="a-libblockdev">libblockdev</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to libblockdev</title>
31
32 <para>
33 libblockdev is a C library supporting GObject Introspection for
34 manipulation of block devices. It has a plugin-based architecture where
35 each technology (like LVM, Btrfs, MD RAID, Swap,...) is implemented in a
36 separate plugin, possibly with multiple implementations (e.g. using LVM
37 CLI or the new LVM DBus API).
38 </para>
39
40 &lfs101_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&libblockdev-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&libblockdev-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &libblockdev-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &libblockdev-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &libblockdev-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &libblockdev-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">libblockdev Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="gobject-introspection"/>,
81 <xref linkend="libbytesize"/>,
82 <xref linkend="libyaml"/>,
83 <xref linkend="parted"/>, and
84 <xref linkend="volume_key"/>
85 </para>
86
87 <bridgehead renderas="sect4">Optional</bridgehead>
88 <para role="optional">
89 <xref linkend="btrfs-progs"/>,
90 <xref linkend="gtk-doc"/>,
91 <xref linkend="mdadm"/>,
92 <ulink url="https://people.redhat.com/~heinzm/sw/dmraid/">dmraid</ulink>,
93 <ulink url="http://bcachefs.org/">bcachefs</ulink>, and
94 <ulink url="https://github.com/pmem/ndctl">ndctl</ulink>
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/libblockdev"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of libblockdev</title>
104<!--
105 <para>
106 Fix the usage of a glib function deprecated for security:
107 </para>
108
109<screen><userinput>sed 's/g_memdup/&amp;2/' -i \
110 src/lib/plugin_apis/vdo.{c,api} \
111 src/plugins/vdo.c</userinput></screen>
112-->
113 <para>
114 Install <application>libblockdev</application> by running
115 the following commands:
116 </para>
117
118<screen><userinput>./configure --prefix=/usr \
119 --sysconfdir=/etc \
120 --with-python3 \
121 --without-gtk-doc \
122 --without-nvdimm \
123 --without-dm &amp;&amp;
124make</userinput></screen>
125
126 <para>
127 This package does not come with a working test suite.
128 </para>
129
130 <para>
131 Now, as the <systemitem class="username">root</systemitem> user:
132 </para>
133
134<screen role="root"><userinput>make install</userinput></screen>
135
136 </sect2>
137<!--
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141
142 </sect2>
143-->
144 <sect2 role="content">
145 <title>Contents</title>
146
147 <segmentedlist>
148 <segtitle>Installed Programs</segtitle>
149 <segtitle>Installed Libraries</segtitle>
150 <segtitle>Installed Directories</segtitle>
151
152 <seglistitem>
153 <seg>
154 lvm-cache-stats
155 </seg>
156 <seg>
157 libbd_btrfs.so,
158 libbd_crypto.so,
159 libbd_fs.so,
160 libbd_kbd.so,
161 libbd_loop.so,
162 libbd_lvm.so,
163 libbd_lvm-dbus.so,
164 libbd_mdraid.so,
165 libbd_mpath.so,
166 libbd_part.so,
167 libbd_part_err.so,
168 libbd_swap.so,
169 libbd_utils.so,
170 libbd_vdo.so, and
171 libblockdev.so
172 </seg>
173 <seg>
174 /etc/libblockdev,
175 /usr/include/blockdev, and
176 /usr/share/gtk-doc/html/libblockdev
177 </seg>
178 </seglistitem>
179 </segmentedlist>
180
181 <variablelist>
182 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
183 <?dbfo list-presentation="list"?>
184 <?dbhtml list-presentation="table"?>
185
186 <varlistentry id="lvm-cache-stats">
187 <term><command>lvm-cache-stats</command></term>
188 <listitem>
189 <para>
190 prints statistics on caches on LVM Logical Volumes
191 </para>
192 <indexterm zone="libblockdev lvm-cache-stats">
193 <primary sortas="b-lvm-cache-stats">lvm-cache-stats</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 </variablelist>
199
200 </sect2>
201
202</sect1>
Note: See TracBrowser for help on using the repository browser.