• Home
Name Date Size #Lines LOC

..--

.bcr/04-Jul-2025-8576

cmake/04-Jul-2025-10592

crypto/04-Jul-2025-658,335547,282

decrepit/04-Jul-2025-5,3733,832

docs/04-Jul-2025-4030

fuzz/04-Jul-2025-6,3244,597

gen/04-Jul-2025-273,774249,408

include/openssl/04-Jul-2025-38,98014,062

infra/config/04-Jul-2025-7,1367,011

pki/04-Jul-2025-202,621177,985

rust/04-Jul-2025-7,4974,716

ssl/04-Jul-2025-99,95774,841

third_party/04-Jul-2025-806,857749,004

tool/04-Jul-2025-6,1924,952

util/04-Jul-2025-33,84128,049

.bazelignoreD04-Jul-202542 32

.bazelrcD04-Jul-20252 KiB4537

.bazelversionD04-Jul-20256 21

.clang-formatD04-Jul-20252.6 KiB8180

API-CONVENTIONS.mdD04-Jul-202515.5 KiB325251

BREAKING-CHANGES.mdD04-Jul-20258.8 KiB8947

BUILD.bazelD04-Jul-20255.4 KiB207191

BUILDING.mdD04-Jul-20259.4 KiB222161

CMakeLists.txtD04-Jul-202529.9 KiB806703

CONTRIBUTING.mdD04-Jul-20252.7 KiB5342

FUZZING.mdD04-Jul-20254.3 KiB8150

INCORPORATING.mdD04-Jul-20255.9 KiB12294

LICENSED04-Jul-202512.2 KiB253222

MODULE.bazelD04-Jul-20251.7 KiB3833

PORTING.mdD04-Jul-202516.3 KiB307228

PrivacyInfo.xcprivacyD04-Jul-2025567 2214

README.mdD04-Jul-20252.6 KiB4635

SANDBOXING.mdD04-Jul-20256.6 KiB141107

STYLE.mdD04-Jul-20258.4 KiB234164

build.jsonD04-Jul-202542.6 KiB1,0601,059

codereview.settingsD04-Jul-2025170 54

go.modD04-Jul-2025311 1612

go.sumD04-Jul-2025998 1312

README.md

1# BoringSSL
2
3BoringSSL is a fork of OpenSSL that is designed to meet Google's needs.
4
5Although BoringSSL is an open source project, it is not intended for general
6use, as OpenSSL is. We don't recommend that third parties depend upon it. Doing
7so is likely to be frustrating because there are no guarantees of API or ABI
8stability.
9
10Programs ship their own copies of BoringSSL when they use it and we update
11everything as needed when deciding to make API changes. This allows us to
12mostly avoid compromises in the name of compatibility. It works for us, but it
13may not work for you.
14
15BoringSSL arose because Google used OpenSSL for many years in various ways and,
16over time, built up a large number of patches that were maintained while
17tracking upstream OpenSSL. As Google's product portfolio became more complex,
18more copies of OpenSSL sprung up and the effort involved in maintaining all
19these patches in multiple places was growing steadily.
20
21Currently BoringSSL is the SSL library in Chrome/Chromium, Android (but it's
22not part of the NDK) and a number of other apps/programs.
23
24Project links:
25
26  * [API documentation](https://commondatastorage.googleapis.com/chromium-boringssl-docs/headers.html)
27  * [Issue tracker](https://crbug.com/boringssl)
28    * [Filing new (public) issues](https://crbug.com/boringssl/new)
29  * [CI](https://ci.chromium.org/p/boringssl/g/main/console)
30  * [Code review](https://boringssl-review.googlesource.com)
31
32To file a security issue, use the [Chromium process](https://www.chromium.org/Home/chromium-security/reporting-security-bugs/) and mention in the report this is for BoringSSL. You can ignore the parts of the process that are specific to Chromium/Chrome.
33
34There are other files in this directory which might be helpful:
35
36  * [PORTING.md](./PORTING.md): how to port OpenSSL-using code to BoringSSL.
37  * [BUILDING.md](./BUILDING.md): how to build BoringSSL
38  * [INCORPORATING.md](./INCORPORATING.md): how to incorporate BoringSSL into a project.
39  * [API-CONVENTIONS.md](./API-CONVENTIONS.md): general API conventions for BoringSSL consumers and developers.
40  * [STYLE.md](./STYLE.md): rules and guidelines for coding style.
41  * include/openssl: public headers with API documentation in comments. Also [available online](https://commondatastorage.googleapis.com/chromium-boringssl-docs/headers.html).
42  * [FUZZING.md](./FUZZING.md): information about fuzzing BoringSSL.
43  * [CONTRIBUTING.md](./CONTRIBUTING.md): how to contribute to BoringSSL.
44  * [BREAKING-CHANGES.md](./BREAKING-CHANGES.md): notes on potentially-breaking changes.
45  * [SANDBOXING.md](./SANDBOXING.md): notes on using BoringSSL in a sandboxed environment.
46