From kato-commits-return-998-apmail-incubator-kato-commits-archive=incubator.apache.org@incubator.apache.org Tue Dec 22 14:26:17 2009 Return-Path: Delivered-To: apmail-incubator-kato-commits-archive@minotaur.apache.org Received: (qmail 59821 invoked from network); 22 Dec 2009 14:26:17 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 22 Dec 2009 14:26:17 -0000 Received: (qmail 15160 invoked by uid 500); 22 Dec 2009 14:26:16 -0000 Delivered-To: apmail-incubator-kato-commits-archive@incubator.apache.org Received: (qmail 15059 invoked by uid 500); 22 Dec 2009 14:26:15 -0000 Mailing-List: contact kato-commits-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: kato-dev@incubator.apache.org Delivered-To: mailing list kato-commits@incubator.apache.org Received: (qmail 15049 invoked by uid 99); 22 Dec 2009 14:26:15 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 22 Dec 2009 14:26:15 +0000 X-ASF-Spam-Status: No, hits=-2.6 required=5.0 tests=AWL,BAYES_00 X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 22 Dec 2009 14:26:08 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 3888223889FA; Tue, 22 Dec 2009 14:25:48 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r893178 - in /incubator/kato/trunk/org.apache.kato: kato.distro/src/main/readme/README kato.native.distro/src/main/assembly/nativebin.xml kato.native.distro/src/main/readme/ kato.native.distro/src/main/readme/README-native.txt Date: Tue, 22 Dec 2009 14:25:48 -0000 To: kato-commits@incubator.apache.org From: monteith@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20091222142548.3888223889FA@eris.apache.org> Author: monteith Date: Tue Dec 22 14:25:47 2009 New Revision: 893178 URL: http://svn.apache.org/viewvc?rev=893178&view=rev Log: Add separate readme for native distribution. Added: incubator/kato/trunk/org.apache.kato/kato.native.distro/src/main/readme/ incubator/kato/trunk/org.apache.kato/kato.native.distro/src/main/readme/README-native.txt Modified: incubator/kato/trunk/org.apache.kato/kato.distro/src/main/readme/README incubator/kato/trunk/org.apache.kato/kato.native.distro/src/main/assembly/nativebin.xml Modified: incubator/kato/trunk/org.apache.kato/kato.distro/src/main/readme/README URL: http://svn.apache.org/viewvc/incubator/kato/trunk/org.apache.kato/kato.distro/src/main/readme/README?rev=893178&r1=893177&r2=893178&view=diff ============================================================================== --- incubator/kato/trunk/org.apache.kato/kato.distro/src/main/readme/README (original) +++ incubator/kato/trunk/org.apache.kato/kato.distro/src/main/readme/README Tue Dec 22 14:25:47 2009 @@ -28,56 +28,22 @@ 3. Generate dump. 4. Run tool that uses API to analyze dump. -CJVMTI -====== +Native Libraries +================ -The CJVMTI agent allows the JVM to produce dumps that contain more information -about the state of the JVM than hprof. - -To start the JVM with the agent, pass the following option to the "java" command, -or equivalent: - - -agentpath:lib/cjvmti-linux-x86-${project.version}=s,r - -agentlib:cjvmti-linux-x86-${project.version}=s,r - -Where "s" is the number of stack frames that should be stored. Only those frames -will be scanned for heap roots. -"r" is the depth into the object graph the agent will store references from. -"0" should be passed as "s" or "r" if they should be are unlimited, which is the default. - -For example: - - -agentlib:cjvmti-windows-x86-${project.version}=3,4 - -Will, on Windows, store the top three stack frames and will scan all objects up to -4 references deep from those stack frames. - -With a stack trace like so: - Object.wait(long, int) - ReferenceQueue.wait(long) - ReferenceQueue.remove(long) - ReferenceQueue.remove() - Disposer.run() - Thread.run() - -Only the following stack traces would appear: - Object.wait(long, int) - ReferenceQueue.wait(long) - ReferenceQueue.remove(long) - -If there was a linked list in ReferenceQueue: - ALinkedList list; - -As the agent will only (in this case) scan objects 4 deep into the object graph, -only the 3rd object into the list would be incorporated into the dump. - -e.g. ReferenceQueue -> ALinkedList -> Node -> Node -> Node - -Limitations ------------ - -. if local variable information is not available (JIT frames, no local variable info in class), - the variables won't appear in the debugger. Heap objects may be missing as a result. +While most of this project is written in Java, there are two components +that are compiled into platform specfic code. They are the Java JVMTI agent +(CJVMTI) that generates a dump of the JVM state and a JNI library that provides +a method of initiating a dump (hprof or JVMTI) without user intervention. + +The libraries are package separately in the following packages: + + apache-kato-${project.version}-native-bin-linux-i386.tar.gz + apache-kato-${project.version}-native-bin-windows-x86.zip + +They can be unpackaged on top of this package. The libraries appear under +the lib directory. +Please see their in README-native.txt . Dump API ======== Modified: incubator/kato/trunk/org.apache.kato/kato.native.distro/src/main/assembly/nativebin.xml URL: http://svn.apache.org/viewvc/incubator/kato/trunk/org.apache.kato/kato.native.distro/src/main/assembly/nativebin.xml?rev=893178&r1=893177&r2=893178&view=diff ============================================================================== --- incubator/kato/trunk/org.apache.kato/kato.native.distro/src/main/assembly/nativebin.xml (original) +++ incubator/kato/trunk/org.apache.kato/kato.native.distro/src/main/assembly/nativebin.xml Tue Dec 22 14:25:47 2009 @@ -32,6 +32,7 @@ src/main/readme/ / + true