diff options
author | Robert Sloan <varomodt@google.com> | 2018-09-11 11:45:04 -0700 |
---|---|---|
committer | Robert Sloan <varomodt@google.com> | 2018-09-11 12:05:43 -0700 |
commit | 726e9d1f47fd5e4e4d8313670d0c719c52850afb (patch) | |
tree | 571d8a1a9056bd99aaa694a9167a123294912b11 /src/BUILDING.md | |
parent | 1f278ae75520bf67658f222a252fc94dec3c156f (diff) | |
download | boringssl-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.md | 22 |
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 |