source: chapter08/openssl.xml@ 0ebda11

ml-11.0 multilib
Last change on this file since 0ebda11 was 0ebda11, checked in by Thomas Trepl (Moody) <thomas@…>, 7 months ago

Remove entities for multilib pathes
Add usage of libc_cv_rtlddir

  • 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
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>Add the version to the documentation directory name, to be
72 consistent with other packages:</para>
73
74<screen><userinput remap="install">mv -v /usr/share/doc/openssl /usr/share/doc/openssl-&openssl-version;</userinput></screen>
75
76 <para>If desired, install some additional documentation:</para>
77
78<screen><userinput remap="install">cp -vfr doc/* /usr/share/doc/openssl-&openssl-version;</userinput></screen>
79
80 </sect2>
81
82 <!-- - - - - - - - - - -->
83 <!-- Multilib - 32bit -->
84 <!-- - - - - - - - - - -->
85
86 <sect2 arch="ml_32,ml_all" role="installation">
87 <title>Installation of OpenSSL - 32bit</title>
88
89 <para>Clean previous build:</para>
90
91<screen><userinput remap="pre">make distclean</userinput></screen>
92
93 <para>Prepare OpenSSL for compilation:</para>
94
95<screen><userinput remap="configure">MACHINE="i686" \
96CC="gcc -m32 -march=i686" \
97CXX="g++ -m32 -march=i686" \
98 ./config \
99 --prefix=/usr \
100 --libdir=/usr/lib32 \
101 --openssldir=/etc/ssl \
102 --libdir=lib32 \
103 shared \
104 zlib-dynamic</userinput></screen>
105
106 <para>Compile the package:</para>
107
108<screen><userinput remap="make">make</userinput></screen>
109
110 <para>Install the package:</para>
111
112<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
113cp -Rv DESTDIR/usr/lib32/* /usr/lib32
114rm -rf DESTDIR</userinput></screen>
115
116 </sect2><!-- m32 -->
117
118 <!-- - - - - - - - - - -->
119 <!-- Multilib - x32bit -->
120 <!-- - - - - - - - - - -->
121
122 <sect2 arch="ml_x32,ml_all" role="installation">
123 <title>Installation of OpenSSL - x32bit</title>
124
125 <para>Clean previous build:</para>
126
127<screen><userinput remap="pre">make distclean</userinput></screen>
128
129 <para>Prepare OpenSSL for compilation:</para>
130
131<screen><userinput remap="configure">MACHINE="x86_64" \
132CC="gcc -mx32" \
133CXX="g++ -mx32" \
134 ./config \
135 --prefix=/usr \
136 --libdir=/usr/libx32 \
137 --openssldir=/etc/ssl \
138 --libdir=libx32 \
139 shared \
140 zlib-dynamic</userinput></screen>
141
142 <para>Compile the package:</para>
143
144<screen><userinput remap="make">make</userinput></screen>
145
146 <para>Install the package:</para>
147
148<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
149cp -Rv DESTDIR/usr/libx32/* /usr/libx32
150rm -rf DESTDIR</userinput></screen>
151
152 </sect2><!-- mx32 -->
153
154 <sect2 id="contents-openssl" role="content">
155 <title>Contents of OpenSSL</title>
156
157 <segmentedlist>
158 <segtitle>Installed programs</segtitle>
159 <segtitle>Installed libraries</segtitle>
160 <segtitle>Installed directories</segtitle>
161
162 <seglistitem>
163 <seg>
164 c_rehash and openssl
165 </seg>
166 <seg>
167 libcrypto.so and libssl.so
168 </seg>
169 <seg>
170 /etc/ssl,
171 /usr/include/openssl,
172 /usr/lib/engines and
173 /usr/share/doc/openssl-&openssl-version;
174 </seg>
175 </seglistitem>
176 </segmentedlist>
177
178 <variablelist>
179 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
180 <?dbfo list-presentation="list"?>
181 <?dbhtml list-presentation="table"?>
182
183 <varlistentry id="c_rehash">
184 <term><command>c_rehash</command></term>
185 <listitem>
186 <para>
187 is a <application>Perl</application> script that scans all files in
188 a directory and adds symbolic links to their hash values
189 </para>
190 <indexterm zone="ch-system-openssl c_rehash">
191 <primary sortas="b-c_rehash">c_rehash</primary>
192 </indexterm>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry id="openssl-prog">
197 <term><command>openssl</command></term>
198 <listitem>
199 <para>
200 is a command-line tool for using the various cryptography functions
201 of <application>OpenSSL</application>'s crypto library from the
202 shell. It can be used for various functions which are documented in
203 <command>man 1 openssl</command>
204 </para>
205 <indexterm zone="ch-system-openssl openssl-prog">
206 <primary sortas="b-openssl">openssl</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="libcrypto">
212 <term><filename class="libraryfile">libcrypto.so</filename></term>
213 <listitem>
214 <para>
215 implements a wide range of cryptographic algorithms used in various
216 Internet standards. The services provided by this library are used
217 by the <application>OpenSSL</application> implementations of SSL,
218 TLS and S/MIME, and they have also been used to implement
219 <application>OpenSSH</application>,
220 <application>OpenPGP</application>, and other cryptographic
221 standards
222 </para>
223 <indexterm zone="ch-system-openssl libcrypto">
224 <primary sortas="c-libcrypto">libcrypto.so</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="libssl">
230 <term><filename class="libraryfile">libssl.so</filename></term>
231 <listitem>
232 <para>
233 implements the Transport Layer Security (TLS v1) protocol.
234 It provides a rich API, documentation
235 on which can be found by running <command>man 3 ssl</command>
236 </para>
237 <indexterm zone="ch-system-openssl libssl">
238 <primary sortas="c-libssl">libssl.so</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 </variablelist>
244
245 </sect2>
246
247</sect1>
Note: See TracBrowser for help on using the repository browser.