Changeset 52d29f7 for general/genlib/openssl.xml
- Timestamp:
- 06/12/2004 10:56:28 PM (20 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- d3edf27
- Parents:
- bfe245f
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
general/genlib/openssl.xml
rbfe245f r52d29f7 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 7 8 <!ENTITY openssl-download-http "http://www.openssl.org/source/openssl-&openssl-version;.tar.gz"> 9 <!ENTITY openssl-download-ftp "ftp://ftp.openssl.org/source/openssl-&openssl-version;.tar.gz"> 10 <!ENTITY openssl-size "2.7 MB"> 11 <!ENTITY openssl-buildsize "25 MB"> 12 <!ENTITY openssl-time "1.16 SBU"> 13 14 ]> 15 16 1 17 <sect1 id="openssl" xreflabel="OpenSSL-&openssl-version;"> 2 18 <?dbhtml filename="openssl.html"?> 3 19 <title>OpenSSL-&openssl-version;</title> 4 20 5 &openssl-intro; 6 &openssl-inst; 7 &openssl-exp; 8 &openssl-config; 9 &openssl-desc; 21 22 <sect2> 23 <title>Introduction to <application>OpenSSL</application></title> 24 25 <para>The <application>OpenSSL</application> package contains management tools 26 and libraries relating to cryptography. These are useful for providing 27 cryptography functions to other packages, notably <application>OpenSSH 28 </application> and web browsers (for accessing secure https sites).</para> 29 30 <sect3><title>Package information</title> 31 <itemizedlist spacing='compact'> 32 <listitem><para>Download (HTTP): <ulink url="&openssl-download-http;"/></para></listitem> 33 <listitem><para>Download (FTP): <ulink url="&openssl-download-ftp;"/></para></listitem> 34 <listitem><para>Download size: &openssl-size;</para></listitem> 35 <listitem><para>Estimated Disk space required: &openssl-buildsize;</para></listitem> 36 <listitem><para>Estimated build time: &openssl-time;</para></listitem></itemizedlist> 37 </sect3> 38 </sect2> 39 40 <sect2> 41 <title>Installation of <application>OpenSSL</application></title> 42 43 <para>Install <application>OpenSSL</application> by running the following commands:</para> 44 45 <screen><userinput><command>sed 's/^passwd/openssl-passwd/' doc/apps/passwd.pod \ 46 > doc/apps/openssl-passwd.pod && 47 rm doc/apps/passwd.pod && 48 mv doc/crypto/{,openssl_}threads.pod && 49 sed -i -e 's/-m486/-march=i486/' Configure && 50 ./config --openssldir=/etc/ssl --prefix=/usr shared && 51 make MANDIR=/usr/share/man && 52 make MANDIR=/usr/share/man install && 53 cp -r certs /etc/ssl && 54 rmdir /etc/ssl/lib</command></userinput></screen> 55 56 </sect2> 57 58 <sect2> 59 <title>Command explanations</title> 60 61 <para><option>no-rc5 no-idea</option>: When added to the 62 <command>./config</command> command, this will eliminate the building of those 63 encryption methods. Patent licenses may be needed for you to utilize either of 64 those methods in your projects.</para> 65 66 <para><command>rm doc/apps/passwd.pod</command>: This command prevents 67 <application>Open<acronym>SSL</acronym></application> from installing its 68 passwd man page over an existing man page with the same name.</para> 69 70 <para><command>mv doc/crypto/{,openssl_}threads.pod</command>: This 71 commands prevents <application>Open<acronym>SSL</acronym></application> from 72 overwriting an existing man page from <application>Perl</application>.</para> 73 74 <para><command>sed -i -e 's/-m486/-march=i486/' Configure</command>: 75 <application>GCC</application> issues a warning on every 76 compilation because the <command>Configure</command> 77 command uses deprecated <parameter>-m486</parameter> instead of 78 <parameter>-march=i486</parameter>.</para> 79 80 <para><screen><command>make MANDIR=/usr/share/man 81 make MANDIR=/usr/share/man install</command></screen> These 82 commands install <application>OpenSSL</application> with the man pages 83 in <filename class='directory'>/usr/share/man</filename> instead of the 84 default which is <filename class='directory'>/etc/ssl/man</filename>.</para> 85 86 <para><command>cp -r certs /etc/ssl</command>: The certificates 87 must be copied manually since the install script 88 skips this step.</para> 89 90 <para><command>rmdir /etc/ssl/lib</command>: This is simply a tidy-up command. 91 For some reason, the <application>openssl</application> install routine creates 92 the <filename class='directory'>/etc/ssl/lib</filename> directory even though 93 the libraries have been installed in 94 <filename class='directory'>/usr/lib</filename>. We remove it to keep things 95 nice and tidy!</para> 96 97 </sect2> 98 99 <sect2> 100 <title>Configuring <application>OpenSSL</application></title> 101 102 <sect3><title>Config files</title> 103 <para><filename>/etc/ssl/openssl.cnf</filename></para> 104 </sect3> 105 106 <sect3><title>Configuration Information</title> 107 108 <para>Most people who just want to use 109 <application>openssl</application> for providing functions 110 to other programs such as <application>OpenSSH</application> and web browsers won't need to worry 111 about configuring <application>OpenSSL</application>. Configuring 112 <application>OpenSSL</application> is an advanced topic and 113 so those who do would normally be expected to either know how to do it 114 or to be able to find out how to do it.</para> 115 </sect3> 116 117 </sect2> 118 119 <sect2> 120 <title>Contents</title> 121 122 <para>The <application>Open<acronym>SSL</acronym></application> package contains <command> 123 c_rehash</command>, <command>openssl</command>, <filename 124 class='libraryfile'>libcrypto</filename> libraries and <filename 125 class='libraryfile'>libssl</filename> libraries.</para> 126 127 </sect2> 128 129 <sect2><title>Description</title> 130 131 <sect3><title>c_rehash</title> 132 133 <para><command>c_rehash</command> is a <application>Perl</application> script 134 that scans all files in a directory and adds symbolic links to their hash 135 values.</para> 136 137 </sect3> 138 139 <sect3><title>openssl</title> 140 141 <para>The <command>openssl</command> program is a command-line tool for using 142 the various cryptography functions of 143 <application>Open<acronym>SSL</acronym></application>'s 144 crypto library from the shell. It can be used for various functions which are 145 documented in <command>man 1 openssl</command>.</para> 146 147 </sect3> 148 149 <sect3><title>libcrypto</title> 150 151 <para>The <application>Open<acronym>SSL</acronym></application> crypto library implements a wide 152 range of cryptographic algorithms used in various Internet standards. The 153 services provided by this library are used by the 154 <application>Open<acronym>SSL</acronym> 155 </application> implementations of <acronym>SSL</acronym>, <acronym>TLS 156 </acronym> and <acronym>S/MIME</acronym>, and they have also been used to 157 implement <application>Open<acronym>SSH</acronym></application>, 158 <application>Open<acronym>PGP</acronym> 159 </application>, and other cryptographic standards.</para> 160 161 </sect3> 162 163 <sect3><title>libssl</title> 164 165 <para>The <application>Open<acronym>SSL</acronym></application> <acronym>SSL</acronym> library 166 implements the Secure Sockets Layer (<acronym>SSL</acronym> v2/v3) and 167 Transport Layer Security (<acronym>TLS</acronym> v1) protocols. It provides a 168 rich <acronym>API</acronym>, documentation on which can be found by running 169 <command>man 3 ssl</command>.</para> 170 171 </sect3> 172 173 </sect2> 10 174 11 175 </sect1> 176
Note:
See TracChangeset
for help on using the changeset viewer.