source: postlfs/security/nettle.xml@ 47274444

10.0 10.1 11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 47274444 was 47274444, checked in by Pierre Labastie <pieere@…>, 2 years ago

Format postlfs/security and misc/forgotten

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22884 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 "&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 "0e5707b418c3826768d41130fbe4ee86">
10 <!ENTITY nettle-size "1.9 MB">
11 <!ENTITY nettle-buildsize "73 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 <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 a low-level
34 cryptographic library that is designed to fit easily in many contexts.
35 </para>
36
37 &lfs91_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>
89 Install <application>Nettle</application> by running the following
90 commands:
91 </para>
92
93<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
94make</userinput></screen>
95
96 <para>
97 To test the results, issue: <command>make check</command>.
98 </para>
99
100 <para>
101 Now, as the <systemitem class="username">root</systemitem> user:
102 </para>
103
104<screen role="root"><userinput>make install &amp;&amp;
105chmod -v 755 /usr/lib/lib{hogweed,nettle}.so &amp;&amp;
106install -v -m755 -d /usr/share/doc/nettle-&nettle-version; &amp;&amp;
107install -v -m644 nettle.html /usr/share/doc/nettle-&nettle-version;</userinput></screen>
108
109 </sect2>
110
111 <sect2 role="commands">
112 <title>Command Explanations</title>
113
114 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
115 href="../../xincludes/static-libraries.xml"/>
116
117 </sect2>
118
119 <sect2 role="content">
120 <title>Contents</title>
121
122 <segmentedlist>
123 <segtitle>Installed Programs</segtitle>
124 <segtitle>Installed Libraries</segtitle>
125 <segtitle>Installed Directory</segtitle>
126
127 <seglistitem>
128 <seg>
129 nettle-hash, nettle-lfib-stream, nettle-pbkdf2,
130 pkcs1-conv and sexp-conv
131 </seg>
132 <seg>
133 libhogweed.so and libnettle.so
134 </seg>
135 <seg>
136 /usr/include/nettle and /usr/share/doc/nettle-&nettle-version;
137 </seg>
138 </seglistitem>
139 </segmentedlist>
140
141 <variablelist>
142 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
143 <?dbfo list-presentation="list"?>
144 <?dbhtml list-presentation="table"?>
145
146 <varlistentry id="nettle-hash">
147 <term><command>nettle-hash</command></term>
148 <listitem>
149 <para>
150 calculates a hash value using a specified algorithm.
151 </para>
152 <indexterm zone="nettle nettle-hash">
153 <primary sortas="b-nettle-hash">nettle-hash</primary>
154 </indexterm>
155 </listitem>
156 </varlistentry>
157
158 <varlistentry id="nettle-lfib-stream">
159 <term><command>nettle-lfib-stream</command></term>
160 <listitem>
161 <para>
162 outputs a sequence of pseudorandom (non-cryptographic) bytes,
163 using Knuth's lagged fibonacci generator. The stream is useful for
164 testing, but should not be used to generate cryptographic keys or
165 anything else that needs real randomness.
166 </para>
167 <indexterm zone="nettle nettle-lfib-stream">
168 <primary sortas="b-nettle-lfib-stream">nettle-lfib-stream</primary>
169 </indexterm>
170 </listitem>
171 </varlistentry>
172
173 <varlistentry id="nettle-pbkdf2">
174 <term><command>nettle-pbkdf2</command></term>
175 <listitem>
176 <para>
177 password-based key derivation function that take as input a
178 password or passphrase and typically strengthen it and protect
179 against certain pre-computation attacks by using salting and
180 expensive computation.
181 </para>
182 <indexterm zone="nettle nettle-pbkdf2">
183 <primary sortas="b-nettle-pbkdf2">nettle-pbkdf2</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="pkcs1-conv">
189 <term><command>pkcs1-conv</command></term>
190 <listitem>
191 <para>
192 converts private and public RSA keys from PKCS #1 format to
193 sexp format.
194 </para>
195 <indexterm zone="nettle pkcs1-conv">
196 <primary sortas="b-pkcs1-conv">pkcs1-conv</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="sexp-conv">
202 <term><command>sexp-conv</command></term>
203 <listitem>
204 <para>
205 converts an s-expression to a different encoding.
206 </para>
207 <indexterm zone="nettle sexp-conv">
208 <primary sortas="b-sexp-conv">sexp-conv</primary>
209 </indexterm>
210 </listitem>
211 </varlistentry>
212
213 </variablelist>
214
215 </sect2>
216
217</sect1>
Note: See TracBrowser for help on using the repository browser.