3 # Copyright (C) 1999 Free Software Foundation, Inc.
4 # This file is part of the GNU C Library.
5 # Contributed by Andreas Jaeger <aj@suse.de>, 1999.
7 # The GNU C Library is free software; you can redistribute it and/or
8 # modify it under the terms of the GNU Library General Public License as
9 # published by the Free Software Foundation; either version 2 of the
10 # License, or (at your option) any later version.
12 # The GNU C Library is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 # Library General Public License for more details.
17 # You should have received a copy of the GNU Library General Public
18 # License along with the GNU C Library; see the file COPYING.LIB. If not,
19 # write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 # Boston, MA 02111-1307, USA.
22 # This file needs to be tidied up
23 # Note that functions and tests share the same namespace.
25 # Information about tests are stored in: %results
26 # $results{$test}{"kind"} is either "fct" or "test" and flags whether this
27 # is a maximal error of a function or a single test.
28 # $results{$test}{"type"} is the result type, e.g. normal or complex.
29 # $results{$test}{"has_ulps"} is set if deltas exist.
30 # $results{$test}{"has_fails"} is set if exptected failures exist.
31 # In the following description $type and $float are:
32 # - $type is either "normal", "real" (for the real part of a complex number)
33 # or "imag" (for the imaginary part # of a complex number).
34 # - $float is either of float, ifloat, double, idouble, ldouble, ildouble;
35 # It represents the underlying floating point type (float, double or long
36 # double) and if inline functions (the leading i stands for inline)
38 # $results{$test}{$type}{"fail"}{$float} is defined and has a 1 if
39 # the test is expected to fail
40 # $results{$test}{$type}{"ulp"}{$float} is defined and has a delta as value
47 use vars qw
($input $output);
48 use vars qw
(%results);
49 use vars qw
(@tests @functions);
51 use vars qw
(%beautify @all_floats);
52 use vars qw
($output_dir $ulps_file);
54 # all_floats is sorted and contains all recognised float types
55 @all_floats = ('double', 'float', 'idouble',
56 'ifloat', 'ildouble', 'ldouble');
59 ( "minus_zero" => "-0",
61 "minus_infty" => "-inf",
62 "plus_infty" => "inf",
67 "M_LOG10El", "log10(e)",
69 "M_PI_34l" => "3/4 pi",
73 "M_PI_34_LOG10El" => "3/4 pi*log10(e)",
74 "M_PI_LOG10El" => "pi*log10(e)",
75 "M_PI2_LOG10El" => "pi/2*log10(e)",
76 "M_PI4_LOG10El" => "pi/4*log10(e)",
77 "M_LOG_SQRT_PIl" => "log(sqrt(pi))",
78 "M_LOG_2_SQRT_PIl" => "log(2*sqrt(pi))",
79 "M_2_SQRT_PIl" => "2 sqrt (pi)",
80 "M_SQRT_PIl" => "sqrt (pi)",
81 "INVALID_EXCEPTION" => "invalid exception",
82 "DIVIDE_BY_ZERO_EXCEPTION" => "division by zero exception",
83 "INVALID_EXCEPTION_OK" => "invalid exception allowed",
84 "DIVIDE_BY_ZERO_EXCEPTION_OK" => "division by zero exception allowed",
85 "EXCEPTIONS_OK" => "exceptions allowed",
86 "IGNORE_ZERO_INF_SIGN" => "sign of zero/inf not specified",
87 "INVALID_EXCEPTION|IGNORE_ZERO_INF_SIGN" => "invalid exception and sign of zero/inf not specified"
96 # n: generate new ulps file
97 use vars
qw($opt_u $opt_h $opt_o $opt_n);
100 $ulps_file = 'libm-test-ulps';
104 print "Usage: gen-libm-test.pl [OPTIONS]\n";
105 print " -h print this help, then exit\n";
106 print " -o DIR directory where generated files will be placed\n";
107 print " -n only generate sorted file NewUlps from libm-test-ulps\n";
108 print " -u FILE input file with ulps\n";
112 $ulps_file = $opt_u if ($opt_u);
113 $output_dir = $opt_o if ($opt_o);
115 $input = "libm-test.inc";
116 $output = "${output_dir}libm-test.c";
120 &parse_ulps ($ulps_file);
121 &generate_testfile ($input, $output) unless ($opt_n);
122 &output_ulps ("${output_dir}libm-test-ulps.h", $ulps_file) unless ($opt_n);
123 &print_ulps_file ("${output_dir}NewUlps") if ($opt_n);
125 # Return a nicer representation
130 if (exists $beautify{$arg}) {
131 return $beautify{$arg};
136 if (exists $beautify{$tmp}) {
137 return '-' . $beautify{$tmp};
140 if ($arg =~ /[0-9]L$/) {
146 # Return a nicer representation of a complex number
147 sub build_complex_beautify {
151 $str1 = &beautify ($r);
152 $str2 = &beautify ($i);
155 $str1 .= ' - ' . $str2;
157 $str1 .= ' + ' . $str2;
163 # Return name of a variable
167 return "x" if ($number == 1);
168 return "y" if ($number == 2);
169 return "z" if ($number == 3);
175 # Add a new test to internal data structures and fill in the
176 # ulps, failures and exception information for the C line.
178 my ($test, $exception) = @_;
182 if (exists $results{$test}{'has_ulps'}) {
183 $rest = ", DELTA$count";
187 if (exists $results{$test}{'has_fails'}) {
188 $rest .= ", FAIL$count";
192 if (defined $exception) {
193 $rest .= ", $exception";
198 # We must increment here to keep @tests and count in sync
204 # Treat some functions especially.
205 # Currently only sincos needs extra treatment.
206 sub special_functions {
207 my ($file, $args) = @_;
208 my (@args, $str, $test, $cline);
210 @args = split /,\s*/, $args;
212 unless ($args[0] =~ /sincos/) {
213 die ("Don't know how to handle $args[0] extra.");
215 print $file " FUNC (sincos) ($args[1], &sin_res, &cos_res);\n";
217 $str = 'sincos (' . &beautify ($args[1]) . ', &sin_res, &cos_res)';
219 $test = $str . ' puts ' . &beautify ($args[2]) . ' in sin_res';
221 $test .= " plus " . &beautify ($args[4]);
224 $cline = " check_float (\"$test\", sin_res, $args[2]";
225 $cline .= &new_test ($test, $args[4]);
229 $test = $str . ' puts ' . &beautify ($args[3]) . ' in cos_res';
230 $cline = " check_float (\"$test\", cos_res, $args[3]";
231 # only tests once for exception
232 $cline .= &new_test ($test, undef);
236 # Parse the arguments to TEST_x_y
238 my ($file, $descr, $args) = @_;
239 my (@args, $str, $descr_args, $descr_res, @descr);
240 my ($current_arg, $cline, $i);
241 my ($pre, $post, @special);
242 my ($extra_var, $call, $c_call);
244 if ($descr eq 'extra') {
245 &special_functions ($file, $args);
248 ($descr_args, $descr_res) = split /_/,$descr, 2;
250 @args = split /,\s*/, $args;
252 $call = "$args[0] (";
254 # Generate first the string that's shown to the user
257 @descr = split //,$descr_args;
258 for ($i = 0; $i <= $#descr; $i++) {
262 # FLOAT, int, long int, long long int
263 if ($descr[$i] =~ /f|i|l|L/) {
264 $call .= &beautify ($args[$current_arg]);
268 # &FLOAT, &int - argument is added here
269 if ($descr[$i] =~ /F|I/) {
271 $call .= '&' . &get_variable ($extra_var);
275 if ($descr[$i] eq 'c') {
276 $call .= &build_complex_beautify ($args[$current_arg], $args[$current_arg+1]);
281 die ("$descr[$i] is unknown");
287 @descr = split //,$descr_res;
289 if ($_ =~ /f|i|l|L/) {
290 $str .= &beautify ($args[$current_arg]);
292 } elsif ($_ eq 'c') {
293 $str .= &build_complex_beautify ($args[$current_arg], $args[$current_arg+1]);
295 } elsif ($_ eq 'b') {
297 $str .= ($args[$current_arg] == 0) ? "false" : "true";
299 } elsif ($_ eq '1') {
302 die ("$_ is unknown");
306 if ($current_arg == $#args) {
307 die ("wrong number of arguments")
308 unless ($args[$current_arg] =~ /EXCEPTION|IGNORE_ZERO_INF_SIGN/);
309 } elsif ($current_arg < $#args) {
310 die ("wrong number of arguments");
311 } elsif ($current_arg > ($#args+1)) {
312 die ("wrong number of arguments");
316 # check for exceptions
317 if ($current_arg <= $#args) {
318 $str .= " plus " . &beautify ($args[$current_arg]);
321 # Put the C program line together
322 # Reset some variables to start again
325 if (substr($descr_res,0,1) eq 'f') {
326 $cline = 'check_float'
327 } elsif (substr($descr_res,0,1) eq 'b') {
328 $cline = 'check_bool';
329 } elsif (substr($descr_res,0,1) eq 'c') {
330 $cline = 'check_complex';
331 } elsif (substr($descr_res,0,1) eq 'i') {
332 $cline = 'check_int';
333 } elsif (substr($descr_res,0,1) eq 'l') {
334 $cline = 'check_long';
335 } elsif (substr($descr_res,0,1) eq 'L') {
336 $cline = 'check_longlong';
338 # Special handling for some macros:
339 $cline .= " (\"$str\", ";
340 if ($args[0] =~ /fpclassify|isnormal|isfinite|signbit/) {
341 $c_call = "$args[0] (";
343 $c_call = " FUNC($args[0]) (";
345 @descr = split //,$descr_args;
346 for ($i=0; $i <= $#descr; $i++) {
350 # FLOAT, int, long int, long long int
351 if ($descr[$i] =~ /f|i|l|L/) {
352 $c_call .= $args[$current_arg];
357 if ($descr[$i] =~ /F|I/) {
359 $c_call .= '&' . &get_variable ($extra_var);
363 if ($descr[$i] eq 'c') {
364 $c_call .= "BUILD_COMPLEX ($args[$current_arg], $args[$current_arg+1])";
370 $cline .= "$c_call, ";
372 @descr = split //,$descr_res;
374 if ($_ =~ /b|f|i|l|L/ ) {
375 $cline .= $args[$current_arg];
377 } elsif ($_ eq 'c') {
378 $cline .= "BUILD_COMPLEX ($args[$current_arg], $args[$current_arg+1])";
380 } elsif ($_ eq '1') {
381 push @special, $args[$current_arg];
386 $cline .= &new_test ($str, ($current_arg <= $#args) ? $args[$current_arg] : undef);
388 # special treatment for some functions
389 if ($args[0] eq 'frexp') {
390 if (defined $special[0] && $special[0] ne "IGNORE") {
391 my ($str) = "$call sets x to $special[0]";
392 $post = " check_int (\"$str\", x, $special[0]";
393 $post .= &new_test ($str, undef);
395 } elsif ($args[0] eq 'gamma' || $args[0] eq 'lgamma') {
396 $pre = " signgam = 0;\n";
397 if (defined $special[0] && $special[0] ne "IGNORE") {
398 my ($str) = "$call sets signgam to $special[0]";
399 $post = " check_int (\"$str\", signgam, $special[0]";
400 $post .= &new_test ($str, undef);
402 } elsif ($args[0] eq 'modf') {
403 if (defined $special[0] && $special[0] ne "IGNORE") {
404 my ($str) = "$call sets x to $special[0]";
405 $post = " check_float (\"$str\", x, $special[0]";
406 $post .= &new_test ($str, undef);
408 } elsif ($args[0] eq 'remquo') {
409 if (defined $special[0] && $special[0] ne "IGNORE") {
410 my ($str) = "$call sets x to $special[0]";
411 $post = " check_int (\"$str\", x, $special[0]";
412 $post .= &new_test ($str, undef);
416 print $file $pre if (defined $pre);
418 print $file " $cline";
420 print $file $post if (defined $post);
423 # Generate libm-test.c
424 sub generate_testfile {
425 my ($input, $output) = @_;
427 my (@args, $i, $str);
429 open INPUT, $input or die ("Can't open $input: $!");
430 open OUTPUT, ">$output" or die ("Can't open $output: $!");
432 # Replace the special macros
439 ($descr, $args) = ($_ =~ /TEST_(\w+)\s*\((.*)\)/);
440 &parse_args (\*OUTPUT, $descr, $args);
445 print OUTPUT " init_max_error ();\n";
450 my ($fct, $line, $type);
457 ($fct) = ($_ =~ /END\s*\((.*)\)/);
458 if ($type eq 'complex') {
459 $line = " print_complex_max_error (\"$fct\", ";
461 $line = " print_max_error (\"$fct\", ";
463 if (exists $results{$fct}{'has_ulps'}) {
464 $line .= "DELTA$fct";
468 if (exists $results{$fct}{'has_fails'}) {
469 $line .= ", FAIL$fct";
475 push @functions, $fct;
489 my ($test, $type, $float, $eps, $kind);
491 # $type has the following values:
492 # "normal": No complex variable
493 # "real": Real part of complex result
494 # "imag": Imaginary part of complex result
495 open ULP, $file or die ("Can't open $file: $!");
498 # ignore comments and empty lines
502 if (/Real part of:/) {
505 } elsif (/Imaginary part of:/) {
506 s/Imaginary part of: //;
511 s/^.+\"(.*)\".*$/$1/;
517 if (/Real part of/) {
520 } elsif (/Imaginary part of/) {
521 s/Imaginary part of //;
526 ($test) = ($_ =~ /^Function:\s*\"([a-zA-Z0-9_]+)\"/);
530 if (/^i?(float|double|ldouble):/) {
531 ($float, $eps) = split /\s*:\s*/,$_,2;
533 if ($eps eq 'fail') {
534 $results{$test}{$type}{'fail'}{$float} = 1;
535 $results{$test}{'has_fails'} = 1;
536 } elsif ($eps eq "0") {
540 $results{$test}{$type}{'ulp'}{$float} = $eps;
541 $results{$test}{'has_ulps'} = 1;
543 if ($type =~ /^real|imag$/) {
544 $results{$test}{'type'} = 'complex';
545 } elsif ($type eq 'normal') {
546 $results{$test}{'type'} = 'normal';
548 $results{$test}{'kind'} = $kind;
551 print "Skipping unknown entry: `$_'\n";
557 # Clean up a floating point number
558 sub clean_up_number {
561 # Remove trailing zeros
567 # Output a file which can be read in as ulps file.
568 sub print_ulps_file {
570 my ($test, $type, $float, $eps, $fct, $last_fct);
573 open NEWULP, ">$file" or die ("Can't open $file: $!");
574 print NEWULP "# Begin of automatic generation\n";
575 # first the function calls
576 foreach $test (sort keys %results) {
577 next if ($results{$test}{'kind'} ne 'test');
578 foreach $type ('real', 'imag', 'normal') {
579 if (exists $results{$test}{$type}) {
580 if (defined $results{$test}) {
581 ($fct) = ($test =~ /^(\w+)\s/);
582 if ($fct ne $last_fct) {
584 print NEWULP "\n# $fct\n";
587 if ($type eq 'normal') {
588 print NEWULP "Test \"$test\":\n";
589 } elsif ($type eq 'real') {
590 print NEWULP "Test \"Real part of: $test\":\n";
591 } elsif ($type eq 'imag') {
592 print NEWULP "Test \"Imaginary part of: $test\":\n";
594 foreach $float (@all_floats) {
595 if (exists $results{$test}{$type}{'ulp'}{$float}) {
596 print NEWULP "$float: ",
597 &clean_up_number ($results{$test}{$type}{'ulp'}{$float}),
600 if (exists $results{$test}{$type}{'fail'}{$float}) {
601 print NEWULP "$float: fail\n";
607 print NEWULP "\n# Maximal error of functions:\n";
609 foreach $fct (sort keys %results) {
610 next if ($results{$fct}{'kind'} ne 'fct');
611 foreach $type ('real', 'imag', 'normal') {
612 if (exists $results{$fct}{$type}) {
613 if ($type eq 'normal') {
614 print NEWULP "Function: \"$fct\":\n";
615 } elsif ($type eq 'real') {
616 print NEWULP "Function: Real part of \"$fct\":\n";
617 } elsif ($type eq 'imag') {
618 print NEWULP "Function: Imaginary part of \"$fct\":\n";
620 foreach $float (@all_floats) {
621 if (exists $results{$fct}{$type}{'ulp'}{$float}) {
622 print NEWULP "$float: ",
623 &clean_up_number ($results{$fct}{$type}{'ulp'}{$float}),
626 if (exists $results{$fct}{$type}{'fail'}{$float}) {
627 print NEWULP "$float: fail\n";
634 print NEWULP "# end of automatic generation\n";
639 my ($test, $type, $float) = @_;
641 if ($type eq 'complex') {
643 # Return 0 instead of BUILD_COMPLEX (0,0)
644 if (!exists $results{$test}{'real'}{'ulp'}{$float} &&
645 !exists $results{$test}{'imag'}{'ulp'}{$float}) {
648 $res = 'BUILD_COMPLEX (';
649 $res .= (exists $results{$test}{'real'}{'ulp'}{$float}
650 ? $results{$test}{'real'}{'ulp'}{$float} : "0");
652 $res .= (exists $results{$test}{'imag'}{'ulp'}{$float}
653 ? $results{$test}{'imag'}{'ulp'}{$float} : "0");
657 return (exists $results{$test}{'normal'}{'ulp'}{$float}
658 ? $results{$test}{'normal'}{'ulp'}{$float} : "0");
662 my ($test, $type, $float) = @_;
663 if ($type eq 'complex') {
666 # Return 0 instead of BUILD_COMPLEX_INT (0,0)
667 if (!exists $results{$test}{'real'}{'ulp'}{$float} &&
668 !exists $results{$test}{'imag'}{'ulp'}{$float}) {
671 $res = 'BUILD_COMPLEX_INT (';
672 $res .= (exists $results{$test}{'real'}{'fail'}{$float}
673 ? $results{$test}{'real'}{'fail'}{$float} : "0");
675 $res .= (exists $results{$test}{'imag'}{'fail'}{$float}
676 ? $results{$test}{'imag'}{'fail'}{$float} : "0");
680 return (exists $results{$test}{'normal'}{'fail'}{$float}
681 ? $results{$test}{'normal'}{'fail'}{$float} : "0");
685 # Output the defines for a single test
687 my ($file, $test, $name) = @_;
688 my ($ldouble, $double, $float, $ildouble, $idouble, $ifloat);
691 # Do we have ulps/failures?
692 if (!exists $results{$test}{'type'}) {
695 $type = $results{$test}{'type'};
696 if (exists $results{$test}{'has_ulps'}) {
697 # XXX use all_floats (change order!)
698 $ldouble = &get_ulps ($test, $type, "ldouble");
699 $double = &get_ulps ($test, $type, "double");
700 $float = &get_ulps ($test, $type, "float");
701 $ildouble = &get_ulps ($test, $type, "ildouble");
702 $idouble = &get_ulps ($test, $type, "idouble");
703 $ifloat = &get_ulps ($test, $type, "ifloat");
704 print $file "#define DELTA$name CHOOSE($ldouble, $double, $float, $ildouble, $idouble, $ifloat)\t/* $test */\n";
707 if (exists $results{$test}{'has_fails'}) {
708 $ldouble = &get_failure ($test, "ldouble");
709 $double = &get_failure ($test, "double");
710 $float = &get_failure ($test, "float");
711 $ildouble = &get_failure ($test, "ildouble");
712 $idouble = &get_failure ($test, "idouble");
713 $ifloat = &get_failure ($test, "ifloat");
714 print $file "#define FAIL$name CHOOSE($ldouble, $double, $float $ildouble, $idouble, $ifloat)\t/* $test */\n";
720 my ($file, $ulps_filename) = @_;
723 open ULP, ">$file" or die ("Can't open $file: $!");
725 print ULP "/* This file is automatically generated\n";
726 print ULP " from $ulps_filename with gen-libm-test.pl.\n";
727 print ULP " Don't change it - change instead the master files. */\n\n";
729 print ULP "\n/* Maximal error of functions. */\n";
730 foreach $fct (@functions) {
731 output_test (\*ULP, $fct, $fct);
734 print ULP "\n/* Error of single function calls. */\n";
735 for ($i = 0; $i < $count; $i++) {
736 output_test (\*ULP, $tests[$i], $i);