summaryrefslogtreecommitdiff
path: root/src/BUILDING.md
diff options
context:
space:
mode:
authorRobert Sloan <varomodt@google.com>2018-09-11 11:45:04 -0700
committerRobert Sloan <varomodt@google.com>2018-09-11 12:05:43 -0700
commit726e9d1f47fd5e4e4d8313670d0c719c52850afb (patch)
tree571d8a1a9056bd99aaa694a9167a123294912b11 /src/BUILDING.md
parent1f278ae75520bf67658f222a252fc94dec3c156f (diff)
downloadboringssl-726e9d1f47fd5e4e4d8313670d0c719c52850afb.tar.gz
external/boringssl: Sync to 689019fe40d5ad94df46ffeebcd794ff359a7074.
This includes the following changes: https://boringssl.googlesource.com/boringssl/+log/67e64342c1aa0b31b0b5c11e5ee21c481ce530e8..689019fe40d5ad94df46ffeebcd794ff359a7074 Test: BoringSSL CTS Presubmits Change-Id: Ib675c5478b0e45270e31248d1dadc5f4841da990
Diffstat (limited to 'src/BUILDING.md')
-rw-r--r--src/BUILDING.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/src/BUILDING.md b/src/BUILDING.md
index 19dbe015..9bf9cb26 100644
--- a/src/BUILDING.md
+++ b/src/BUILDING.md
@@ -110,6 +110,28 @@ architecture, matching values used in the `-arch` flag in Apple's toolchain.
Passing multiple architectures for a multiple-architecture build is not
supported.
+### Building with Prefixed Symbols
+
+BoringSSL's build system has experimental support for adding a custom prefix to
+all symbols. This can be useful when linking multiple versions of BoringSSL in
+the same project to avoid symbol conflicts.
+
+In order to build with prefixed symbols, the `BORINGSSL_PREFIX` CMake variable
+should specify the prefix to add to all symbols, and the
+`BORINGSSL_PREFIX_SYMBOLS` CMake variable should specify the path to a file
+which contains a list of symbols which should be prefixed (one per line;
+comments are supported with `#`). In other words, `cmake ..
+-DBORINGSSL_PREFIX=MY_CUSTOM_PREFIX
+-DBORINGSSL_PREFIX_SYMBOLS=/path/to/symbols.txt` will configure the build to add
+the prefix `MY_CUSTOM_PREFIX` to all of the symbols listed in
+`/path/to/symbols.txt`.
+
+It is currently the caller's responsibility to create and maintain the list of
+symbols to be prefixed.
+
+This mechanism is under development and may change over time. Please contact the
+BoringSSL maintainers if making use of it.
+
## Known Limitations on Windows
* Versions of CMake since 3.0.2 have a bug in its Ninja generator that causes