TLS/SSL and crypto library https://www.openssl.org

Matt Caswell 871493a2be Ignore an auto-generated documentation file 5 years ago
.github 7dc6875c55 Remove markdown links from HTML comments in issue templates 5 years ago
Configurations f19d20b60f VMS build: don't forget the generation marker when removing files 5 years ago
VMS d445302418 Simplify the handling of shared library version numbers 6 years ago
apps b92678f4e9 openssl s_server: don't use sendto() with connected UDP socket 5 years ago
boringssl @ 2070f8ad91 4b5f7e7555 Update ossl_config.json for later BoringSSL commit 7 years ago
crypto 0ac8f35c04 Disallow Ed25519 signature maleability 5 years ago
demos 47d2080fac Remove outdated e_chil.txt file 5 years ago
doc be80b21d2a Docs: better deprecation text 5 years ago
engines ed57d89bd1 Change the build of engines to use ordinal files for symbol export 5 years ago
external 1212818eb0 Update copyright year 5 years ago
fuzz c486283cb8 Update copyright year 5 years ago
include f658a3b64d err/err.c: add err_clear_last_constant_time. 5 years ago
krb5 @ b9ad6c4950 0fef74486e [extended tests] Enable krb5 tests in Travis 7 years ago
ms 6ec5fce25e Update copyright year 6 years ago
os-dep 6c4be50a5d Move Haiku configuration to separate config file to denote 8 years ago
pyca-cryptography @ 09403100de 7a8f6cad82 Update the pyca-cryptography submodule 5 years ago
ssl 9b1c0e006b Fix usage of deprecated SSL_set_tmp_ecdh() 5 years ago
test e65a79d2aa Add an Ed25519 signature maleability test 5 years ago
tools b0edda11cb Update copyright year 6 years ago
util be80b21d2a Docs: better deprecation text 5 years ago
.gitattributes 76bc401cc6 Don't export the submodules 'boringssl', 'krb5' and 'pyca-cryptography' 5 years ago
.gitignore 871493a2be Ignore an auto-generated documentation file 5 years ago
.gitmodules 0fef74486e [extended tests] Enable krb5 tests in Travis 7 years ago
.travis-apt-pin.preferences 404c76f4ee Fix travis clang-3.9 builds 6 years ago
.travis-create-release.sh 8d9535ec3e Remove all 'make dist' artifacts 5 years ago
.travis.yml 2a6f57bc09 Travis CI: Use flake8 to find Python syntax errors or undefined names 5 years ago
ACKNOWLEDGEMENTS ab29c82a55 Refer to website for acknowledgements. 8 years ago
AUTHORS b7b13c7ac8 Update AUTHORS list, add commentary 5 years ago
CHANGES b42922ea2f Document the removed 'dist' target 5 years ago
CONTRIBUTING 029c11c21f Add a note on CHANGES and NEWS in CONTRIBUTING 6 years ago
Configure 856b1b65fa Configuration: only include shared_sources in dirinfo in shared config 5 years ago
FAQ 4f46473a86 Move FAQ to the web. 8 years ago
INSTALL 46d085096c typo-fixes: miscellaneous typo fixes 5 years ago
LICENSE 7c24f9d21c Update the license end year 6 years ago
NEWS c1ef2852b2 Update CHANGES and NEWS for new release 5 years ago
NOTES.ANDROID 03ad7c009e Configurations/15-android.conf: add support for "standalone toolchain". 5 years ago
NOTES.DJGPP 07930a75a1 Slight cleanup of the collection of READMEs, INSTALLs and NOTES 8 years ago
NOTES.PERL 073b1b72f6 Tweaks to NOTES.PERL 8 years ago
NOTES.UNIX 2c879241ba NOTES.UNIX: add "Linking your application" paragraph 5 years ago
NOTES.VMS 69687aa829 More typo fixes 7 years ago
NOTES.WIN f529b5cf05 INSTALL,NOTES.WIN: classify no-asm as non-production option. 5 years ago
README a4a90a8a3b The next version in master is at least 1.1.2, not 1.1.1x 5 years ago
README.ENGINE f39a5501ce Remove bsd_cryptodev engine 6 years ago
README.FIPS 700b4a4ae7 Remove more (rest?) of FIPS build stuff. 8 years ago
appveyor.yml 986caf9e34 CI config: no need to make both install and install_docs 6 years ago
build.info 547a3320fc Doc: add doc/man7/openssl_user_macros.pod.in 5 years ago
config 0ad4078cd6 Configure: move --noexecstack probe to Configure. 6 years ago
config.com 6738bf1417 Update copyright year 6 years ago
e_os.h 8529b15642 test/secmemtest: test secure memory only if it is implemented 5 years ago

README


OpenSSL 1.1.2-dev

Copyright (c) 1998-2018 The OpenSSL Project
Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson
All rights reserved.

DESCRIPTION
-----------

The OpenSSL Project is a collaborative effort to develop a robust,
commercial-grade, fully featured, and Open Source toolkit implementing the
Transport Layer Security (TLS) protocols (including SSLv3) as well as a
full-strength general purpose cryptographic library.

OpenSSL is descended from the SSLeay library developed by Eric A. Young
and Tim J. Hudson. The OpenSSL toolkit is licensed under a dual-license (the
OpenSSL license plus the SSLeay license), which means that you are free to
get and use it for commercial and non-commercial purposes as long as you
fulfill the conditions of both licenses.

OVERVIEW
--------

The OpenSSL toolkit includes:

libssl (with platform specific naming):
Provides the client and server-side implementations for SSLv3 and TLS.

libcrypto (with platform specific naming):
Provides general cryptographic and X.509 support needed by SSL/TLS but
not logically part of it.

openssl:
A command line tool that 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...

INSTALLATION
------------

See the appropriate file:
INSTALL Linux, Unix, Windows, OpenVMS, ...
NOTES.* INSTALL addendums for different platforms

SUPPORT
-------

See the OpenSSL website www.openssl.org for details on how to obtain
commercial technical support. Free community support is available through the
openssl-users email list (see
https://www.openssl.org/community/mailinglists.html for further details).

If you have any problems with OpenSSL then please take the following steps
first:

- Download the latest version from the repository
to see if the problem has already been addressed
- Configure with no-asm
- Remove compiler optimization flags

If you wish to report a bug then please include the following information
and create an issue on GitHub:

- OpenSSL version: output of 'openssl version -a'
- Configuration data: output of 'perl configdata.pm --dump'
- OS Name, Version, Hardware platform
- Compiler Details (name, version)
- Application Details (name, version)
- Problem Description (steps that will reproduce the problem, if known)
- Stack Traceback (if the application dumps core)

Just because something doesn't work the way you expect does not mean it
is necessarily a bug in OpenSSL. Use the openssl-users email list for this type
of query.

HOW TO CONTRIBUTE TO OpenSSL
----------------------------

See CONTRIBUTING

LEGALITIES
----------

A number of nations restrict the use or export of cryptography. If you
are potentially subject to such restrictions you should seek competent
professional legal advice before attempting to develop or distribute
cryptographic code.