source: general/genlib/qca.xml@ a81f3ed

12.2 gimp3 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since a81f3ed was e0b41c4, checked in by Thomas Trepl <thomas@…>, 3 months ago

which is required, no need to have it in optional
  • Property mode set to 100644
File size: 6.7 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 qca-download-http "https://download.kde.org/stable/qca/&qca-version;/qca-&qca-version;.tar.xz">
8 <!ENTITY qca-download-ftp " ">
9 <!ENTITY qca-md5sum "4c6348286c170b3da24820c977565d75">
10 <!ENTITY qca-size "744 KB">
11 <!ENTITY qca-buildsize "42 MB">
12 <!ENTITY qca-time "0.5 SBU (using parallelism=4; add 0.1 SBU for tests)">
13]>
14
15<sect1 id="qca" xreflabel="qca-&qca-version;">
16 <?dbhtml filename="qca.html"?>
17
18
19 <title>Qca-&qca-version;</title>
20
21 <indexterm zone="qca">
22 <primary sortas="a-qca">qca</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Qca</title>
27
28 <para>
29 <application>Qca</application> aims to provide a straightforward and
30 cross-platform crypto API, using <application>Qt</application> datatypes
31 and conventions. <application>Qca</application> separates the API from
32 the implementation, using plugins known as Providers.
33 </para>
34
35 &lfs121_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>
41 Download (HTTP): <ulink url="&qca-download-http;"/>
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Download (FTP): <ulink url="&qca-download-ftp;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download MD5 sum: &qca-md5sum;
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download size: &qca-size;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated disk space required: &qca-buildsize;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated build time: &qca-time;
67 </para>
68 </listitem>
69 </itemizedlist>
70<!--
71 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>
75 Required patch:
76 <ulink url="&patch-root;/qca-&qca-version;-openssl-1.patch"/>
77 </para>
78 </listitem>
79 </itemizedlist>
80-->
81 <bridgehead renderas="sect3">Qca Dependencies</bridgehead>
82
83 <bridgehead renderas="sect4">Required</bridgehead>
84 <para role="required">
85 <xref linkend="make-ca"/>,
86 <xref linkend="cmake"/>,
87 <xref linkend="qt6"/>, and
88 <xref linkend="which"/>
89 </para>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="Optional">
93 <xref linkend="cyrus-sasl"/>,
94 <xref linkend="gnupg2"/>,
95 <xref linkend="libgcrypt"/>,
96 <xref linkend="libgpg-error"/>,
97 <xref linkend="nss"/>,
98 <xref linkend="nspr"/>,
99 <xref linkend="p11-kit"/>,
100 <xref linkend="doxygen"/>, and
101 <ulink url="https://botan.randombit.net/">Botan</ulink>
102 </para>
103
104 </sect2>
105
106 <sect2 role="installation">
107 <title>Installation of Qca</title>
108
109 <para>
110 Fix the location of the CA certificates:
111 </para>
112
113<screen><userinput>sed -i 's@cert.pem@certs/ca-bundle.crt@' CMakeLists.txt</userinput></screen>
114
115 <para>
116 Install <application>Qca</application> by running the following
117 commands:
118 </para>
119
120<screen><userinput>mkdir build &amp;&amp;
121cd build &amp;&amp;
122
123cmake -D CMAKE_INSTALL_PREFIX=$QT6DIR \
124 -D CMAKE_BUILD_TYPE=Release \
125 -D QT6=ON \
126 -D QCA_INSTALL_IN_QT_PREFIX=ON \
127 -D QCA_MAN_INSTALL_DIR:PATH=/usr/share/man \
128 .. &amp;&amp;
129make</userinput></screen>
130
131 <para>
132 To test the results, issue <command>make test</command>. <!--One test
133 using <xref linkend="gnupg2"/> fails without a correct passphrase. The
134 required passphrase does not seem to be published.-->
135 </para>
136
137 <para>
138 Now, as the <systemitem class="username">root</systemitem> user:
139 </para>
140
141<screen role="root"><userinput>make install</userinput></screen>
142
143 </sect2>
144
145 <sect2 role="commands">
146 <title>Command Explanations</title>
147
148 <para>
149 <parameter>-DCMAKE_BUILD_TYPE=Release</parameter>: This switch is
150 used to apply a higher level of compiler optimizations.
151 </para>
152
153 <para>
154 <parameter>-DQT6=ON</parameter>:
155 Ensure the packages is built with <xref linkend="qt6"/>.
156 </para>
157
158 <para>
159 <parameter>-DQCA_MAN_INSTALL_DIR:PATH=/usr/share/man</parameter>:
160 Install the qca man page in the normal location.
161 </para>
162
163 </sect2>
164
165 <sect2 role="content">
166 <title>Contents</title>
167
168 <segmentedlist>
169 <segtitle>Installed Programs</segtitle>
170 <segtitle>Installed Libraries</segtitle>
171 <segtitle>Installed Directories</segtitle>
172
173 <seglistitem>
174 <seg>mozcerts-qt6 and qcatool-qt6</seg>
175 <seg>
176 libqca-qt6.so,
177 libqca-cyrus-sasl.so,
178 libqca-gcrypt.so,
179 libqca-gnupg.so,
180 libqca-logger.so,
181 libqca-nss.so,
182 libqca-ossl.so, and
183 libqca-softstore.so
184 </seg>
185 <seg>
186 &qt6-dir;/include/Qca-qt6,
187 &qt6-dir;/lib/cmake/Qca-qt6, and
188 &qt6-dir;/lib/qca-qt6
189 </seg>
190 </seglistitem>
191 </segmentedlist>
192
193 <variablelist>
194 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
195 <?dbfo list-presentation="list"?>
196 <?dbhtml list-presentation="table"?>
197
198 <varlistentry id="mozcerts">
199 <term><command>mozcerts-qt6</command></term>
200 <listitem>
201 <para>
202 is a command line tool for converting certdata.txt into
203 outfile.pem files
204 </para>
205 <indexterm zone="qca mozcerts">
206 <primary sortas="b-mozcerts">mozcerts-qt6</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="qcatool">
212 <term><command>qcatool-qt6</command></term>
213 <listitem>
214 <para>
215 is a command line tool for performing various cryptographic
216 operations with Qca
217 </para>
218 <indexterm zone="qca qcatool">
219 <primary sortas="b-qcatool">qcatool-qt6</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="libqca">
225 <term><filename class="libraryfile">libqca-qt6.so</filename></term>
226 <listitem>
227 <para>
228 is the Qt Cryptography Architecture (Qca) library
229 </para>
230 <indexterm zone="qca libqca">
231 <primary sortas="c-libqca">libqca-qt6.so</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 </variablelist>
237
238 </sect2>
239
240</sect1>
Note: See TracBrowser for help on using the repository browser.