Return-Path: Delivered-To: apmail-incubator-harmony-commits-archive@www.apache.org Received: (qmail 71964 invoked from network); 21 Sep 2006 13:19:37 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 21 Sep 2006 13:19:37 -0000 Received: (qmail 54337 invoked by uid 500); 21 Sep 2006 13:19:36 -0000 Delivered-To: apmail-incubator-harmony-commits-archive@incubator.apache.org Received: (qmail 54120 invoked by uid 500); 21 Sep 2006 13:19:35 -0000 Mailing-List: contact harmony-commits-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: harmony-dev@incubator.apache.org Delivered-To: mailing list harmony-commits@incubator.apache.org Received: (qmail 53973 invoked by uid 99); 21 Sep 2006 13:19:34 -0000 Received: from idunn.apache.osuosl.org (HELO idunn.apache.osuosl.org) (140.211.166.84) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 21 Sep 2006 06:19:34 -0700 Authentication-Results: idunn.apache.osuosl.org smtp.mail=tellison@apache.org; spf=permerror X-ASF-Spam-Status: No, hits=-9.4 required=5.0 tests=ALL_TRUSTED,NO_REAL_NAME Received-SPF: error (idunn.apache.osuosl.org: domain apache.org from 140.211.166.113 cause and error) Received: from [140.211.166.113] ([140.211.166.113:54102] helo=eris.apache.org) by idunn.apache.osuosl.org (ecelerity 2.1.1.8 r(12930)) with ESMTP id E5/DB-04092-D4192154 for ; Thu, 21 Sep 2006 06:19:10 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id A31FD1A9823; Thu, 21 Sep 2006 06:18:36 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r448545 [4/4] - in /incubator/harmony/standard/site: ./ docs/subcomponents/drlvm/ xdocs/subcomponents/drlvm/ Date: Thu, 21 Sep 2006 13:18:34 -0000 To: harmony-commits@incubator.apache.org From: tellison@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20060921131836.A31FD1A9823@eris.apache.org> X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Modified: incubator/harmony/standard/site/docs/subcomponents/drlvm/index.html URL: http://svn.apache.org/viewvc/incubator/harmony/standard/site/docs/subcomponents/drlvm/index.html?view=diff&rev=448545&r1=448544&r2=448545 ============================================================================== --- incubator/harmony/standard/site/docs/subcomponents/drlvm/index.html (original) +++ incubator/harmony/standard/site/docs/subcomponents/drlvm/index.html Thu Sep 21 06:18:33 2006 @@ -239,15 +239,34 @@
  • README -
    - Building instructions for the VM source code. -
    +
    + Source package and building instructions for the VM source code. +
  • +
  • + + Getting Started + +
    + Basic usage scenarios of VM and lists standard + and non-standard supported options.
  • Debugging VM and JIT -
    - Guide to debugging VM and Jitrino.JET source code covering - basic actions and some useful tips -
    +
    + Guide to debugging VM and Jitrino.JET source code covering + basic actions and some useful tips +
  • +
  • + Configuring Execution Manager +
    + Guide to Execution Manager (EM) options and configuration file format.
    +
  • +
  • + How to write DRL GC +
    + Instructions on creating a custom garbage collector implementation in C++ + and configuring the DRL virtual machine to use it with a real-life example + of a copying GC implementation (source included) +
@@ -256,39 +275,30 @@

- Architecture and guides + Architecture and Component Documentation

    -
  • - - Getting Started -
    - Basic usage scenarios of VM and lists standard - and non-standard supported options. -
    -
  • +
  • Developer's Guide -
    - In-depth description of the DRLVM internal architecture and components' interaction -
    +
    + In-depth description of the DRLVM internal architecture and components' interaction +
    + Now with additions in separate documents:
  • +
    • - How to write DRL GC -
      - Instructions on creating a custom garbage collector implementation in C++ - and configuring the DRL virtual machine to use it with a real-life example - of a copying GC implementation (source included) -
      -
    • -
    • Configuring Execution Manager -
      - Guide to Execution Manager (EM) options and configuration file format.
      -
      + Execution Manager Component Description +
      + Detailed description of the Execution Manager current implementation +
      + Invalidates implementation-specific info in the DRLVM Developer's guide
    • +
    +
Modified: incubator/harmony/standard/site/xdocs/subcomponents/drlvm/gc-howto-content.html URL: http://svn.apache.org/viewvc/incubator/harmony/standard/site/xdocs/subcomponents/drlvm/gc-howto-content.html?view=diff&rev=448545&r1=448544&r2=448545 ============================================================================== --- incubator/harmony/standard/site/xdocs/subcomponents/drlvm/gc-howto-content.html (original) +++ incubator/harmony/standard/site/xdocs/subcomponents/drlvm/gc-howto-content.html Thu Sep 21 06:18:33 2006 @@ -305,24 +305,23 @@ the major steps of this procedure, namely:

  • -

    Establishing the build infrastructure -

    +
  • -

    + Implementing the GC interface -

    +
  • -

    + Implementing the garbage collector algorithm -

    +
  • -

    + Running the VM with the custom GC -

    +
