gccint: profopt Testing

1 
1 7.7 Support for testing profile-directed optimizations
1 ======================================================
1 
1 The file 'profopt.exp' provides language-independent support for
1 checking correct execution of a test built with profile-directed
1 optimization.  This testing requires that a test program be built and
1 executed twice.  The first time it is compiled to generate profile data,
1 and the second time it is compiled to use the data that was generated
1 during the first execution.  The second execution is to verify that the
1 test produces the expected results.
1 
1  To check that the optimization actually generated better code, a test
1 can be built and run a third time with normal optimizations to verify
1 that the performance is better with the profile-directed optimizations.
1 'profopt.exp' has the beginnings of this kind of support.
1 
1  'profopt.exp' provides generic support for profile-directed
1 optimizations.  Each set of tests that uses it provides information
1 about a specific optimization:
1 
1 'tool'
1      tool being tested, e.g., 'gcc'
1 
1 'profile_option'
1      options used to generate profile data
1 
1 'feedback_option'
1      options used to optimize using that profile data
1 
1 'prof_ext'
1      suffix of profile data files
1 
1 'PROFOPT_OPTIONS'
1      list of options with which to run each test, similar to the lists
1      for torture tests
1 
1 '{ dg-final-generate { LOCAL-DIRECTIVE } }'
1      This directive is similar to 'dg-final', but the LOCAL-DIRECTIVE is
1      run after the generation of profile data.
1 
1 '{ dg-final-use { LOCAL-DIRECTIVE } }'
1      The LOCAL-DIRECTIVE is run after the profile data have been used.
1