summaryrefslogtreecommitdiffstats
path: root/INSTALL.md
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2023-01-30 13:54:01 +0100
committerTomas Mraz <tomas@openssl.org>2023-02-01 08:30:04 +0100
commitaa2d7e0ee15d1b7015479c38f370a25ceec690fc (patch)
treeb5369f8cbb7a2bf248a51b0adaf64f3039171e80 /INSTALL.md
parente788c772b12eea5ced4ce46619e13acf0e0eb6ba (diff)
Use $config{build_file} instead of $target{build_file}
If the user specifies an alternative build file than the default, this alternative is recorded in $config{build_file}, not $target{build_file}. Therefore, the former should be used, leaving the latter as a mere default. This is a bug. While fixing it, document it better too. Reviewed-by: Matt Caswell <matt@openssl.org> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/20173)
Diffstat (limited to 'INSTALL.md')
-rw-r--r--INSTALL.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/INSTALL.md b/INSTALL.md
index b0947baf2c..ebde856a90 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1304,6 +1304,14 @@ and `descrip.mms` on OpenVMS) from a suitable template in `Configurations/`,
and defines various macros in `include/openssl/configuration.h` (generated
from `include/openssl/configuration.h.in`.
+If none of the generated build files suit your purpose, it's possible to
+write your own build file template and give its name through the environment
+variable `BUILDFILE`. For example, Ninja build files could be supported by
+writing `Configurations/build.ninja.tmpl` and then configure with `BUILDFILE`
+set like this (Unix syntax shown, you'll have to adapt for other platforms):
+
+ $ BUILDFILE=build.ninja perl Configure [options...]
+
### Out of Tree Builds
OpenSSL can be configured to build in a build directory separate from the