source: postlfs/security/nettle.xml@ 69e77f2d

trunk
Last change on this file since 69e77f2d was 69e77f2d, checked in by Douglas R. Reno <renodr@…>, 7 weeks ago

Update to nettle-3.7.3

  • Property mode set to 100644
File size: 6.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 nettle-download-http "&gnu-http;/nettle/nettle-&nettle-version;.tar.gz">
8 <!ENTITY nettle-download-ftp "&gnu-ftp;/nettle/nettle-&nettle-version;.tar.gz">
9 <!ENTITY nettle-md5sum "a60273d0fab9c808646fcf5e9edc2e8f">
10 <!ENTITY nettle-size "2.3 MB">
11 <!ENTITY nettle-buildsize "87 MB (with tests)">
12 <!ENTITY nettle-time "0.4 SBU (with tests)">
13]>
14
15<sect1 id="nettle" xreflabel="Nettle-&nettle-version;">
16 <?dbhtml filename="nettle.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Nettle-&nettle-version;</title>
23
24 <indexterm zone="nettle">
25 <primary sortas="a-Nettle">Nettle</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Nettle</title>
30
31 <para>
32 The <application>Nettle</application> package contains a low-level
33 cryptographic library that is designed to fit easily in many contexts.
34 </para>
35
36 &lfs101_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&nettle-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&nettle-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &nettle-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &nettle-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &nettle-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &nettle-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">Nettle Dependencies</bridgehead>
73
74 <bridgehead renderas="sect4">Optional</bridgehead>
75 <para role="optional">
76 <xref linkend="valgrind"/> (optional for the tests)
77 </para>
78
79 <para condition="html" role="usernotes">User Notes:
80 <ulink url="&blfs-wiki;/nettle"/>
81 </para>
82 </sect2>
83
84 <sect2 role="installation">
85 <title>Installation of Nettle</title>
86
87 <para>
88 Install <application>Nettle</application> by running the following
89 commands:
90 </para>
91
92<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
93make</userinput></screen>
94
95 <para>
96 To test the results, issue: <command>make check</command>.
97 </para>
98
99 <para>
100 Now, as the <systemitem class="username">root</systemitem> user:
101 </para>
102
103<screen role="root"><userinput>make install &amp;&amp;
104chmod -v 755 /usr/lib/lib{hogweed,nettle}.so &amp;&amp;
105install -v -m755 -d /usr/share/doc/nettle-&nettle-version; &amp;&amp;
106install -v -m644 nettle.html /usr/share/doc/nettle-&nettle-version;</userinput></screen>
107
108 </sect2>
109
110 <sect2 role="commands">
111 <title>Command Explanations</title>
112
113 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
114 href="../../xincludes/static-libraries.xml"/>
115
116 </sect2>
117
118 <sect2 role="content">
119 <title>Contents</title>
120
121 <segmentedlist>
122 <segtitle>Installed Programs</segtitle>
123 <segtitle>Installed Libraries</segtitle>
124 <segtitle>Installed Directory</segtitle>
125
126 <seglistitem>
127 <seg>
128 nettle-hash, nettle-lfib-stream, nettle-pbkdf2,
129 pkcs1-conv and sexp-conv
130 </seg>
131 <seg>
132 libhogweed.so and libnettle.so
133 </seg>
134 <seg>
135 /usr/include/nettle and /usr/share/doc/nettle-&nettle-version;
136 </seg>
137 </seglistitem>
138 </segmentedlist>
139
140 <variablelist>
141 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
142 <?dbfo list-presentation="list"?>
143 <?dbhtml list-presentation="table"?>
144
145 <varlistentry id="nettle-hash">
146 <term><command>nettle-hash</command></term>
147 <listitem>
148 <para>
149 calculates a hash value using a specified algorithm
150 </para>
151 <indexterm zone="nettle nettle-hash">
152 <primary sortas="b-nettle-hash">nettle-hash</primary>
153 </indexterm>
154 </listitem>
155 </varlistentry>
156
157 <varlistentry id="nettle-lfib-stream">
158 <term><command>nettle-lfib-stream</command></term>
159 <listitem>
160 <para>
161 outputs a sequence of pseudorandom (non-cryptographic) bytes,
162 using Knuth's lagged fibonacci generator. The stream is useful for
163 testing, but should not be used to generate cryptographic keys or
164 anything else that needs real randomness
165 </para>
166 <indexterm zone="nettle nettle-lfib-stream">
167 <primary sortas="b-nettle-lfib-stream">nettle-lfib-stream</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="nettle-pbkdf2">
173 <term><command>nettle-pbkdf2</command></term>
174 <listitem>
175 <para>
176 is a password-based key derivation function that takes a password
177 or a passphrase as input and returns a strengthened password,
178 which is protected against pre-computation attacks by using
179 salting and other expensive computations.
180 </para>
181 <indexterm zone="nettle nettle-pbkdf2">
182 <primary sortas="b-nettle-pbkdf2">nettle-pbkdf2</primary>
183 </indexterm>
184 </listitem>
185 </varlistentry>
186
187 <varlistentry id="pkcs1-conv">
188 <term><command>pkcs1-conv</command></term>
189 <listitem>
190 <para>
191 converts private and public RSA keys from PKCS #1 format to
192 sexp format
193 </para>
194 <indexterm zone="nettle pkcs1-conv">
195 <primary sortas="b-pkcs1-conv">pkcs1-conv</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="sexp-conv">
201 <term><command>sexp-conv</command></term>
202 <listitem>
203 <para>
204 converts an s-expression to a different encoding
205 </para>
206 <indexterm zone="nettle sexp-conv">
207 <primary sortas="b-sexp-conv">sexp-conv</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 </variablelist>
213
214 </sect2>
215
216</sect1>
Note: See TracBrowser for help on using the repository browser.