Mailing-List: contact harmony-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: harmony-dev@incubator.apache.org
Message-ID: <1489303.1152897314788.JavaMail.jira@brutus>
Date: Fri, 14 Jul 2006 10:15:14 -0700 (PDT)
From: "Vera Volynets (JIRA)" <jira@apache.org>
To: harmony-commits@incubator.apache.org
Subject: [jira] Updated: (HARMONY-881) DRLVM GC heap verification
 infrastructure
In-Reply-To: <11482416.1152896841309.JavaMail.jira@brutus>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

     [ http://issues.apache.org/jira/browse/HARMONY-881?page=all ]

Vera Volynets updated HARMONY-881:
----------------------------------

    Attachment: 0002-Checks-correctness-of-gc-work.txt

This is GC  heap verification infrastructure.
It verifys that the structure of object reference graph stays
exactly the same during collection. Therefore
number of strongly reachable live objects and
live bytes before and after GC should stay
unchanged.

Run vm with option:
-Dvm.verify.gc=true in command line.

---

d9d2f53581754029e051b91bd6bbfdecf10e34fb
 vm/vmcore/include/environment.h                   |    3 
 vm/vmcore/include/gc_debug.h                      |   24 +
 vm/vmcore/src/gc/gc_debug.cpp                     |  417 +++++++++++++++++++++
 vm/vmcore/src/gc/stop_the_world_root_set_enum.cpp |   12 +
 vm/vmcore/src/init/vm.cpp                         |    3 
 vm/vmcore/src/init/vm_main.cpp                    |    7 
 6 files changed, 462 insertions(+), 4 deletions(-)


> DRLVM GC heap verification infrastructure
> -----------------------------------------
>
>                 Key: HARMONY-881
>                 URL: http://issues.apache.org/jira/browse/HARMONY-881
>             Project: Harmony
>          Issue Type: New Feature
>          Components: Contributions
>            Reporter: Vera Volynets
>         Attachments: 0001-Add-function-to-gc-interface.txt, 0002-Checks-correctness-of-gc-work.txt
>
>
> *************   GC heap verification infrastructure   *************** 
> Hi,
> I have been working on implementing GC heap verification infrastructure for Stop-The-World GC in DRLVM.
> This infrastructure is intended be used with any stop-the-world GC implementation, conforming to the GC-VM interface (described in gc.h and vm_gc.h), with only a minor GC-VM interface change. 
> It works on Windows and Linux ia32 platforms.
>  
> *Description*
> GC heap verification infrastructure is a small module which is hijacked into GC-VM interface.
> The main idea is to substitute GC interface function so that necessary information can be easily collected.
>  
> Everybody who is interested in GC development and debugging is invited
> to try it, modify files and add their own functionality.
>  
> At this moment GC heap verification infrastructure verifies that the structure of object reference graph stays exactly the same during collection. Therefore, the number of strongly reachable live objects and live bytes before and after GC should stay unchanged.
>  
> The verification is performed in two phases:
> 1) On the start of Stop-The-World phase, all enumerated roots to GC by VM are cached by GC heap verification infrastructure and heap is traversed, constructing heap "fingerprint", recording the order of the objects and counting their number and size.   
> 2) After actual garbage collection is complete, before resuming user threads, the heap is traced once again and the heap structure is verified. 
>  
> *Patch contents*
> This is an individual contribution, and it was prepared according to the requirements of Apache cleanroom process; the size of two files all in all is about 30kb (161 and 585 lines). 
> -Patch Add-function-to-gc-interface.txt
> It adds function gc_add_finalizable_root_set_entry() for separate counting of finalizable objects because the GC may not preserve ordering of finalizable objects, and thus the heap structure can be changed.
>  
> -Patch Checks-correctness-of-gc-work.txt
> The heart of this patch is file gc_debug.cpp.
> The tracing of heap starts with debug_gc_trace_heap() function.
>  
> *Users guide*
> The debugging mode is off by default, and has no impact on the GC performance.. 
> - To turn on GC Debug infrastructure use VM with -Dvm.verify.gc=true option in command line.
> - To see debug information build VM in debug mode, BUILD_CFG=debug, and use logger in usual way.
> When enabled, the verification heap trace takes quite a bit of time (two times for each collection: before and after actual collection), GC pauses increase by 1.5-2 times (from 1406ms to 2515ms) when running Eclipse on DRLVM built in debug configuration.   
> To apply patch: 
> patch -p1 < 000*.txt

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira