diff options
author | Richard Levitte <levitte@openssl.org> | 2017-03-06 11:19:49 +0100 |
---|---|---|
committer | Richard Levitte <levitte@openssl.org> | 2017-03-06 16:42:46 +0100 |
commit | 44eb65ce20d673d0332802275d54f6811f448076 (patch) | |
tree | 627a3ab9b16dc5a4b561761d9f499e287803726e /Configurations/README | |
parent | d192a3aaeb76fc89f8285b4dc938c2bc0c37d0d4 (diff) |
Add documentation on platform specific checks
Reviewed-by: Andy Polyakov <appro@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/2851)
Diffstat (limited to 'Configurations/README')
-rw-r--r-- | Configurations/README | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/Configurations/README b/Configurations/README index 21a6f036f8..2958461393 100644 --- a/Configurations/README +++ b/Configurations/README @@ -1,3 +1,20 @@ +Intro +===== + +This directory contains a few sets of files that are used for +configuration in diverse ways: + + *.conf Target platform configurations, please read + 'Configurations of OpenSSL target platforms' for more + information. + *.tmpl Build file templates, please read 'Build-file + programming with the "unified" build system' as well + as 'Build info files' for more information. + *.pm Helper scripts / modules for the main `Configure` + script. See 'Configure helper scripts for more + information. + + Configurations of OpenSSL target platforms ========================================== @@ -672,3 +689,23 @@ else, end it like this: ""; # Make sure no lingering values end up in the Makefile -} + + +Configure helper scripts +======================== + +Configure uses helper scripts in this directory: + +Checker scripts +--------------- + +These scripts are per platform family, to check the integrity of the +tools used for configuration and building. The checker script used is +either {build_platform}-{build_file}-checker.pm or +{build_platform}-checker.pm, where {build_platform} is the second +'build_scheme' list element from the configuration target data, and +{build_file} is 'build_file' from the same target data. + +If the check succeeds, the script is expected to end with a non-zero +expression. If the check fails, the script can end with a zero, or +with a `die`. |