php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Request #52718 Simplifying Makefile.gcov?
Submitted: 2010-08-27 13:33 UTC Modified: 2019-09-25 08:42 UTC
From: hartmut@php.net Assigned: nikic (profile)
Status: Closed Package: Unknown/Other Function
PHP Version: 5.3SVN-2010-08-27 (SVN) OS: linux/unix
Private report: No CVE-ID: None
 [2010-08-27 13:33 UTC] hartmut@php.net
Description:
------------
Looks as if the current lcov/gcov implementation works by:

* collecting all 'interesting' files and copying/linking them
  over to a new directory lcov_data

* then removing files for which actually no coverage information
  should be generated, like bundled library sources

* finally running lcov and genhtml over the lcov_data copies

As far as i can tell the removal of bundled library stuff is the
only real reason for the copy/symlink step, or am i missing
something else there?

Assuming that this is really the only reason i'd like to propose
to use 'lcov --remove' for filtering out the bundled library stuff
instead and to run lcov and genhtml in place instead of the new
lcov_data subdir, so skipping the need for this extra directory
and the process needed to populate it.

Advantages:

* less complex (Makefile.gcov line count shrinks from 64 to 30)

* no duplication of information

* shows coverage info for a few file that the current implementation
  misses for some reason unknown to me yet, like

  * main/internal_functions.c
  * main/internal_functions_cli.c
  * ext/standard/url_scanner_ex.re
  * ext/standard/var_unserializer.re
  * Zend/zend_language_scanner.l
  * Zend/zend_ini_scanner.l

Disadvantages:

 * 'lcov --remove' is rather slow, as far as i can tell the copy&remove
   approach is a tad quicker ... the difference is not relevant when
   compared with the total time needed for a lcov analysis run though

 * genhtml still generates HTML files for files filtered out by
   'lcov --remove', so taking a bit longer to run, the files do not
   show up in any of the result overview pages though

So all in all i think the advantages justify a change while the
disadvantages are not blocking it.

The only thing that actually changes would be the 'php_lcov.info'
target in 'Makgefile.gcov', the simplified version would look
like this:

php_lcov.info: lcov-test
    @echo "Generating $@"
    @$(LTP) --directory . --capture --base-directory . --output-file $@
    @echo "Stripping bundled libraries from $@"
    @for dir in ext/bcmath/libbcmath ext/fileinfo/libmagic ext/gd/libgd ext/mbstring/libmbfl ext/mbstring/oniguruma ext/pcre/pcrelib ext/pdo_sqlite/libsqlite ext/sqlite/libsqlite ext/sqlite3/libsqlite ext/xmlrpc/libxmlrpc ext/zip/lib; do \
        echo "... removing $$dir"; \
        $(LTP) --remove $@ $$dir/\* --output-file $@ ; \
    done
    @echo

Ideas, comments, any reasons *not* to commit this? 

Test script:
---------------
see Makefile.gcov implementation

Expected result:
----------------
LCOV report generated by patched PHP 5.3 "make lcov"
see http://php-baustelle.de/lcov_newhtml

Actual result:
--------------
LCOV report generated by unpatched PHP 5.3 "make lcov"
see http://php-baustelle.de/lcov_old65html

Patches

make_lcov.diff (last revision 2010-08-27 11:40 UTC by hartmut dot holzgraefe at gmail dot com)

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2010-08-27 13:59 UTC] hholzgra@php.net
Correct link for "Actual result" is 

  http://php-baustelle.de/lcov_oldhtml
 [2010-08-30 19:11 UTC] johannes@php.net
-Status: Open +Status: Assigned -Assigned To: +Assigned To: hholzgra
 [2010-08-30 19:11 UTC] johannes@php.net
the lcov version on gcov.php.net supports the flag, so this might be ok.
 [2017-10-24 07:02 UTC] kalle@php.net
-Status: Assigned +Status: Open -Assigned To: hholzgra +Assigned To:
 [2019-09-25 08:42 UTC] nikic@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: nikic
 [2019-09-25 08:42 UTC] nikic@php.net
This was implemented in https://github.com/php/php-src/pull/4739.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Sat Nov 23 04:01:28 2024 UTC