Adam Langley 3faf3db6d8 Fix GCC (8.2.1) build error. Not sure that I think this is a very valid build error from GCC, but it's easy enough to work around. ../crypto/cpu-arm-linux_test.cc: In member function ‘virtual void ARMLinuxTest_CPUInfo_Test::TestBody()’: ../crypto/cpu-arm-linux_test.cc:25:10: error: declaration of ‘struct ARMLinuxTest_CPUInfo_Test::TestBody()::Test’ shadows a previous local [-Werror=shadow] struct Test { ^~~~ In file included from ../crypto/cpu-arm-linux_test.cc:19: ../third_party/googletest/include/gtest/gtest.h:375:23: note: shadowed declaration is here class GTEST_API_ Test { Change-Id: Icc1676a621ec26b3665adaf5daf7d6c6f5307ba8 Reviewed-on: https://boringssl-review.googlesource.com/31624 Reviewed-by: Adam Langley <agl@google.com>		vor 6 Jahren
.github	Add a PULL_REQUEST_TEMPLATE.	vor 8 Jahren
crypto	Fix GCC (8.2.1) build error.	vor 6 Jahren
decrepit	Flatten the decrepit target.	vor 6 Jahren
fipstools	Align on a single CMake style.	vor 6 Jahren
fuzz	Fix corner case in cpuinfo parser.	vor 6 Jahren
include/openssl	Tidy up docs for #defines.	vor 6 Jahren
infra/config	Remove apparently unused cq_name field.	vor 6 Jahren
ssl	Some more bools.	vor 6 Jahren
third_party	Document that ED25519_sign only fails on allocation failure	vor 6 Jahren
tool	Switch the default TLS 1.3 variant to tls13_rfc.	vor 6 Jahren
util	Tidy up docs for #defines.	vor 6 Jahren
.clang-format	Import `newhope' (post-quantum key exchange).	vor 8 Jahren
.gitignore	Add an option to statically link a custom libc++.	vor 6 Jahren
API-CONVENTIONS.md	Clarify "reference" and fix typo.	vor 6 Jahren
BREAKING-CHANGES.md	Add some notes on how to handle breaking changes.	vor 6 Jahren
BUILDING.md	Add -DOPENSSL_SMALL to CMake.	vor 6 Jahren
CMakeLists.txt	Flatten most of the crypto target.	vor 6 Jahren
CONTRIBUTING.md	Add a CONTRIBUTING.md file.	vor 8 Jahren
FUZZING.md	Switch to Clang 6.0's fuzzer support.	vor 6 Jahren
INCORPORATING.md	Update URL for GN quick start guide.	vor 6 Jahren
LICENSE	Note licenses for support code in the top-level LICENSE file.	vor 6 Jahren
PORTING.md	Remove reference to SSL3 in PORTING.md.	vor 6 Jahren
README.md	Add some notes on how to handle breaking changes.	vor 6 Jahren
STYLE.md	Fix some style guide samples.	vor 7 Jahren
codereview.settings	Comment change in codereview.settings	vor 6 Jahren
sources.cmake	Add new curve/hash ECDSA combinations from Wycheproof.	vor 6 Jahren

README.md

BoringSSL

BoringSSL is a fork of OpenSSL that is designed to meet Google’s needs.

Although BoringSSL is an open source project, it is not intended for general use, as OpenSSL is. We don’t recommend that third parties depend upon it. Doing so is likely to be frustrating because there are no guarantees of API or ABI stability.

Programs ship their own copies of BoringSSL when they use it and we update everything as needed when deciding to make API changes. This allows us to mostly avoid compromises in the name of compatibility. It works for us, but it may not work for you.

BoringSSL arose because Google used OpenSSL for many years in various ways and, over time, built up a large number of patches that were maintained while tracking upstream OpenSSL. As Google’s product portfolio became more complex, more copies of OpenSSL sprung up and the effort involved in maintaining all these patches in multiple places was growing steadily.

Currently BoringSSL is the SSL library in Chrome/Chromium, Android (but it’s not part of the NDK) and a number of other apps/programs.

There are other files in this directory which might be helpful:

PORTING.md: how to port OpenSSL-using code to BoringSSL.
BUILDING.md: how to build BoringSSL
INCORPORATING.md: how to incorporate BoringSSL into a project.
API-CONVENTIONS.md: general API conventions for BoringSSL consumers and developers.
STYLE.md: rules and guidelines for coding style.
include/openssl: public headers with API documentation in comments. Also available online.
FUZZING.md: information about fuzzing BoringSSL.
CONTRIBUTING.md: how to contribute to BoringSSL.
BREAKING-CHANGES.md: notes on potentially-breaking changes.