Note
@@ -426,75 +425,75 @@

2.1. GC lifecycle

  • -

    + gc_init() initializes the garbage collector -

    +
  • -

    + gc_wrapup() shuts down the GC -

    +
  • -

    + gc_vm_initialized() notifies the GC about the VM transition from the initialization stage to running user applications -

    +
  • -

    + gc_thread_init() and gc_thread_kill() notify the GC about creation and termination of user threads that may request memory allocation or other GC services -

    +
  • -

    + gc_class_prepared() notifies the GC about loaded and prepared classes -

    +

2.2. Object allocation

  • -

    + gc_alloc() performs slow allocation, can trigger garbage collection -

    +
  • -

    + gc_alloc_fast() performs faster allocation, should not trigger garbage collection -

    +
  • -

    + gc_add_root_set_entry() is responsible for enumeration -

    +
  • -

    + gc_add_root_set_entry() enumerates one root pointer -

    +

See the Root set enumeration section in the Developer's Guide for details.

2.3. Miscellaneous

  • -

    + gc_supports_compressed_references() indicates whether GC supports compressed references -

    +
  • -

    + gc_is_object_pinned() indicates whether the GC will move an object or not -

    +
  • -

    + gc_force_gc() forces a garbage collection -

    +

2.4. Optional

@@ -502,48 +501,48 @@ will be unavailable.

  • -

    + gc_free_memory() returns the estimated amount of memory available for allocation -

    +
  • -

    + gc_pin_object() requests that the GC does not move an object -

    +
  • -

    + gc_unpin_object() removes the restriction on not moving an object -

    +
  • -

    + gc_get_next_live_object() iterates over live objects during the stop-the-world phase of garbage collection -

    +
  • -

    + gc_finalize_on_exit() transfers finalizable queue contents to the VM core on shutdown -

    +
  • -

    + gc_time_since_last_gc() returns the amount of time that elapsed since the previous collection, in milliseconds -

    +
  • -

    + gc_total_memory() returns the overall amount of memory used for the Java heap -

    +
  • -

    + gc_max_memory() returns the maximum amount of memory that can be used for the Java heap -

    +

2.5. The VM_GC interface

@@ -568,15 +567,15 @@ enumeration simultaneously:

  • -

    + vm_enumerate_root_set_all_threads() suspends all user threads and initiates root set enumeration -

    +
  • -

    + vm_resume_threads_after() resumes execution of user threads -

    +

These functions effectively restrict the garbage collector to stop-the-world algorithms only.

Modified: incubator/harmony/standard/site/xdocs/subcomponents/drlvm/index.xml URL: http://svn.apache.org/viewvc/incubator/harmony/standard/site/xdocs/subcomponents/drlvm/index.xml?view=diff&rev=448545&r1=448544&r2=448545 ============================================================================== --- incubator/harmony/standard/site/xdocs/subcomponents/drlvm/index.xml (original) +++ incubator/harmony/standard/site/xdocs/subcomponents/drlvm/index.xml Thu Sep 21 06:18:33 2006 @@ -51,49 +51,58 @@
  • README -
    - Building instructions for the VM source code. -
    +
    + Source package and building instructions for the VM source code. +
  • +
  • + + Getting Started + +
    + Basic usage scenarios of VM and lists standard + and non-standard supported options.
  • Debugging VM and JIT -
    - Guide to debugging VM and Jitrino.JET source code covering - basic actions and some useful tips -
    +
    + Guide to debugging VM and Jitrino.JET source code covering + basic actions and some useful tips +
  • +
  • + Configuring Execution Manager +
    + Guide to Execution Manager (EM) options and configuration file format.
    +
  • +
  • + How to write DRL GC +
    + Instructions on creating a custom garbage collector implementation in C++ + and configuring the DRL virtual machine to use it with a real-life example + of a copying GC implementation (source included) +
  • - +
      -
    • - - Getting Started -
      - Basic usage scenarios of VM and lists standard - and non-standard supported options. -
      -
    • +
    • Developer's Guide -
      - In-depth description of the DRLVM internal architecture and components' interaction -
      +
      + In-depth description of the DRLVM internal architecture and components' interaction +
      + Now with additions in separate documents:
    • +
      • - How to write DRL GC -
        - Instructions on creating a custom garbage collector implementation in C++ - and configuring the DRL virtual machine to use it with a real-life example - of a copying GC implementation (source included) -
        -
      • -
      • Configuring Execution Manager -
        - Guide to Execution Manager (EM) options and configuration file format.
        -
        + Execution Manager Component Description +
        + Detailed description of the Execution Manager current implementation +
        + Invalidates implementation-specific info in the DRLVM Developer's guide
      • +
      +