source: chapter08/openssl.xml@ 37e35d2

multilib-10.1
Last change on this file since 37e35d2 was 37e35d2, checked in by Thomas Trepl <thomas@…>, 4 years ago

Update to new lfs structure

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/multilib@11986 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 7.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
8<sect1 id="ch-system-openssl" role="wrap">
9 <?dbhtml filename="openssl.html"?>
10
11 <sect1info condition="script">
12 <productname>openssl</productname>
13 <productnumber>&openssl-version;</productnumber>
14 <address>&openssl-url;</address>
15 </sect1info>
16
17 <title>OpenSSL-&openssl-version;</title>
18
19 <indexterm zone="ch-system-openssl">
20 <primary sortas="a-OpenSSL">OpenSSL</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The OpenSSL package contains management tools and libraries relating
27 to cryptography. These are useful for providing cryptographic functions
28 to other packages, such as OpenSSH, email applications, and web browsers
29 (for accessing HTTPS sites). </para>
30
31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
34
35 <seglistitem>
36 <seg>&openssl-fin-sbu;</seg>
37 <seg>&openssl-fin-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of OpenSSL</title>
45
46 <para>Prepare OpenSSL for compilation:</para>
47
48<screen><userinput remap="configure">./config --prefix=/usr \
49 --openssldir=/etc/ssl \
50 --libdir=lib \
51 shared \
52 zlib-dynamic</userinput></screen>
53
54 <para>Compile the package:</para>
55
56<screen><userinput remap="make">make</userinput></screen>
57
58 <para>To test the results, issue:</para>
59
60<screen><userinput remap="test">make test</userinput></screen>
61
62 <para>One test 30-test_afalg.t is known to fail on some kernel
63 configurations (it apparently assumes certain unspecified crypto
64 options have been selected).</para>
65
66 <para>Install the package:</para>
67
68<screen><userinput remap="install">sed -i '/INSTALL_LIBS/s/libcrypto.a libssl.a//' Makefile
69make MANSUFFIX=ssl install</userinput></screen>
70
71 <para>If desired, install the documentation:</para>
72
73<screen><userinput remap="install">mv -v /usr/share/doc/openssl /usr/share/doc/openssl-&openssl-version;
74cp -vfr doc/* /usr/share/doc/openssl-&openssl-version;</userinput></screen>
75
76 </sect2>
77
78 <!-- - - - - - - - - - -->
79 <!-- Multilib - 32bit -->
80 <!-- - - - - - - - - - -->
81
82 <sect2 arch="ml_32,ml_all" role="installation">
83 <title>Installation of OpenSSL - 32bit</title>
84
85 <para>Clean previous build:</para>
86
87<screen><userinput remap="pre">make distclean</userinput></screen>
88
89 <para>Prepare OpenSSL for compilation:</para>
90
91<screen><userinput remap="configure">MACHINE="i686" \
92CC="gcc -m32 -march=i686" \
93CXX="g++ -m32 -march=i686" \
94 ./config \
95 --prefix=/usr \
96 --libdir=&usr-lib-m32; \
97 --openssldir=/etc/ssl \
98 --libdir=lib32 \
99 shared \
100 zlib-dynamic</userinput></screen>
101
102 <para>Compile the package:</para>
103
104<screen><userinput remap="make">make</userinput></screen>
105
106 <para>Install the package:</para>
107
108<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
109cp -Rv DESTDIR&usr-lib-m32;/* &usr-lib-m32;
110rm -rf DESTDIR</userinput></screen>
111
112 </sect2><!-- m32 -->
113
114 <!-- - - - - - - - - - -->
115 <!-- Multilib - x32bit -->
116 <!-- - - - - - - - - - -->
117
118 <sect2 arch="ml_x32,ml_all" role="installation">
119 <title>Installation of OpenSSL - x32bit</title>
120
121 <para>Clean previous build:</para>
122
123<screen><userinput remap="pre">make distclean</userinput></screen>
124
125 <para>Prepare OpenSSL for compilation:</para>
126
127<screen><userinput remap="configure">MACHINE="x86_64" \
128CC="gcc -mx32" \
129CXX="g++ -mx32" \
130 ./config \
131 --prefix=/usr \
132 --libdir=&usr-lib-mx32; \
133 --openssldir=/etc/ssl \
134 --libdir=libx32 \
135 shared \
136 zlib-dynamic</userinput></screen>
137
138 <para>Compile the package:</para>
139
140<screen><userinput remap="make">make</userinput></screen>
141
142 <para>Install the package:</para>
143
144<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
145cp -Rv DESTDIR&usr-lib-mx32;/* &usr-lib-mx32;
146rm -rf DESTDIR</userinput></screen>
147
148 </sect2><!-- mx32 -->
149
150 <sect2 id="contents-openssl" role="content">
151 <title>Contents of OpenSSL</title>
152
153 <segmentedlist>
154 <segtitle>Installed programs</segtitle>
155 <segtitle>Installed libraries</segtitle>
156 <segtitle>Installed directories</segtitle>
157
158 <seglistitem>
159 <seg>
160 c_rehash and openssl
161 </seg>
162 <seg>
163 libcrypto.{so,a} and libssl.{so,a}
164 </seg>
165 <seg>
166 /etc/ssl,
167 /usr/include/openssl,
168 /usr/lib/engines and
169 /usr/share/doc/openssl-&openssl-version;
170 </seg>
171 </seglistitem>
172 </segmentedlist>
173
174 <variablelist>
175 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
176 <?dbfo list-presentation="list"?>
177 <?dbhtml list-presentation="table"?>
178
179 <varlistentry id="c_rehash">
180 <term><command>c_rehash</command></term>
181 <listitem>
182 <para>
183 is a <application>Perl</application> script that scans all files in
184 a directory and adds symbolic links to their hash values.
185 </para>
186 <indexterm zone="ch-system-openssl c_rehash">
187 <primary sortas="b-c_rehash">c_rehash</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry id="openssl-prog">
193 <term><command>openssl</command></term>
194 <listitem>
195 <para>
196 is a command-line tool for using the various cryptography functions
197 of <application>OpenSSL</application>'s crypto library from the
198 shell. It can be used for various functions which are documented in
199 <command>man 1 openssl</command>.
200 </para>
201 <indexterm zone="ch-system-openssl openssl-prog">
202 <primary sortas="b-openssl">openssl</primary>
203 </indexterm>
204 </listitem>
205 </varlistentry>
206
207 <varlistentry id="libcrypto">
208 <term><filename class="libraryfile">libcrypto.so</filename></term>
209 <listitem>
210 <para>
211 implements a wide range of cryptographic algorithms used in various
212 Internet standards. The services provided by this library are used
213 by the <application>OpenSSL</application> implementations of SSL,
214 TLS and S/MIME, and they have also been used to implement
215 <application>OpenSSH</application>,
216 <application>OpenPGP</application>, and other cryptographic
217 standards.
218 </para>
219 <indexterm zone="ch-system-openssl libcrypto">
220 <primary sortas="c-libcrypto">libcrypto.so</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="libssl">
226 <term><filename class="libraryfile">libssl.so</filename></term>
227 <listitem>
228 <para>
229 implements the Transport Layer Security (TLS v1) protocol.
230 It provides a rich API, documentation
231 on which can be found by running <command>man 3 ssl</command>.
232 </para>
233 <indexterm zone="ch-system-openssl libssl">
234 <primary sortas="c-libssl">libssl.so</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 </variablelist>
240
241 </sect2>
242
243</sect1>
Note: See TracBrowser for help on using the repository browser.