1 # Copyright
(C
) 2001-2017 Free Software Foundation
, Inc.
3 # This
program is free software
; you can redistribute it and
/or modify
4 # it under the terms of the GNU General Public License as published by
5 # the Free Software Foundation
; either version
3 of the License
, or
6 #
(at your option
) any later version.
8 # This
program is distributed in the hope that it will be useful
,
9 # but WITHOUT
ANY WARRANTY
; without even the implied warranty of
10 # MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the
11 # GNU General Public License
for more details.
13 # You should have received a copy of the GNU General Public License
14 # along with GCC
; see the file COPYING3.
If not see
15 #
<http
://www.gnu.org
/licenses
/>.
17 # This script was submitted by Janis Johnson
<janis187@us.ibm.com
>.
19 # Test the functionality and optionally
, performance improvement
, of
20 # programs compiled with profile
-directed optimizations.
Compile and
21 # run a test with profile options
, compile it with options using the
22 # profile feedback
, and
then run the test again. Optionally
compile
23 # and run a third time without the profile
-directed optimization and
24 # compare timing results of the
program with
normal optimization and
25 # with the profile
-directed optimization. Each test is run using
26 # multiple sets of optimization and
/or code generation options in
27 # addition to the profiling and feedback options.
29 #
If perf_ext is defined and the performance value
for the
30 # profile
-directed test run is nonzero
then the performance check will
36 global PROFOPT_OPTIONS perf_delta
38 # The including .exp file must
define these.
39 global tool profile_option feedback_option prof_ext profile_wrapper
40 if ![info exists tool
] {
41 error
"Tools is not specified."
43 if ![info exists prof_ext
] {
44 error
"No profile data file extensions specified."
47 # The maximum perforance degradation can be defined in the including file.
48 if ![info exists perf_delta
] {
52 # The default option list can be overridden by
53 # PROFOPT_OPTIONS
="{ { list1 } ... { list2 } }"
55 if ![info exists PROFOPT_OPTIONS
] {
56 set PROFOPT_OPTIONS
[list \
67 # profopt
-cleanup
-- remove profiling or performance results files.
69 # TESTCASE is the
name of the test
70 # EXT is the extensions of files to remove
72 proc profopt
-cleanup
{ testcase extlist
} {
73 set basename
[file tail $testcase
]
74 set base
[file rootname $basename
]
75 foreach ext $extlist
{
76 set files
[glob
-nocomplain $base.$ext
]
78 eval
"remote_file build delete $files"
84 # profopt
-target
-cleanup
-- remove profiling result files.
86 #
DIR is the
name of the directory
87 # TESTCASE is the
name of the test
88 # EXT is the extensions of files to remove
90 proc profopt
-target
-cleanup
{ dir testcase ext
} {
91 global additional_sources_used
92 set basename
[file tail $testcase
]
93 set base
[file rootname $basename
]
94 set file
"$dir/$base.$ext"
95 eval
"remote_file target delete $file"
97 if [info exists additional_sources_used
] {
98 foreach srcfile $additional_sources_used
{
99 set basename
[file tail $srcfile
]
100 set base
[file rootname $basename
]
101 set file
"$dir/$base.$ext"
102 eval
"remote_file target delete $file"
108 # profopt
-perf
-value
-- get performance value
for a test
110 # TESTCASE is the
name of the test
111 # PERF_EXT is the extension of the performance result file
112 # OPTSTR is the string of compiler options
114 proc profopt
-perf
-value
{ testcase perf_ext optstr
} {
115 set basename
[file tail $testcase
]
116 set base
[file rootname $basename
]
117 set files
[glob
-nocomplain $base.$perf_ext
]
118 # The file doesn
't exist; let the caller decide if that's a problem.
119 if { $files
== "" } {
122 remote_upload host $base.$perf_ext $base.$perf_ext
123 set fd
[open $base.$perf_ext r
]
126 if [regexp
"TIME" $line] {
127 if [regexp
"TIME -1" $line] {
128 fail
"$testcase perf check: no consistent time available, $optstr"
130 } elseif
![regexp
"(\[0-9\]+)" "$line" val] {
134 #
Report problems with an existing file.
136 fail
"$testcase perf check: file $base.$perf_ext has wrong format, $optstr"
139 profopt
-cleanup $testcase $perf_ext
144 # dg
-final
-generate
-- process code to run after the profile
-generate step
146 #
ARGS is the line number of the directive followed by the commands.
148 proc dg
-final
-generate
{ args } {
149 global generate_final_code
151 if { [llength $
args] > 2 } {
152 error
"[lindex $args 0]: too many arguments"
155 append generate_final_code
"[lindex $args 1]\n"
159 # dg
-final
-use
-- process code to run after the profile
-use step
161 #
ARGS is the line number of the directive followed by the commands.
163 proc dg
-final
-use
{ args } {
164 global use_final_code
166 if { [llength $
args] > 2 } {
167 error
"[lindex $args 0]: too many arguments"
170 append use_final_code
"[lindex $args 1]\n"
174 # dg
-final
-use
-not
-autofdo
-- process code to run after the profile
-use step
175 # but only
if not running autofdo
176 #
ARGS is the line number of the directive followed by the commands.
178 proc dg
-final
-use
-not
-autofdo
{ args } {
179 global use_final_code
182 if { [llength $
args] > 2 } {
183 error
"[lindex $args 0]: too many arguments"
187 if { $run_autofdo
== 1 } {
190 append use_final_code
"[lindex $args 1]\n"
194 # dg
-final
-use
-autofdo
-- process code to run after the profile
-use step
195 # but only
if running autofdo
196 #
ARGS is the line number of the directive followed by the commands.
199 proc dg
-final
-use
-autofdo
{ args } {
200 global use_final_code
203 if { [llength $
args] > 2 } {
204 error
"[lindex $args 0]: too many arguments"
208 if { $run_autofdo
!= 1 } {
211 append use_final_code
"[lindex $args 1]\n"
215 # profopt
-final
-code
-- run final code
217 # WHICH is
"generate" or "use".
218 # FINAL_CODE is the TCL code to run.
219 # TESTCASE is the
name of the test
, for error messages.
221 proc profopt
-final
-code
{ which final_code
name } {
222 # This is copied from dg
-test in dg.exp of DejaGnu.
223 regsub
-all
"\\\\(\[{}\])" $final_code "\\1" final_code
224 proc profopt
-final
-proc
{ args } $final_code
225 if [catch
"profopt-final-proc $name" errmsg] {
226 perror
"$name: error executing dg-final-${which}: $errmsg"
227 unresolved
"$name: Error executing dg-final-${which}: $errmsg"
232 # profopt
-get-options
-- process test directives
234 # SRC is the full pathname of the testcase.
236 proc profopt
-get-options
{ src
} {
237 # dg
-options sets a
variable called dg
-extra
-tool
-flags.
238 set dg
-extra
-tool
-flags
""
240 # dg
-require
-* sets dg
-do-what.
241 upvar dg
-do-what dg
-do-what
243 # current_compiler_flags reads tool_flags from the same stack frame
244 # as dg
-extra
-tool
-flags
247 set tmp
[dg
-get-options $src
]
249 set cmd
[lindex $op
0]
250 if { ![string compare
"dg-options" $cmd] \
251 ||
![string compare
"dg-skip-if" $cmd] \
252 ||
![string compare
"dg-final-generate" $cmd] \
253 ||
![string compare
"dg-final-use" $cmd] \
254 ||
![string compare
"dg-final-use-not-autofdo" $cmd] \
255 ||
![string compare
"dg-final-use-autofdo" $cmd] \
256 ||
![string compare
"dg-additional-sources" $cmd] \
257 ||
[string match
"dg-require-*" $cmd] } {
258 set status [catch
"$op" errmsg]
259 if { $
status != 0 } {
260 perror
"$src: $errmsg for \"$op\"\n"
261 unresolved
"$src: $errmsg for \"$op\""
265 # Ignore unrecognized dg
- commands
, but warn about them.
266 warning
"profopt.exp does not support $cmd"
270 #
Return flags to use
for compiling the primary source file and
for
272 return $
{dg
-extra
-tool
-flags
}
275 # auto
-profopt
-execute -- Compile for auto profiling and
then feedback
,
276 #
then normal. SRC is the full path
name of the testcase.
277 proc auto
-profopt
-execute { src
} {
278 global profile_wrapper
279 global profile_option
280 global feedback_option
284 if { ! [check_profiling_available
"-fauto-profile"] } {
285 regsub
"(?q)$srcdir/" $src "" testcase
286 unsupported
"$src -fauto-profile"
289 set profile_wrapper
[profopt
-perf
-wrapper
]
290 set profile_option
"-g"
291 set feedback_option
"-fauto-profile"
294 unset profile_wrapper
296 unset feedback_option
301 # c
-prof
-execute -- compile for profiling and
then feedback
, then normal
303 # SRC is the full pathname of the testcase.
305 proc profopt
-execute { src
} {
307 global PROFOPT_OPTIONS
308 global tool profile_option feedback_option prof_ext perf_ext perf_delta
309 global profile_wrapper run_autofdo ld_library_path
310 global generate_final_code use_final_code
312 global testname_with_flags
314 if ![info exists profile_option
] {
315 error
"No profile option specified for first compile."
317 if ![info exists feedback_option
] {
318 error
"No feedback option specified for second compile."
320 if ![info exists profile_wrapper
] {
321 set profile_wrapper
""
323 if ![info exists run_autofdo
] {
327 # Use the default option list or one defined
for a
set of tests.
328 if ![info exists PROFOPT_OPTIONS
] {
329 error
"PROFOPT_OPTIONS is not defined"
331 set prof_option_list $PROFOPT_OPTIONS
333 regsub
"(?q)$srcdir/" $src "" testcase
334 #
If we couldn
't rip $srcdir out of `src' then just
do the best we can.
335 # The point is to reduce the unnecessary noise in the logs. Don
't strip
336 # out too much because different testcases with the same name can confuse
338 if [string match
"/*" $testcase] {
339 set testcase
"[file tail [file dirname $src]]/[file tail $src]"
342 # Several procedures access the
name of the test with torture flags
,
343 # normally defined in dg
-test. Profile optimization tests don
't
344 # use dg-test, so define it here to make it accessible via
345 # testname-for-summary.
346 set testname_with_flags $testcase
348 set executable $tmpdir/[file tail [file rootname $src].x]
349 set basename [file tail $testcase]
350 set base [file rootname $basename]
353 foreach option $prof_option_list {
354 set execname1 "${executable}${count}1"
355 set execname2 "${executable}${count}2"
356 set execname3 "${executable}${count}3"
359 remote_file build delete $execname1
360 remote_file build delete $execname2
361 remote_file build delete $execname3
362 verbose "Testing $testcase, $option" 1
364 # Remove old performance data files.
365 if [info exists perf_ext] {
366 profopt-cleanup $testcase $perf_ext
369 # Process test directives.
371 set generate_final_code ""
372 set use_final_code ""
373 set dg-do-what [list "run" "" P]
374 set extra_flags [profopt-get-options $src]
375 if { [lindex ${dg-do-what} 1 ] == "N" } {
376 unsupported "$testcase"
377 unset testname_with_flags
378 verbose "$src not supported on this target, skipping it" 3
382 # schedule removal of dump files et al
383 # Do this before the call below destroys additional_sources..
384 append use_final_code [schedule-cleanups "$option $extra_flags"]
385 set extra_options [dg-additional-files-options "" "$src"]
387 # Remove old profiling data files. Make sure additional_sources_used is
388 # valid, by running it after dg-additional-files-options.
389 foreach ext $prof_ext {
390 profopt-target-cleanup $tmpdir $base $ext
391 profopt-target-cleanup $tmpdir $base "perf.data"
394 # Tree profiling requires TLS runtime support, which may need
396 if { [string first "-fprofile-generate" $profile_option] >= 0 } {
397 set extra_flags [add_options_for_tls $extra_flags]
400 # Compile for profiling.
402 set options "$extra_options"
403 lappend options "additional_flags=$option $extra_flags $profile_option"
404 set optstr "$option $profile_option"
405 set comp_output [${tool}_target_compile "$src" "$execname1" executable $options]
406 if ![${tool}_check_compile "$testcase compilation" $optstr $execname1 $comp_output] {
407 unresolved "$testcase execution, $optstr"
408 unresolved "$testcase compilation, $option $feedback_option"
409 unresolved "$testcase execution, $option $feedback_option"
413 # Run the profiled test.
414 if { $run_autofdo == 1 } {
415 if { ![info exists ld_library_path]} {
416 set ld_library_path ""
418 set orig_ld_library_path "[getenv LD_LIBRARY_PATH]"
419 setenv LD_LIBRARY_PATH "$ld_library_path:$orig_ld_library_path"
420 verbose -log "Running $profile_wrapper -o $tmpdir/$base.perf.data $execname1"
421 set id [remote_spawn "" "$profile_wrapper -o $tmpdir/$base.perf.data $execname1" "readonly"]
422 setenv LD_LIBRARY_PATH $orig_ld_library_path
424 warning "Failed to run profiler"
427 set result [remote_wait "" 300]
428 set status [lindex $result 0]
429 verbose "perf result $result"
430 if { $status == 0 } {
437 set result [${tool}_load $execname1 "" ""]
438 set status [lindex $result 0]
443 # Make sure the profile data was generated, and fail if not.
444 if { $status == "pass" } {
446 if { $run_autofdo == 1 } {
448 set cmd "create_gcov --binary $execname1 --profile=$tmpdir/$base.perf.data -gcov_version=1 --gcov=$tmpdir/$bprefix$base.$ext"
449 verbose "Running $cmd"
450 set id [remote_spawn "" $cmd]
452 unsupported "$src -fauto-profile: cannot run create_gcov"
456 set status [remote_wait "" 300]
460 foreach ext $prof_ext {
461 remote_upload target $tmpdir/$bprefix$base.$ext
462 set files [glob -nocomplain $bprefix$base.$ext]
463 if { $files == "" } {
466 fail "$testcase execution: file $bprefix$base.$ext does not exist, $option $profile_option"
470 if { $missing_file == 0 } {
471 $status "$testcase execution, $optstr"
474 # If there is dg-final code to execute for the generate step, do it
475 # even if it failed; it might clean up temporary files.
476 if ![string match $generate_final_code ""] {
477 profopt-final-code "generate" $generate_final_code $testcase
480 remote_file build delete $execname1
482 # Quit for this round if it failed
483 if { $status != "pass" } {
484 unresolved "$testcase compilation, $option $feedback_option"
485 unresolved "$testcase execution, $option $feedback_option"
489 # Compile with feedback-directed optimizations.
491 set options "$extra_options"
492 lappend options "additional_flags=$option $extra_flags $feedback_option"
493 set optstr "$option $feedback_option"
494 if { [string first "-fauto-profile" $options] >= 0} {
495 set options [regsub -- "-fauto-profile" $options "-fauto-profile=$tmpdir/$bprefix$base.$ext"]
498 set comp_output [${tool}_target_compile "$src" "$execname2" "executable" $options]
500 # Prune warnings we know are unwanted.
501 set comp_output [prune_warnings $comp_output]
503 if ![${tool}_check_compile "$testcase compilation" $optstr $execname2 $comp_output] {
504 unresolved "$testcase execution, $optstr"
508 # Run the profile-directed optimized test.
510 set result [${tool}_load "$execname2" "" ""]
511 set status [lindex $result 0]
512 $status "$testcase execution, $optstr"
514 # If there is dg-final code to execute for the use step, do it.
515 if ![string match $use_final_code ""] {
516 profopt-final-code "use" $use_final_code $testcase
519 # Remove the profiling data files.
520 foreach ext $prof_ext {
521 profopt-target-cleanup $tmpdir "$bprefix$base" $ext
522 profopt-target-cleanup $tmpdir $base "perf.data"
523 profopt-target-cleanup $tmpdir $base "gcda.imports"
526 if { $status != "pass" } {
530 # If the test is not expected to produce performance data then
532 if ![info exists perf_ext
] {
533 remote_file build
delete $execname2
537 #
Get the performance data from the test built with
538 # profile
-directed optimization.
If the file doesn
't exist or if
539 # the value is zero, skip the performance comparison.
540 set val2 [profopt-perf-value $testcase $perf_ext $optstr]
542 remote_file build delete $execname2
546 # Compile with normal optimizations.
548 set options "$extra_options"
549 lappend options "additional_flags=$option"
551 set comp_output [${tool}_target_compile "$src" "$execname3" "executable" $options]
552 if ![${tool}_check_compile "$testcase compilation" $optstr $execname3 $comp_output] {
553 unresolved "$testcase execution, $optstr"
554 unresolved "$testcase perf check, $optstr"
558 # Run the test with normal optimizations.
560 set result [${tool}_load "$execname3" "" ""]
561 set status [lindex $result 0]
562 $status "$testcase execution, $optstr"
563 if { $status != "pass" } {
564 unresolved "$testcase perf check, $optstr"
568 # Get the performance data from the test built with normal
570 set val1 [profopt-perf-value $testcase $perf_ext $optstr]
573 # The data file existed with the profile-directed
574 # optimization so this one should, too.
575 fail "$testcase perf check: file $base.$perf_ext does not exist, $optstr"
580 # Compare results of the two runs and fail if the time with the
581 # profile-directed optimization is significantly more than the time
584 if { $val2 > $val1 } {
585 # Check for a performance degration outside of allowable limits.
586 if { [expr $val2 - $val1] > [expr [expr $val1 * $perf_delta] / 100] } {
590 if { $status == "fail" } {
591 fail "$testcase perf check: orig: $val1 new: $val2, $optstr"
593 $status "$testcase perf check, $optstr"
594 verbose "$testcase orig: $val1 new: $val2, $optstr" 2
595 remote_file build delete $execname2
596 remote_file build delete $execname3
599 unset testname_with_flags