From: William Roberts <william.c.roberts@xxxxxxxxx> Start a section in the README for documenting that custom CFLAGS yeilds CUSTOM results and that your mileage may vary. The first CFLAG to document that you likely want to include is -fsemantic-interposition. Signed-off-by: William Roberts <william.c.roberts@xxxxxxxxx> --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 9d64f0b5cf90..f37a9f91f51e 100644 --- a/README.md +++ b/README.md @@ -120,6 +120,17 @@ lacks library functions or other dependencies relied upon by your distribution. If it breaks, you get to keep both pieces. +## Setting CFLAGS + +Setting CFLAGS during the make process will cause the omission of many default CFLAGS. While the project strives +to provide a sane set of default CFLAGS, custom CFLAGS could break the build, or have other undesired changes +on the build output. Thus, be very careful when setting CFLAGS. CFLAGS that we encourage to be set when +overriding CFLAGS are: + +- -fsemantic-interposition for gcc or compilers that do not do this. clang does this by default. clang-10 and up + will support passing this flag, but ignore it. Previous clang versions fail. + + macOS ----- -- 2.17.1