Configure: Fix ordering bug when processing split DEPENDs
[openssl.git] / Configure
1 #! /usr/bin/env perl
2 # -*- mode: perl; -*-
3 # Copyright 2016-2023 The OpenSSL Project Authors. All Rights Reserved.
4 #
5 # Licensed under the Apache License 2.0 (the "License").  You may not use
6 # this file except in compliance with the License.  You can obtain a copy
7 # in the file LICENSE in the source distribution or at
8 # https://www.openssl.org/source/license.html
9
10 ##  Configure -- OpenSSL source tree configuration script
11
12 use 5.10.0;
13 use strict;
14 use Config;
15 use FindBin;
16 use lib "$FindBin::Bin/util/perl";
17 use File::Basename;
18 use File::Spec::Functions qw/:DEFAULT abs2rel rel2abs splitdir/;
19 use File::Path qw/mkpath/;
20 use OpenSSL::fallback "$FindBin::Bin/external/perl/MODULES.txt";
21 use OpenSSL::Glob;
22 use OpenSSL::Template;
23 use OpenSSL::config;
24
25 # see INSTALL.md for instructions.
26
27 my $orig_death_handler = $SIG{__DIE__};
28 $SIG{__DIE__} = \&death_handler;
29
30 my $usage="Usage: Configure [no-<feature> ...] [enable-<feature> ...] [-Dxxx] [-lxxx] [-Lxxx] [-fxxx] [-Kxxx] [no-hw-xxx|no-hw] [[no-]threads] [[no-]thread-pool] [[no-]default-thread-pool] [[no-]shared] [[no-]zlib|zlib-dynamic] [no-asm] [no-egd] [sctp] [386] [--prefix=DIR] [--openssldir=OPENSSLDIR] [--with-xxx[=vvv]] [--config=FILE] os/compiler[:flags]\n";
31
32 my $banner = <<"EOF";
33
34 **********************************************************************
35 ***                                                                ***
36 ***   OpenSSL has been successfully configured                     ***
37 ***                                                                ***
38 ***   If you encounter a problem while building, please open an    ***
39 ***   issue on GitHub <https://github.com/openssl/openssl/issues>  ***
40 ***   and include the output from the following command:           ***
41 ***                                                                ***
42 ***       perl configdata.pm --dump                                ***
43 ***                                                                ***
44 ***   (If you are new to OpenSSL, you might want to consult the    ***
45 ***   'Troubleshooting' section in the INSTALL.md file first)      ***
46 ***                                                                ***
47 **********************************************************************
48 EOF
49
50 # Options:
51 #
52 # --config      add the given configuration file, which will be read after
53 #               any "Configurations*" files that are found in the same
54 #               directory as this script.
55 # --prefix      prefix for the OpenSSL installation, which includes the
56 #               directories bin, lib, include, share/man, share/doc/openssl
57 #               This becomes the value of INSTALLTOP in Makefile
58 #               (Default: /usr/local)
59 # --openssldir  OpenSSL data area, such as openssl.cnf, certificates and keys.
60 #               If it's a relative directory, it will be added on the directory
61 #               given with --prefix.
62 #               This becomes the value of OPENSSLDIR in Makefile and in C.
63 #               (Default: PREFIX/ssl)
64 # --banner=".." Output specified text instead of default completion banner
65 #
66 # -w            Don't wait after showing a Configure warning
67 #
68 # --cross-compile-prefix Add specified prefix to binutils components.
69 #
70 # --api         One of 0.9.8, 1.0.0, 1.0.1, 1.0.2, 1.1.0, 1.1.1, or 3.0
71 #               Define the public APIs as they were for that version
72 #               including patch releases.  If 'no-deprecated' is also
73 #               given, do not compile support for interfaces deprecated
74 #               up to and including the specified OpenSSL version.
75 #
76 # no-hw-xxx     do not compile support for specific crypto hardware.
77 #               Generic OpenSSL-style methods relating to this support
78 #               are always compiled but return NULL if the hardware
79 #               support isn't compiled.
80 # no-hw         do not compile support for any crypto hardware.
81 # [no-]threads  [don't] try to create a library that is suitable for
82 #               multithreaded applications (default is "threads" if we
83 #               know how to do it)
84 # [no-]thread-pool
85 #               [don't] allow thread pool functionality
86 # [no-]default-thread-pool
87 #               [don't] allow default thread pool functionality
88 # [no-]shared   [don't] try to create shared libraries when supported.
89 # [no-]pic      [don't] try to build position independent code when supported.
90 #               If disabled, it also disables shared and dynamic-engine.
91 # no-asm        do not use assembler
92 # no-egd        do not compile support for the entropy-gathering daemon APIs
93 # [no-]zlib     [don't] compile support for zlib compression.
94 # zlib-dynamic  Like "zlib", but the zlib library is expected to be a shared
95 #               library and will be loaded at run-time by the OpenSSL library.
96 # sctp          include SCTP support
97 # no-quic       disable QUIC support
98 # no-uplink     Don't build support for UPLINK interface.
99 # enable-weak-ssl-ciphers
100 #               Enable weak ciphers that are disabled by default.
101 # 386           generate 80386 code in assembly modules
102 # no-sse2       disables IA-32 SSE2 code in assembly modules, the above
103 #               mentioned '386' option implies this one
104 # no-<cipher>   build without specified algorithm (dsa, idea, rc5, ...)
105 # -<xxx> +<xxx> All options which are unknown to the 'Configure' script are
106 # /<xxx>        passed through to the compiler. Unix-style options beginning
107 #               with a '-' or '+' are recognized, as well as Windows-style
108 #               options beginning with a '/'. If the option contains arguments
109 #               separated by spaces, then the URL-style notation %20 can be
110 #               used for the space character in order to avoid having to quote
111 #               the option. For example, -opt%20arg gets expanded to -opt arg.
112 #               In fact, any ASCII character can be encoded as %xx using its
113 #               hexadecimal encoding.
114 # -static       while -static is also a pass-through compiler option (and
115 #               as such is limited to environments where it's actually
116 #               meaningful), it triggers a number configuration options,
117 #               namely no-pic, no-shared and no-threads. It is
118 #               argued that the only reason to produce statically linked
119 #               binaries (and in context it means executables linked with
120 #               -static flag, and not just executables linked with static
121 #               libcrypto.a) is to eliminate dependency on specific run-time,
122 #               a.k.a. libc version. The mentioned config options are meant
123 #               to achieve just that. Unfortunately on Linux it's impossible
124 #               to eliminate the dependency completely for openssl executable
125 #               because of getaddrinfo and gethostbyname calls, which can
126 #               invoke dynamically loadable library facility anyway to meet
127 #               the lookup requests. For this reason on Linux statically
128 #               linked openssl executable has rather debugging value than
129 #               production quality.
130 #
131 # BN_LLONG      use the type 'long long' in crypto/bn/bn.h
132 # RC4_CHAR      use 'char' instead of 'int' for RC4_INT in crypto/rc4/rc4.h
133 # Following are set automatically by this script
134 #
135 # MD5_ASM       use some extra md5 assembler,
136 # SHA1_ASM      use some extra sha1 assembler, must define L_ENDIAN for x86
137 # RMD160_ASM    use some extra ripemd160 assembler,
138 # SHA256_ASM    sha256_block is implemented in assembler
139 # SHA512_ASM    sha512_block is implemented in assembler
140 # AES_ASM       AES_[en|de]crypt is implemented in assembler
141
142 # Minimum warning options... any contributions to OpenSSL should at least
143 # get past these.  Note that we only use these with C compilers, not with
144 # C++ compilers.
145
146 # -DPEDANTIC complements -pedantic and is meant to mask code that
147 # is not strictly standard-compliant and/or implementation-specific,
148 # e.g. inline assembly, disregards to alignment requirements, such
149 # that -pedantic would complain about. Incidentally -DPEDANTIC has
150 # to be used even in sanitized builds, because sanitizer too is
151 # supposed to and does take notice of non-standard behaviour. Then
152 # -pedantic with pre-C9x compiler would also complain about 'long
153 # long' not being supported. As 64-bit algorithms are common now,
154 # it grew impossible to resolve this without sizeable additional
155 # code, so we just tell compiler to be pedantic about everything
156 # but 'long long' type.
157
158 my @gcc_devteam_warn = qw(
159     -DPEDANTIC -pedantic -Wno-long-long -DUNUSEDRESULT_DEBUG
160     -Wall
161     -Wmissing-declarations
162     -Wextra
163     -Wno-unused-parameter
164     -Wno-missing-field-initializers
165     -Wswitch
166     -Wsign-compare
167     -Wshadow
168     -Wformat
169     -Wno-type-limits
170     -Wno-tautological-constant-out-of-range-compare
171     -Wundef
172     -Werror
173     -Wmissing-prototypes
174     -Wstrict-prototypes
175 );
176
177 # These are used in addition to $gcc_devteam_warn when the compiler is clang.
178 # TODO(openssl-team): fix problems and investigate if (at least) the
179 # following warnings can also be enabled:
180 #       -Wcast-align
181 #       -Wunreachable-code -- no, too ugly/compiler-specific
182 #       -Wlanguage-extension-token -- no, we use asm()
183 #       -Wunused-macros -- no, too tricky for BN and _XOPEN_SOURCE etc
184 #       -Wextended-offsetof -- no, needed in CMS ASN1 code
185 my @clang_devteam_warn = qw(
186     -Wno-unknown-warning-option
187     -Wswitch-default
188     -Wno-parentheses-equality
189     -Wno-language-extension-token
190     -Wno-extended-offsetof
191     -Wno-missing-braces
192     -Wconditional-uninitialized
193     -Wincompatible-pointer-types-discards-qualifiers
194     -Wmissing-variable-declarations
195 );
196
197 my @cl_devteam_warn = qw(
198     /WX
199 );
200
201 my $strict_warnings = 0;
202
203 # As for $BSDthreads. Idea is to maintain "collective" set of flags,
204 # which would cover all BSD flavors. -pthread applies to them all,
205 # but is treated differently. OpenBSD expands is as -D_POSIX_THREAD
206 # -lc_r, which is sufficient. FreeBSD 4.x expands it as -lc_r,
207 # which has to be accompanied by explicit -D_THREAD_SAFE and
208 # sometimes -D_REENTRANT. FreeBSD 5.x expands it as -lc_r, which
209 # seems to be sufficient?
210 our $BSDthreads="-pthread -D_THREAD_SAFE -D_REENTRANT";
211
212 #
213 # API compatibility name to version number mapping.
214 #
215 my $apitable = {
216     # This table expresses when API additions or changes can occur.
217     # The numbering used changes from 3.0 and on because we updated
218     # (solidified) our version numbering scheme at that point.
219
220     # From 3.0 and on, we internalise the given version number in decimal
221     # as MAJOR * 10000 + MINOR * 100 + 0
222     "3.0.0" => 30000,
223     "3.0"   => 30000,
224
225     # Note that before 3.0, we didn't have the same version number scheme.
226     # Still, the numbering we use here covers what we need.
227     "1.1.1" => 10101,
228     "1.1.0" => 10100,
229     "1.0.2" => 10002,
230     "1.0.1" => 10001,
231     "1.0.0" => 10000,
232     "0.9.8" =>   908,
233 };
234
235 # For OpenSSL::config::get_platform
236 my %guess_opts = ();
237
238 my $dryrun = 0;
239
240 our %table = ();
241 our %config = ();
242 our %withargs = ();
243 our $now_printing;      # set to current entry's name in print_table_entry
244                         # (todo: right thing would be to encapsulate name
245                         # into %target [class] and make print_table_entry
246                         # a method)
247
248 # Forward declarations ###############################################
249
250 # read_config(filename)
251 #
252 # Reads a configuration file and populates %table with the contents
253 # (which the configuration file places in %targets).
254 sub read_config;
255
256 # resolve_config(target)
257 #
258 # Resolves all the late evaluations, inheritances and so on for the
259 # chosen target and any target it inherits from.
260 sub resolve_config;
261
262
263 # Information collection #############################################
264
265 # Unified build supports separate build dir
266 my $srcdir = catdir(absolutedir(dirname($0))); # catdir ensures local syntax
267 my $blddir = catdir(absolutedir("."));         # catdir ensures local syntax
268
269 # File::Spec::Unix doesn't detect case insensitivity, so we make sure to
270 # check if the source and build directory are really the same, and make
271 # them so.  This avoids all kinds of confusion later on.
272 # We must check @File::Spec::ISA rather than using File::Spec->isa() to
273 # know if File::Spec ended up loading File::Spec::Unix.
274 $srcdir = $blddir
275     if (grep(/::Unix$/, @File::Spec::ISA)
276         && samedir($srcdir, $blddir));
277
278 my $dofile = abs2rel(catfile($srcdir, "util/dofile.pl"));
279
280 my $local_config_envname = 'OPENSSL_LOCAL_CONFIG_DIR';
281
282 $config{sourcedir} = abs2rel($srcdir, $blddir);
283 $config{builddir} = abs2rel($blddir, $blddir);
284 # echo -n 'holy hand grenade of antioch' | openssl sha256
285 $config{FIPSKEY} =
286     'f4556650ac31d35461610bac4ed81b1a181b2d8a43ea2854cbae22ca74560813';
287
288 # Collect reconfiguration information if needed
289 my @argvcopy=@ARGV;
290
291 if (grep /^reconf(igure)?$/, @argvcopy) {
292     die "reconfiguring with other arguments present isn't supported"
293         if scalar @argvcopy > 1;
294     if (-f "./configdata.pm") {
295         my $file = "./configdata.pm";
296         unless (my $return = do $file) {
297             die "couldn't parse $file: $@" if $@;
298             die "couldn't do $file: $!"    unless defined $return;
299             die "couldn't run $file"       unless $return;
300         }
301
302         @argvcopy = defined($configdata::config{perlargv}) ?
303             @{$configdata::config{perlargv}} : ();
304         die "Incorrect data to reconfigure, please do a normal configuration\n"
305             if (grep(/^reconf/,@argvcopy));
306         $config{perlenv} = $configdata::config{perlenv} // {};
307     } else {
308         die "Insufficient data to reconfigure, please do a normal configuration\n";
309     }
310 }
311
312 $config{perlargv} = [ @argvcopy ];
313
314 # Historical: if known directories in crypto/ have been removed, it means
315 # that those sub-systems are disabled.
316 # (the other option would be to removed them from the SUBDIRS statement in
317 # crypto/build.info)
318 # We reverse the input list for cosmetic purely reasons, to compensate that
319 # 'unshift' adds at the front of the list (i.e. in reverse input order).
320 foreach ( reverse sort( 'aes', 'aria', 'bf', 'camellia', 'cast', 'des', 'dh',
321                         'dsa', 'ec', 'hmac', 'idea', 'md2', 'md5', 'mdc2',
322                         'rc2', 'rc4', 'rc5', 'ripemd', 'seed', 'sha',
323                         'sm2', 'sm3', 'sm4') ) {
324     unshift @argvcopy, "no-$_" if ! -d catdir($srcdir, 'crypto', $_);
325 }
326
327 # Collect version numbers
328 my %version = ();
329
330 collect_information(
331     collect_from_file(catfile($srcdir,'VERSION.dat')),
332     qr/\s*(\w+)\s*=\s*(.*?)\s*$/ =>
333         sub {
334             # Only define it if there is a value at all
335             if ($2 ne '') {
336                 my $k = $1;
337                 my $v = $2;
338                 # Some values are quoted.  Trim the quotes
339                 $v = $1 if $v =~ /^"(.*)"$/;
340                 $version{uc $k} = $v;
341             }
342         },
343     "OTHERWISE" =>
344         sub { die "Something wrong with this line:\n$_\nin $srcdir/VERSION.dat" },
345     );
346
347 $config{major} = $version{MAJOR} // 'unknown';
348 $config{minor} = $version{MINOR} // 'unknown';
349 $config{patch} = $version{PATCH} // 'unknown';
350 $config{prerelease} =
351     defined $version{PRE_RELEASE_TAG} ? "-$version{PRE_RELEASE_TAG}" : '';
352 $config{build_metadata} =
353     defined $version{BUILD_METADATA} ? "+$version{BUILD_METADATA}" : '';
354 $config{shlib_version} = $version{SHLIB_VERSION} // 'unknown';
355 $config{release_date} = $version{RELEASE_DATE} // 'xx XXX xxxx';
356
357 $config{version} = "$config{major}.$config{minor}.$config{patch}";
358 $config{full_version} = "$config{version}$config{prerelease}$config{build_metadata}";
359
360 die "erroneous version information in VERSION.dat: ",
361     "$config{version}, $config{shlib_version}\n"
362     unless (defined $version{MAJOR}
363             && defined $version{MINOR}
364             && defined $version{PATCH}
365             && defined $version{SHLIB_VERSION});
366
367 # Collect target configurations
368
369 my $pattern = catfile(dirname($0), "Configurations", "*.conf");
370 foreach (sort glob($pattern)) {
371     &read_config($_);
372 }
373
374 if (defined env($local_config_envname)) {
375     if ($^O eq 'VMS') {
376         # VMS environment variables are logical names,
377         # which can be used as is
378         $pattern = $local_config_envname . ':' . '*.conf';
379     } else {
380         $pattern = catfile(env($local_config_envname), '*.conf');
381     }
382
383     foreach (sort glob($pattern)) {
384         &read_config($_);
385     }
386 }
387
388 # Fail if no configuration is apparent
389 if (!%table) {
390     print "Failed to find any os/compiler configurations. Please make sure the Configurations directory is included.\n";
391     &usage;
392 }
393
394 # Save away perl command information
395 $config{perl_cmd} = $^X;
396 $config{perl_version} = $Config{version};
397 $config{perl_archname} = $Config{archname};
398
399 $config{prefix}="";
400 $config{openssldir}="";
401 $config{processor}="";
402 $config{libdir}="";
403 my $auto_threads=1;    # enable threads automatically? true by default
404 my $default_ranlib;
405
406 # Known TLS and DTLS protocols
407 my @tls = qw(ssl3 tls1 tls1_1 tls1_2 tls1_3);
408 my @dtls = qw(dtls1 dtls1_2);
409
410 # Explicitly known options that are possible to disable.  They can
411 # be regexps, and will be used like this: /^no-${option}$/
412 # For developers: keep it sorted alphabetically
413
414 my @disablables = (
415     "acvp-tests",
416     "afalgeng",
417     "apps",
418     "argon2",
419     "aria",
420     "asan",
421     "asm",
422     "async",
423     "atexit",
424     "autoalginit",
425     "autoerrinit",
426     "autoload-config",
427     "bf",
428     "blake2",
429     "brotli",
430     "brotli-dynamic",
431     "buildtest-c++",
432     "bulk",
433     "cached-fetch",
434     "camellia",
435     "capieng",
436     "winstore",
437     "cast",
438     "chacha",
439     "cmac",
440     "cmp",
441     "cms",
442     "comp",
443     "crypto-mdebug",
444     "ct",
445     "default-thread-pool",
446     "deprecated",
447     "des",
448     "devcryptoeng",
449     "dgram",
450     "dh",
451     "docs",
452     "dsa",
453     "dso",
454     "dtls",
455     "dynamic-engine",
456     "ec",
457     "ec2m",
458     "ec_nistp_64_gcc_128",
459     "ecdh",
460     "ecdsa",
461     "ecx",
462     "egd",
463     "engine",
464     "err",
465     "external-tests",
466     "filenames",
467     "fips",
468     "fips-securitychecks",
469     "fuzz-afl",
470     "fuzz-libfuzzer",
471     "gost",
472     "http",
473     "idea",
474     "ktls",
475     "legacy",
476     "loadereng",
477     "makedepend",
478     "md2",
479     "md4",
480     "mdc2",
481     "module",
482     "msan",
483     "multiblock",
484     "nextprotoneg",
485     "ocb",
486     "ocsp",
487     "padlockeng",
488     "pic",
489     "pinshared",
490     "poly1305",
491     "posix-io",
492     "psk",
493     "quic",
494     "unstable-qlog",
495     "rc2",
496     "rc4",
497     "rc5",
498     "rdrand",
499     "rfc3779",
500     "rmd160",
501     "scrypt",
502     "sctp",
503     "secure-memory",
504     "seed",
505     "shared",
506     "siphash",
507     "siv",
508     "sm2",
509     "sm2-precomp",
510     "sm3",
511     "sm4",
512     "sock",
513     "srp",
514     "srtp",
515     "sse2",
516     "ssl",
517     "ssl-trace",
518     "static-engine",
519     "stdio",
520     "tests",
521     "tfo",
522     "thread-pool",
523     "threads",
524     "tls",
525     "trace",
526     "ts",
527     "ubsan",
528     "ui-console",
529     "unit-test",
530     "uplink",
531     "weak-ssl-ciphers",
532     "whirlpool",
533     "zlib",
534     "zlib-dynamic",
535     "zstd",
536     "zstd-dynamic",
537     );
538 foreach my $proto ((@tls, @dtls))
539         {
540         push(@disablables, $proto);
541         push(@disablables, "$proto-method") unless $proto eq "tls1_3";
542         }
543
544 # Internal disablables, for aliasing purposes.  They serve no special
545 # purpose here, but allow scripts to get to know them through configdata.pm,
546 # where these are merged with @disablables.
547 # The actual aliasing mechanism is done via %disable_cascades
548 my @disablables_int = qw(
549     crmf
550     );
551
552 my %deprecated_disablables = (
553     "ssl2" => undef,
554     "buf-freelists" => undef,
555     "crypto-mdebug-backtrace" => undef,
556     "hw" => "hw",               # causes cascade, but no macro
557     "hw-padlock" => "padlockeng",
558     "ripemd" => "rmd160",
559     "ui" => "ui-console",
560     "heartbeats" => undef,
561     );
562
563 # All of the following are disabled by default:
564
565 our %disabled = ( # "what"         => "comment"
566                   "fips"                => "default",
567                   "asan"                => "default",
568                   "brotli"              => "default",
569                   "brotli-dynamic"      => "default",
570                   "buildtest-c++"       => "default",
571                   "crypto-mdebug"       => "default",
572                   "crypto-mdebug-backtrace" => "default",
573                   "devcryptoeng"        => "default",
574                   "ec_nistp_64_gcc_128" => "default",
575                   "egd"                 => "default",
576                   "external-tests"      => "default",
577                   "fuzz-afl"            => "default",
578                   "fuzz-libfuzzer"      => "default",
579                   "ktls"                => "default",
580                   "md2"                 => "default",
581                   "msan"                => "default",
582                   "unstable-qlog"       => "default",
583                   "rc5"                 => "default",
584                   "sctp"                => "default",
585                   "ssl3"                => "default",
586                   "ssl3-method"         => "default",
587                   "tfo"                 => "default",
588                   "trace"               => "default",
589                   "ubsan"               => "default",
590                   "unit-test"           => "default",
591                   "weak-ssl-ciphers"    => "default",
592                   "zlib"                => "default",
593                   "zlib-dynamic"        => "default",
594                   "zstd"                => "default",
595                   "zstd-dynamic"        => "default",
596                 );
597
598 # Note: => pair form used for aesthetics, not to truly make a hash table
599 my @disable_cascades = (
600     # "what"            => [ "cascade", ... ]
601     "bulk"              => [ "shared", "dso",
602                              "aria", "async", "atexit", "autoload-config",
603                              "blake2", "bf", "camellia", "cast", "chacha",
604                              "cmac", "cms", "cmp", "comp", "ct",
605                              "des", "dgram", "dh", "dsa",
606                              "ec", "engine",
607                              "filenames",
608                              "idea", "ktls",
609                              "md4", "multiblock", "nextprotoneg",
610                              "ocsp", "ocb", "poly1305", "psk",
611                              "rc2", "rc4", "rmd160",
612                              "seed", "siphash", "siv",
613                              "sm3", "sm4", "srp",
614                              "srtp", "ssl3-method", "ssl-trace",
615                              "tfo",
616                              "ts", "ui-console", "whirlpool",
617                              "fips-securitychecks" ],
618     sub { $config{processor} eq "386" }
619                         => [ "sse2" ],
620     "ssl"               => [ "ssl3" ],
621     "ssl3-method"       => [ "ssl3" ],
622     "zlib"              => [ "zlib-dynamic" ],
623     "brotli"            => [ "brotli-dynamic" ],
624     "zstd"              => [ "zstd-dynamic" ],
625     "des"               => [ "mdc2" ],
626     "ec"                => [ "ec2m", "ecdsa", "ecdh", "sm2", "gost", "ecx" ],
627     "dgram"             => [ "dtls", "quic", "sctp" ],
628     "sock"              => [ "dgram", "tfo" ],
629     "dtls"              => [ @dtls ],
630     sub { 0 == scalar grep { !$disabled{$_} } @dtls }
631                         => [ "dtls" ],
632
633     "tls"               => [ @tls ],
634     sub { 0 == scalar grep { !$disabled{$_} } @tls }
635                         => [ "tls" ],
636     "tls1_3"            => [ "quic" ],
637     "quic"              => [ "unstable-qlog" ],
638
639     "crypto-mdebug"     => [ "crypto-mdebug-backtrace" ],
640
641     "module"            => [ "dynamic-engine", "fips" ],
642
643     # Without shared libraries, dynamic engines aren't possible.
644     # This is due to them having to link with libcrypto and register features
645     # using the ENGINE functionality, and since that relies on global tables,
646     # those *have* to be exactly the same as the ones accessed from the app,
647     # which cannot be guaranteed if shared libraries aren't present.
648     # (note that even with shared libraries, both the app and dynamic engines
649     # must be linked with the same library)
650     "shared"            => [ "dynamic-engine", "uplink" ],
651     "dso"               => [ "dynamic-engine", "module" ],
652     # Other modules don't necessarily have to link with libcrypto, so shared
653     # libraries do not have to be a condition to produce those.
654
655     # Without position independent code, there can be no shared libraries
656     # or modules.
657     "pic"               => [ "shared", "module" ],
658
659     "engine"            => [ "dynamic-engine", grep(/eng$/, @disablables) ],
660     "dynamic-engine"    => [ "loadereng" ],
661     "hw"                => [ "padlockeng" ],
662
663     # no-autoalginit is only useful when building non-shared
664     "autoalginit"       => [ "shared", "apps", "fips" ],
665
666     "stdio"             => [ "apps", "capieng", "egd" ],
667     "apps"              => [ "tests" ],
668     "tests"             => [ "external-tests" ],
669     "comp"              => [ "zlib", "brotli", "zstd" ],
670     "sm3"               => [ "sm2" ],
671     sub { !$disabled{"unit-test"} } => [ "heartbeats" ],
672
673     sub { !$disabled{"msan"} } => [ "asm" ],
674
675     "cmac"              => [ "siv" ],
676     "legacy"            => [ "md2" ],
677
678     "cmp"               => [ "crmf" ],
679
680     "fips"              => [ "fips-securitychecks", "acvp-tests" ],
681
682     "threads"           => [ "thread-pool" ],
683     "thread-pool"       => [ "default-thread-pool" ],
684
685     "blake2"            => [ "argon2" ],
686
687     "deprecated-3.0"    => [ "engine", "srp" ],
688
689     "http"              => [ "ocsp" ]
690     );
691
692 # Avoid protocol support holes.  Also disable all versions below N, if version
693 # N is disabled while N+1 is enabled.
694 #
695 my @list = (reverse @tls);
696 while ((my $first, my $second) = (shift @list, shift @list)) {
697     last unless @list;
698     push @disable_cascades, ( sub { !$disabled{$first} && $disabled{$second} }
699                               => [ @list ] );
700     unshift @list, $second;
701 }
702 my @list = (reverse @dtls);
703 while ((my $first, my $second) = (shift @list, shift @list)) {
704     last unless @list;
705     push @disable_cascades, ( sub { !$disabled{$first} && $disabled{$second} }
706                               => [ @list ] );
707     unshift @list, $second;
708 }
709
710 # Explicit "no-..." options will be collected in %disabled along with the defaults.
711 # To remove something from %disabled, use "enable-foo".
712 # For symmetry, "disable-foo" is a synonym for "no-foo".
713
714 # For the "make variables" CPPINCLUDES and CPPDEFINES, we support lists with
715 # platform specific list separators.  Users from those platforms should
716 # recognise those separators from how you set up the PATH to find executables.
717 # The default is the Unix like separator, :, but as an exception, we also
718 # support the space as separator.
719 my $list_separator_re =
720     { VMS           => qr/(?<!\^),/,
721       MSWin32       => qr/(?<!\\);/ } -> {$^O} // qr/(?<!\\)[:\s]/;
722 # All the "make variables" we support
723 # Some get pre-populated for the sake of backward compatibility
724 # (we supported those before the change to "make variable" support.
725 my %user = (
726     AR          => env('AR'),
727     ARFLAGS     => [],
728     AS          => undef,
729     ASFLAGS     => [],
730     CC          => env('CC'),
731     CFLAGS      => [ env('CFLAGS') || () ],
732     CXX         => env('CXX'),
733     CXXFLAGS    => [ env('CXXFLAGS') || () ],
734     CPP         => undef,
735     CPPFLAGS    => [ env('CPPFLAGS') || () ],  # -D, -I, -Wp,
736     CPPDEFINES  => [],  # Alternative for -D
737     CPPINCLUDES => [],  # Alternative for -I
738     CROSS_COMPILE => env('CROSS_COMPILE'),
739     HASHBANGPERL=> env('HASHBANGPERL') || env('PERL'),
740     LD          => undef,
741     LDFLAGS     => [ env('LDFLAGS') || () ],  # -L, -Wl,
742     LDLIBS      => [ env('LDLIBS') || () ],  # -l
743     MT          => undef,
744     MTFLAGS     => [],
745     PERL        => env('PERL') || ($^O ne "VMS" ? $^X : "perl"),
746     RANLIB      => env('RANLIB'),
747     RC          => env('RC') || env('WINDRES'),
748     RCFLAGS     => [ env('RCFLAGS') || () ],
749     RM          => undef,
750    );
751 # Info about what "make variables" may be prefixed with the cross compiler
752 # prefix.  This should NEVER mention any such variable with a list for value.
753 my @user_crossable = qw ( AR AS CC CXX CPP LD MT RANLIB RC );
754 # The same but for flags given as Configure options.  These are *additional*
755 # input, as opposed to the VAR=string option that override the corresponding
756 # config target attributes
757 my %useradd = (
758     ASFLAGS     => [],
759     CPPDEFINES  => [],
760     CPPINCLUDES => [],
761     CPPFLAGS    => [],
762     CFLAGS      => [],
763     CXXFLAGS    => [],
764     LDFLAGS     => [],
765     LDLIBS      => [],
766     RCFLAGS     => [],
767    );
768
769 my %user_synonyms = (
770     HASHBANGPERL=> 'PERL',
771     RC          => 'WINDRES',
772    );
773
774 # Some target attributes have been renamed, this is the translation table
775 my %target_attr_translate =(
776     ar          => 'AR',
777     as          => 'AS',
778     cc          => 'CC',
779     cxx         => 'CXX',
780     cpp         => 'CPP',
781     hashbangperl => 'HASHBANGPERL',
782     ld          => 'LD',
783     mt          => 'MT',
784     ranlib      => 'RANLIB',
785     rc          => 'RC',
786     rm          => 'RM',
787    );
788
789 # Initialisers coming from 'config' scripts
790 $config{defines} = [ split(/$list_separator_re/, env('__CNF_CPPDEFINES')) ];
791 $config{includes} = [ split(/$list_separator_re/, env('__CNF_CPPINCLUDES')) ];
792 $config{cppflags} = [ env('__CNF_CPPFLAGS') || () ];
793 $config{cflags} = [ env('__CNF_CFLAGS') || () ];
794 $config{cxxflags} = [ env('__CNF_CXXFLAGS') || () ];
795 $config{lflags} = [ env('__CNF_LDFLAGS') || () ];
796 $config{ex_libs} = [ env('__CNF_LDLIBS') || () ];
797
798 $config{openssl_api_defines}=[];
799 $config{openssl_sys_defines}=[];
800 $config{openssl_feature_defines}=[];
801 $config{options}="";
802 $config{build_type} = "release";
803 my $target="";
804
805 my %cmdvars = ();               # Stores FOO='blah' type arguments
806 my %unsupported_options = ();
807 my %deprecated_options = ();
808 # If you change this, update apps/version.c
809 my @known_seed_sources = qw(getrandom devrandom os egd none rdcpu librandom);
810 my @seed_sources = ();
811 while (@argvcopy)
812         {
813         $_ = shift @argvcopy;
814
815         # Support env variable assignments among the options
816         if (m|^(\w+)=(.+)?$|)
817                 {
818                 $cmdvars{$1} = $2;
819                 # Every time a variable is given as a configuration argument,
820                 # it acts as a reset if the variable.
821                 if (exists $user{$1})
822                         {
823                         $user{$1} = ref $user{$1} eq "ARRAY" ? [] : undef;
824                         }
825                 #if (exists $useradd{$1})
826                 #       {
827                 #       $useradd{$1} = [];
828                 #       }
829                 next;
830                 }
831
832         # VMS is a case insensitive environment, and depending on settings
833         # out of our control, we may receive options uppercased.  Let's
834         # downcase at least the part before any equal sign.
835         if ($^O eq "VMS")
836                 {
837                 s/^([^=]*)/lc($1)/e;
838                 }
839
840         # some people just can't read the instructions, clang people have to...
841         s/^-no-(?!integrated-as)/no-/;
842
843         # rewrite some options in "enable-..." form
844         s /^-?-?shared$/enable-shared/;
845         s /^sctp$/enable-sctp/;
846         s /^threads$/enable-threads/;
847         s /^zlib$/enable-zlib/;
848         s /^zlib-dynamic$/enable-zlib-dynamic/;
849         s /^fips$/enable-fips/;
850
851         if (/^(no|disable|enable)-(.+)$/)
852                 {
853                 my $word = $2;
854                 if ($word !~ m|hw(?:-.+)| # special treatment for hw regexp opt
855                         && !exists $deprecated_disablables{$word}
856                         && !grep { $word eq $_ } @disablables)
857                         {
858                         $unsupported_options{$_} = 1;
859                         next;
860                         }
861                 }
862         if (/^no-(.+)$/ || /^disable-(.+)$/)
863                 {
864                 foreach my $proto ((@tls, @dtls))
865                         {
866                         if ($1 eq "$proto-method")
867                                 {
868                                 $disabled{"$proto"} = "option($proto-method)";
869                                 last;
870                                 }
871                         }
872                 if ($1 eq "dtls")
873                         {
874                         foreach my $proto (@dtls)
875                                 {
876                                 $disabled{$proto} = "option(dtls)";
877                                 }
878                         $disabled{"dtls"} = "option(dtls)";
879                         }
880                 elsif ($1 eq "ssl")
881                         {
882                         # Last one of its kind
883                         $disabled{"ssl3"} = "option(ssl)";
884                         }
885                 elsif ($1 eq "tls")
886                         {
887                         # XXX: Tests will fail if all SSL/TLS
888                         # protocols are disabled.
889                         foreach my $proto (@tls)
890                                 {
891                                 $disabled{$proto} = "option(tls)";
892                                 }
893                         }
894                 elsif ($1 eq "static-engine")
895                         {
896                         delete $disabled{"dynamic-engine"};
897                         }
898                 elsif ($1 eq "dynamic-engine")
899                         {
900                         $disabled{"dynamic-engine"} = "option";
901                         }
902                 elsif (exists $deprecated_disablables{$1})
903                         {
904                         $deprecated_options{$_} = 1;
905                         if (defined $deprecated_disablables{$1})
906                                 {
907                                 $disabled{$deprecated_disablables{$1}} = "option";
908                                 }
909                         }
910                 elsif ($1 =~ m|hw(?:-.+)|) # deprecate hw options in regexp form
911                         {
912                         $deprecated_options{$_} = 1;
913                         }
914                 else
915                         {
916                         $disabled{$1} = "option";
917                         }
918                 # No longer an automatic choice
919                 $auto_threads = 0 if ($1 eq "threads");
920                 }
921         elsif (/^enable-(.+)$/)
922                 {
923                 if ($1 eq "static-engine")
924                         {
925                         $disabled{"dynamic-engine"} = "option";
926                         }
927                 elsif ($1 eq "dynamic-engine")
928                         {
929                         delete $disabled{"dynamic-engine"};
930                         }
931                 elsif ($1 eq "zlib-dynamic")
932                         {
933                         delete $disabled{"zlib"};
934                         }
935                 elsif ($1 eq "brotli-dynamic")
936                         {
937                         delete $disabled{"brotli"};
938                         }
939                 elsif ($1 eq "zstd-dynamic")
940                         {
941                         delete $disabled{"zstd"};
942                         }
943                 my $algo = $1;
944                 delete $disabled{$algo};
945
946                 # No longer an automatic choice
947                 $auto_threads = 0 if ($1 eq "threads");
948                 }
949         elsif (/^-d$/)          # From older 'config'
950                 {
951                 $config{build_type} = "debug";
952                 }
953         elsif (/^-v$/)          # From older 'config'
954                 {
955                 $guess_opts{verbose} = 1;
956                 }
957         elsif (/^-w$/)
958                 {
959                 $guess_opts{nowait} = 1;
960                 }
961         elsif (/^-t$/)          # From older 'config'
962                 {
963                 $dryrun = 1;
964                 }
965         elsif (/^--strict-warnings$/)
966                 {
967                 # Pretend that our strict flags is a C flag, and replace it
968                 # with the proper flags later on
969                 push @{$useradd{CFLAGS}}, '--ossl-strict-warnings';
970                 $strict_warnings=1;
971                 }
972         elsif (/^--debug$/)
973                 {
974                 $config{build_type} = "debug";
975                 }
976         elsif (/^--release$/)
977                 {
978                 $config{build_type} = "release";
979                 }
980         elsif (/^386$/)
981                 { $config{processor}=386; }
982         elsif (/^rsaref$/)
983                 {
984                 # No RSAref support any more since it's not needed.
985                 # The check for the option is there so scripts aren't
986                 # broken
987                 }
988         elsif (m|^[-+/]|)
989                 {
990                 if (/^--prefix=(.*)$/)
991                         {
992                         $config{prefix}=$1;
993                         }
994                 elsif (/^--api=(.*)$/)
995                         {
996                         my $api = $1;
997                         die "Unknown API compatibility level $api"
998                                 unless defined $apitable->{$api};
999                         $config{api}=$apitable->{$api};
1000                         }
1001                 elsif (/^--libdir=(.*)$/)
1002                         {
1003                         $config{libdir}=$1;
1004                         }
1005                 elsif (/^--openssldir=(.*)$/)
1006                         {
1007                         $config{openssldir}=$1;
1008                         }
1009                 elsif (/^--with-zlib-lib=(.*)$/)
1010                         {
1011                         $withargs{zlib_lib}=$1;
1012                         }
1013                 elsif (/^--with-zlib-include=(.*)$/)
1014                         {
1015                         $withargs{zlib_include}=$1;
1016                         }
1017                 elsif (/^--with-brotli-lib=(.*)$/)
1018                         {
1019                         $withargs{brotli_lib}=$1;
1020                         }
1021                 elsif (/^--with-brotli-include=(.*)$/)
1022                         {
1023                         $withargs{brotli_include}=$1;
1024                         }
1025                 elsif (/^--with-zstd-lib=(.*)$/)
1026                         {
1027                         $withargs{zstd_lib}=$1;
1028                         }
1029                 elsif (/^--with-zstd-include=(.*)$/)
1030                         {
1031                         $withargs{zstd_include}=$1;
1032                         }
1033                 elsif (/^--with-fuzzer-lib=(.*)$/)
1034                         {
1035                         $withargs{fuzzer_lib}=$1;
1036                         }
1037                 elsif (/^--with-fuzzer-include=(.*)$/)
1038                         {
1039                         $withargs{fuzzer_include}=$1;
1040                         }
1041                 elsif (/^--with-rand-seed=(.*)$/)
1042                         {
1043                         foreach my $x (split(m|,|, $1))
1044                             {
1045                             die "Unknown --with-rand-seed choice $x\n"
1046                                 if ! grep { $x eq $_ } @known_seed_sources;
1047                             push @seed_sources, $x;
1048                             }
1049                         }
1050                 elsif (/^--fips-key=(.*)$/)
1051                         {
1052                         $user{FIPSKEY}=lc($1);
1053                         die "Non-hex character in FIPS key\n"
1054                            if $user{FIPSKEY} =~ /[^a-f0-9]/;
1055                         die "FIPS key must have even number of characters\n"
1056                            if length $1 & 1;
1057                         die "FIPS key too long (64 bytes max)\n"
1058                            if length $1 > 64;
1059                         }
1060                 elsif (/^--banner=(.*)$/)
1061                         {
1062                         $banner = $1 . "\n";
1063                         }
1064                 elsif (/^--cross-compile-prefix=(.*)$/)
1065                         {
1066                         $user{CROSS_COMPILE}=$1;
1067                         }
1068                 elsif (/^--config=(.*)$/)
1069                         {
1070                         read_config $1;
1071                         }
1072                 elsif (/^-l(.*)$/)
1073                         {
1074                         push @{$useradd{LDLIBS}}, $_;
1075                         }
1076                 elsif (/^-framework$/)
1077                         {
1078                         push @{$useradd{LDLIBS}}, $_, shift(@argvcopy);
1079                         }
1080                 elsif (/^-L(.*)$/ or /^-Wl,/)
1081                         {
1082                         push @{$useradd{LDFLAGS}}, $_;
1083                         }
1084                 elsif (/^-rpath$/ or /^-R$/)
1085                         # -rpath is the OSF1 rpath flag
1086                         # -R is the old Solaris rpath flag
1087                         {
1088                         my $rpath = shift(@argvcopy) || "";
1089                         $rpath .= " " if $rpath ne "";
1090                         push @{$useradd{LDFLAGS}}, $_, $rpath;
1091                         }
1092                 elsif (/^-static$/)
1093                         {
1094                         push @{$useradd{LDFLAGS}}, $_;
1095                         }
1096                 elsif (m|^[-/]D(.*)$|)
1097                         {
1098                         push @{$useradd{CPPDEFINES}}, $1;
1099                         }
1100                 elsif (m|^[-/]I(.*)$|)
1101                         {
1102                         push @{$useradd{CPPINCLUDES}}, $1;
1103                         }
1104                 elsif (/^-Wp,$/)
1105                         {
1106                         push @{$useradd{CPPFLAGS}}, $1;
1107                         }
1108                 else    # common if (/^[-+]/), just pass down...
1109                         {
1110                         # Treat %xx as an ASCII code (e.g. replace %20 by a space character).
1111                         # This provides a simple way to pass options with arguments separated
1112                         # by spaces without quoting (e.g. -opt%20arg translates to -opt arg).
1113                         $_ =~ s/%([0-9a-f]{1,2})/chr(hex($1))/gei;
1114                         push @{$useradd{CFLAGS}}, $_;
1115                         push @{$useradd{CXXFLAGS}}, $_;
1116                         }
1117                 }
1118         elsif (m|^/|)
1119                 {
1120                 # Treat %xx as an ASCII code (e.g. replace %20 by a space character).
1121                 # This provides a simple way to pass options with arguments separated
1122                 # by spaces without quoting (e.g. /opt%20arg translates to /opt arg).
1123                 $_ =~ s/%([0-9a-f]{1,2})/chr(hex($1))/gei;
1124                 push @{$useradd{CFLAGS}}, $_;
1125                 push @{$useradd{CXXFLAGS}}, $_;
1126                 }
1127         else
1128                 {
1129                 die "target already defined - $target (offending arg: $_)\n" if ($target ne "");
1130                 $target=$_;
1131                 }
1132         unless ($_ eq $target || /^no-/ || /^disable-/)
1133                 {
1134                 # "no-..." follows later after implied deactivations
1135                 # have been derived.  (Don't take this too seriously,
1136                 # we really only write OPTIONS to the Makefile out of
1137                 # nostalgia.)
1138
1139                 if ($config{options} eq "")
1140                         { $config{options} = $_; }
1141                 else
1142                         { $config{options} .= " ".$_; }
1143                 }
1144         }
1145
1146 if (keys %deprecated_options)
1147         {
1148         warn "***** Deprecated options: ",
1149                 join(", ", keys %deprecated_options), "\n";
1150         }
1151 if (keys %unsupported_options)
1152         {
1153         die "***** Unsupported options: ",
1154                 join(", ", keys %unsupported_options), "\n";
1155         }
1156
1157 # If any %useradd entry has been set, we must check that the "make
1158 # variables" haven't been set.  We start by checking of any %useradd entry
1159 # is set.
1160 if (grep { scalar @$_ > 0 } values %useradd) {
1161     # Hash of env / make variables names.  The possible values are:
1162     # 1 - "make vars"
1163     # 2 - %useradd entry set
1164     # 3 - both set
1165     my %detected_vars =
1166         map { my $v = 0;
1167               $v += 1 if $cmdvars{$_};
1168               $v += 2 if @{$useradd{$_}};
1169               $_ => $v }
1170         keys %useradd;
1171
1172     # If any of the corresponding "make variables" is set, we error
1173     if (grep { $_ & 1 } values %detected_vars) {
1174         my $names = join(', ', grep { $detected_vars{$_} > 0 }
1175                                sort keys %detected_vars);
1176         die <<"_____";
1177 ***** Mixing make variables and additional compiler/linker flags as
1178 ***** configure command line option is not permitted.
1179 ***** Affected make variables: $names
1180 _____
1181     }
1182 }
1183
1184 # Check through all supported command line variables to see if any of them
1185 # were set, and canonicalise the values we got.  If no compiler or linker
1186 # flag or anything else that affects %useradd was set, we also check the
1187 # environment for values.
1188 my $anyuseradd =
1189     grep { defined $_ && (ref $_ ne 'ARRAY' || @$_) } values %useradd;
1190 foreach (keys %user) {
1191     my $value = $cmdvars{$_};
1192     $value //= env($_) unless $anyuseradd;
1193     $value //=
1194         defined $user_synonyms{$_} ? $cmdvars{$user_synonyms{$_}} : undef;
1195     $value //= defined $user_synonyms{$_} ? env($user_synonyms{$_}) : undef
1196         unless $anyuseradd;
1197
1198     if (defined $value) {
1199         if (ref $user{$_} eq 'ARRAY') {
1200             if ($_ eq 'CPPDEFINES' || $_ eq 'CPPINCLUDES') {
1201                 $user{$_} = [ split /$list_separator_re/, $value ];
1202             } else {
1203                 $user{$_} = [ $value ];
1204             }
1205         } elsif (!defined $user{$_}) {
1206             $user{$_} = $value;
1207         }
1208     }
1209 }
1210
1211 if (grep { /-rpath\b/ } ($user{LDFLAGS} ? @{$user{LDFLAGS}} : ())
1212     && !$disabled{shared}
1213     && !($disabled{asan} && $disabled{msan} && $disabled{ubsan})) {
1214     die "***** Cannot simultaneously use -rpath, shared libraries, and\n",
1215         "***** any of asan, msan or ubsan\n";
1216 }
1217
1218 # If no target was given, try guessing.
1219 unless ($target) {
1220     my %system_config = OpenSSL::config::get_platform(%guess_opts, %user);
1221
1222     # The $system_config{disable} is used to populate %disabled with
1223     # entries that aren't already there.
1224     foreach ( @{$system_config{disable} // []} ) {
1225         $disabled{$_} = 'system' unless defined $disabled{$_};
1226     }
1227     delete $system_config{disable};
1228
1229     # Override config entries with stuff from the guesser.
1230     # It's assumed that this really is nothing new.
1231     %config = ( %config, %system_config );
1232     $target = $system_config{target};
1233 }
1234
1235 sub disable {
1236     my $disable_type = shift;
1237
1238     for (@_) {
1239         $disabled{$_} = $disable_type;
1240     }
1241
1242     my @tocheckfor = (@_ ? @_ : keys %disabled);
1243     while (@tocheckfor) {
1244         my %new_tocheckfor = ();
1245         my @cascade_copy = (@disable_cascades);
1246         while (@cascade_copy) {
1247             my ($test, $descendents) =
1248                 (shift @cascade_copy, shift @cascade_copy);
1249             if (ref($test) eq "CODE" ? $test->() : defined($disabled{$test})) {
1250                 foreach (grep { !defined($disabled{$_}) } @$descendents) {
1251                     $new_tocheckfor{$_} = 1; $disabled{$_} = "cascade";
1252                 }
1253             }
1254         }
1255         @tocheckfor = (keys %new_tocheckfor);
1256     }
1257 }
1258 disable();                     # First cascade run
1259
1260 our $die = sub { die @_; };
1261 if ($target eq "TABLE") {
1262     local $die = sub { warn @_; };
1263     foreach (sort keys %table) {
1264         print_table_entry($_, "TABLE");
1265     }
1266     exit 0;
1267 }
1268
1269 if ($target eq "LIST") {
1270     foreach (sort keys %table) {
1271         print $_,"\n" unless $table{$_}->{template};
1272     }
1273     exit 0;
1274 }
1275
1276 if ($target eq "HASH") {
1277     local $die = sub { warn @_; };
1278     print "%table = (\n";
1279     foreach (sort keys %table) {
1280         print_table_entry($_, "HASH");
1281     }
1282     exit 0;
1283 }
1284
1285 print "Configuring OpenSSL version $config{full_version} ";
1286 print "for target $target\n";
1287
1288 if (scalar(@seed_sources) == 0) {
1289     print "Using os-specific seed configuration\n";
1290     push @seed_sources, 'os';
1291 }
1292 if (scalar(grep { $_ eq 'egd' } @seed_sources) > 0) {
1293     delete $disabled{'egd'};
1294 }
1295 if (scalar(grep { $_ eq 'none' } @seed_sources) > 0) {
1296     die "Cannot seed with none and anything else" if scalar(@seed_sources) > 1;
1297     warn <<_____ if scalar(@seed_sources) == 1;
1298
1299 ============================== WARNING ===============================
1300 You have selected the --with-rand-seed=none option, which effectively
1301 disables automatic reseeding of the OpenSSL random generator.
1302 All operations depending on the random generator such as creating keys
1303 will not work unless the random generator is seeded manually by the
1304 application.
1305
1306 Please read the 'Note on random number generation' section in the
1307 INSTALL.md instructions and the RAND_DRBG(7) manual page for more
1308 details.
1309 ============================== WARNING ===============================
1310
1311 _____
1312 }
1313 push @{$config{openssl_feature_defines}},
1314      map { (my $x = $_) =~ tr|[\-a-z]|[_A-Z]|; "OPENSSL_RAND_SEED_$x" }
1315         @seed_sources;
1316
1317 # Backward compatibility?
1318 if ($target =~ m/^CygWin32(-.*)$/) {
1319     $target = "Cygwin".$1;
1320 }
1321
1322 # Support for legacy targets having a name starting with 'debug-'
1323 my ($d, $t) = $target =~ m/^(debug-)?(.*)$/;
1324 if ($d) {
1325     $config{build_type} = "debug";
1326
1327     # If we do not find debug-foo in the table, the target is set to foo.
1328     if (!$table{$target}) {
1329         $target = $t;
1330     }
1331 }
1332
1333 if ($target) {
1334     # It's possible that we have different config targets for specific
1335     # toolchains, so we try to detect them, and go for the plain config
1336     # target if not.
1337     my $found;
1338     foreach ( ( "$target-$user{CC}", "$target", undef ) ) {
1339         $found=$_ if $table{$_} && !$table{$_}->{template};
1340         last if $found;
1341     }
1342     $target = $found;
1343 } else {
1344     # If we don't have a config target now, we try the C compiler as we
1345     # fallback
1346     my $cc = $user{CC} // 'cc';
1347     $target = $cc if $table{$cc} && !$table{$cc}->{template};
1348 }
1349
1350 &usage unless $target;
1351
1352 exit 0 if $dryrun;              # From older 'config'
1353
1354 $config{target} = $target;
1355 my %target = resolve_config($target);
1356
1357 foreach (keys %target_attr_translate) {
1358     $target{$target_attr_translate{$_}} = $target{$_}
1359         if $target{$_};
1360     delete $target{$_};
1361 }
1362
1363 %target = ( %{$table{DEFAULTS}}, %target );
1364
1365 my %conf_files = map { $_ => 1 } (@{$target{_conf_fname_int}});
1366 $config{conf_files} = [ sort keys %conf_files ];
1367
1368 # Using sub disable within these loops may prove fragile, so we run
1369 # a cascade afterwards
1370 foreach my $feature (@{$target{disable}}) {
1371     if (exists $deprecated_disablables{$feature}) {
1372         warn "***** config $target disables deprecated feature $feature\n";
1373     } elsif (!grep { $feature eq $_ } @disablables) {
1374         die "***** config $target disables unknown feature $feature\n";
1375     }
1376     $disabled{$feature} = 'config';
1377 }
1378 foreach my $feature (@{$target{enable}}) {
1379     if ("default" eq ($disabled{$feature} // "")) {
1380         if (exists $deprecated_disablables{$feature}) {
1381             warn "***** config $target enables deprecated feature $feature\n";
1382         } elsif (!grep { $feature eq $_ } @disablables) {
1383             die "***** config $target enables unknown feature $feature\n";
1384         }
1385         delete $disabled{$feature};
1386     }
1387 }
1388
1389 # If uplink_arch isn't defined, disable uplink
1390 $disabled{uplink} = 'no uplink_arch' unless (defined $target{uplink_arch});
1391 # If asm_arch isn't defined, disable asm
1392 $disabled{asm} = 'no asm_arch' unless (defined $target{asm_arch});
1393
1394 disable();                      # Run a cascade now
1395
1396 $target{CXXFLAGS}//=$target{CFLAGS} if $target{CXX};
1397 $target{cxxflags}//=$target{cflags} if $target{CXX};
1398 $target{exe_extension}=".exe" if ($config{target} eq "DJGPP");
1399 $target{exe_extension}=".pm"  if ($config{target} =~ /vos/);
1400
1401 # Fill %config with values from %user, and in case those are undefined or
1402 # empty, use values from %target (acting as a default).
1403 foreach (keys %user) {
1404     my $ref_type = ref $user{$_};
1405
1406     # Temporary function.  Takes an intended ref type (empty string or "ARRAY")
1407     # and a value that's to be coerced into that type.
1408     my $mkvalue = sub {
1409         my $type = shift;
1410         my $value = shift;
1411         my $undef_p = shift;
1412
1413         die "Too many arguments for \$mkvalue" if @_;
1414
1415         while (ref $value eq 'CODE') {
1416             $value = $value->();
1417         }
1418
1419         if ($type eq 'ARRAY') {
1420             return undef unless defined $value;
1421             return undef if ref $value ne 'ARRAY' && !$value;
1422             return undef if ref $value eq 'ARRAY' && !@$value;
1423             return [ $value ] unless ref $value eq 'ARRAY';
1424         }
1425         return undef unless $value;
1426         return $value;
1427     };
1428
1429     $config{$_} =
1430         $mkvalue->($ref_type, $user{$_})
1431         || $mkvalue->($ref_type, $target{$_});
1432     delete $config{$_} unless defined $config{$_};
1433 }
1434
1435 # Finish up %config by appending things the user gave us on the command line
1436 # apart from "make variables"
1437 foreach (keys %useradd) {
1438     # The must all be lists, so we assert that here
1439     die "internal error: \$useradd{$_} isn't an ARRAY\n"
1440         unless ref $useradd{$_} eq 'ARRAY';
1441
1442     if (defined $config{$_}) {
1443         push @{$config{$_}}, @{$useradd{$_}};
1444     } else {
1445         $config{$_} = [ @{$useradd{$_}} ];
1446     }
1447 }
1448 # At this point, we can forget everything about %user and %useradd,
1449 # because it's now all been merged into the corresponding $config entry
1450
1451 if ($config{prefix} && !$config{CROSS_COMPILE}) {
1452     die "Directory given with --prefix MUST be absolute\n"
1453         unless file_name_is_absolute($config{prefix});
1454 }
1455
1456 if (grep { $_ =~ /(?:^|\s)-static(?:\s|$)/ } @{$config{LDFLAGS}}) {
1457     disable('static', 'pic', 'threads');
1458 }
1459
1460 # Allow overriding the build file name
1461 $config{build_file} = env('BUILDFILE') || $target{build_file} || "Makefile";
1462
1463 # Make sure build_scheme is consistent.
1464 $target{build_scheme} = [ $target{build_scheme} ]
1465     if ref($target{build_scheme}) ne "ARRAY";
1466
1467 my ($builder, $builder_platform, @builder_opts) =
1468     @{$target{build_scheme}};
1469
1470 foreach my $checker (($builder_platform."-".$config{build_file}."-checker.pm",
1471                       $builder_platform."-checker.pm")) {
1472     my $checker_path = catfile($srcdir, "Configurations", $checker);
1473     if (-f $checker_path) {
1474         my $fn = $ENV{CONFIGURE_CHECKER_WARN}
1475             ? sub { warn $@; } : sub { die $@; };
1476         if (! do $checker_path) {
1477             if ($@) {
1478                 $fn->($@);
1479             } elsif ($!) {
1480                 $fn->($!);
1481             } else {
1482                 $fn->("The detected tools didn't match the platform\n");
1483             }
1484         }
1485         last;
1486     }
1487 }
1488
1489 push @{$config{defines}}, "NDEBUG"    if $config{build_type} eq "release";
1490
1491 if ($target =~ /^mingw/ && `$config{CC} --target-help 2>&1` =~ m/-mno-cygwin/m)
1492         {
1493         push @{$config{cflags}}, "-mno-cygwin";
1494         push @{$config{cxxflags}}, "-mno-cygwin" if $config{CXX};
1495         push @{$config{shared_ldflag}}, "-mno-cygwin";
1496         }
1497
1498 if ($target =~ /linux.*-mips/ && !$disabled{asm}
1499         && !grep { $_ =~ /-m(ips|arch=)/ } (@{$config{CFLAGS}})) {
1500         # minimally required architecture flags for assembly modules
1501         my $value;
1502         $value = '-mips2' if ($target =~ /mips32/);
1503         $value = '-mips3' if ($target =~ /mips64/);
1504         unshift @{$config{cflags}}, $value;
1505         unshift @{$config{cxxflags}}, $value if $config{CXX};
1506 }
1507
1508 # If threads aren't disabled, check how possible they are
1509 unless ($disabled{threads}) {
1510     if ($auto_threads) {
1511         # Enabled by default, disable it forcibly if unavailable
1512         if ($target{thread_scheme} eq "(unknown)") {
1513             disable("unavailable", 'threads');
1514         }
1515     } else {
1516         # The user chose to enable threads explicitly, let's see
1517         # if there's a chance that's possible
1518         if ($target{thread_scheme} eq "(unknown)") {
1519             # If the user asked for "threads" and we don't have internal
1520             # knowledge how to do it, [s]he is expected to provide any
1521             # system-dependent compiler options that are necessary.  We
1522             # can't truly check that the given options are correct, but
1523             # we expect the user to know what [s]He is doing.
1524             if (!@{$config{CFLAGS}} && !@{$config{CPPDEFINES}}) {
1525                 die "You asked for multi-threading support, but didn't\n"
1526                     ,"provide any system-specific compiler options\n";
1527             }
1528         }
1529     }
1530 }
1531
1532 # Find out if clang's sanitizers have been enabled with -fsanitize
1533 # flags and ensure that the corresponding %disabled elements area
1534 # removed to reflect that the sanitizers are indeed enabled.
1535 my %detected_sanitizers = ();
1536 foreach (grep /^-fsanitize=/, @{$config{CFLAGS} || []}) {
1537     (my $checks = $_) =~ s/^-fsanitize=//;
1538     foreach (split /,/, $checks) {
1539         my $d = { address       => 'asan',
1540                   undefined     => 'ubsan',
1541                   memory        => 'msan' } -> {$_};
1542         next unless defined $d;
1543
1544         $detected_sanitizers{$d} = 1;
1545         if (defined $disabled{$d}) {
1546             die "***** Conflict between disabling $d and enabling $_ sanitizer"
1547                 if $disabled{$d} ne "default";
1548             delete $disabled{$d};
1549         }
1550     }
1551 }
1552
1553 # If threads still aren't disabled, add a C macro to ensure the source
1554 # code knows about it.  Any other flag is taken care of by the configs.
1555 unless($disabled{threads}) {
1556     push @{$config{openssl_feature_defines}}, "OPENSSL_THREADS";
1557 }
1558
1559 if ($disabled{"unstable-qlog"}) {
1560     $disabled{"qlog"} = 1;
1561 }
1562
1563 my $no_shared_warn=0;
1564 if (($target{shared_target} // '') eq "")
1565         {
1566         $no_shared_warn = 1
1567             if (!$disabled{shared} || !$disabled{"dynamic-engine"});
1568         disable('no-shared-target', 'pic');
1569         }
1570
1571 if ($disabled{"dynamic-engine"}) {
1572         $config{dynamic_engines} = 0;
1573 } else {
1574         $config{dynamic_engines} = 1;
1575 }
1576
1577 unless ($disabled{asan} || defined $detected_sanitizers{asan}) {
1578     push @{$config{cflags}}, "-fsanitize=address";
1579 }
1580
1581 unless ($disabled{ubsan} || defined $detected_sanitizers{ubsan}) {
1582     push @{$config{cflags}}, "-fsanitize=undefined", "-fno-sanitize-recover=all", "-DPEDANTIC";
1583 }
1584
1585 unless ($disabled{msan} || defined $detected_sanitizers{msan}) {
1586   push @{$config{cflags}}, "-fsanitize=memory";
1587 }
1588
1589 unless ($disabled{"fuzz-libfuzzer"} && $disabled{"fuzz-afl"}
1590         && $disabled{asan} && $disabled{ubsan} && $disabled{msan}) {
1591     push @{$config{cflags}}, "-fno-omit-frame-pointer", "-g";
1592     push @{$config{cxxflags}}, "-fno-omit-frame-pointer", "-g" if $config{CXX};
1593 }
1594 #
1595 # Platform fix-ups
1596 #
1597
1598 # This saves the build files from having to check
1599 if ($disabled{pic})
1600         {
1601         foreach (qw(shared_cflag shared_cxxflag shared_cppflag
1602                     shared_defines shared_includes shared_ldflag
1603                     module_cflags module_cxxflags module_cppflags
1604                     module_defines module_includes module_lflags))
1605                 {
1606                 delete $config{$_};
1607                 $target{$_} = "";
1608                 }
1609         }
1610 else
1611         {
1612         push @{$config{lib_defines}}, "OPENSSL_PIC";
1613         }
1614
1615 if ($target{sys_id} ne "")
1616         {
1617         push @{$config{openssl_sys_defines}}, "OPENSSL_SYS_$target{sys_id}";
1618         }
1619
1620 my %predefined_C = compiler_predefined($config{CROSS_COMPILE}.$config{CC});
1621 my %predefined_CXX = $config{CXX}
1622     ? compiler_predefined($config{CROSS_COMPILE}.$config{CXX})
1623     : ();
1624
1625 unless ($disabled{asm}) {
1626     # big endian systems can use ELFv2 ABI
1627     if ($target eq "linux-ppc64" || $target eq "BSD-ppc64") {
1628         $target{perlasm_scheme} = "linux64v2" if ($predefined_C{_CALL_ELF} == 2);
1629     }
1630 }
1631
1632 # Check for makedepend capabilities.
1633 if (!$disabled{makedepend}) {
1634     # If the attribute makedep_scheme is defined, then we assume that the
1635     # config target and its associated build file are programmed to deal
1636     # with it.
1637     # If makedep_scheme is undefined, we go looking for GCC compatible
1638     # dependency making, and if that's not available, we try to fall back
1639     # on 'makedepend'.
1640     if ($target{makedep_scheme}) {
1641         $config{makedep_scheme} = $target{makedep_scheme};
1642         # If the makedepcmd attribute is defined, copy it.  If not, the
1643         # build files will have to fend for themselves.
1644         $config{makedepcmd} = $target{makedepcmd} if $target{makedepcmd};
1645     } elsif (($predefined_C{__GNUC__} // -1) >= 3
1646              && !($predefined_C{__APPLE_CC__} && !$predefined_C{__clang__})) {
1647         # We know that GNU C version 3 and up as well as all clang
1648         # versions support dependency generation, but Xcode did not
1649         # handle $cc -M before clang support (but claims __GNUC__ = 3)
1650         $config{makedep_scheme} = 'gcc';
1651     } else {
1652         # In all other cases, we look for 'makedepend', and set the
1653         # makedep_scheme value if we found it.
1654         $config{makedepcmd} = which('makedepend');
1655         $config{makedep_scheme} = 'makedepend' if $config{makedepcmd};
1656     }
1657
1658     # If no depend scheme is set, we disable makedepend
1659     disable('unavailable', 'makedepend') unless $config{makedep_scheme};
1660 }
1661
1662 if (!$disabled{asm} && !$predefined_C{__MACH__} && $^O ne 'VMS') {
1663     # probe for -Wa,--noexecstack option...
1664     if ($predefined_C{__clang__}) {
1665         # clang has builtin assembler, which doesn't recognize --help,
1666         # but it apparently recognizes the option in question on all
1667         # supported platforms even when it's meaningless. In other words
1668         # probe would fail, but probed option always accepted...
1669         push @{$config{cflags}}, "-Wa,--noexecstack", "-Qunused-arguments";
1670     } else {
1671         my $cc = $config{CROSS_COMPILE}.$config{CC};
1672         open(PIPE, "$cc -Wa,--help -c -o null.$$.o -x assembler /dev/null 2>&1 |");
1673         while(<PIPE>) {
1674             if (m/--noexecstack/) {
1675                 push @{$config{cflags}}, "-Wa,--noexecstack";
1676                 last;
1677             }
1678         }
1679         close(PIPE);
1680         unlink("null.$$.o");
1681     }
1682 }
1683
1684 # Deal with bn_ops ###################################################
1685
1686 $config{bn_ll}                  =0;
1687 my $def_int="unsigned int";
1688 $config{rc4_int}                =$def_int;
1689 ($config{b64l},$config{b64},$config{b32})=(0,0,1);
1690
1691 my $count = 0;
1692 foreach (sort split(/\s+/,$target{bn_ops})) {
1693     $count++ if /SIXTY_FOUR_BIT|SIXTY_FOUR_BIT_LONG|THIRTY_TWO_BIT/;
1694     $config{bn_ll}=1                            if $_ eq 'BN_LLONG';
1695     $config{rc4_int}="unsigned char"            if $_ eq 'RC4_CHAR';
1696     ($config{b64l},$config{b64},$config{b32})
1697         =(0,1,0)                                if $_ eq 'SIXTY_FOUR_BIT';
1698     ($config{b64l},$config{b64},$config{b32})
1699         =(1,0,0)                                if $_ eq 'SIXTY_FOUR_BIT_LONG';
1700     ($config{b64l},$config{b64},$config{b32})
1701         =(0,0,1)                                if $_ eq 'THIRTY_TWO_BIT';
1702 }
1703 die "Exactly one of SIXTY_FOUR_BIT|SIXTY_FOUR_BIT_LONG|THIRTY_TWO_BIT can be set in bn_ops\n"
1704     if $count > 1;
1705
1706 $config{api} = $config{major} * 10000 + $config{minor} * 100
1707     unless $config{api};
1708 foreach (keys %$apitable) {
1709     $disabled{"deprecated-$_"} = "deprecation"
1710         if $disabled{deprecated} && $config{api} >= $apitable->{$_};
1711 }
1712
1713 disable();                      # Run a cascade now
1714
1715 # Hack cflags for better warnings (dev option) #######################
1716
1717 # "Stringify" the C and C++ flags string.  This permits it to be made part of
1718 # a string and works as well on command lines.
1719 $config{cflags} = [ map { (my $x = $_) =~ s/([\\\"])/\\$1/g; $x }
1720                         @{$config{cflags}} ];
1721 $config{cxxflags} = [ map { (my $x = $_) =~ s/([\\\"])/\\$1/g; $x }
1722                           @{$config{cxxflags}} ] if $config{CXX};
1723
1724 $config{openssl_api_defines} = [
1725     "OPENSSL_CONFIGURED_API=".$config{api},
1726 ];
1727
1728 my @strict_warnings_collection=();
1729 if ($strict_warnings)
1730         {
1731         my $wopt;
1732         my $gccver = $predefined_C{__GNUC__} // -1;
1733
1734         if ($gccver >= 4)
1735                 {
1736                 push @strict_warnings_collection, @gcc_devteam_warn;
1737                 push @strict_warnings_collection, @clang_devteam_warn
1738                     if (defined($predefined_C{__clang__}));
1739                 }
1740         elsif ($config{target} =~ /^VC-/)
1741                 {
1742                 push @strict_warnings_collection, @cl_devteam_warn;
1743                 }
1744         else
1745                 {
1746                 warn "WARNING --strict-warnings requires gcc[>=4] or gcc-alike, or MSVC"
1747                 }
1748         }
1749
1750 $config{CFLAGS} = [ map { $_ eq '--ossl-strict-warnings'
1751                               ? @strict_warnings_collection
1752                               : ( $_ ) }
1753                     @{$config{CFLAGS}} ];
1754
1755 unless ($disabled{afalgeng}) {
1756     $config{afalgeng}="";
1757     if (grep { $_ eq 'afalgeng' } @{$target{enable}}) {
1758         push @{$config{engdirs}}, "afalg";
1759     } else {
1760         disable('not-linux', 'afalgeng');
1761     }
1762 }
1763
1764 unless ($disabled{devcryptoeng}) {
1765     if ($target =~ m/^BSD/) {
1766         my $maxver = 5*100 + 7;
1767         my $sysstr = `uname -s`;
1768         my $verstr = `uname -r`;
1769         $sysstr =~ s|\R$||;
1770         $verstr =~ s|\R$||;
1771         my ($ma, $mi, @rest) = split m|\.|, $verstr;
1772         my $ver = $ma*100 + $mi;
1773         if ($sysstr eq 'OpenBSD' && $ver >= $maxver) {
1774             disable('too-new-kernel', 'devcryptoeng');
1775         }
1776     }
1777 }
1778
1779 unless ($disabled{ktls}) {
1780     $config{ktls}="";
1781     my $cc = $config{CROSS_COMPILE}.$config{CC};
1782     if ($target =~ m/^linux/) {
1783         system("printf '#include <sys/types.h>\n#include <linux/tls.h>' | $cc -E - >/dev/null 2>&1");
1784         if ($? != 0) {
1785             disable('too-old-kernel', 'ktls');
1786         }
1787     } elsif ($target =~ m/^BSD/) {
1788         system("printf '#include <sys/types.h>\n#include <sys/ktls.h>' | $cc -E - >/dev/null 2>&1");
1789         if ($? != 0) {
1790             disable('too-old-freebsd', 'ktls');
1791         }
1792     } else {
1793         disable('not-linux-or-freebsd', 'ktls');
1794     }
1795 }
1796
1797 unless ($disabled{winstore}) {
1798     unless ($target =~ /^(?:Cygwin|mingw|VC-|BC-)/) {
1799         disable('not-windows', 'winstore');
1800     }
1801 }
1802
1803 push @{$config{openssl_other_defines}}, "OPENSSL_NO_KTLS" if ($disabled{ktls});
1804
1805 # Get the extra flags used when building shared libraries and modules.  We
1806 # do this late because some of them depend on %disabled.
1807
1808 # Make the flags to build DSOs the same as for shared libraries unless they
1809 # are already defined
1810 $target{module_cflags} = $target{shared_cflag} unless defined $target{module_cflags};
1811 $target{module_cxxflags} = $target{shared_cxxflag} unless defined $target{module_cxxflags};
1812 $target{module_ldflags} = $target{shared_ldflag} unless defined $target{module_ldflags};
1813 {
1814     my $shared_info_pl =
1815         catfile(dirname($0), "Configurations", "shared-info.pl");
1816     my %shared_info = read_eval_file($shared_info_pl);
1817     push @{$target{_conf_fname_int}}, $shared_info_pl;
1818     my $si = $target{shared_target};
1819     while (ref $si ne "HASH") {
1820         last if ! defined $si;
1821         if (ref $si eq "CODE") {
1822             $si = $si->();
1823         } else {
1824             $si = $shared_info{$si};
1825         }
1826     }
1827
1828     # Some of the 'shared_target' values don't have any entries in
1829     # %shared_info.  That's perfectly fine, AS LONG AS the build file
1830     # template knows how to handle this.  That is currently the case for
1831     # Windows and VMS.
1832     if (defined $si) {
1833         # Just as above, copy certain shared_* attributes to the corresponding
1834         # module_ attribute unless the latter is already defined
1835         $si->{module_cflags} = $si->{shared_cflag} unless defined $si->{module_cflags};
1836         $si->{module_cxxflags} = $si->{shared_cxxflag} unless defined $si->{module_cxxflags};
1837         $si->{module_ldflags} = $si->{shared_ldflag} unless defined $si->{module_ldflags};
1838         foreach (sort keys %$si) {
1839             $target{$_} = defined $target{$_}
1840                 ? add($si->{$_})->($target{$_})
1841                 : $si->{$_};
1842         }
1843     }
1844 }
1845
1846 # ALL MODIFICATIONS TO %disabled, %config and %target MUST BE DONE FROM HERE ON
1847
1848 ######################################################################
1849 # Build up information for skipping certain directories depending on disabled
1850 # features, as well as setting up macros for disabled features.
1851
1852 # This is a tentative database of directories to skip.  Some entries may not
1853 # correspond to anything real, but that's ok, they will simply be ignored.
1854 # The actual processing of these entries is done in the build.info lookup
1855 # loop further down.
1856 #
1857 # The key is a Unix formatted path in the source tree, the value is an index
1858 # into %disabled_info, so any existing path gets added to a corresponding
1859 # 'skipped' entry in there with the list of skipped directories.
1860 my %skipdir = ();
1861 my %disabled_info = ();         # For configdata.pm
1862 foreach my $what (sort keys %disabled) {
1863     # There are deprecated disablables that translate to themselves.
1864     # They cause disabling cascades, but should otherwise not register.
1865     next if $deprecated_disablables{$what};
1866     # The generated $disabled{"deprecated-x.y"} entries are special
1867     # and treated properly elsewhere
1868     next if $what =~ m|^deprecated-|;
1869
1870     $config{options} .= " no-$what";
1871
1872     if (!grep { $what eq $_ } ( 'buildtest-c++', 'fips', 'threads', 'shared',
1873                                 'module', 'pic', 'dynamic-engine', 'makedepend',
1874                                 'sse2', 'legacy' )) {
1875         (my $WHAT = uc $what) =~ s|-|_|g;
1876         my $skipdir = $what;
1877
1878         # fix-up crypto/directory name(s)
1879         $skipdir = "ripemd" if $what eq "rmd160";
1880         $skipdir = "whrlpool" if $what eq "whirlpool";
1881
1882         my $macro = $disabled_info{$what}->{macro} = "OPENSSL_NO_$WHAT";
1883         push @{$config{openssl_feature_defines}}, $macro;
1884
1885         $skipdir{engines} = $what if $what eq 'engine';
1886         $skipdir{"crypto/$skipdir"} = $what
1887             unless $what eq 'async' || $what eq 'err' || $what eq 'dso';
1888     }
1889 }
1890
1891 if ($disabled{"dynamic-engine"}) {
1892     push @{$config{openssl_feature_defines}}, "OPENSSL_NO_DYNAMIC_ENGINE";
1893 } else {
1894     push @{$config{openssl_feature_defines}}, "OPENSSL_NO_STATIC_ENGINE";
1895 }
1896
1897 # If we use the unified build, collect information from build.info files
1898 my %unified_info = ();
1899
1900 my $buildinfo_debug = defined($ENV{CONFIGURE_DEBUG_BUILDINFO});
1901 if ($builder eq "unified") {
1902     use Text::Template 1.46;
1903
1904     sub cleandir {
1905         my $base = shift;
1906         my $dir = shift;
1907         my $relativeto = shift || ".";
1908         my $no_mkpath = shift // 0;
1909
1910         $dir = catdir($base,$dir) unless isabsolute($dir);
1911
1912         # Make sure the directories we're building in exists
1913         mkpath($dir) unless $no_mkpath;
1914
1915         my $res = abs2rel(absolutedir($dir), rel2abs($relativeto));
1916         #print STDERR "DEBUG[cleandir]: $dir , $base => $res\n";
1917         return $res;
1918     }
1919
1920     sub cleanfile {
1921         my $base = shift;
1922         my $file = shift;
1923         my $relativeto = shift || ".";
1924         my $no_mkpath = shift // 0;
1925
1926         $file = catfile($base,$file) unless isabsolute($file);
1927
1928         my $d = dirname($file);
1929         my $f = basename($file);
1930
1931         # Make sure the directories we're building in exists
1932         mkpath($d) unless $no_mkpath;
1933
1934         my $res = abs2rel(catfile(absolutedir($d), $f), rel2abs($relativeto));
1935         #print STDERR "DEBUG[cleanfile]: $d , $f => $res\n";
1936         return $res;
1937     }
1938
1939     # Store the name of the template file we will build the build file from
1940     # in %config.  This may be useful for the build file itself.
1941     my @build_file_template_names =
1942         ( $builder_platform."-".$config{build_file}.".tmpl",
1943           $config{build_file}.".tmpl" );
1944     my @build_file_templates = ();
1945
1946     # First, look in the user provided directory, if given
1947     if (defined env($local_config_envname)) {
1948         @build_file_templates =
1949             map {
1950                 if ($^O eq 'VMS') {
1951                     # VMS environment variables are logical names,
1952                     # which can be used as is
1953                     $local_config_envname . ':' . $_;
1954                 } else {
1955                     catfile(env($local_config_envname), $_);
1956                 }
1957             }
1958             @build_file_template_names;
1959     }
1960     # Then, look in our standard directory
1961     push @build_file_templates,
1962         ( map { cleanfile($srcdir, catfile("Configurations", $_), $blddir, 1) }
1963           @build_file_template_names );
1964
1965     my $build_file_template;
1966     for $_ (@build_file_templates) {
1967         $build_file_template = $_;
1968         last if -f $build_file_template;
1969
1970         $build_file_template = undef;
1971     }
1972     if (!defined $build_file_template) {
1973         die "*** Couldn't find any of:\n", join("\n", @build_file_templates), "\n";
1974     }
1975     $config{build_file_templates}
1976       = [ cleanfile($srcdir, catfile("Configurations", "common0.tmpl"),
1977                     $blddir, 1),
1978            $build_file_template ];
1979
1980     my @build_dirs = ( [ ] );   # current directory
1981
1982     $config{build_infos} = [ ];
1983
1984     # We want to detect configdata.pm in the source tree, so we
1985     # don't use it if the build tree is different.
1986     my $src_configdata = cleanfile($srcdir, "configdata.pm", $blddir, 1);
1987
1988     # Any source file that we recognise is placed in this hash table, with
1989     # the list of its intended destinations as value.  When everything has
1990     # been collected, there's a routine that checks that these source files
1991     # exist, or if they are generated, that the generator exists.
1992     my %check_exist = ();
1993     my %check_generate = ();
1994
1995     my %ordinals = ();
1996     while (@build_dirs) {
1997         my @curd = @{shift @build_dirs};
1998         my $sourced = catdir($srcdir, @curd);
1999         my $buildd = catdir($blddir, @curd);
2000
2001         my $unixdir = join('/', @curd);
2002         if (exists $skipdir{$unixdir}) {
2003             my $what = $skipdir{$unixdir};
2004             push @{$disabled_info{$what}->{skipped}}, catdir(@curd);
2005             next;
2006         }
2007
2008         mkpath($buildd);
2009
2010         my $f = 'build.info';
2011         # The basic things we're trying to build
2012         my @programs = ();
2013         my @libraries = ();
2014         my @modules = ();
2015         my @scripts = ();
2016
2017         my %sources = ();
2018         my %shared_sources = ();
2019         my %includes = ();
2020         my %defines = ();
2021         my %depends = ();
2022         my %generate = ();
2023         my %imagedocs = ();
2024         my %htmldocs = ();
2025         my %mandocs = ();
2026
2027         # Support for $variablename in build.info files.
2028         # Embedded perl code is the ultimate master, still.  If its output
2029         # contains a dollar sign, it had better be escaped, or it will be
2030         # taken for a variable name prefix.
2031         my %variables = ();
2032         # Variable name syntax
2033         my $variable_name_re = qr/(?P<VARIABLE>[[:alpha:]][[:alnum:]_]*)/;
2034         # Value modifier syntaxes
2035         my $variable_subst_re = qr/\/(?P<RE>(?:\\\/|.)*?)\/(?P<SUBST>.*?)/;
2036         # Variable reference
2037         my $variable_simple_re = qr/(?<!\\)\$${variable_name_re}/;
2038         my $variable_w_mod_re =
2039             qr/(?<!\\)\$\{${variable_name_re}(?P<MOD>(?:\\\/|.)*?)\}/;
2040         # Tie it all together
2041         my $variable_re = qr/${variable_simple_re}|${variable_w_mod_re}/;
2042
2043         my $expand_variables = sub {
2044             my $value = '';
2045             my $value_rest = shift;
2046
2047             if ($ENV{CONFIGURE_DEBUG_VARIABLE_EXPAND}) {
2048                 print STDERR
2049                     "DEBUG[\$expand_variables] Parsed '$value_rest' ...\n"
2050             }
2051
2052             while ($value_rest =~ /${variable_re}/) {
2053                 # We must save important regexp values, because the next
2054                 # regexp clears them
2055                 my $mod = $+{MOD};
2056                 my $variable_value = $variables{$+{VARIABLE}};
2057
2058                 $value_rest = $';
2059                 $value .= $`;
2060
2061                 # Process modifier expressions, if present
2062                 if (defined $mod) {
2063                     if ($mod =~ /^${variable_subst_re}$/) {
2064                         my $re = $+{RE};
2065                         my $subst = $+{SUBST};
2066
2067                         $variable_value =~ s/\Q$re\E/$subst/g;
2068
2069                         if ($ENV{CONFIGURE_DEBUG_VARIABLE_EXPAND}) {
2070                             print STDERR
2071                                 "DEBUG[\$expand_variables] ... and substituted ",
2072                                 "'$re' with '$subst'\n";
2073                         }
2074                     }
2075                 }
2076
2077                 $value .= $variable_value;
2078             }
2079             if ($ENV{CONFIGURE_DEBUG_VARIABLE_EXPAND}) {
2080                 print STDERR
2081                     "DEBUG[\$expand_variables] ... into: '$value$value_rest'\n";
2082             }
2083             return $value . $value_rest;
2084         };
2085
2086         # Support for attributes in build.info files
2087         my %attributes = ();
2088         my $handle_attributes = sub {
2089             my $attr_str = shift;
2090             my $ref = shift;
2091             my @goals = @_;
2092
2093             return unless defined $attr_str;
2094
2095             my @a = tokenize($attr_str, qr|\s*,\s*|);
2096             foreach my $a (@a) {
2097                 my $ac = 1;
2098                 my $ak = $a;
2099                 my $av = 1;
2100                 if ($a =~ m|^(!)?(.*?)\s* = \s*(.*?)$|x) {
2101                     $ac = ! $1;
2102                     $ak = $2;
2103                     $av = $3;
2104                 }
2105                 foreach my $g (@goals) {
2106                     if ($ac) {
2107                         $$ref->{$g}->{$ak} = $av;
2108                     } else {
2109                         delete $$ref->{$g}->{$ak};
2110                     }
2111                 }
2112             }
2113         };
2114
2115         # Support for pushing values on multiple indexes of a given hash
2116         # array.
2117         my $push_to = sub {
2118             my $valueref = shift;
2119             my $index_str = shift; # May be undef or empty
2120             my $attrref = shift;   # May be undef
2121             my $attr_str = shift;
2122             my @values = @_;
2123
2124             if (defined $index_str) {
2125                 my @indexes = ( '' );
2126                 if ($index_str !~ m|^\s*$|) {
2127                     @indexes = tokenize($index_str);
2128                 }
2129                 foreach (@indexes) {
2130                     push @{$valueref->{$_}}, @values;
2131                     if (defined $attrref) {
2132                         $handle_attributes->($attr_str, \$$attrref->{$_},
2133                                              @values);
2134                     }
2135                 }
2136             } else {
2137                 push @$valueref, @values;
2138                 $handle_attributes->($attr_str, $attrref, @values)
2139                     if defined $attrref;
2140             }
2141         };
2142
2143         if ($buildinfo_debug) {
2144             print STDERR "DEBUG: Reading ",catfile($sourced, $f),"\n";
2145         }
2146         push @{$config{build_infos}}, catfile(abs2rel($sourced, $blddir), $f);
2147         my $template =
2148             Text::Template->new(TYPE => 'FILE',
2149                                 SOURCE => catfile($sourced, $f),
2150                                 PREPEND => qq{use lib "$FindBin::Bin/util/perl";});
2151         die "Something went wrong with $sourced/$f: $!\n" unless $template;
2152         my @text =
2153             split /^/m,
2154             $template->fill_in(HASH => { config => \%config,
2155                                          target => \%target,
2156                                          disabled => \%disabled,
2157                                          withargs => \%withargs,
2158                                          builddir => abs2rel($buildd, $blddir),
2159                                          sourcedir => abs2rel($sourced, $blddir),
2160                                          buildtop => abs2rel($blddir, $blddir),
2161                                          sourcetop => abs2rel($srcdir, $blddir) },
2162                                DELIMITERS => [ "{-", "-}" ]);
2163
2164         # The top item of this stack has the following values
2165         # -2 positive already run and we found ELSE (following ELSIF should fail)
2166         # -1 positive already run (skip until ENDIF)
2167         # 0 negatives so far (if we're at a condition, check it)
2168         # 1 last was positive (don't skip lines until next ELSE, ELSIF or ENDIF)
2169         # 2 positive ELSE (following ELSIF should fail)
2170         my @skip = ();
2171
2172         # A few useful generic regexps
2173         my $index_re = qr/\[\s*(?P<INDEX>(?:\\.|.)*?)\s*\]/;
2174         my $cond_re = qr/\[\s*(?P<COND>(?:\\.|.)*?)\s*\]/;
2175         my $attribs_re = qr/(?:\{\s*(?P<ATTRIBS>(?:\\.|.)*?)\s*\})?/;
2176         my $value_re = qr/(?P<VALUE>.*?)/;
2177         collect_information(
2178             collect_from_array([ @text ],
2179                                qr/\\$/ => sub { my $l1 = shift; my $l2 = shift;
2180                                                 $l1 =~ s/\\$//; $l1.$l2 }),
2181             # Info we're looking for
2182             qr/^\s* IF ${cond_re} \s*$/x
2183             => sub {
2184                 if (! @skip || $skip[$#skip] > 0) {
2185                     push @skip, !! $expand_variables->($+{COND});
2186                 } else {
2187                     push @skip, -1;
2188                 }
2189             },
2190             qr/^\s* ELSIF ${cond_re} \s*$/x
2191             => sub { die "ELSIF out of scope" if ! @skip;
2192                      die "ELSIF following ELSE" if abs($skip[$#skip]) == 2;
2193                      $skip[$#skip] = -1 if $skip[$#skip] != 0;
2194                      $skip[$#skip] = !! $expand_variables->($+{COND})
2195                          if $skip[$#skip] == 0; },
2196             qr/^\s* ELSE \s*$/x
2197             => sub { die "ELSE out of scope" if ! @skip;
2198                      $skip[$#skip] = -2 if $skip[$#skip] != 0;
2199                      $skip[$#skip] = 2 if $skip[$#skip] == 0; },
2200             qr/^\s* ENDIF \s*$/x
2201             => sub { die "ENDIF out of scope" if ! @skip;
2202                      pop @skip; },
2203             qr/^\s* ${variable_re} \s* = \s* ${value_re} \s* $/x
2204             => sub {
2205                 if (!@skip || $skip[$#skip] > 0) {
2206                     $variables{$+{VARIABLE}} = $expand_variables->($+{VALUE});
2207                 }
2208             },
2209             qr/^\s* SUBDIRS \s* = \s* ${value_re} \s* $/x
2210             => sub {
2211                 if (!@skip || $skip[$#skip] > 0) {
2212                     foreach (tokenize($expand_variables->($+{VALUE}))) {
2213                         push @build_dirs, [ @curd, splitdir($_, 1) ];
2214                     }
2215                 }
2216             },
2217             qr/^\s* PROGRAMS ${attribs_re} \s* =  \s* ${value_re} \s* $/x
2218             => sub { $push_to->(\@programs, undef,
2219                                 \$attributes{programs}, $+{ATTRIBS},
2220                                 tokenize($expand_variables->($+{VALUE})))
2221                          if !@skip || $skip[$#skip] > 0; },
2222             qr/^\s* LIBS ${attribs_re} \s* =  \s* ${value_re} \s* $/x
2223             => sub { $push_to->(\@libraries, undef,
2224                                 \$attributes{libraries}, $+{ATTRIBS},
2225                                 tokenize($expand_variables->($+{VALUE})))
2226                          if !@skip || $skip[$#skip] > 0; },
2227             qr/^\s* MODULES ${attribs_re} \s* =  \s* ${value_re} \s* $/x
2228             => sub { $push_to->(\@modules, undef,
2229                                 \$attributes{modules}, $+{ATTRIBS},
2230                                 tokenize($expand_variables->($+{VALUE})))
2231                          if !@skip || $skip[$#skip] > 0; },
2232             qr/^\s* SCRIPTS ${attribs_re} \s* = \s* ${value_re} \s* $/x
2233             => sub { $push_to->(\@scripts, undef,
2234                                 \$attributes{scripts}, $+{ATTRIBS},
2235                                 tokenize($expand_variables->($+{VALUE})))
2236                          if !@skip || $skip[$#skip] > 0; },
2237             qr/^\s* IMAGEDOCS ${index_re} \s* = \s* ${value_re} \s* $/x
2238             => sub { $push_to->(\%imagedocs, $expand_variables->($+{INDEX}),
2239                                 undef, undef,
2240                                 tokenize($expand_variables->($+{VALUE})))
2241                          if !@skip || $skip[$#skip] > 0; },
2242             qr/^\s* HTMLDOCS ${index_re} \s* = \s* ${value_re} \s* $/x
2243             => sub { $push_to->(\%htmldocs, $expand_variables->($+{INDEX}),
2244                                 undef, undef,
2245                                 tokenize($expand_variables->($+{VALUE})))
2246                          if !@skip || $skip[$#skip] > 0; },
2247             qr/^\s* MANDOCS ${index_re} \s* = \s* ${value_re} \s* $/x
2248             => sub { $push_to->(\%mandocs, $expand_variables->($+{INDEX}),
2249                                 undef, undef,
2250                                 tokenize($expand_variables->($+{VALUE})))
2251                          if !@skip || $skip[$#skip] > 0; },
2252             qr/^\s* SOURCE ${index_re} ${attribs_re} \s* = \s* ${value_re} \s* $/x
2253             => sub { $push_to->(\%sources, $expand_variables->($+{INDEX}),
2254                                 \$attributes{sources}, $+{ATTRIBS},
2255                                 tokenize($expand_variables->($+{VALUE})))
2256                          if !@skip || $skip[$#skip] > 0; },
2257             qr/^\s* SHARED_SOURCE ${index_re} ${attribs_re} \s* = \s* ${value_re} \s* $/x
2258             => sub { $push_to->(\%shared_sources, $expand_variables->($+{INDEX}),
2259                                 \$attributes{sources}, $+{ATTRIBS},
2260                                 tokenize($expand_variables->($+{VALUE})))
2261                          if !@skip || $skip[$#skip] > 0; },
2262             qr/^\s* INCLUDE ${index_re} \s* = \s* ${value_re} \s* $/x
2263             => sub { $push_to->(\%includes, $expand_variables->($+{INDEX}),
2264                                 undef, undef,
2265                                 tokenize($expand_variables->($+{VALUE})))
2266                          if !@skip || $skip[$#skip] > 0; },
2267             qr/^\s* DEFINE ${index_re} \s* = \s* ${value_re} \s* $/x
2268             => sub { $push_to->(\%defines, $expand_variables->($+{INDEX}),
2269                                 undef, undef,
2270                                 tokenize($expand_variables->($+{VALUE})))
2271                          if !@skip || $skip[$#skip] > 0; },
2272             qr/^\s* DEPEND ${index_re} ${attribs_re} \s* = \s* ${value_re} \s* $/x
2273             => sub { $push_to->(\%depends, $expand_variables->($+{INDEX}),
2274                                 \$attributes{depends}, $+{ATTRIBS},
2275                                 tokenize($expand_variables->($+{VALUE})))
2276                          if !@skip || $skip[$#skip] > 0; },
2277             qr/^\s* GENERATE ${index_re} ${attribs_re} \s* = \s* ${value_re} \s* $/x
2278             => sub { $push_to->(\%generate, $expand_variables->($+{INDEX}),
2279                                 \$attributes{generate}, $+{ATTRIBS},
2280                                 $expand_variables->($+{VALUE}))
2281                          if !@skip || $skip[$#skip] > 0; },
2282             qr/^\s* (?:\#.*)? $/x => sub { },
2283             "OTHERWISE" => sub { die "Something wrong with this line:\n$_\nat $sourced/$f" },
2284             "BEFORE" => sub {
2285                 if ($buildinfo_debug) {
2286                     print STDERR "DEBUG: Parsing ",join(" ", @_),"\n";
2287                     print STDERR "DEBUG: ... before parsing, skip stack is ",join(" ", map { int($_) } @skip),"\n";
2288                 }
2289             },
2290             "AFTER" => sub {
2291                 if ($buildinfo_debug) {
2292                     print STDERR "DEBUG: .... after parsing, skip stack is ",join(" ", map { int($_) } @skip),"\n";
2293                 }
2294             },
2295             );
2296         die "runaway IF?" if (@skip);
2297
2298         if (grep { defined $attributes{modules}->{$_}->{engine} } keys %attributes
2299                 and !$config{dynamic_engines}) {
2300             die <<"EOF"
2301 ENGINES can only be used if configured with 'dynamic-engine'.
2302 This is usually a fault in a build.info file.
2303 EOF
2304         }
2305
2306         {
2307             my %infos = ( programs  => [ @programs  ],
2308                           libraries => [ @libraries ],
2309                           modules   => [ @modules   ],
2310                           scripts   => [ @scripts   ] );
2311             foreach my $k (keys %infos) {
2312                 foreach (@{$infos{$k}}) {
2313                     my $item = cleanfile($buildd, $_, $blddir);
2314                     $unified_info{$k}->{$item} = 1;
2315
2316                     # Fix up associated attributes
2317                     $unified_info{attributes}->{$k}->{$item} =
2318                         $attributes{$k}->{$_}
2319                         if defined $attributes{$k}->{$_};
2320                 }
2321             }
2322         }
2323
2324         # Check that we haven't defined any library as both shared and
2325         # explicitly static.  That is forbidden.
2326         my @doubles = ();
2327         foreach (grep /\.a$/, keys %{$unified_info{libraries}}) {
2328             (my $l = $_) =~ s/\.a$//;
2329             push @doubles, $l if defined $unified_info{libraries}->{$l};
2330         }
2331         die "these libraries are both explicitly static and shared:\n  ",
2332             join(" ", @doubles), "\n"
2333             if @doubles;
2334
2335         foreach (keys %sources) {
2336             my $dest = $_;
2337             my $ddest = cleanfile($buildd, $_, $blddir);
2338             foreach (@{$sources{$dest}}) {
2339                 my $s = cleanfile($sourced, $_, $blddir, 1);
2340
2341                 # If it's generated or we simply don't find it in the source
2342                 # tree, we assume it's in the build tree.
2343                 if ($s eq $src_configdata || $generate{$_} || ! -f $s) {
2344                     $s = cleanfile($buildd, $_, $blddir);
2345                 }
2346                 my $o = $_;
2347                 # We recognise C++, C and asm files
2348                 if ($s =~ /\.(cc|cpp|c|s|S)$/) {
2349                     push @{$check_exist{$s}}, $ddest;
2350                     $o =~ s/\.[csS]$/.o/; # C and assembler
2351                     $o =~ s/\.(cc|cpp)$/_cc.o/; # C++
2352                     $o = cleanfile($buildd, $o, $blddir);
2353                     $unified_info{sources}->{$ddest}->{$o} = -1;
2354                     $unified_info{sources}->{$o}->{$s} = -1;
2355                 } elsif ($s =~ /\.rc$/) {
2356                     # We also recognise resource files
2357                     push @{$check_exist{$s}}, $ddest;
2358                     $o =~ s/\.rc$/.res/; # Resource configuration
2359                     $o = cleanfile($buildd, $o, $blddir);
2360                     $unified_info{sources}->{$ddest}->{$o} = -1;
2361                     $unified_info{sources}->{$o}->{$s} = -1;
2362                 } else {
2363                     push @{$check_exist{$s}}, $ddest;
2364                     $unified_info{sources}->{$ddest}->{$s} = 1;
2365                 }
2366                 # Fix up associated attributes
2367                 if ($o ne $_) {
2368                     $unified_info{attributes}->{sources}->{$ddest}->{$o} =
2369                         $unified_info{attributes}->{sources}->{$o}->{$s} =
2370                         $attributes{sources}->{$dest}->{$_}
2371                         if defined $attributes{sources}->{$dest}->{$_};
2372                 } else {
2373                     $unified_info{attributes}->{sources}->{$ddest}->{$s} =
2374                         $attributes{sources}->{$dest}->{$_}
2375                         if defined $attributes{sources}->{$dest}->{$_};
2376                 }
2377             }
2378         }
2379
2380         foreach (keys %shared_sources) {
2381             my $dest = $_;
2382             my $ddest = cleanfile($buildd, $_, $blddir);
2383             foreach (@{$shared_sources{$dest}}) {
2384                 my $s = cleanfile($sourced, $_, $blddir, 1);
2385
2386                 # If it's generated or we simply don't find it in the source
2387                 # tree, we assume it's in the build tree.
2388                 if ($s eq $src_configdata || $generate{$_} || ! -f $s) {
2389                     $s = cleanfile($buildd, $_, $blddir);
2390                 }
2391
2392                 my $o = $_;
2393                 if ($s =~ /\.(cc|cpp|c|s|S)$/) {
2394                     # We recognise C++, C and asm files
2395                     push @{$check_exist{$s}}, $ddest;
2396                     $o =~ s/\.[csS]$/.o/; # C and assembler
2397                     $o =~ s/\.(cc|cpp)$/_cc.o/; # C++
2398                     $o = cleanfile($buildd, $o, $blddir);
2399                     $unified_info{shared_sources}->{$ddest}->{$o} = -1;
2400                     $unified_info{sources}->{$o}->{$s} = -1;
2401                 } elsif ($s =~ /\.rc$/) {
2402                     # We also recognise resource files
2403                     push @{$check_exist{$s}}, $ddest;
2404                     $o =~ s/\.rc$/.res/; # Resource configuration
2405                     $o = cleanfile($buildd, $o, $blddir);
2406                     $unified_info{shared_sources}->{$ddest}->{$o} = -1;
2407                     $unified_info{sources}->{$o}->{$s} = -1;
2408                 } elsif ($s =~ /\.ld$/) {
2409                     # We also recognise linker scripts (or corresponding)
2410                     # We know they are generated files
2411                     push @{$check_exist{$s}}, $ddest;
2412                     $o = cleanfile($buildd, $_, $blddir);
2413                     $unified_info{shared_sources}->{$ddest}->{$o} = 1;
2414                 } else {
2415                     die "unrecognised source file type for shared library: $s\n";
2416                 }
2417                 # Fix up associated attributes
2418                 if ($o ne $_) {
2419                     $unified_info{attributes}->{shared_sources}->{$ddest}->{$o} =
2420                         $unified_info{attributes}->{sources}->{$o}->{$s} =
2421                         $attributes{sources}->{$dest}->{$_}
2422                         if defined $attributes{sources}->{$dest}->{$_};
2423                 } else {
2424                     $unified_info{attributes}->{shared_sources}->{$ddest}->{$o} =
2425                         $attributes{sources}->{$dest}->{$_}
2426                         if defined $attributes{sources}->{$dest}->{$_};
2427                 }
2428             }
2429         }
2430
2431         foreach (keys %generate) {
2432             my $dest = $_;
2433             my $ddest = cleanfile($buildd, $_, $blddir);
2434             die "more than one generator for $dest: "
2435                 ,join(" ", @{$generate{$_}}),"\n"
2436                 if scalar @{$generate{$_}} > 1;
2437             my @generator = split /\s+/, $generate{$dest}->[0];
2438             my $gen = $generator[0];
2439             $generator[0] = cleanfile($sourced, $gen, $blddir, 1);
2440
2441             # If the generator is itself generated, it's in the build tree
2442             if ($generate{$gen} || ! -f $generator[0]) {
2443                 $generator[0] = cleanfile($buildd, $gen, $blddir);
2444             }
2445             $check_generate{$ddest}->{$generator[0]}++;
2446
2447             $unified_info{generate}->{$ddest} = [ @generator ];
2448             # Fix up associated attributes
2449             $unified_info{attributes}->{generate}->{$ddest} =
2450                 $attributes{generate}->{$dest}->{$gen}
2451                 if defined $attributes{generate}->{$dest}->{$gen};
2452         }
2453
2454         foreach (keys %depends) {
2455             my $dest = $_;
2456             my $ddest = $dest;
2457
2458             if ($dest =~ /^\|(.*)\|$/) {
2459                 # Collect the raw target
2460                 $unified_info{targets}->{$1} = 1;
2461                 $ddest = $1;
2462             } elsif ($dest eq '') {
2463                 $ddest = '';
2464             } else {
2465                 $ddest = cleanfile($sourced, $dest, $blddir, 1);
2466
2467                 # If the destination doesn't exist in source, it can only be
2468                 # a generated file in the build tree.
2469                 if ($ddest eq $src_configdata || ! -f $ddest) {
2470                     $ddest = cleanfile($buildd, $dest, $blddir);
2471                 }
2472             }
2473             foreach my $f (@{$depends{$dest}}) {
2474                 # If the dependency destination is generated, dependencies
2475                 # may have an extra syntax to separate the intended inclusion
2476                 # directory from the module to be loaded: a | instead of a
2477                 # / as directory separator.
2478                 # Do note that this has to be handled in the build file
2479                 # template as well.
2480                 # $i = inclusion path in source directory
2481                 # $i2 = inclusion path in build directory
2482                 # $m = module path (within the inclusion path)
2483                 # $i = full module path in source directory
2484                 # $i2 = full module path in build directory
2485                 my $i; my $i2; my $m; my $d; my $d2;
2486                 if ($unified_info{generate}->{$ddest}
2487                     && $f =~ m/^(.*?)\|(.*)$/) {
2488                     $i = $1;
2489                     $m = $2;
2490                     # We must be very careful to modify $i last
2491                     $d = cleanfile($sourced, "$i/$m", $blddir, 1);
2492                     $d2 = cleanfile($buildd, "$i/$m", $blddir);
2493                     $i2 = cleandir($buildd, $i, $blddir);
2494                     $i = cleandir($sourced, $i, $blddir, 1);
2495                 } else {
2496                     $d = cleanfile($sourced, $f, $blddir, 1);
2497                     $d2 = cleanfile($buildd, $f, $blddir);
2498                 }
2499
2500                 # If we know it's generated, or assume it is because we can't
2501                 # find it in the source tree, we set file we depend on to be
2502                 # in the build tree rather than the source tree.
2503                 if ($d eq $src_configdata
2504                     || (grep { $d2 eq $_ }
2505                         keys %{$unified_info{generate}})
2506                     || ! -f $d) {
2507                     $d = $d2;
2508                     $i = $i2;
2509                 }
2510                 if ($i) {
2511                     # Put together the computed inclusion dir with the
2512                     # original module name.  Do note that we conserve the
2513                     # Unixly path syntax for the module path.
2514                     $d = "$i|$m";
2515                 }
2516                 $unified_info{depends}->{$ddest}->{$d} = 1;
2517
2518                 # Fix up associated attributes
2519                 $unified_info{attributes}->{depends}->{$ddest}->{$d} =
2520                     $attributes{depends}->{$dest}->{$f}
2521                     if defined $attributes{depends}->{$dest}->{$f};
2522             }
2523         }
2524
2525         foreach (keys %includes) {
2526             my $dest = $_;
2527             my $ddest = cleanfile($sourced, $_, $blddir, 1);
2528
2529             # If the destination doesn't exist in source, it can only be
2530             # a generated file in the build tree.
2531             if ($ddest eq $src_configdata || ! -f $ddest) {
2532                 $ddest = cleanfile($buildd, $_, $blddir);
2533             }
2534             foreach (@{$includes{$dest}}) {
2535                 my $is = cleandir($sourced, $_, $blddir, 1);
2536                 my $ib = cleandir($buildd, $_, $blddir);
2537                 push @{$unified_info{includes}->{$ddest}->{source}}, $is
2538                     unless grep { $_ eq $is } @{$unified_info{includes}->{$ddest}->{source}};
2539                 push @{$unified_info{includes}->{$ddest}->{build}}, $ib
2540                     unless grep { $_ eq $ib } @{$unified_info{includes}->{$ddest}->{build}};
2541             }
2542         }
2543
2544         foreach my $dest (keys %defines) {
2545             my $ddest;
2546
2547             if ($dest ne "") {
2548                 $ddest = cleanfile($sourced, $dest, $blddir, 1);
2549
2550                 # If the destination doesn't exist in source, it can only
2551                 # be a generated file in the build tree.
2552                 if (! -f $ddest) {
2553                     $ddest = cleanfile($buildd, $dest, $blddir);
2554                 }
2555             }
2556             foreach my $v (@{$defines{$dest}}) {
2557                 $v =~ m|^([^=]*)(=.*)?$|;
2558                 die "0 length macro name not permitted\n" if $1 eq "";
2559                 if ($dest ne "") {
2560                     die "$1 defined more than once\n"
2561                         if defined $unified_info{defines}->{$ddest}->{$1};
2562                     $unified_info{defines}->{$ddest}->{$1} = $2;
2563                 } else {
2564                     die "$1 defined more than once\n"
2565                         if grep { $v eq $_ } @{$config{defines}};
2566                     push @{$config{defines}}, $v;
2567                 }
2568             }
2569         }
2570
2571         foreach my $section (keys %imagedocs) {
2572             foreach (@{$imagedocs{$section}}) {
2573                 my $imagedocs = cleanfile($buildd, $_, $blddir);
2574                 $unified_info{imagedocs}->{$section}->{$imagedocs} = 1;
2575             }
2576         }
2577
2578         foreach my $section (keys %htmldocs) {
2579             foreach (@{$htmldocs{$section}}) {
2580                 my $htmldocs = cleanfile($buildd, $_, $blddir);
2581                 $unified_info{htmldocs}->{$section}->{$htmldocs} = 1;
2582             }
2583         }
2584
2585         foreach my $section (keys %mandocs) {
2586             foreach (@{$mandocs{$section}}) {
2587                 my $mandocs = cleanfile($buildd, $_, $blddir);
2588                 $unified_info{mandocs}->{$section}->{$mandocs} = 1;
2589             }
2590         }
2591     }
2592
2593     my $ordinals_text = join(', ', sort keys %ordinals);
2594     warn <<"EOF" if $ordinals_text;
2595
2596 WARNING: ORDINALS were specified for $ordinals_text
2597 They are ignored and should be replaced with a combination of GENERATE,
2598 DEPEND and SHARED_SOURCE.
2599 EOF
2600
2601     # Check that each generated file is only generated once
2602     my $ambiguous_generation = 0;
2603     foreach (sort keys %check_generate) {
2604         my @generators = sort keys %{$check_generate{$_}};
2605         my $generators_txt = join(', ', @generators);
2606         if (scalar @generators > 1) {
2607             warn "$_ is GENERATEd by more than one generator ($generators_txt)\n";
2608             $ambiguous_generation++;
2609         }
2610         if ($check_generate{$_}->{$generators[0]} > 1) {
2611             warn "INFO: $_ has more than one GENERATE declaration (same generator)\n"
2612         }
2613     }
2614     die "There are ambiguous source file generations\n"
2615         if $ambiguous_generation > 0;
2616
2617     # All given source files should exist, or if generated, their
2618     # generator should exist.  This loop ensures this is true.
2619     my $missing = 0;
2620     foreach my $orig (sort keys %check_exist) {
2621         foreach my $dest (@{$check_exist{$orig}}) {
2622             if ($orig ne $src_configdata) {
2623                 if ($orig =~ /\.a$/) {
2624                     # Static library names may be used as sources, so we
2625                     # need to detect those and give them special treatment.
2626                     unless (grep { $_ eq $orig }
2627                             keys %{$unified_info{libraries}}) {
2628                         warn "$orig is given as source for $dest, but no such library is built\n";
2629                         $missing++;
2630                     }
2631                 } else {
2632                     # A source may be generated, and its generator may be
2633                     # generated as well.  We therefore loop to dig out the
2634                     # first generator.
2635                     my $gen = $orig;
2636
2637                     while (my @next = keys %{$check_generate{$gen}}) {
2638                         $gen = $next[0];
2639                     }
2640
2641                     if (! -f $gen) {
2642                         if ($gen ne $orig) {
2643                             $missing++;
2644                             warn "$orig is given as source for $dest, but its generator (leading to $gen) is missing\n";
2645                         } else {
2646                             $missing++;
2647                             warn "$orig is given as source for $dest, but is missing\n";
2648                         }
2649                     }
2650                 }
2651             }
2652         }
2653     }
2654     die "There are files missing\n" if $missing > 0;
2655
2656     # Go through the sources of all libraries and check that the same basename
2657     # doesn't appear more than once.  Some static library archivers depend on
2658     # them being unique.
2659     {
2660         my $err = 0;
2661         foreach my $prod (keys %{$unified_info{libraries}}) {
2662             my @prod_sources =
2663                 map { keys %{$unified_info{sources}->{$_}} }
2664                 keys %{$unified_info{sources}->{$prod}};
2665             my %srccnt = ();
2666
2667             # Count how many times a given each source basename
2668             # appears for each product.
2669             foreach my $src (@prod_sources) {
2670                 $srccnt{basename $src}++;
2671             }
2672
2673             foreach my $src (keys %srccnt) {
2674                 if ((my $cnt = $srccnt{$src}) > 1) {
2675                     print STDERR "$src appears $cnt times for the product $prod\n";
2676                     $err++
2677                 }
2678             }
2679         }
2680         die if $err > 0;
2681     }
2682
2683     # Massage the result
2684
2685     # If we depend on a header file or a perl module, add an inclusion of
2686     # its directory to allow smoothe inclusion
2687     foreach my $dest (keys %{$unified_info{depends}}) {
2688         next if $dest eq "";
2689         foreach my $d (keys %{$unified_info{depends}->{$dest}}) {
2690             next unless $d =~ /\.(h|pm)$/;
2691             # Take into account when a dependency uses the inclusion|module
2692             # syntax
2693             my $i = $d =~ m/\|/ ? $` : dirname($d);
2694             my $spot =
2695                 $d eq "configdata.pm" || defined($unified_info{generate}->{$d})
2696                 ? 'build' : 'source';
2697             push @{$unified_info{includes}->{$dest}->{$spot}}, $i
2698                 unless grep { $_ eq $i } @{$unified_info{includes}->{$dest}->{$spot}};
2699         }
2700     }
2701
2702     # Go through all intermediary files and change their names to something that
2703     # reflects what they will be built for.  Note that for some source files,
2704     # this leads to duplicate object files because they are used multiple times.
2705     # the goal is to rename all object files according to this scheme:
2706     #    {productname}-{midfix}-{origobjname}.[o|res]
2707     # the {midfix} is a keyword indicating the type of product, which is mostly
2708     # valuable for libraries since they come in two forms.
2709     #
2710     # This also reorganises the {sources} and {shared_sources} so that the
2711     # former only contains ALL object files that are supposed to end up in
2712     # static libraries and programs, while the latter contains ALL object files
2713     # that are supposed to end up in shared libraries and DSOs.
2714     # The main reason for having two different source structures is to allow
2715     # the same name to be used for the static and the shared variants of a
2716     # library.
2717     {
2718         # Take copies so we don't get interference from added stuff
2719         my %unified_copy = ();
2720         foreach (('sources', 'shared_sources')) {
2721             $unified_copy{$_} = { %{$unified_info{$_}} }
2722                 if defined($unified_info{$_});
2723             delete $unified_info{$_};
2724         }
2725         foreach my $prodtype (('programs', 'libraries', 'modules', 'scripts')) {
2726             # $intent serves multi purposes:
2727             # - give a prefix for the new object files names
2728             # - in the case of libraries, rearrange the object files so static
2729             #   libraries use the 'sources' structure exclusively, while shared
2730             #   libraries use the 'shared_sources' structure exclusively.
2731             my $intent = {
2732                 programs  => { bin    => { src => [ 'sources' ],
2733                                            dst => 'sources' } },
2734                 libraries => { lib    => { src => [ 'sources' ],
2735                                            dst => 'sources' },
2736                                shlib  => { prodselect =>
2737                                                sub { grep !/\.a$/, @_ },
2738                                            src => [ 'sources',
2739                                                     'shared_sources' ],
2740                                            dst => 'shared_sources' } },
2741                 modules   => { dso    => { src => [ 'sources' ],
2742                                            dst => 'sources' } },
2743                 scripts   => { script => { src => [ 'sources' ],
2744                                            dst => 'sources' } }
2745                } -> {$prodtype};
2746             foreach my $kind (keys %$intent) {
2747                 next if ($intent->{$kind}->{dst} eq 'shared_sources'
2748                              && $disabled{shared});
2749
2750                 my @src = @{$intent->{$kind}->{src}};
2751                 my $dst = $intent->{$kind}->{dst};
2752                 my $prodselect = $intent->{$kind}->{prodselect} // sub { @_ };
2753                 foreach my $prod ($prodselect->(keys %{$unified_info{$prodtype}})) {
2754                     # %prod_sources has all applicable objects as keys, and
2755                     # their corresponding sources as values
2756                     my %prod_sources =
2757                         map { $_ => [ keys %{$unified_copy{sources}->{$_}} ] }
2758                         map { keys %{$unified_copy{$_}->{$prod}} }
2759                         @src;
2760                     foreach (keys %prod_sources) {
2761                         # Only affect object files and resource files,
2762                         # the others simply get a new value
2763                         # (+1 instead of -1)
2764                         if ($_ =~ /\.(o|res)$/) {
2765                             (my $prodname = $prod) =~ s|\.a$||;
2766                             my $newobj =
2767                                 catfile(dirname($_),
2768                                         basename($prodname)
2769                                             . '-' . $kind
2770                                             . '-' . basename($_));
2771                             $unified_info{$dst}->{$prod}->{$newobj} = 1;
2772                             foreach my $src (@{$prod_sources{$_}}) {
2773                                 $unified_info{sources}->{$newobj}->{$src} = 1;
2774                                 # Adjust source attributes
2775                                 my $attrs = $unified_info{attributes}->{sources};
2776                                 if (defined $attrs->{$prod}
2777                                     && defined $attrs->{$prod}->{$_}) {
2778                                     $attrs->{$prod}->{$newobj} =
2779                                         $attrs->{$prod}->{$_};
2780                                     delete $attrs->{$prod}->{$_};
2781                                 }
2782                                 foreach my $objsrc (keys %{$attrs->{$_} // {}}) {
2783                                     $attrs->{$newobj}->{$objsrc} =
2784                                         $attrs->{$_}->{$objsrc};
2785                                     delete $attrs->{$_}->{$objsrc};
2786                                 }
2787                             }
2788                             # Adjust dependencies
2789                             foreach my $deps (keys %{$unified_info{depends}->{$_}}) {
2790                                 $unified_info{depends}->{$_}->{$deps} = -1;
2791                                 $unified_info{depends}->{$newobj}->{$deps} = 1;
2792                             }
2793                             # Adjust includes
2794                             foreach my $k (('source', 'build')) {
2795                                 next unless
2796                                     defined($unified_info{includes}->{$_}->{$k});
2797                                 my @incs = @{$unified_info{includes}->{$_}->{$k}};
2798                                 $unified_info{includes}->{$newobj}->{$k} = [ @incs ];
2799                             }
2800                         } else {
2801                             $unified_info{$dst}->{$prod}->{$_} = 1;
2802                         }
2803                     }
2804                 }
2805             }
2806         }
2807     }
2808
2809     # At this point, we have a number of sources with the value -1.  They
2810     # aren't part of the local build and are probably meant for a different
2811     # platform, and can therefore be cleaned away.  That happens when making
2812     # %unified_info more efficient below.
2813
2814     ### Make unified_info a bit more efficient
2815     # One level structures
2816     foreach (("programs", "libraries", "modules", "scripts", "targets")) {
2817         $unified_info{$_} = [ sort keys %{$unified_info{$_}} ];
2818     }
2819     # Two level structures
2820     foreach my $l1 (("sources", "shared_sources", "ldadd", "depends",
2821                      "imagedocs", "htmldocs", "mandocs")) {
2822         foreach my $l2 (sort keys %{$unified_info{$l1}}) {
2823             my @items =
2824                 sort
2825                 grep { $unified_info{$l1}->{$l2}->{$_} > 0 }
2826                 keys %{$unified_info{$l1}->{$l2}};
2827             if (@items) {
2828                 $unified_info{$l1}->{$l2} = [ @items ];
2829             } else {
2830                 delete $unified_info{$l1}->{$l2};
2831             }
2832         }
2833     }
2834     # Defines
2835     foreach my $dest (sort keys %{$unified_info{defines}}) {
2836         $unified_info{defines}->{$dest}
2837             = [ map { $_.$unified_info{defines}->{$dest}->{$_} }
2838                 sort keys %{$unified_info{defines}->{$dest}} ];
2839     }
2840     # Includes
2841     foreach my $dest (sort keys %{$unified_info{includes}}) {
2842         if (defined($unified_info{includes}->{$dest}->{build})) {
2843             my @source_includes = ();
2844             @source_includes = ( @{$unified_info{includes}->{$dest}->{source}} )
2845                 if defined($unified_info{includes}->{$dest}->{source});
2846             $unified_info{includes}->{$dest} =
2847                 [ @{$unified_info{includes}->{$dest}->{build}} ];
2848             foreach my $inc (@source_includes) {
2849                 push @{$unified_info{includes}->{$dest}}, $inc
2850                     unless grep { $_ eq $inc } @{$unified_info{includes}->{$dest}};
2851             }
2852         } elsif (defined($unified_info{includes}->{$dest}->{source})) {
2853             $unified_info{includes}->{$dest} =
2854                 [ @{$unified_info{includes}->{$dest}->{source}} ];
2855         } else {
2856             delete $unified_info{includes}->{$dest};
2857         }
2858     }
2859
2860     # For convenience collect information regarding directories where
2861     # files are generated, those generated files and the end product
2862     # they end up in where applicable.  Then, add build rules for those
2863     # directories
2864     my %loopinfo = ( "lib" => [ @{$unified_info{libraries}} ],
2865                      "dso" => [ @{$unified_info{modules}} ],
2866                      "bin" => [ @{$unified_info{programs}} ],
2867                      "script" => [ @{$unified_info{scripts}} ],
2868                      "docs" => [ (map { @{$unified_info{imagedocs}->{$_} // []} }
2869                                   keys %{$unified_info{imagedocs} // {}}),
2870                                  (map { @{$unified_info{htmldocs}->{$_} // []} }
2871                                   keys %{$unified_info{htmldocs} // {}}),
2872                                  (map { @{$unified_info{mandocs}->{$_} // []} }
2873                                   keys %{$unified_info{mandocs} // {}}) ] );
2874     foreach my $type (sort keys %loopinfo) {
2875         foreach my $product (@{$loopinfo{$type}}) {
2876             my %dirs = ();
2877             my $pd = dirname($product);
2878
2879             foreach (@{$unified_info{sources}->{$product} // []},
2880                      @{$unified_info{shared_sources}->{$product} // []}) {
2881                 my $d = dirname($_);
2882
2883                 # We don't want to create targets for source directories
2884                 # when building out of source
2885                 next if ($config{sourcedir} ne $config{builddir}
2886                              && $d =~ m|^\Q$config{sourcedir}\E|);
2887                 # We already have a "test" target, and the current directory
2888                 # is just silly to make a target for
2889                 next if $d eq "test" || $d eq ".";
2890
2891                 $dirs{$d} = 1;
2892                 push @{$unified_info{dirinfo}->{$d}->{deps}}, $_
2893                     if $d ne $pd;
2894             }
2895             foreach (sort keys %dirs) {
2896                 push @{$unified_info{dirinfo}->{$_}->{products}->{$type}},
2897                     $product;
2898             }
2899         }
2900     }
2901 }
2902
2903 # For the schemes that need it, we provide the old *_obj configs
2904 # from the *_asm_obj ones
2905 foreach (grep /_(asm|aux)_src$/, keys %target) {
2906     my $src = $_;
2907     (my $obj = $_) =~ s/_(asm|aux)_src$/_obj/;
2908     $target{$obj} = $target{$src};
2909     $target{$obj} =~ s/\.[csS]\b/.o/g; # C and assembler
2910     $target{$obj} =~ s/\.(cc|cpp)\b/_cc.o/g; # C++
2911 }
2912
2913 # Write down our configuration where it fits #########################
2914
2915 my %template_vars = (
2916     config => \%config,
2917     target => \%target,
2918     disablables => \@disablables,
2919     disablables_int => \@disablables_int,
2920     disabled => \%disabled,
2921     withargs => \%withargs,
2922     unified_info => \%unified_info,
2923     tls => \@tls,
2924     dtls => \@dtls,
2925     makevars => [ sort keys %user ],
2926     disabled_info => \%disabled_info,
2927     user_crossable => \@user_crossable,
2928 );
2929 my $configdata_outname = 'configdata.pm';
2930 open CONFIGDATA, ">$configdata_outname.new"
2931     or die "Trying to create $configdata_outname.new: $!";
2932 my $configdata_tmplname = cleanfile($srcdir, "configdata.pm.in", $blddir, 1);
2933 my $configdata_tmpl =
2934     OpenSSL::Template->new(TYPE => 'FILE', SOURCE => $configdata_tmplname);
2935 $configdata_tmpl->fill_in(
2936     FILENAME => $configdata_tmplname,
2937     OUTPUT => \*CONFIGDATA,
2938     HASH => { %template_vars,
2939               autowarntext => [
2940                   'WARNING: do not edit!',
2941                   "Generated by Configure from $configdata_tmplname",
2942               ] }
2943 ) or die $Text::Template::ERROR;
2944 close CONFIGDATA;
2945
2946 rename "$configdata_outname.new", $configdata_outname;
2947 if ($builder_platform eq 'unix') {
2948     my $mode = (0755 & ~umask);
2949     chmod $mode, 'configdata.pm'
2950         or warn sprintf("WARNING: Couldn't change mode for 'configdata.pm' to 0%03o: %s\n",$mode,$!);
2951 }
2952 print "Created $configdata_outname\n";
2953
2954 print "Running $configdata_outname\n";
2955 my $perlcmd = (quotify("maybeshell", $config{PERL}))[0];
2956 my $cmd = "$perlcmd $configdata_outname";
2957 #print STDERR "DEBUG[run_dofile]: \$cmd = $cmd\n";
2958 system($cmd);
2959 exit 1 if $? != 0;
2960
2961 $SIG{__DIE__} = $orig_death_handler;
2962
2963 print <<"EOF" if ($disabled{threads} eq "unavailable");
2964
2965 The library could not be configured for supporting multi-threaded
2966 applications as the compiler options required on this system are not known.
2967 See file INSTALL.md for details if you need multi-threading.
2968 EOF
2969
2970 print <<"EOF" if ($no_shared_warn);
2971
2972 The options 'shared', 'pic' and 'dynamic-engine' aren't supported on this
2973 platform, so we will pretend you gave the option 'no-pic', which also disables
2974 'shared' and 'dynamic-engine'.  If you know how to implement shared libraries
2975 or position independent code, please let us know (but please first make sure
2976 you have tried with a current version of OpenSSL).
2977 EOF
2978
2979 print <<"EOF" if (!$disabled{qlog});
2980
2981 ============================== WARNING ===============================
2982
2983 WARNING: You have enabled qlog. This functionality is unstable and
2984     implements a draft version of the qlog specification. The qlog
2985     output from OpenSSL *will* change in incompatible ways in future,
2986     and is not subject to any format stability or compatibility
2987     guarantees at this time. See the manpage openssl-qlog(7) for
2988     details.
2989
2990 ============================== WARNING ===============================
2991
2992 EOF
2993
2994 print $banner;
2995
2996 exit(0);
2997
2998 ######################################################################
2999 #
3000 # Helpers and utility functions
3001 #
3002
3003 # Death handler, to print a helpful message in case of failure #######
3004 #
3005 sub death_handler {
3006     die @_ if $^S;              # To prevent the added message in eval blocks
3007     my $build_file = $config{build_file} // "build file";
3008     my @message = ( <<"_____", @_ );
3009
3010 Failure!  $build_file wasn't produced.
3011 Please read INSTALL.md and associated NOTES-* files.  You may also have to
3012 look over your available compiler tool chain or change your configuration.
3013
3014 _____
3015
3016     # Dying is terminal, so it's ok to reset the signal handler here.
3017     $SIG{__DIE__} = $orig_death_handler;
3018     die @message;
3019 }
3020
3021 # Configuration file reading #########################################
3022
3023 # Note: All of the helper functions are for lazy evaluation.  They all
3024 # return a CODE ref, which will return the intended value when evaluated.
3025 # Thus, whenever there's mention of a returned value, it's about that
3026 # intended value.
3027
3028 # Helper function to implement conditional value variants, with a default
3029 # plus additional values based on the value of $config{build_type}.
3030 # Arguments are given in hash table form:
3031 #
3032 #       picker(default => "Basic string: ",
3033 #              debug   => "debug",
3034 #              release => "release")
3035 #
3036 # When configuring with --debug, the resulting string will be
3037 # "Basic string: debug", and when not, it will be "Basic string: release"
3038 #
3039 # This can be used to create variants of sets of flags according to the
3040 # build type:
3041 #
3042 #       cflags => picker(default => "-Wall",
3043 #                        debug   => "-g -O0",
3044 #                        release => "-O3")
3045 #
3046 sub picker {
3047     my %opts = @_;
3048     return sub { add($opts{default} || (),
3049                      $opts{$config{build_type}} || ())->(); }
3050 }
3051
3052 # Helper function to combine several values of different types into one.
3053 # This is useful if you want to combine a string with the result of a
3054 # lazy function, such as:
3055 #
3056 #       cflags => combine("-Wall", sub { $disabled{zlib} ? () : "-DZLIB" })
3057 #
3058 sub combine {
3059     my @stuff = @_;
3060     return sub { add(@stuff)->(); }
3061 }
3062
3063 # Helper function to implement conditional values depending on the value
3064 # of $disabled{threads}.  Can be used as follows:
3065 #
3066 #       cflags => combine("-Wall", threads("-pthread"))
3067 #
3068 sub threads {
3069     my @flags = @_;
3070     return sub { add($disabled{threads} ? () : @flags)->(); }
3071 }
3072
3073 sub shared {
3074     my @flags = @_;
3075     return sub { add($disabled{shared} ? () : @flags)->(); }
3076 }
3077
3078 our $add_called = 0;
3079 # Helper function to implement adding values to already existing configuration
3080 # values.  It handles elements that are ARRAYs, CODEs and scalars
3081 sub _add {
3082     my $separator = shift;
3083
3084     # If there's any ARRAY in the collection of values OR the separator
3085     # is undef, we will return an ARRAY of combined values, otherwise a
3086     # string of joined values with $separator as the separator.
3087     my $found_array = !defined($separator);
3088
3089     my @values =
3090         map {
3091             my $res = $_;
3092             while (ref($res) eq "CODE") {
3093                 $res = $res->();
3094             }
3095             if (defined($res)) {
3096                 if (ref($res) eq "ARRAY") {
3097                     $found_array = 1;
3098                     @$res;
3099                 } else {
3100                     $res;
3101                 }
3102             } else {
3103                 ();
3104             }
3105     } (@_);
3106
3107     $add_called = 1;
3108
3109     if ($found_array) {
3110         [ @values ];
3111     } else {
3112         join($separator, grep { defined($_) && $_ ne "" } @values);
3113     }
3114 }
3115 sub add_before {
3116     my $separator = " ";
3117     if (ref($_[$#_]) eq "HASH") {
3118         my $opts = pop;
3119         $separator = $opts->{separator};
3120     }
3121     my @x = @_;
3122     sub { _add($separator, @x, @_) };
3123 }
3124 sub add {
3125     my $separator = " ";
3126     if (ref($_[$#_]) eq "HASH") {
3127         my $opts = pop;
3128         $separator = $opts->{separator};
3129     }
3130     my @x = @_;
3131     sub { _add($separator, @_, @x) };
3132 }
3133
3134 sub read_eval_file {
3135     my $fname = shift;
3136     my $content;
3137     my @result;
3138
3139     open F, "< $fname" or die "Can't open '$fname': $!\n";
3140     {
3141         undef local $/;
3142         $content = <F>;
3143     }
3144     close F;
3145     {
3146         local $@;
3147
3148         @result = ( eval $content );
3149         warn $@ if $@;
3150     }
3151     return wantarray ? @result : $result[0];
3152 }
3153
3154 # configuration reader, evaluates the input file as a perl script and expects
3155 # it to fill %targets with target configurations.  Those are then added to
3156 # %table.
3157 sub read_config {
3158     my $fname = shift;
3159     my %targets;
3160
3161     {
3162         # Protect certain tables from tampering
3163         local %table = ();
3164
3165         %targets = read_eval_file($fname);
3166     }
3167     my %preexisting = ();
3168     foreach (sort keys %targets) {
3169         $preexisting{$_} = 1 if $table{$_};
3170     }
3171     die <<"EOF",
3172 The following config targets from $fname
3173 shadow pre-existing config targets with the same name:
3174 EOF
3175         map { "  $_\n" } sort keys %preexisting
3176         if %preexisting;
3177
3178
3179     # For each target, check that it's configured with a hash table.
3180     foreach (keys %targets) {
3181         if (ref($targets{$_}) ne "HASH") {
3182             if (ref($targets{$_}) eq "") {
3183                 warn "Deprecated target configuration for $_, ignoring...\n";
3184             } else {
3185                 warn "Misconfigured target configuration for $_ (should be a hash table), ignoring...\n";
3186             }
3187             delete $targets{$_};
3188         } else {
3189             $targets{$_}->{_conf_fname_int} = add([ $fname ]);
3190         }
3191     }
3192
3193     %table = (%table, %targets);
3194
3195 }
3196
3197 # configuration resolver.  Will only resolve all the lazy evaluation
3198 # codeblocks for the chosen target and all those it inherits from,
3199 # recursively
3200 sub resolve_config {
3201     my $target = shift;
3202     my @breadcrumbs = @_;
3203
3204 #    my $extra_checks = defined($ENV{CONFIGURE_EXTRA_CHECKS});
3205
3206     if (grep { $_ eq $target } @breadcrumbs) {
3207         die "inherit_from loop!  target backtrace:\n  "
3208             ,$target,"\n  ",join("\n  ", @breadcrumbs),"\n";
3209     }
3210
3211     if (!defined($table{$target})) {
3212         warn "Warning! target $target doesn't exist!\n";
3213         return ();
3214     }
3215     # Recurse through all inheritances.  They will be resolved on the
3216     # fly, so when this operation is done, they will all just be a
3217     # bunch of attributes with string values.
3218     # What we get here, though, are keys with references to lists of
3219     # the combined values of them all.  We will deal with lists after
3220     # this stage is done.
3221     my %combined_inheritance = ();
3222     if ($table{$target}->{inherit_from}) {
3223         my @inherit_from =
3224             map { ref($_) eq "CODE" ? $_->() : $_ } @{$table{$target}->{inherit_from}};
3225         foreach (@inherit_from) {
3226             my %inherited_config = resolve_config($_, $target, @breadcrumbs);
3227
3228             # 'template' is a marker that's considered private to
3229             # the config that had it.
3230             delete $inherited_config{template};
3231
3232             foreach (keys %inherited_config) {
3233                 if (!$combined_inheritance{$_}) {
3234                     $combined_inheritance{$_} = [];
3235                 }
3236                 push @{$combined_inheritance{$_}}, $inherited_config{$_};
3237             }
3238         }
3239     }
3240
3241     # We won't need inherit_from in this target any more, since we've
3242     # resolved all the inheritances that lead to this
3243     delete $table{$target}->{inherit_from};
3244
3245     # Now is the time to deal with those lists.  Here's the place to
3246     # decide what shall be done with those lists, all based on the
3247     # values of the target we're currently dealing with.
3248     # - If a value is a coderef, it will be executed with the list of
3249     #   inherited values as arguments.
3250     # - If the corresponding key doesn't have a value at all or is the
3251     #   empty string, the inherited value list will be run through the
3252     #   default combiner (below), and the result becomes this target's
3253     #   value.
3254     # - Otherwise, this target's value is assumed to be a string that
3255     #   will simply override the inherited list of values.
3256     my $default_combiner = add();
3257
3258     my %all_keys =
3259         map { $_ => 1 } (keys %combined_inheritance,
3260                          keys %{$table{$target}});
3261
3262     sub process_values {
3263         my $object    = shift;
3264         my $inherited = shift;  # Always a [ list ]
3265         my $target    = shift;
3266         my $entry     = shift;
3267
3268         $add_called = 0;
3269
3270         while(ref($object) eq "CODE") {
3271             $object = $object->(@$inherited);
3272         }
3273         if (!defined($object)) {
3274             return ();
3275         }
3276         elsif (ref($object) eq "ARRAY") {
3277             local $add_called;  # To make sure recursive calls don't affect it
3278             return [ map { process_values($_, $inherited, $target, $entry) }
3279                      @$object ];
3280         } elsif (ref($object) eq "") {
3281             return $object;
3282         } else {
3283             die "cannot handle reference type ",ref($object)
3284                 ," found in target ",$target," -> ",$entry,"\n";
3285         }
3286     }
3287
3288     foreach my $key (sort keys %all_keys) {
3289         my $previous = $combined_inheritance{$key};
3290
3291         # Current target doesn't have a value for the current key?
3292         # Assign it the default combiner, the rest of this loop body
3293         # will handle it just like any other coderef.
3294         if (!exists $table{$target}->{$key}) {
3295             $table{$target}->{$key} = $default_combiner;
3296         }
3297
3298         $table{$target}->{$key} = process_values($table{$target}->{$key},
3299                                                $combined_inheritance{$key},
3300                                                $target, $key);
3301         unless(defined($table{$target}->{$key})) {
3302             delete $table{$target}->{$key};
3303         }
3304 #        if ($extra_checks &&
3305 #            $previous && !($add_called ||  $previous ~~ $table{$target}->{$key})) {
3306 #            warn "$key got replaced in $target\n";
3307 #        }
3308     }
3309
3310     # Finally done, return the result.
3311     return %{$table{$target}};
3312 }
3313
3314 sub usage
3315         {
3316         print STDERR $usage;
3317         print STDERR "\npick os/compiler from:\n";
3318         my $j=0;
3319         my $i;
3320         my $k=0;
3321         foreach $i (sort keys %table)
3322                 {
3323                 next if $table{$i}->{template};
3324                 next if $i =~ /^debug/;
3325                 $k += length($i) + 1;
3326                 if ($k > 78)
3327                         {
3328                         print STDERR "\n";
3329                         $k=length($i);
3330                         }
3331                 print STDERR $i . " ";
3332                 }
3333         foreach $i (sort keys %table)
3334                 {
3335                 next if $table{$i}->{template};
3336                 next if $i !~ /^debug/;
3337                 $k += length($i) + 1;
3338                 if ($k > 78)
3339                         {
3340                         print STDERR "\n";
3341                         $k=length($i);
3342                         }
3343                 print STDERR $i . " ";
3344                 }
3345         exit(1);
3346         }
3347
3348 sub compiler_predefined {
3349     state %predefined;
3350     my $cc = shift;
3351
3352     return () if $^O eq 'VMS';
3353
3354     die 'compiler_predefined called without a compiler command'
3355         unless $cc;
3356
3357     if (! $predefined{$cc}) {
3358
3359         $predefined{$cc} = {};
3360
3361         # collect compiler pre-defines from gcc or gcc-alike...
3362         open(PIPE, "$cc -dM -E -x c /dev/null 2>&1 |");
3363         while (my $l = <PIPE>) {
3364             $l =~ m/^#define\s+(\w+(?:\(\w+\))?)(?:\s+(.+))?/ or last;
3365             $predefined{$cc}->{$1} = $2 // '';
3366         }
3367         close(PIPE);
3368     }
3369
3370     return %{$predefined{$cc}};
3371 }
3372
3373 sub which
3374 {
3375     my ($name)=@_;
3376
3377     if (eval { require IPC::Cmd; 1; }) {
3378         IPC::Cmd->import();
3379         return scalar IPC::Cmd::can_run($name);
3380     } else {
3381         # if there is $directories component in splitpath,
3382         # then it's not something to test with $PATH...
3383         return $name if (File::Spec->splitpath($name))[1];
3384
3385         foreach (File::Spec->path()) {
3386             my $fullpath = catfile($_, "$name$target{exe_extension}");
3387             if (-f $fullpath and -x $fullpath) {
3388                 return $fullpath;
3389             }
3390         }
3391     }
3392 }
3393
3394 sub env
3395 {
3396     my $name = shift;
3397     my %opts = @_;
3398
3399     unless ($opts{cacheonly}) {
3400         # Note that if $ENV{$name} doesn't exist or is undefined,
3401         # $config{perlenv}->{$name} will be created with the value
3402         # undef.  This is intentional.
3403
3404         $config{perlenv}->{$name} = $ENV{$name}
3405             if ! exists $config{perlenv}->{$name};
3406     }
3407     return $config{perlenv}->{$name};
3408 }
3409
3410 # Configuration printer ##############################################
3411
3412 sub print_table_entry
3413 {
3414     local $now_printing = shift;
3415     my %target = resolve_config($now_printing);
3416     my $type = shift;
3417
3418     # Don't print the templates
3419     return if $target{template};
3420
3421     my @sequence = (
3422         "sys_id",
3423         "cpp",
3424         "cppflags",
3425         "defines",
3426         "includes",
3427         "cc",
3428         "cflags",
3429         "ld",
3430         "lflags",
3431         "loutflag",
3432         "ex_libs",
3433         "bn_ops",
3434         "enable",
3435         "disable",
3436         "poly1035_asm_src",
3437         "thread_scheme",
3438         "perlasm_scheme",
3439         "dso_scheme",
3440         "shared_target",
3441         "shared_cflag",
3442         "shared_defines",
3443         "shared_ldflag",
3444         "shared_rcflag",
3445         "shared_extension",
3446         "dso_extension",
3447         "obj_extension",
3448         "exe_extension",
3449         "ranlib",
3450         "ar",
3451         "arflags",
3452         "aroutflag",
3453         "rc",
3454         "rcflags",
3455         "rcoutflag",
3456         "mt",
3457         "mtflags",
3458         "mtinflag",
3459         "mtoutflag",
3460         "multilib",
3461         "build_scheme",
3462         );
3463
3464     if ($type eq "TABLE") {
3465         print "\n";
3466         print "*** $now_printing\n";
3467         foreach (@sequence) {
3468             if (ref($target{$_}) eq "ARRAY") {
3469                 printf "\$%-12s = %s\n", $_, join(" ", @{$target{$_}});
3470             } else {
3471                 printf "\$%-12s = %s\n", $_, $target{$_};
3472             }
3473         }
3474     } elsif ($type eq "HASH") {
3475         my $largest =
3476             length((sort { length($a) <=> length($b) } @sequence)[-1]);
3477         print "    '$now_printing' => {\n";
3478         foreach (@sequence) {
3479             if ($target{$_}) {
3480                 if (ref($target{$_}) eq "ARRAY") {
3481                     print "      '",$_,"'"," " x ($largest - length($_))," => [ ",join(", ", map { "'$_'" } @{$target{$_}})," ],\n";
3482                 } else {
3483                     print "      '",$_,"'"," " x ($largest - length($_))," => '",$target{$_},"',\n";
3484                 }
3485             }
3486         }
3487         print "    },\n";
3488     }
3489 }
3490
3491 # Utility routines ###################################################
3492
3493 # On VMS, if the given file is a logical name, File::Spec::Functions
3494 # will consider it an absolute path.  There are cases when we want a
3495 # purely syntactic check without checking the environment.
3496 sub isabsolute {
3497     my $file = shift;
3498
3499     # On non-platforms, we just use file_name_is_absolute().
3500     return file_name_is_absolute($file) unless $^O eq "VMS";
3501
3502     # If the file spec includes a device or a directory spec,
3503     # file_name_is_absolute() is perfectly safe.
3504     return file_name_is_absolute($file) if $file =~ m|[:\[]|;
3505
3506     # Here, we know the given file spec isn't absolute
3507     return 0;
3508 }
3509
3510 # Makes a directory absolute and cleans out /../ in paths like foo/../bar
3511 # On some platforms, this uses rel2abs(), while on others, realpath() is used.
3512 # realpath() requires that at least all path components except the last is an
3513 # existing directory.  On VMS, the last component of the directory spec must
3514 # exist.
3515 sub absolutedir {
3516     my $dir = shift;
3517
3518     # realpath() is quite buggy on VMS.  It uses LIB$FID_TO_NAME, which
3519     # will return the volume name for the device, no matter what.  Also,
3520     # it will return an incorrect directory spec if the argument is a
3521     # directory that doesn't exist.
3522     if ($^O eq "VMS") {
3523         return rel2abs($dir);
3524     }
3525
3526     # We use realpath() on Unix, since no other will properly clean out
3527     # a directory spec.
3528     use Cwd qw/realpath/;
3529
3530     return realpath($dir);
3531 }
3532
3533 # Check if all paths are one and the same, using stat.  They must both exist
3534 # We need this for the cases when File::Spec doesn't detect case insensitivity
3535 # (File::Spec::Unix assumes case sensitivity)
3536 sub samedir {
3537     die "samedir expects two arguments\n" unless scalar @_ == 2;
3538
3539     my @stat0 = stat($_[0]);    # First argument
3540     my @stat1 = stat($_[1]);    # Second argument
3541
3542     die "Couldn't stat $_[0]" unless @stat0;
3543     die "Couldn't stat $_[1]" unless @stat1;
3544
3545     # Compare device number
3546     return 0 unless ($stat0[0] == $stat1[0]);
3547     # Compare "inode".  The perl manual recommends comparing as
3548     # string rather than as number.
3549     return 0 unless ($stat0[1] eq $stat1[1]);
3550
3551     return 1;                   # All the same
3552 }
3553
3554 sub quotify {
3555     my %processors = (
3556         perl    => sub { my $x = shift;
3557                          $x =~ s/([\\\$\@"])/\\$1/g;
3558                          return '"'.$x.'"'; },
3559         maybeshell => sub { my $x = shift;
3560                             (my $y = $x) =~ s/([\\\"])/\\$1/g;
3561                             if ($x ne $y || $x =~ m|\s|) {
3562                                 return '"'.$y.'"';
3563                             } else {
3564                                 return $x;
3565                             }
3566                         },
3567         );
3568     my $for = shift;
3569     my $processor =
3570         defined($processors{$for}) ? $processors{$for} : sub { shift; };
3571
3572     return map { $processor->($_); } @_;
3573 }
3574
3575 # collect_from_file($filename, $line_concat_cond_re, $line_concat)
3576 # $filename is a file name to read from
3577 # $line_concat_cond_re is a regexp detecting a line continuation ending
3578 # $line_concat is a CODEref that takes care of concatenating two lines
3579 sub collect_from_file {
3580     my $filename = shift;
3581     my $line_concat_cond_re = shift;
3582     my $line_concat = shift;
3583
3584     open my $fh, $filename || die "unable to read $filename: $!\n";
3585     return sub {
3586         my $saved_line = "";
3587         $_ = "";
3588         while (<$fh>) {
3589             s|\R$||;
3590             if (defined $line_concat) {
3591                 $_ = $line_concat->($saved_line, $_);
3592                 $saved_line = "";
3593             }
3594             if (defined $line_concat_cond_re && /$line_concat_cond_re/) {
3595                 $saved_line = $_;
3596                 next;
3597             }
3598             return $_;
3599         }
3600         die "$filename ending with continuation line\n" if $_;
3601         close $fh;
3602         return undef;
3603     }
3604 }
3605
3606 # collect_from_array($array, $line_concat_cond_re, $line_concat)
3607 # $array is an ARRAYref of lines
3608 # $line_concat_cond_re is a regexp detecting a line continuation ending
3609 # $line_concat is a CODEref that takes care of concatenating two lines
3610 sub collect_from_array {
3611     my $array = shift;
3612     my $line_concat_cond_re = shift;
3613     my $line_concat = shift;
3614     my @array = (@$array);
3615
3616     return sub {
3617         my $saved_line = "";
3618         $_ = "";
3619         while (defined($_ = shift @array)) {
3620             s|\R$||;
3621             if (defined $line_concat) {
3622                 $_ = $line_concat->($saved_line, $_);
3623                 $saved_line = "";
3624             }
3625             if (defined $line_concat_cond_re && /$line_concat_cond_re/) {
3626                 $saved_line = $_;
3627                 next;
3628             }
3629             return $_;
3630         }
3631         die "input text ending with continuation line\n" if $_;
3632         return undef;
3633     }
3634 }
3635
3636 # collect_information($lineiterator, $line_continue, $regexp => $CODEref, ...)
3637 # $lineiterator is a CODEref that delivers one line at a time.
3638 # All following arguments are regex/CODEref pairs, where the regexp detects a
3639 # line and the CODEref does something with the result of the regexp.
3640 sub collect_information {
3641     my $lineiterator = shift;
3642     my %collectors = @_;
3643
3644     while(defined($_ = $lineiterator->())) {
3645         s|\R$||;
3646         my $found = 0;
3647         if ($collectors{"BEFORE"}) {
3648             $collectors{"BEFORE"}->($_);
3649         }
3650         foreach my $re (keys %collectors) {
3651             if ($re !~ /^OTHERWISE|BEFORE|AFTER$/ && /$re/) {
3652                 $collectors{$re}->($lineiterator);
3653                 $found = 1;
3654             };
3655         }
3656         if ($collectors{"OTHERWISE"}) {
3657             $collectors{"OTHERWISE"}->($lineiterator, $_)
3658                 unless $found || !defined $collectors{"OTHERWISE"};
3659         }
3660         if ($collectors{"AFTER"}) {
3661             $collectors{"AFTER"}->($_);
3662         }
3663     }
3664 }
3665
3666 # tokenize($line)
3667 # tokenize($line,$separator)
3668 # $line is a line of text to split up into tokens
3669 # $separator [optional] is a regular expression that separates the tokens,
3670 # the default being spaces.  Do not use quotes of any kind as separators,
3671 # that will give undefined results.
3672 # Returns a list of tokens.
3673 #
3674 # Tokens are divided by separator (spaces by default).  If the tokens include
3675 # the separators, they have to be quoted with single or double quotes.
3676 # Double quotes inside a double quoted token must be escaped.  Escaping is done
3677 # with backslash.
3678 # Basically, the same quoting rules apply for " and ' as in any
3679 # Unix shell.
3680 sub tokenize {
3681     my $line = my $debug_line = shift;
3682     my $separator = shift // qr|\s+|;
3683     my @result = ();
3684
3685     if ($ENV{CONFIGURE_DEBUG_TOKENIZE}) {
3686         print STDERR "DEBUG[tokenize]: \$separator = $separator\n";
3687     }
3688
3689     while ($line =~ s|^${separator}||, $line ne "") {
3690         my $token = "";
3691     again:
3692         $line =~ m/^(.*?)(${separator}|"|'|$)/;
3693         $token .= $1;
3694         $line = $2.$';
3695
3696         if ($line =~ m/^"((?:[^"\\]+|\\.)*)"/) {
3697             $token .= $1;
3698             $line = $';
3699             goto again;
3700         } elsif ($line =~ m/^'([^']*)'/) {
3701             $token .= $1;
3702             $line = $';
3703             goto again;
3704         }
3705         push @result, $token;
3706     }
3707
3708     if ($ENV{CONFIGURE_DEBUG_TOKENIZE}) {
3709         print STDERR "DEBUG[tokenize]: Parsed '$debug_line' into:\n";
3710         print STDERR "DEBUG[tokenize]: ('", join("', '", @result), "')\n";
3711     }
3712     return @result;
3713 }