source: archive/openssl10.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 4 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.6 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 openssl10-download-http
8 "https://openssl.org/source/openssl-&openssl10-version;.tar.gz">
9 <!ENTITY openssl10-download-ftp
10 "ftp://openssl.org/source/openssl-&openssl10-version;.tar.gz">
11 <!ENTITY openssl10-md5sum "7563e1ce046cb21948eeb6ba1a0eb71c">
12 <!ENTITY openssl10-size "5.1 MB">
13 <!ENTITY openssl10-buildsize "74 MB (with tests)">
14 <!ENTITY openssl10-time "1.2 SBU (with tests)">
15]>
16
17<sect1 id="openssl10" xreflabel="OpenSSL-&openssl10-version; Libraries">
18 <?dbhtml filename="openssl10.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>OpenSSL-&openssl10-version;</title>
25
26 <indexterm zone="openssl10">
27 <primary sortas="a-OpenSSL10">OpenSSL-&openssl10-version;</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to OpenSSL-&openssl10-version; Libraries</title>
32
33 <para>
34 The <application>OpenSSL-&openssl10-version;</application> package
35 contains libraries relating to cryptography. These are useful for
36 providing cryptographic functions to other packages, such as
37 email applications and web browsers (for accessing HTTPS sites). This
38 package provides only the libraries and headers for packages that have
39 not yet been ported to openssl-1.1.x or later.
40 </para>
41
42 &lfs83_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&openssl10-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&openssl10-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &openssl10-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &openssl10-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &openssl10-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &openssl10-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79
80 <itemizedlist spacing="compact">
81 <listitem>
82 <para>Required patch: <ulink url="&patch-root;/openssl-&openssl10-version;-compat_versioned_symbols-1.patch"/></para>
83 </listitem>
84 </itemizedlist>
85
86 <bridgehead renderas="sect3">OpenSSL-&openssl10-version; Dependencies</bridgehead>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="mitkrb"/>
91 </para>
92
93 <para condition="html" role="usernotes">
94 User Notes: <ulink url='&blfs-wiki;/OpenSSL'/>
95 </para>
96 </sect2>
97
98 <sect2 role="installation">
99 <title>Installation of OpenSSL-&openssl10-version; Libraries</title>
100
101 <note>
102 <para>
103 This package does not support parallel build.
104 </para>
105 </note>
106
107 <para>
108 Install <application>OpenSSL-&openssl10-version; Libraries</application>
109 with the following commands:
110 </para>
111
112
113<screen><userinput> patch -Np1 -i ../openssl-&openssl10-version;-compat_versioned_symbols-1.patch &amp;&amp;
114
115./config --prefix=/usr \
116 --openssldir=/etc/ssl \
117 --libdir=lib/openssl-1.0 \
118 shared \
119 zlib-dynamic &amp;&amp;
120
121make depend &amp;&amp;
122make -j1</userinput></screen>
123
124 <para>
125 To test the results, issue: <command>make -j1 test</command>. The
126 test suite does not support parallel jobs.
127 </para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>make INSTALL_PREFIX=$PWD/Dest install_sw &amp;&amp;
134
135rm -rf /usr/lib/openssl-1.0 &amp;&amp;
136install -vdm755 /usr/lib/openssl-1.0 &amp;&amp;
137cp -Rv Dest/usr/lib/openssl-1.0/* /usr/lib/openssl-1.0 &amp;&amp;
138
139mv -v /usr/lib/openssl-1.0/lib{crypto,ssl}.so.1.0.0 /usr/lib &amp;&amp;
140ln -sv ../libssl.so.1.0.0 /usr/lib/openssl-1.0 &amp;&amp;
141ln -sv ../libcrypto.so.1.0.0 /usr/lib/openssl-1.0 &amp;&amp;
142
143install -vdm755 /usr/include/openssl-1.0 &amp;&amp;
144cp -Rv Dest/usr/include/openssl /usr/include/openssl-1.0 &amp;&amp;
145
146sed 's@/include$@/include/openssl-1.0@' -i /usr/lib/openssl-1.0/pkgconfig/*.pc</userinput></screen>
147
148 </sect2>
149
150 <sect2 role="commands">
151 <title>Command Explanations</title>
152
153 <para>
154 <parameter>shared</parameter>: This parameter forces the creation of
155 shared libraries along with the static libraries.
156 </para>
157
158 <para>
159 <parameter>zlib-dynamic</parameter>: This parameter adds
160 compression/decompression functionality using the
161 <filename class="libraryfile">libz</filename> library.
162 </para>
163
164 <para>
165 <parameter>rm -rf /usr/lib/openssl-1.0</parameter>: This will do
166 nothing on a first install, but enables a later update. During the
167 install the libraries are moved and replaced by symlinks. If you later
168 upgrade to a future release of <application>openssl-1.0.2</application>
169 to fix newly discovered vulnerabilities, without this command the move
170 would fail because the symlinks mean the source and destination files
171 are identical.
172 </para>
173
174 </sect2>
175
176 <sect2 role="content">
177 <title>Contents</title>
178
179 <segmentedlist>
180 <segtitle>Installed Libraries</segtitle>
181 <segtitle>Installed Directories</segtitle>
182
183 <seglistitem>
184 <seg>
185 libcrypto.so.1.0.0 and libssl.so.1.0.0
186 </seg>
187 <seg>
188 /usr/lib/openssl-1.0 and /usr/include/openssl-1.0
189 </seg>
190 </seglistitem>
191 </segmentedlist>
192
193 <variablelist>
194 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
195 <?dbfo list-presentation="list"?>
196 <?dbhtml list-presentation="table"?>
197
198 <varlistentry id="libcrypto10">
199 <term><filename class="libraryfile">libcrypto.so.1.0.0</filename></term>
200 <listitem>
201 <para>
202 implements a wide range of cryptographic algorithms used in various
203 Internet standards. The services provided by this library are used
204 by the <application>OpenSSL</application> implementations of SSL,
205 TLS and S/MIME, and they have also been used to implement
206 <application>OpenSSH</application>,
207 <application>OpenPGP</application>, and other cryptographic
208 standards.
209 </para>
210 <indexterm zone="openssl10 libcrypto10">
211 <primary sortas="c-libcrypto10">libcrypto.so.1.0.0</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 <varlistentry id="libssl10">
217 <term><filename class="libraryfile">libssl.so.1.0.0</filename></term>
218 <listitem>
219 <para>
220 implements the Transport Layer Security (TLS v1) protocol.
221 It provides a rich API, documentation
222 on which can be found by running <command>man 3 ssl</command>.
223 </para>
224 <indexterm zone="openssl10 libssl10">
225 <primary sortas="c-libssl10">libssl.so.1.0.0</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 </variablelist>
231
232 </sect2>
233
234</sect1>
Note: See TracBrowser for help on using the repository browser.