source: postlfs/security/gnutls.xml@ d309b21

10.0 10.1 11.0 11.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since d309b21 was d309b21, checked in by Ag Hatzimanikas <ag@…>, 12 years ago

Updated to gnutls-2.8.5

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8191 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.4 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 gnutls-download-http "http://mirrors.kernel.org/gnu/gnutls/gnutls-&gnutls-version;.tar.bz2">
8 <!ENTITY gnutls-download-ftp "ftp://ftp.gnutls.org/pub/gnutls/gnutls-&gnutls-version;.tar.bz2">
9 <!ENTITY gnutls-md5sum "e3b2788b79bfc82acbe717e3c54d4e92">
10 <!ENTITY gnutls-size "6 MB">
11 <!ENTITY gnutls-buildsize "90 MB">
12 <!ENTITY gnutls-time "0.9 SBU">
13]>
14
15<sect1 id="gnutls" xreflabel="GnuTLS-&gnutls-version;">
16 <?dbhtml filename="gnutls.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>GnuTLS-&gnutls-version;</title>
24
25 <indexterm zone="gnutls">
26 <primary sortas="a-GnuTLS">GnuTLS</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to GnuTLS</title>
31
32 <para>The <application>GnuTLS</application> package contains a library and
33 userspace tools which provide a secure layer over a reliable transport
34 layer. Currently the <application>GnuTLS</application> library implements
35 the proposed standards by the IETF's TLS working group. Quoting from the
36 TLS protocol specification:</para>
37
38 <para><quote>The TLS protocol provides communications privacy over the
39 Internet. The protocol allows client/server applications to communicate in
40 a way that is designed to prevent eavesdropping, tampering, or message
41 forgery.</quote></para>
42
43 <para><application>GnuTLS</application> provides support for TLS 1.1, TLS
44 1.0 and SSL 3.0 protocols, TLS extensions, including server name and max
45 record size. Additionally, the library supports authentication using the
46 SRP protocol, X.509 certificates and OpenPGP keys, along with support for
47 the TLS Pre-Shared-Keys (PSK) extension, the Inner Application (TLS/IA)
48 extension and X.509 and OpenPGP certificate handling.</para>
49
50 &lfs65_checked;
51
52 <bridgehead renderas="sect3">Package Information</bridgehead>
53 <itemizedlist spacing="compact">
54 <listitem>
55 <para>Download (HTTP): <ulink url="&gnutls-download-http;"/></para>
56 </listitem>
57 <listitem>
58 <para>Download (FTP): <ulink url="&gnutls-download-ftp;"/></para>
59 </listitem>
60 <listitem>
61 <para>Download MD5 sum: &gnutls-md5sum;</para>
62 </listitem>
63 <listitem>
64 <para>Download size: &gnutls-size;</para>
65 </listitem>
66 <listitem>
67 <para>Estimated disk space required: &gnutls-buildsize;</para>
68 </listitem>
69 <listitem>
70 <para>Estimated build time: &gnutls-time;</para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">GnuTLS Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required"><xref linkend="libgcrypt"/></para>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional"><xref linkend="gtk-doc"/>,
81 <ulink url="http://www.gnu.org/software/gnutls/download.html">OpenCDK</ulink>,
82 <xref linkend="guile"/>,
83 <xref linkend="libtasn1"/>,
84 <ulink url="http://webscripts.softpedia.com/script/Development-Scripts-js/C-C-Library/libcfg--26570.html">libcfg+</ulink>, and
85 <ulink url="http://valgrind.org/">Valgrind</ulink> (used during the test suite)</para>
86
87 <bridgehead renderas="sect4">Optional Debugging Libraries</bridgehead>
88 <para role="optional"><ulink url="http://dmalloc.com/">Dmalloc</ulink> and
89 <ulink url="http://perens.com/FreeSoftware/ElectricFence/">Electric Fence</ulink></para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/gnutls"/></para>
93
94 </sect2>
95
96 <sect2 role="installation">
97 <title>Installation of GnuTLS</title>
98
99 <para>Install <application>GnuTLS</application> by running the
100 following commands:</para>
101
102<screen><userinput>./configure --prefix=/usr &amp;&amp;
103make</userinput></screen>
104
105 <para>To test the results, issue: <command>make check</command>.</para>
106
107 <para>Now, as the <systemitem class="username">root</systemitem>
108 user:</para>
109
110<screen role="root"><userinput>make install &amp;&amp;
111
112install -v -m755 -d /usr/share/doc/gnutls-&gnutls-version;/reference &amp;&amp;
113install -v -m644 doc/reference/html/* \
114 /usr/share/doc/gnutls-&gnutls-version;/reference &amp;&amp;
115install -v -m644 doc/*.{html,png,eps,pdf,ps} \
116 /usr/share/doc/gnutls-&gnutls-version;</userinput></screen>
117
118 </sect2>
119
120 <sect2 role="commands">
121 <title>Command Explanations</title>
122
123 <para><option>--with-included-libtasn1</option>: This option forces
124 the use of the shipped version of <application>libtasn1</application>,
125 instead of the system's installed version.</para>
126
127 </sect2>
128
129 <sect2 role="content">
130 <title>Contents</title>
131
132 <segmentedlist>
133 <segtitle>Installed Programs</segtitle>
134 <segtitle>Installed Libraries</segtitle>
135 <segtitle>Installed Directory</segtitle>
136
137 <seglistitem>
138 <seg>certtool, gnutls-cli, gnutls-cli-debug, gnutls-serv,
139 psktool, and srptool</seg>
140 <seg>libgnutls.{so,a}, libgnutls-extra.{so,a},
141 libgnutls-openssl.{so,a}, and libgnutlsxx.{so,a}</seg>
142 <seg>/usr/include/gnutls and
143 /usr/share/doc/gnutls-&gnutls-version;</seg>
144 </seglistitem>
145 </segmentedlist>
146
147 <variablelist>
148 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
149 <?dbfo list-presentation="list"?>
150 <?dbhtml list-presentation="table"?>
151
152 <varlistentry id="certtool">
153 <term><command>certtool</command></term>
154 <listitem>
155 <para>is used to generate X.509 certificates, certificate requests,
156 and private keys.</para>
157 <indexterm zone="gnutls certtool">
158 <primary sortas="b-certtool">certtool</primary>
159 </indexterm>
160 </listitem>
161 </varlistentry>
162
163 <varlistentry id="gnutls-cli">
164 <term><command>gnutls-cli</command></term>
165 <listitem>
166 <para>is a simple client program to set up a TLS connection to some
167 other computer.</para>
168 <indexterm zone="gnutls gnutls-cli">
169 <primary sortas="b-gnutls-cli">gnutls-cli</primary>
170 </indexterm>
171 </listitem>
172 </varlistentry>
173
174 <varlistentry id="gnutls-cli-debug">
175 <term><command>gnutls-cli-debug</command></term>
176 <listitem>
177 <para>is a simple client program to set up a TLS connection to some
178 other computer and produces very verbose progress results.</para>
179 <indexterm zone="gnutls gnutls-cli-debug">
180 <primary sortas="b-gnutls-cli-debug">gnutls-cli-debug</primary>
181 </indexterm>
182 </listitem>
183 </varlistentry>
184
185 <varlistentry id="gnutls-serv">
186 <term><command>gnutls-serv</command></term>
187 <listitem>
188 <para>is a simple server program that listens to incoming TLS
189 connections.</para>
190 <indexterm zone="gnutls gnutls-serv">
191 <primary sortas="b-gnutls-serv">gnutls-serv</primary>
192 </indexterm>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry id="psktool">
197 <term><command>psktool</command></term>
198 <listitem>
199 <para>is a simple program that generates random keys for use with
200 TLS-PSK.</para>
201 <indexterm zone="gnutls psktool">
202 <primary sortas="b-psktool">psktool</primary>
203 </indexterm>
204 </listitem>
205 </varlistentry>
206
207 <varlistentry id="srptool">
208 <term><command>srptool</command></term>
209 <listitem>
210 <para>is a simple program that emulates the programs in the Stanford
211 SRP (Secure Remote Password) libraries using GNU TLS.</para>
212 <indexterm zone="gnutls srptool">
213 <primary sortas="b-srptool">srptool</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="libgnutls">
219 <term><filename class='libraryfile'>libgnutls.{so,a}</filename></term>
220 <listitem>
221 <para>contains the core API functions and X.509 certificate
222 API functions.</para>
223 <indexterm zone="gnutls libgnutls">
224 <primary sortas="c-libgnutls">libgnutls.{so,a}</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 </variablelist>
230
231 </sect2>
232
233</sect1>
Note: See TracBrowser for help on using the repository browser.