1 #!/usr/local/bin/perl -w
5 # It does this by parsing the header files and looking for the
6 # prototyped functions: it then prunes the output.
8 # Intermediary files are created, call libeay.num and ssleay.num,...
9 # Previously, they had the following format:
13 # But that isn't enough for a number of reasons, the first on being that
14 # this format is (needlessly) very Win32-centric, and even then...
15 # One of the biggest problems is that there's no information about what
16 # routines should actually be used, which varies with what crypto algorithms
17 # are disabled. Also, some operating systems (for example VMS with VAX C)
18 # need to keep track of the global variables as well as the functions.
20 # So, a remake of this script is done so as to include information on the
21 # kind of symbol it is (function or variable) and what algorithms they're
22 # part of. This will allow easy translating to .def files or the corresponding
23 # file in other operating systems (a .opt file for VMS, possibly with a .mar
26 # The format now becomes:
28 # routine-name nnnn info
30 # and the "info" part is actually a colon-separated string of fields with
31 # the following meaning:
33 # existence:platform:kind:algorithms
35 # - "existence" can be "EXIST" or "NOEXIST" depending on if the symbol is
36 # found somewhere in the source,
37 # - "platforms" is empty if it exists on all platforms, otherwise it contains
38 # comma-separated list of the platform, just as they are if the symbol exists
39 # for those platforms, or prepended with a "!" if not. This helps resolve
40 # symbol name variants for platforms where the names are too long for the
41 # compiler or linker, or if the systems is case insensitive and there is a
42 # clash, or the symbol is implemented differently (see
43 # EXPORT_VAR_AS_FUNCTION). This script assumes renaming of symbols is found
44 # in the file crypto/symhacks.h.
45 # The semantics for the platforms is that every item is checked against the
46 # environment. For the negative items ("!FOO"), if any of them is false
47 # (i.e. "FOO" is true) in the environment, the corresponding symbol can't be
48 # used. For the positive itms, if all of them are false in the environment,
49 # the corresponding symbol can't be used. Any combination of positive and
50 # negative items are possible, and of course leave room for some redundancy.
51 # - "kind" is "FUNCTION" or "VARIABLE". The meaning of that is obvious.
52 # - "algorithms" is a comma-separated list of algorithm names. This helps
53 # exclude symbols that are part of an algorithm that some user wants to
59 my $crypto_num= "util/libeay.num";
60 my $ssl_num= "util/ssleay.num";
69 my $do_checkexist = 0;
78 # Set this to make typesafe STACK definitions appear in DEF
79 my $safe_stack_def = 0;
81 my @known_platforms = ( "__FreeBSD__", "PERL5", "NeXT",
82 "EXPORT_VAR_AS_FUNCTION", "OPENSSL_FIPS" );
83 my @known_ossl_platforms = ( "VMS", "WIN16", "WIN32", "WINNT", "OS2" );
84 my @known_algorithms = ( "RC2", "RC4", "RC5", "IDEA", "DES", "BF",
85 "CAST", "MD2", "MD4", "MD5", "SHA", "SHA0", "SHA1",
87 "MDC2", "RSA", "DSA", "DH", "EC", "HMAC", "AES",
88 # Envelope "algorithms"
89 "EVP", "X509", "ASN1_TYPEDEFS",
91 "BIO", "COMP", "BUFFER", "LHASH", "STACK", "ERR",
93 # External "algorithms"
94 "FP_API", "STDIO", "SOCK", "KRB5", "ENGINE", "HW" );
97 open(IN,"<Makefile") || die "unable to open Makefile!\n";
99 $options=$1 if (/^OPTIONS=(.*)$/);
103 # The following ciphers may be excluded (by Configure). This means functions
104 # defined with ifndef(NO_XXX) are not included in the .def file, and everything
105 # in directory xxx is ignored.
106 my $no_rc2; my $no_rc4; my $no_rc5; my $no_idea; my $no_des; my $no_bf;
108 my $no_md2; my $no_md4; my $no_md5; my $no_sha; my $no_ripemd; my $no_mdc2;
109 my $no_rsa; my $no_dsa; my $no_dh; my $no_hmac=0; my $no_aes; my $no_krb5;
110 my $no_ec; my $no_engine; my $no_hw;
114 foreach (@ARGV, split(/ /, $options))
116 $debug=1 if $_ eq "debug";
117 $W32=1 if $_ eq "32";
118 $W16=1 if $_ eq "16";
123 if ($_ eq "VMS-VAX") {
127 if ($_ eq "VMS-Alpha") {
131 $VMS=1 if $_ eq "VMS";
132 $OS2=1 if $_ eq "OS2";
133 $fips=1 if $_ eq "fips";
135 $do_ssl=1 if $_ eq "ssleay";
140 $do_crypto=1 if $_ eq "libeay";
141 if ($_ eq "crypto") {
145 $do_update=1 if $_ eq "update";
146 $do_rewrite=1 if $_ eq "rewrite";
147 $do_ctest=1 if $_ eq "ctest";
148 $do_ctestall=1 if $_ eq "ctestall";
149 $do_checkexist=1 if $_ eq "exist";
150 #$safe_stack_def=1 if $_ eq "-DDEBUG_SAFESTACK";
152 if (/^no-rc2$/) { $no_rc2=1; }
153 elsif (/^no-rc4$/) { $no_rc4=1; }
154 elsif (/^no-rc5$/) { $no_rc5=1; }
155 elsif (/^no-idea$/) { $no_idea=1; }
156 elsif (/^no-des$/) { $no_des=1; $no_mdc2=1; }
157 elsif (/^no-bf$/) { $no_bf=1; }
158 elsif (/^no-cast$/) { $no_cast=1; }
159 elsif (/^no-md2$/) { $no_md2=1; }
160 elsif (/^no-md4$/) { $no_md4=1; }
161 elsif (/^no-md5$/) { $no_md5=1; }
162 elsif (/^no-sha$/) { $no_sha=1; }
163 elsif (/^no-ripemd$/) { $no_ripemd=1; }
164 elsif (/^no-mdc2$/) { $no_mdc2=1; }
165 elsif (/^no-rsa$/) { $no_rsa=1; }
166 elsif (/^no-dsa$/) { $no_dsa=1; }
167 elsif (/^no-dh$/) { $no_dh=1; }
168 elsif (/^no-ec$/) { $no_ec=1; }
169 elsif (/^no-hmac$/) { $no_hmac=1; }
170 elsif (/^no-aes$/) { $no_aes=1; }
171 elsif (/^no-evp$/) { $no_evp=1; }
172 elsif (/^no-lhash$/) { $no_lhash=1; }
173 elsif (/^no-stack$/) { $no_stack=1; }
174 elsif (/^no-err$/) { $no_err=1; }
175 elsif (/^no-buffer$/) { $no_buffer=1; }
176 elsif (/^no-bio$/) { $no_bio=1; }
177 #elsif (/^no-locking$/) { $no_locking=1; }
178 elsif (/^no-comp$/) { $no_comp=1; }
179 elsif (/^no-dso$/) { $no_dso=1; }
180 elsif (/^no-krb5$/) { $no_krb5=1; }
181 elsif (/^no-engine$/) { $no_engine=1; }
182 elsif (/^no-hw$/) { $no_hw=1; }
195 # If no platform is given, assume WIN32
196 if ($W32 + $W16 + $VMS + $OS2 == 0) {
200 # Add extra knowledge
205 if (!$do_ssl && !$do_crypto)
207 print STDERR "usage: $0 ( ssl | crypto ) [ 16 | 32 | NT | OS2 ]\n";
211 %ssl_list=&load_numbers($ssl_num);
213 %crypto_list=&load_numbers($crypto_num);
214 $max_crypto = $max_num;
219 my $crypto ="crypto/crypto.h";
220 $crypto.=" crypto/des/des.h crypto/des/des_old.h" ; # unless $no_des;
221 $crypto.=" crypto/idea/idea.h" ; # unless $no_idea;
222 $crypto.=" crypto/rc4/rc4.h" ; # unless $no_rc4;
223 $crypto.=" crypto/rc5/rc5.h" ; # unless $no_rc5;
224 $crypto.=" crypto/rc2/rc2.h" ; # unless $no_rc2;
225 $crypto.=" crypto/bf/blowfish.h" ; # unless $no_bf;
226 $crypto.=" crypto/cast/cast.h" ; # unless $no_cast;
227 $crypto.=" crypto/md2/md2.h" ; # unless $no_md2;
228 $crypto.=" crypto/md4/md4.h" ; # unless $no_md4;
229 $crypto.=" crypto/md5/md5.h" ; # unless $no_md5;
230 $crypto.=" crypto/mdc2/mdc2.h" ; # unless $no_mdc2;
231 $crypto.=" crypto/sha/sha.h" ; # unless $no_sha;
232 $crypto.=" crypto/ripemd/ripemd.h" ; # unless $no_ripemd;
233 $crypto.=" crypto/aes/aes.h" ; # unless $no_aes;
235 $crypto.=" crypto/bn/bn.h";
236 $crypto.=" crypto/rsa/rsa.h" ; # unless $no_rsa;
237 $crypto.=" crypto/dsa/dsa.h" ; # unless $no_dsa;
238 $crypto.=" crypto/dh/dh.h" ; # unless $no_dh;
239 $crypto.=" crypto/ec/ec.h" ; # unless $no_ec;
240 $crypto.=" crypto/hmac/hmac.h" ; # unless $no_hmac;
242 $crypto.=" crypto/engine/engine.h"; # unless $no_engine;
243 $crypto.=" crypto/stack/stack.h" ; # unless $no_stack;
244 $crypto.=" crypto/buffer/buffer.h" ; # unless $no_buffer;
245 $crypto.=" crypto/bio/bio.h" ; # unless $no_bio;
246 $crypto.=" crypto/dso/dso.h" ; # unless $no_dso;
247 $crypto.=" crypto/lhash/lhash.h" ; # unless $no_lhash;
248 $crypto.=" crypto/conf/conf.h";
249 $crypto.=" crypto/txt_db/txt_db.h";
251 $crypto.=" crypto/evp/evp.h" ; # unless $no_evp;
252 $crypto.=" crypto/objects/objects.h";
253 $crypto.=" crypto/pem/pem.h";
254 #$crypto.=" crypto/meth/meth.h";
255 $crypto.=" crypto/asn1/asn1.h";
256 $crypto.=" crypto/asn1/asn1t.h";
257 $crypto.=" crypto/asn1/asn1_mac.h";
258 $crypto.=" crypto/err/err.h" ; # unless $no_err;
259 $crypto.=" crypto/pkcs7/pkcs7.h";
260 $crypto.=" crypto/pkcs12/pkcs12.h";
261 $crypto.=" crypto/x509/x509.h";
262 $crypto.=" crypto/x509/x509_vfy.h";
263 $crypto.=" crypto/x509v3/x509v3.h";
264 $crypto.=" crypto/rand/rand.h";
265 $crypto.=" crypto/comp/comp.h" ; # unless $no_comp;
266 $crypto.=" crypto/ocsp/ocsp.h";
267 $crypto.=" crypto/ui/ui.h crypto/ui/ui_compat.h";
268 $crypto.=" crypto/krb5/krb5_asn.h";
269 $crypto.=" crypto/tmdiff.h";
270 $crypto.=" fips/fips.h fips/rand/fips_rand.h";
272 my $symhacks="crypto/symhacks.h";
274 my @ssl_symbols = &do_defs("SSLEAY", $ssl, $symhacks);
275 my @crypto_symbols = &do_defs("LIBEAY", $crypto, $symhacks);
281 &maybe_add_info("SSLEAY",*ssl_list,@ssl_symbols);
282 if ($do_rewrite == 1) {
283 open(OUT, ">$ssl_num");
284 &rewrite_numbers(*OUT,"SSLEAY",*ssl_list,@ssl_symbols);
286 open(OUT, ">>$ssl_num");
288 &update_numbers(*OUT,"SSLEAY",*ssl_list,$max_ssl,@ssl_symbols);
292 if($do_crypto == 1) {
294 &maybe_add_info("LIBEAY",*crypto_list,@crypto_symbols);
295 if ($do_rewrite == 1) {
296 open(OUT, ">$crypto_num");
297 &rewrite_numbers(*OUT,"LIBEAY",*crypto_list,@crypto_symbols);
299 open(OUT, ">>$crypto_num");
301 &update_numbers(*OUT,"LIBEAY",*crypto_list,$max_crypto,@crypto_symbols);
305 } elsif ($do_checkexist) {
306 &check_existing(*ssl_list, @ssl_symbols)
308 &check_existing(*crypto_list, @crypto_symbols)
310 } elsif ($do_ctest || $do_ctestall) {
314 /* Test file to check all DEF file symbols are present by trying
315 * to link to all of them. This is *not* intended to be run!
321 &print_test_file(*STDOUT,"SSLEAY",*ssl_list,$do_ctestall,@ssl_symbols)
324 &print_test_file(*STDOUT,"LIBEAY",*crypto_list,$do_ctestall,@crypto_symbols)
331 &print_def_file(*STDOUT,$libname,*ssl_list,@ssl_symbols)
334 &print_def_file(*STDOUT,$libname,*crypto_list,@crypto_symbols)
342 my($name,$files,$symhacksfile)=@_;
346 my %platform; # For anything undefined, we assume ""
347 my %kind; # For anything undefined, we assume "FUNCTION"
348 my %algorithm; # For anything undefined, we assume ""
350 my %variant_cnt; # To be able to allocate "name{n}" if "name"
351 # is the same name as the original.
353 my %unknown_algorithms = ();
355 foreach $file (split(/\s+/,$symhacksfile." ".$files))
357 print STDERR "DEBUG: starting on $file:\n" if $debug;
358 open(IN,"<$file") || die "unable to open $file:$!\n";
359 my $line = "", my $def= "";
361 (map { $_ => 0 } @known_platforms),
362 (map { "OPENSSL_SYS_".$_ => 0 } @known_ossl_platforms),
363 (map { "OPENSSL_NO_".$_ => 0 } @known_algorithms),
370 my $symhacking = $file eq $symhacksfile;
371 my @current_platforms = ();
372 my @current_algorithms = ();
374 # params: symbol, alias, platforms, kind
375 # The reason to put this subroutine in a variable is that
376 # it will otherwise create it's own, unshared, version of
377 # %tag and %variant...
378 my $make_variant = sub
380 my ($s, $a, $p, $k) = @_;
383 print STDERR "DEBUG: make_variant: Entered with ",$s,", ",$a,", ",(defined($p)?$p:""),", ",(defined($k)?$k:""),"\n" if $debug;
388 map { $tag{$_} == 1 ? $_ : "" }
395 map { $tag{$_} == 1 ? $_ : "" }
400 map { $tag{"OPENSSL_SYS_".$_} == 1 ? $_ : "" }
401 @known_ossl_platforms));
402 print STDERR "DEBUG: make_variant: a1 = $a1; a2 = $a2\n" if $debug;
403 if ($a1 eq "") { $a1 = $a2; }
404 elsif ($a1 ne "" && $a2 ne "") { $a1 .= ",".$a2; }
407 if (!defined($variant_cnt{$s}))
409 $variant_cnt{$s} = 0;
412 $a .= "{$variant_cnt{$s}}";
414 my $toadd = $a.":".$a1.(defined($k)?":".$k:"");
415 my $togrep = $s.'(\{[0-9]+\})?:'.$a1.(defined($k)?":".$k:"");
416 if (!grep(/^$togrep$/,
417 split(/;/, defined($variant{$s})?$variant{$s}:""))) {
418 if (defined($variant{$s})) { $variant{$s} .= ";"; }
419 $variant{$s} .= $toadd;
421 print STDERR "DEBUG: make_variant: Exit with variant of ",$s," = ",$variant{$s},"\n" if $debug;
424 print STDERR "DEBUG: parsing ----------\n" if $debug;
426 last if (/\/\* Error codes for the \w+ functions\. \*\//);
434 chop; # remove ending backslash
439 $cpp = 1 if /^\#.*ifdef.*cplusplus/;
441 $cpp = 0 if /^\#.*endif/;
445 s/\/\*.*?\*\///gs; # ignore comments
446 if (/\/\*/) { # if we have part
447 $line = $_; # of a comment,
448 next; # continue reading
450 s/{[^{}]*}//gs; # ignore {} blocks
451 print STDERR "DEBUG: \$def=\"$def\"\n" if $debug && $def ne "";
452 print STDERR "DEBUG: \$_=\"$_\"\n" if $debug;
453 if (/^\#\s*ifndef\s+(.*)/) {
457 print STDERR "DEBUG: $file: found tag $1 = -1\n" if $debug;
458 } elsif (/^\#\s*if\s+!defined\(([^\)]+)\)/) {
460 if (/^\#\s*if\s+(!defined\(([^\)]+)\)(\s+\&\&\s+!defined\(([^\)]+)\))*)$/) {
463 foreach $tmp_ (split '\&\&',$tmp_1) {
464 $tmp_ =~ /!defined\(([^\)]+)\)/;
465 print STDERR "DEBUG: $file: found tag $1 = -1\n" if $debug;
470 print STDERR "Warning: $file: complicated expression: $_" if $debug; # because it is O...
471 print STDERR "DEBUG: $file: found tag $1 = -1\n" if $debug;
475 } elsif (/^\#\s*ifdef\s+(.*)/) {
479 print STDERR "DEBUG: $file: found tag $1 = 1\n" if $debug;
480 } elsif (/^\#\s*if\s+defined\(([^\)]+)\)/) {
482 if (/^\#\s*if\s+(defined\(([^\)]+)\)(\s+\|\|\s+defined\(([^\)]+)\))*)$/) {
485 foreach $tmp_ (split '\|\|',$tmp_1) {
486 $tmp_ =~ /defined\(([^\)]+)\)/;
487 print STDERR "DEBUG: $file: found tag $1 = 1\n" if $debug;
492 print STDERR "Warning: $file: complicated expression: $_\n" if $debug; # because it is O...
493 print STDERR "DEBUG: $file: found tag $1 = 1\n" if $debug;
497 } elsif (/^\#\s*error\s+(\w+) is disabled\./) {
499 while($tag[$tag_i] ne "-") {
500 if ($tag[$tag_i] eq "OPENSSL_NO_".$1) {
501 $tag{$tag[$tag_i]}=2;
502 print STDERR "DEBUG: $file: chaged tag $1 = 2\n" if $debug;
506 } elsif (/^\#\s*endif/) {
508 while($tag[$tag_i] ne "-") {
510 print STDERR "DEBUG: \$t=\"$t\"\n" if $debug;
516 print STDERR "DEBUG: $file: changed tag ",$t," = ",$tag{$t},"\n" if $debug;
518 if ($t =~ /^OPENSSL_NO_([A-Z0-9_]+)$/) {
524 && !grep(/^$t$/, @known_algorithms)) {
525 $unknown_algorithms{$t} = 1;
526 #print STDERR "DEBUG: Added as unknown algorithm: $t\n" if $debug;
531 } elsif (/^\#\s*else/) {
533 while($tag[$tag_i] ne "-") {
536 print STDERR "DEBUG: $file: changed tag ",$t," = ",$tag{$t},"\n" if $debug;
539 } elsif (/^\#\s*if\s+1/) {
544 print STDERR "DEBUG: $file: found 1\n" if $debug;
545 } elsif (/^\#\s*if\s+0/) {
550 print STDERR "DEBUG: $file: found 0\n" if $debug;
551 } elsif (/^\#\s*define\s+(\w+)\s+(\w+)/
552 && $symhacking && $tag{'TRUE'} != -1) {
553 # This is for aliasing. When we find an alias,
555 &$make_variant($1,$2);
556 print STDERR "DEBUG: $file: defined $1 = $2\n" if $debug;
561 map { $tag{$_} == 1 ? $_ :
562 $tag{$_} == -1 ? "!".$_ : "" }
564 push @current_platforms
566 map { $tag{"OPENSSL_SYS_".$_} == 1 ? $_ :
567 $tag{"OPENSSL_SYS_".$_} == -1 ? "!".$_ : "" }
568 @known_ossl_platforms);
569 @current_algorithms =
571 map { $tag{"OPENSSL_NO_".$_} == -1 ? $_ : "" }
575 .join(',',@current_platforms).":"
576 .join(',',@current_algorithms).";";
579 if ($tag{'TRUE'} != -1) {
580 if (/^\s*DECLARE_STACK_OF\s*\(\s*(\w*)\s*\)/) {
582 } elsif (/^\s*DECLARE_ASN1_ENCODE_FUNCTIONS\s*\(\s*(\w*)\s*,\s*(\w*)\s*,\s*(\w*)\s*\)/) {
583 $def .= "int d2i_$3(void);";
584 $def .= "int i2d_$3(void);";
585 # Variant for platforms that do not
586 # have to access globale variables
587 # in shared libraries through functions
590 .join(',',"!EXPORT_VAR_AS_FUNCTION",@current_platforms).":"
591 .join(',',@current_algorithms).";";
592 $def .= "OPENSSL_EXTERN int $2_it;";
595 .join(',',@current_platforms).":"
596 .join(',',@current_algorithms).";";
597 # Variant for platforms that have to
598 # access globale variables in shared
599 # libraries through functions
600 &$make_variant("$2_it","$2_it",
601 "EXPORT_VAR_AS_FUNCTION",
604 } elsif (/^\s*DECLARE_ASN1_FUNCTIONS_fname\s*\(\s*(\w*)\s*,\s*(\w*)\s*,\s*(\w*)\s*\)/) {
605 $def .= "int d2i_$3(void);";
606 $def .= "int i2d_$3(void);";
607 $def .= "int $3_free(void);";
608 $def .= "int $3_new(void);";
609 # Variant for platforms that do not
610 # have to access globale variables
611 # in shared libraries through functions
614 .join(',',"!EXPORT_VAR_AS_FUNCTION",@current_platforms).":"
615 .join(',',@current_algorithms).";";
616 $def .= "OPENSSL_EXTERN int $2_it;";
619 .join(',',@current_platforms).":"
620 .join(',',@current_algorithms).";";
621 # Variant for platforms that have to
622 # access globale variables in shared
623 # libraries through functions
624 &$make_variant("$2_it","$2_it",
625 "EXPORT_VAR_AS_FUNCTION",
628 } elsif (/^\s*DECLARE_ASN1_FUNCTIONS\s*\(\s*(\w*)\s*\)/ ||
629 /^\s*DECLARE_ASN1_FUNCTIONS_const\s*\(\s*(\w*)\s*\)/) {
630 $def .= "int d2i_$1(void);";
631 $def .= "int i2d_$1(void);";
632 $def .= "int $1_free(void);";
633 $def .= "int $1_new(void);";
634 # Variant for platforms that do not
635 # have to access globale variables
636 # in shared libraries through functions
639 .join(',',"!EXPORT_VAR_AS_FUNCTION",@current_platforms).":"
640 .join(',',@current_algorithms).";";
641 $def .= "OPENSSL_EXTERN int $1_it;";
644 .join(',',@current_platforms).":"
645 .join(',',@current_algorithms).";";
646 # Variant for platforms that have to
647 # access globale variables in shared
648 # libraries through functions
649 &$make_variant("$1_it","$1_it",
650 "EXPORT_VAR_AS_FUNCTION",
653 } elsif (/^\s*DECLARE_ASN1_ENCODE_FUNCTIONS_const\s*\(\s*(\w*)\s*,\s*(\w*)\s*\)/) {
654 $def .= "int d2i_$2(void);";
655 $def .= "int i2d_$2(void);";
656 # Variant for platforms that do not
657 # have to access globale variables
658 # in shared libraries through functions
661 .join(',',"!EXPORT_VAR_AS_FUNCTION",@current_platforms).":"
662 .join(',',@current_algorithms).";";
663 $def .= "OPENSSL_EXTERN int $2_it;";
666 .join(',',@current_platforms).":"
667 .join(',',@current_algorithms).";";
668 # Variant for platforms that have to
669 # access globale variables in shared
670 # libraries through functions
671 &$make_variant("$2_it","$2_it",
672 "EXPORT_VAR_AS_FUNCTION",
675 } elsif (/^\s*DECLARE_ASN1_FUNCTIONS_name\s*\(\s*(\w*)\s*,\s*(\w*)\s*\)/) {
676 $def .= "int d2i_$2(void);";
677 $def .= "int i2d_$2(void);";
678 $def .= "int $2_free(void);";
679 $def .= "int $2_new(void);";
680 # Variant for platforms that do not
681 # have to access globale variables
682 # in shared libraries through functions
685 .join(',',"!EXPORT_VAR_AS_FUNCTION",@current_platforms).":"
686 .join(',',@current_algorithms).";";
687 $def .= "OPENSSL_EXTERN int $2_it;";
690 .join(',',@current_platforms).":"
691 .join(',',@current_algorithms).";";
692 # Variant for platforms that have to
693 # access globale variables in shared
694 # libraries through functions
695 &$make_variant("$2_it","$2_it",
696 "EXPORT_VAR_AS_FUNCTION",
699 } elsif (/^\s*DECLARE_ASN1_ITEM\s*\(\s*(\w*)\s*\)/) {
700 # Variant for platforms that do not
701 # have to access globale variables
702 # in shared libraries through functions
705 .join(',',"!EXPORT_VAR_AS_FUNCTION",@current_platforms).":"
706 .join(',',@current_algorithms).";";
707 $def .= "OPENSSL_EXTERN int $1_it;";
710 .join(',',@current_platforms).":"
711 .join(',',@current_algorithms).";";
712 # Variant for platforms that have to
713 # access globale variables in shared
714 # libraries through functions
715 &$make_variant("$1_it","$1_it",
716 "EXPORT_VAR_AS_FUNCTION",
719 } elsif (/^\s*DECLARE_ASN1_SET_OF\s*\(\s*(\w*)\s*\)/) {
721 } elsif (/^\s*DECLARE_PKCS12_STACK_OF\s*\(\s*(\w*)\s*\)/) {
723 } elsif (/^DECLARE_PEM_rw\s*\(\s*(\w*)\s*,/ ||
724 /^DECLARE_PEM_rw_cb\s*\(\s*(\w*)\s*,/ ) {
725 # Things not in Win16
728 .join(',',"!WIN16",@current_platforms).":"
729 .join(',',@current_algorithms).";";
730 $def .= "int PEM_read_$1(void);";
731 $def .= "int PEM_write_$1(void);";
734 .join(',',@current_platforms).":"
735 .join(',',@current_algorithms).";";
736 # Things that are everywhere
737 $def .= "int PEM_read_bio_$1(void);";
738 $def .= "int PEM_write_bio_$1(void);";
740 } elsif (/^DECLARE_PEM_write\s*\(\s*(\w*)\s*,/ ||
741 /^DECLARE_PEM_write_cb\s*\(\s*(\w*)\s*,/ ) {
742 # Things not in Win16
745 .join(',',"!WIN16",@current_platforms).":"
746 .join(',',@current_algorithms).";";
747 $def .= "int PEM_write_$1(void);";
750 .join(',',@current_platforms).":"
751 .join(',',@current_algorithms).";";
752 # Things that are everywhere
753 $def .= "int PEM_write_bio_$1(void);";
755 } elsif (/^DECLARE_PEM_read\s*\(\s*(\w*)\s*,/ ||
756 /^DECLARE_PEM_read_cb\s*\(\s*(\w*)\s*,/ ) {
757 # Things not in Win16
760 .join(',',"!WIN16",@current_platforms).":"
761 .join(',',@current_algorithms).";";
762 $def .= "int PEM_read_$1(void);";
765 .join(',',@current_platforms).":"
766 .join(',',@current_algorithms).";";
767 # Things that are everywhere
768 $def .= "int PEM_read_bio_$1(void);";
770 } elsif (/^OPENSSL_DECLARE_GLOBAL\s*\(\s*(\w*)\s*,\s*(\w*)\s*\)/) {
771 # Variant for platforms that do not
772 # have to access globale variables
773 # in shared libraries through functions
776 .join(',',"!EXPORT_VAR_AS_FUNCTION",@current_platforms).":"
777 .join(',',@current_algorithms).";";
778 $def .= "OPENSSL_EXTERN int _shadow_$2;";
781 .join(',',@current_platforms).":"
782 .join(',',@current_algorithms).";";
783 # Variant for platforms that have to
784 # access globale variables in shared
785 # libraries through functions
786 &$make_variant("_shadow_$2","_shadow_$2",
787 "EXPORT_VAR_AS_FUNCTION",
789 } elsif ($tag{'CONST_STRICT'} != 1) {
790 if (/\{|\/\*|\([^\)]*$/) {
803 print STDERR "DEBUG: postprocessing ----------\n" if $debug;
804 foreach (split /;/, $def) {
805 my $s; my $k = "FUNCTION"; my $p; my $a;
809 next if(/typedef\W/);
812 print STDERR "DEBUG: \$_ = \"$_\"\n" if $debug;
813 if (/^\#INFO:([^:]*):(.*)$/) {
816 print STDERR "DEBUG: found info on platforms ($plats) and algorithms ($algs)\n" if $debug;
818 } elsif (/^\s*OPENSSL_EXTERN\s.*?(\w+(\{[0-9]+\})?)(\[[0-9]*\])*\s*$/) {
821 print STDERR "DEBUG: found external variable $s\n" if $debug;
822 } elsif (/\(\*(\w*(\{[0-9]+\})?)\([^\)]+/) {
824 print STDERR "DEBUG: found ANSI C function $s\n" if $debug;
825 } elsif (/\w+\W+(\w+)\W*\(\s*\)(\s*__attribute__\(.*\)\s*)?$/s) {
827 print STDERR "DEBUG: found K&R C function $s\n" if $debug;
829 } elsif (/\w+\W+\w+(\{[0-9]+\})?\W*\(.*\)(\s*__attribute__\(.*\)\s*)?$/s) {
830 while (not /\(\)(\s*__attribute__\(.*\)\s*)?$/s) {
831 s/[^\(\)]*\)(\s*__attribute__\(.*\)\s*)?$/\)/s;
832 s/\([^\(\)]*\)\)(\s*__attribute__\(.*\)\s*)?$/\)/s;
835 /(\w+(\{[0-9]+\})?)\W*\(\)/s;
837 print STDERR "DEBUG: found function $s\n" if $debug;
838 } elsif (/\(/ and not (/=/)) {
839 print STDERR "File $file: cannot parse: $_;\n";
850 $a .= ",BF" if($s =~ /EVP_bf/);
851 $a .= ",CAST" if($s =~ /EVP_cast/);
852 $a .= ",DES" if($s =~ /EVP_des/);
853 $a .= ",DSA" if($s =~ /EVP_dss/);
854 $a .= ",IDEA" if($s =~ /EVP_idea/);
855 $a .= ",MD2" if($s =~ /EVP_md2/);
856 $a .= ",MD4" if($s =~ /EVP_md4/);
857 $a .= ",MD5" if($s =~ /EVP_md5/);
858 $a .= ",RC2" if($s =~ /EVP_rc2/);
859 $a .= ",RC4" if($s =~ /EVP_rc4/);
860 $a .= ",RC5" if($s =~ /EVP_rc5/);
861 $a .= ",RIPEMD" if($s =~ /EVP_ripemd/);
862 $a .= ",SHA" if($s =~ /EVP_sha/);
863 $a .= ",RSA" if($s =~ /EVP_(Open|Seal)(Final|Init)/);
864 $a .= ",RSA" if($s =~ /PEM_Seal(Final|Init|Update)/);
865 $a .= ",RSA" if($s =~ /RSAPrivateKey/);
866 $a .= ",RSA" if($s =~ /SSLv23?_((client|server)_)?method/);
869 &reduce_platforms((defined($platform{$s})?$platform{$s}.',':"").$p);
870 $algorithm{$s} = '' if !defined $algorithm{$s};
871 $algorithm{$s} .= ','.$a;
873 if (defined($variant{$s})) {
874 foreach $v (split /;/,$variant{$s}) {
875 (my $r, my $p, my $k) = split(/:/,$v);
876 my $ip = join ',',map({ /^!(.*)$/ ? $1 : "!".$_ } split /,/, $p);
878 if (!defined($k)) { $k = $kind{$s}; }
879 $kind{$r} = $k."(".$s.")";
880 $algorithm{$r} = $algorithm{$s};
881 $platform{$r} = &reduce_platforms($platform{$s}.",".$p.",".$p);
882 $platform{$s} = &reduce_platforms($platform{$s}.','.$ip.','.$ip);
883 print STDERR "DEBUG: \$variant{\"$s\"} = ",$v,"; \$r = $r; \$p = ",$platform{$r},"; \$a = ",$algorithm{$r},"; \$kind = ",$kind{$r},"\n" if $debug;
886 print STDERR "DEBUG: \$s = $s; \$p = ",$platform{$s},"; \$a = ",$algorithm{$s},"; \$kind = ",$kind{$s},"\n" if $debug;
890 # Prune the returned symbols
892 delete $syms{"bn_dump1"};
893 $platform{"BIO_s_log"} .= ",!WIN32,!WIN16,!macintosh";
895 $platform{"PEM_read_NS_CERT_SEQ"} = "VMS";
896 $platform{"PEM_write_NS_CERT_SEQ"} = "VMS";
897 $platform{"PEM_read_P8_PRIV_KEY_INFO"} = "VMS";
898 $platform{"PEM_write_P8_PRIV_KEY_INFO"} = "VMS";
902 push @ret, map { $_."\\".&info_string($_,"EXIST",
905 $algorithm{$_}) } keys %syms;
907 if (keys %unknown_algorithms) {
908 print STDERR "WARNING: mkdef.pl doesn't know the following algorithms:\n";
909 print STDERR "\t",join("\n\t",keys %unknown_algorithms),"\n";
914 # Param: string of comma-separated platform-specs.
917 my ($platforms) = @_;
918 my $pl = defined($platforms) ? $platforms : "";
919 my %p = map { $_ => 0 } split /,/, $pl;
922 print STDERR "DEBUG: Entered reduce_platforms with \"$platforms\"\n"
924 # We do this, because if there's code like the following, it really
925 # means the function exists in all cases and should therefore be
926 # everywhere. By increasing and decreasing, we may attain 0:
933 foreach $platform (split /,/, $pl) {
934 if ($platform =~ /^!(.*)$/) {
940 foreach $platform (keys %p) {
941 if ($p{$platform} == 0) { delete $p{$platform}; }
946 $ret = join(',',sort(map { $p{$_} < 0 ? "!".$_ : $_ } keys %p));
947 print STDERR "DEBUG: Exiting reduce_platforms with \"$ret\"\n"
953 (my $symbol, my $exist, my $platforms, my $kind, my $algorithms) = @_;
955 my %a = defined($algorithms) ?
956 map { $_ => 1 } split /,/, $algorithms : ();
957 my $k = defined($kind) ? $kind : "FUNCTION";
959 my $p = &reduce_platforms($platforms);
966 $ret .= ":".join(',',sort keys %a);
971 (my $name, *nums, my @symbols) = @_;
976 print STDERR "Updating $name info\n";
977 foreach $sym (@symbols) {
978 (my $s, my $i) = split /\\/, $sym;
979 if (defined($nums{$s})) {
980 $i =~ s/^(.*?:.*?:\w+)(\(\w+\))?/$1/;
981 (my $n, my $dummy) = split /\\/, $nums{$s};
982 if (!defined($dummy) || $i ne $dummy) {
983 $nums{$s} = $n."\\".$i;
985 print STDERR "DEBUG: maybe_add_info for $s: \"$dummy\" => \"$i\"\n" if $debug;
991 my @s=sort { &parse_number($nums{$a},"n") <=> &parse_number($nums{$b},"n") } keys %nums;
993 (my $n, my $i) = split /\\/, $nums{$sym};
994 if (!defined($syms{$sym}) && $i !~ /^NOEXIST:/) {
996 print STDERR "DEBUG: maybe_add_info for $sym: -> undefined\n" if $debug;
1000 print STDERR "$new_info old symbols got an info update\n";
1002 print STDERR "You should do a rewrite to fix this.\n";
1005 print STDERR "No old symbols needed info update\n";
1009 # Param: string of comma-separated keywords, each possibly prefixed with a "!"
1012 my ($keywords_txt,$platforms) = @_;
1013 my (@keywords) = split /,/,$keywords_txt;
1014 my ($falsesum, $truesum) = (0, !grep(/^[^!]/,@keywords));
1016 # Param: one keyword
1019 my ($keyword,$platforms) = @_;
1023 if ($keyword eq "VMS" && $VMS) { return 1; }
1024 if ($keyword eq "WIN32" && $W32) { return 1; }
1025 if ($keyword eq "WIN16" && $W16) { return 1; }
1026 if ($keyword eq "WINNT" && $NT) { return 1; }
1027 if ($keyword eq "OS2" && $OS2) { return 1; }
1028 # Special platforms:
1029 # EXPORT_VAR_AS_FUNCTION means that global variables
1030 # will be represented as functions. This currently
1031 # only happens on VMS-VAX.
1032 if ($keyword eq "EXPORT_VAR_AS_FUNCTION" && ($VMSVAX || $W32 || $W16)) {
1035 if ($keyword eq "OPENSSL_FIPS" && $fips) {
1041 if ($keyword eq "RC2" && $no_rc2) { return 0; }
1042 if ($keyword eq "RC4" && $no_rc4) { return 0; }
1043 if ($keyword eq "RC5" && $no_rc5) { return 0; }
1044 if ($keyword eq "IDEA" && $no_idea) { return 0; }
1045 if ($keyword eq "DES" && $no_des) { return 0; }
1046 if ($keyword eq "BF" && $no_bf) { return 0; }
1047 if ($keyword eq "CAST" && $no_cast) { return 0; }
1048 if ($keyword eq "MD2" && $no_md2) { return 0; }
1049 if ($keyword eq "MD4" && $no_md4) { return 0; }
1050 if ($keyword eq "MD5" && $no_md5) { return 0; }
1051 if ($keyword eq "SHA" && $no_sha) { return 0; }
1052 if ($keyword eq "RIPEMD" && $no_ripemd) { return 0; }
1053 if ($keyword eq "MDC2" && $no_mdc2) { return 0; }
1054 if ($keyword eq "RSA" && $no_rsa) { return 0; }
1055 if ($keyword eq "DSA" && $no_dsa) { return 0; }
1056 if ($keyword eq "DH" && $no_dh) { return 0; }
1057 if ($keyword eq "EC" && $no_ec) { return 0; }
1058 if ($keyword eq "HMAC" && $no_hmac) { return 0; }
1059 if ($keyword eq "AES" && $no_aes) { return 0; }
1060 if ($keyword eq "EVP" && $no_evp) { return 0; }
1061 if ($keyword eq "LHASH" && $no_lhash) { return 0; }
1062 if ($keyword eq "STACK" && $no_stack) { return 0; }
1063 if ($keyword eq "ERR" && $no_err) { return 0; }
1064 if ($keyword eq "BUFFER" && $no_buffer) { return 0; }
1065 if ($keyword eq "BIO" && $no_bio) { return 0; }
1066 if ($keyword eq "COMP" && $no_comp) { return 0; }
1067 if ($keyword eq "DSO" && $no_dso) { return 0; }
1068 if ($keyword eq "KRB5" && $no_krb5) { return 0; }
1069 if ($keyword eq "ENGINE" && $no_engine) { return 0; }
1070 if ($keyword eq "HW" && $no_hw) { return 0; }
1071 if ($keyword eq "FP_API" && $no_fp_api) { return 0; }
1073 # Nothing recognise as true
1078 foreach $k (@keywords) {
1079 if ($k =~ /^!(.*)$/) {
1080 $falsesum += &recognise($1,$platforms);
1082 $truesum += &recognise($k,$platforms);
1085 print STDERR "DEBUG: [",$#keywords,",",$#keywords < 0,"] is_valid($keywords_txt) => (\!$falsesum) && $truesum = ",(!$falsesum) && $truesum,"\n" if $debug;
1086 return (!$falsesum) && $truesum;
1091 (*OUT,my $name,*nums,my $testall,my @symbols)=@_;
1092 my $n = 1; my @e; my @r;
1093 my $sym; my $prev = ""; my $prefSSLeay;
1095 (@e)=grep(/^SSLeay(\{[0-9]+\})?\\.*?:.*?:.*/,@symbols);
1096 (@r)=grep(/^\w+(\{[0-9]+\})?\\.*?:.*?:.*/ && !/^SSLeay(\{[0-9]+\})?\\.*?:.*?:.*/,@symbols);
1097 @symbols=((sort @e),(sort @r));
1099 foreach $sym (@symbols) {
1100 (my $s, my $i) = $sym =~ /^(.*?)\\(.*)$/;
1102 $v = 1 if $i=~ /^.*?:.*?:VARIABLE/;
1103 my $p = ($i =~ /^[^:]*:([^:]*):/,$1);
1104 my $a = ($i =~ /^[^:]*:[^:]*:[^:]*:([^:]*)/,$1);
1105 if (!defined($nums{$s})) {
1106 print STDERR "Warning: $s does not have a number assigned\n"
1108 } elsif (is_valid($p,1) && is_valid($a,0)) {
1109 my $s2 = ($s =~ /^(.*?)(\{[0-9]+\})?$/, $1);
1111 print OUT "\t/* The following has already appeared previously */\n";
1112 print STDERR "Warning: Symbol '",$s2,"' redefined. old=",($nums{$prev} =~ /^(.*?)\\/,$1),", new=",($nums{$s2} =~ /^(.*?)\\/,$1),"\n";
1114 $prev = $s2; # To warn about duplicates...
1116 ($nn,$ni)=($nums{$s2} =~ /^(.*?)\\(.*)$/);
1118 print OUT "\textern int $s2; /* type unknown */ /* $nn $ni */\n";
1120 print OUT "\textern int $s2(); /* type unknown */ /* $nn $ni */\n";
1129 open MF, 'Makefile' or return $v;
1131 $v = $1, last if /^VERSION=(.*?)\s*$/;
1139 (*OUT,my $name,*nums,my @symbols)=@_;
1140 my $n = 1; my @e; my @r; my @v; my $prev="";
1142 my $libname = $name;
1143 my $http_vendor = 'www.openssl.org/';
1144 my $version = get_version();
1145 my $what = "OpenSSL: implementation of Secure Socket Layer";
1146 my $description = "$what $version, $name - http://$http_vendor";
1153 { # DLL names should not clash on the whole system.
1154 # However, they should not have any particular relationship
1155 # to the name of the static library. Chose descriptive names
1156 # (must be at most 8 chars).
1157 my %translate = (ssl => 'open_ssl', crypto => 'cryptssl');
1158 $libname = $translate{$name} || $name;
1159 $liboptions = <<EOO;
1161 DATA MULTIPLE NONSHARED
1163 # Vendor field can't contain colon, drat; so we omit http://
1164 $description = "\@#$http_vendor:$version#\@$what; DLL for library $name. Build for EMX -Zmtd";
1169 ; Definition file for the DLL version of the $name library from OpenSSL
1172 LIBRARY $libname $liboptions
1174 DESCRIPTION '$description'
1180 CODE PRELOAD MOVEABLE
1181 DATA PRELOAD MOVEABLE SINGLE
1193 (@e)=grep(/^SSLeay(\{[0-9]+\})?\\.*?:.*?:FUNCTION/,@symbols);
1194 (@r)=grep(/^\w+(\{[0-9]+\})?\\.*?:.*?:FUNCTION/ && !/^SSLeay(\{[0-9]+\})?\\.*?:.*?:FUNCTION/,@symbols);
1195 (@v)=grep(/^\w+(\{[0-9]+\})?\\.*?:.*?:VARIABLE/,@symbols);
1196 @symbols=((sort @e),(sort @r), (sort @v));
1199 foreach $sym (@symbols) {
1200 (my $s, my $i) = $sym =~ /^(.*?)\\(.*)$/;
1202 $v = 1 if $i =~ /^.*?:.*?:VARIABLE/;
1203 if (!defined($nums{$s})) {
1204 printf STDERR "Warning: $s does not have a number assigned\n"
1207 (my $n, my $dummy) = split /\\/, $nums{$s};
1209 my $p = ($i =~ /^[^:]*:([^:]*):/,$1);
1210 my $a = ($i =~ /^[^:]*:[^:]*:[^:]*:([^:]*)/,$1);
1211 if (is_valid($p,1) && is_valid($a,0)) {
1212 my $s2 = ($s =~ /^(.*?)(\{[0-9]+\})?$/, $1);
1214 print STDERR "Warning: Symbol '",$s2,"' redefined. old=",($nums{$prev} =~ /^(.*?)\\/,$1),", new=",($nums{$s2} =~ /^(.*?)\\/,$1),"\n";
1216 $prev = $s2; # To warn about duplicates...
1218 printf OUT " %s%-39s @%-8d DATA\n",($W32)?"":"_",$s2,$n;
1220 printf OUT " %s%-39s @%d\n",($W32||$OS2)?"":"_",$s2,$n;
1238 open(IN,"<$name") || die "unable to open $name:$!\n";
1244 if (defined $ret{$a[0]}) {
1245 # This is actually perfectly OK
1246 #print STDERR "Warning: Symbol '",$a[0],"' redefined. old=",$ret{$a[0]},", new=",$a[1],"\n";
1248 if ($max_num > $a[1]) {
1249 print STDERR "Warning: Number decreased from ",$max_num," to ",$a[1],"\n";
1251 elsif ($max_num == $a[1]) {
1252 # This is actually perfectly OK
1253 #print STDERR "Warning: Symbol ",$a[0]," has same number as previous ",$prev,": ",$a[1],"\n";
1254 if ($a[0] eq $prev) {
1256 $a[0] .= "{$prev_cnt}";
1263 # Existence will be proven later, in do_defs
1267 $ret{$a[0]}=$a[1]."\\".$a[2]; # \\ is a special marker
1269 $max_num = $a[1] if $a[1] > $max_num;
1273 print STDERR "Warning: $num_noinfo symbols were without info.";
1275 printf STDERR " The rewrite will fix this.\n";
1277 printf STDERR " You should do a rewrite to fix this.\n";
1286 (my $str, my $what) = @_;
1287 (my $n, my $i) = split(/\\/,$str);
1297 (*OUT,$name,*nums,@symbols)=@_;
1300 print STDERR "Rewriting $name\n";
1302 my @r = grep(/^\w+(\{[0-9]+\})?\\.*?:.*?:\w+\(\w+\)/,@symbols);
1303 my $r; my %r; my %rsyms;
1305 (my $s, my $i) = split /\\/, $r;
1306 my $a = $1 if $i =~ /^.*?:.*?:\w+\((\w+)\)/;
1307 $i =~ s/^(.*?:.*?:\w+)\(\w+\)/$1/;
1308 $r{$a} = $s."\\".$i;
1313 foreach $_ (@symbols) {
1314 (my $n, my $i) = split /\\/;
1319 &parse_number($nums{$a},"n") <=> &parse_number($nums{$b},"n")
1323 (my $n, my $i) = split /\\/, $nums{$sym};
1324 next if defined($i) && $i =~ /^.*?:.*?:\w+\(\w+\)/;
1325 next if defined($rsyms{$sym});
1326 print STDERR "DEBUG: rewrite_numbers for sym = ",$sym,": i = ",$i,", n = ",$n,", rsym{sym} = ",$rsyms{$sym},"syms{sym} = ",$syms{$sym},"\n" if $debug;
1327 $i="NOEXIST::FUNCTION:"
1328 if !defined($i) || $i eq "" || !defined($syms{$sym});
1330 $s2 =~ s/\{[0-9]+\}$//;
1331 printf OUT "%s%-39s %d\t%s\n","",$s2,$n,$i;
1332 if (exists $r{$sym}) {
1333 (my $s, $i) = split /\\/,$r{$sym};
1335 $s2 =~ s/\{[0-9]+\}$//;
1336 printf OUT "%s%-39s %d\t%s\n","",$s2,$n,$i;
1343 (*OUT,$name,*nums,my $start_num, my @symbols)=@_;
1346 print STDERR "Updating $name numbers\n";
1348 my @r = grep(/^\w+(\{[0-9]+\})?\\.*?:.*?:\w+\(\w+\)/,@symbols);
1349 my $r; my %r; my %rsyms;
1351 (my $s, my $i) = split /\\/, $r;
1352 my $a = $1 if $i =~ /^.*?:.*?:\w+\((\w+)\)/;
1353 $i =~ s/^(.*?:.*?:\w+)\(\w+\)/$1/;
1354 $r{$a} = $s."\\".$i;
1358 foreach $sym (@symbols) {
1359 (my $s, my $i) = $sym =~ /^(.*?)\\(.*)$/;
1360 next if $i =~ /^.*?:.*?:\w+\(\w+\)/;
1361 next if defined($rsyms{$sym});
1362 die "ERROR: Symbol $sym had no info attached to it."
1364 if (!exists $nums{$s}) {
1367 $s2 =~ s/\{[0-9]+\}$//;
1368 printf OUT "%s%-39s %d\t%s\n","",$s2, ++$start_num,$i;
1369 if (exists $r{$s}) {
1370 ($s, $i) = split /\\/,$r{$s};
1371 $s =~ s/\{[0-9]+\}$//;
1372 printf OUT "%s%-39s %d\t%s\n","",$s, $start_num,$i;
1377 print STDERR "$new_syms New symbols added\n";
1379 print STDERR "No New symbols Added\n";
1385 (*nums, my @symbols)=@_;
1386 my %existing; my @remaining;
1388 foreach $sym (@symbols) {
1389 (my $s, my $i) = $sym =~ /^(.*?)\\(.*)$/;
1392 foreach $sym (keys %nums) {
1393 if (!exists $existing{$sym}) {
1394 push @remaining, $sym;
1398 print STDERR "The following symbols do not seem to exist:\n";
1399 foreach $sym (@remaining) {
1400 print STDERR "\t",$sym,"\n";