+Welcome to the OpenSSL Project
+==============================
+
[![openssl logo][]][www.openssl.org]
[![travis badge][]][travis jobs]
[![appveyor badge][]][appveyor jobs]
-
-
-Welcome to the OpenSSL Project
-==============================
-
OpenSSL is a robust, commercial-grade, full-featured Open Source Toolkit
for the Transport Layer Security (TLS) protocol formerly known as the
Secure Sockets Layer (SSL) protocol. The protocol implementation is based
The official Home Page of the OpenSSL Project is [www.openssl.org][].
-
Table of Contents
=================
- **openssl**
the OpenSSL command line tool, a swiss army knife for cryptographic tasks,
testing and analyzing. It can be used for
- - creation of key parameters
- - creation of X.509 certificates, CSRs and CRLs
- - calculation of message digests
- - encryption and decryption
- - SSL/TLS client and server tests
- - handling of S/MIME signed or encrypted mail
- - and more...
+ - creation of key parameters
+ - creation of X.509 certificates, CSRs and CRLs
+ - calculation of message digests
+ - encryption and decryption
+ - SSL/TLS client and server tests
+ - handling of S/MIME signed or encrypted mail
+ - and more...
Download
========
Unix operating systems it is normally recommended to link against the
precompiled shared libraries provided by the distributor or vendor.
-
For Testing and Development
---------------------------
A local copy of the Git Repository can be obtained by cloning it from
the original OpenSSL repository using
- git clone git://git.openssl.org/openssl.git
+ git clone git://git.openssl.org/openssl.git
or from the GitHub mirror using
- git clone https://github.com/openssl/openssl.git
+ git clone https://github.com/openssl/openssl.git
If you intend to contribute to OpenSSL, either to fix bugs or contribute
new features, you need to fork the OpenSSL repository openssl/openssl on
GitHub and clone your public fork instead.
- git clone https://github.com/yourname/openssl.git
+ git clone https://github.com/yourname/openssl.git
This is necessary, because all development of OpenSSL nowadays is done via
GitHub pull requests. For more details, see [Contributing](#contributing).
-
Build and Install
=================
platforms, the installation instructions are amended by a platform specific
document.
- * [NOTES.ANDROID](NOTES.ANDROID)
- * [NOTES.DJGPP](NOTES.DJGPP)
- * [NOTES.PERL](NOTES.PERL)
- * [NOTES.UNIX](NOTES.UNIX)
- * [NOTES.VALGRIND](NOTES.VALGRIND)
- * [NOTES.VMS](NOTES.VMS)
- * [NOTES.WIN](NOTES.WIN)
+ * [NOTES-Android.md](NOTES-Android.md)
+ * [NOTES-DJGPP.md](NOTES-DJGPP.md)
+ * [NOTES-Unix.md](NOTES-Unix.md)
+ * [NOTES-VMS.md](NOTES-VMS.md)
+ * [NOTES-Windows.txt](NOTES-Windows.txt)
+ * [NOTES-Perl.m](NOTES-Perl.md)
+ * [NOTES-Valgrind.md](NOTES-Valgrind.md)
Specific notes on upgrading to OpenSSL 3.0 from previous versions, as well as
known issues are available on the OpenSSL
you are free to get and use it for commercial and non-commercial
purposes as long as you fulfill its conditions.
-See the [LICENSE](LICENSE) file for more details.
+See the [LICENSE.txt](LICENSE.txt) file for more details.
Support
=======
If you are interested and willing to contribute to the OpenSSL project,
please take a look at the [CONTRIBUTING](CONTRIBUTING.md) file.
-Since 2016, development takes place in public on the GitHub open source
-platform. The OpenSSL Project Pages at [openssl.github.io][] are a
-valuable source of information if you want to get familiar with our
-development process on GitHub.
-
-
Legalities
==========
potentially subject to such restrictions you should seek legal advice before
attempting to develop or distribute cryptographic code.
-
Copyright
=========
All rights reserved.
-
<!-- Links -->
[www.openssl.org]:
- https://www.openssl.org
+ <https://www.openssl.org>
"OpenSSL Homepage"
[git.openssl.org]:
- https://git.openssl.org
+ <https://git.openssl.org>
"OpenSSL Git Repository"
[git.openssl.org]:
- https://git.openssl.org
+ <https://git.openssl.org>
"OpenSSL Git Repository"
[github.com/openssl/openssl]:
- https://github.com/openssl/openssl
+ <https://github.com/openssl/openssl>
"OpenSSL GitHub Mirror"
-[openssl.github.io]:
- https://mspncp.github.io
- "OpenSSL Project Pages"
-
[wiki.openssl.org]:
- https://wiki.openssl.org
+ <https://wiki.openssl.org>
"OpenSSL Wiki"
-
[RFC 8446]:
- https://tools.ietf.org/html/rfc8446
-
+ <https://tools.ietf.org/html/rfc8446>
<!-- Logos and Badges -->
-<!--
- Note: The security token for the appveyor badge (the random number in
- the URL below) was obtained for the mspncp/openssl project.
- It needs to be replaced by the correct token by some core member
- (@levitte, @mattcaswell?). It can be obtained for project members at
- https://ci.appveyor.com/project/openssl/openssl/settings/badges.
--->
[openssl logo]:
doc/images/openssl.svg
"OpenSSL Logo"
[travis badge]:
- https://travis-ci.org/openssl/openssl.svg?branch=master
+ <https://travis-ci.org/openssl/openssl.svg?branch=master>
"Travis Build Status"
[travis jobs]:
- https://travis-ci.org/openssl/openssl
+ <https://travis-ci.org/openssl/openssl>
"Travis Jobs"
[appveyor badge]:
- https://ci.appveyor.com/api/projects/status/ikn2l4u1xsume63u/branch/master?svg=true
+ <https://ci.appveyor.com/api/projects/status/8e10o7xfrg73v98f/branch/master?svg=true>
"AppVeyor Build Status"
[appveyor jobs]:
- https://ci.appveyor.com/project/openssl/openssl/branch/master
+ <https://ci.appveyor.com/project/openssl/openssl/branch/master>
"AppVeyor Jobs"