]>
Commit | Line | Data |
---|---|---|
5f8e6c50 DMSP |
1 | Description |
2 | =========== | |
d02b48c6 | 3 | |
5f8e6c50 DMSP |
4 | The OpenSSL Project is a collaborative effort to develop a robust, |
5 | commercial-grade, fully featured, and Open Source toolkit implementing the | |
6 | Transport Layer Security (TLS) protocols (including SSLv3) as well as a | |
7 | full-strength general purpose cryptographic library. | |
651d0aff | 8 | |
5f8e6c50 DMSP |
9 | OpenSSL is descended from the SSLeay library developed by Eric A. Young |
10 | and Tim J. Hudson. | |
dfca822f | 11 | |
5f8e6c50 DMSP |
12 | The OpenSSL toolkit is licensed under the Apache License 2.0, which means |
13 | that you are free to get and use it for commercial and non-commercial | |
14 | purposes as long as you fulfill its conditions. | |
651d0aff | 15 | |
5f8e6c50 DMSP |
16 | Overview |
17 | ======== | |
15133316 | 18 | |
5f8e6c50 | 19 | The OpenSSL toolkit includes: |
651d0aff | 20 | |
5f8e6c50 | 21 | * **libssl** |
b06935f4 | 22 | Provides the client and server-side implementations for SSLv3 and TLS. |
651d0aff | 23 | |
5f8e6c50 | 24 | * **libcrypto:** |
b06935f4 RS |
25 | Provides general cryptographic and X.509 support needed by SSL/TLS but |
26 | not logically part of it. | |
651d0aff | 27 | |
5f8e6c50 | 28 | * **openssl:** |
d7f0ab5f | 29 | A command line tool that can be used for: |
b06935f4 | 30 | Creation of key parameters |
a2c96d88 | 31 | Creation of X.509 certificates, CSRs and CRLs |
b06935f4 RS |
32 | Calculation of message digests |
33 | Encryption and decryption | |
34 | SSL/TLS client and server tests | |
d7f0ab5f | 35 | Handling of S/MIME signed or encrypted mail |
b06935f4 | 36 | And more... |
d7f0ab5f | 37 | |
5f8e6c50 DMSP |
38 | Installation |
39 | ============ | |
dfca822f | 40 | |
5f8e6c50 | 41 | See the appropriate file: |
80e1495b | 42 | |
5f8e6c50 DMSP |
43 | * [INSTALL](INSTALL): General installation instructions for all platforms |
44 | * Additional instructions for specific platforms | |
45 | * [NOTES.ANDROID](NOTES.ANDROID) | |
46 | * [NOTES.DJGPP](NOTES.DJGPP) | |
47 | * [NOTES.PERL](NOTES.PERL) | |
48 | * [NOTES.UNIX](NOTES.UNIX) | |
49 | * [NOTES.VALGRIND](NOTES.VALGRIND) | |
50 | * [NOTES.VMS](NOTES.VMS) | |
51 | * [NOTES.WIN](NOTES.WIN) | |
dfca822f | 52 | |
5f8e6c50 DMSP |
53 | Support |
54 | ======= | |
0e37c909 | 55 | |
5f8e6c50 DMSP |
56 | See the OpenSSL website www.openssl.org for details on how to obtain |
57 | commercial technical support. Free community support is available through the | |
58 | openssl-users email list (see | |
59 | https://www.openssl.org/community/mailinglists.html for further details). | |
dfca822f | 60 | |
5f8e6c50 DMSP |
61 | If you have any problems with OpenSSL then please take the following steps |
62 | first: | |
dfca822f | 63 | |
5f8e6c50 DMSP |
64 | - Download the latest version from the repository |
65 | to see if the problem has already been addressed | |
66 | - Configure with no-asm | |
67 | - Remove compiler optimization flags | |
dfca822f | 68 | |
5f8e6c50 DMSP |
69 | If you wish to report a bug then please include the following information |
70 | and create an issue on GitHub: | |
dfca822f | 71 | |
5f8e6c50 DMSP |
72 | - OpenSSL version: output of 'openssl version -a' |
73 | - Configuration data: output of 'perl configdata.pm --dump' | |
74 | - OS Name, Version, Hardware platform | |
75 | - Compiler Details (name, version) | |
76 | - Application Details (name, version) | |
77 | - Problem Description (steps that will reproduce the problem, if known) | |
78 | - Stack Traceback (if the application dumps core) | |
932af161 | 79 | |
5f8e6c50 DMSP |
80 | Just because something doesn't work the way you expect does not mean it |
81 | is necessarily a bug in OpenSSL. Use the openssl-users email list for this type | |
82 | of query. | |
b282fdae | 83 | |
5f8e6c50 DMSP |
84 | How to contribute to OpenSSL |
85 | ============================ | |
b06935f4 | 86 | |
5f8e6c50 DMSP |
87 | See [CONTRIBUTING](CONTRIBUTING.md) |
88 | ||
89 | Legalities | |
90 | ========== | |
b06935f4 | 91 | |
12a7715e | 92 | A number of nations restrict the use or export of cryptography. If you |
7954dced RS |
93 | are potentially subject to such restrictions you should seek competent |
94 | professional legal advice before attempting to develop or distribute | |
95 | cryptographic code. | |
5f8e6c50 DMSP |
96 | |
97 | ||
98 | Copyright | |
99 | ========= | |
100 | ||
101 | Copyright (c) 1998-2018 The OpenSSL Project | |
102 | ||
103 | Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson | |
104 | ||
105 | All rights reserved. |