source: postlfs/security/nettle.xml@ 0134954

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0134954 was 0134954, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Initial 7.10 tags; only 765 to go

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

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