diff -r fd16c54261b3 -r 90ce3da70b43 jdk/make/mkdemo/jvmti/README.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jdk/make/mkdemo/jvmti/README.txt Sat Dec 01 00:00:00 2007 +0000 @@ -0,0 +1,58 @@ +# +# Copyright 2004 Sun Microsystems, Inc. All Rights Reserved. +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. +# +# This code is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License version 2 only, as +# published by the Free Software Foundation. Sun designates this +# particular file as subject to the "Classpath" exception as provided +# by Sun in the LICENSE file that accompanied this code. +# +# This code is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +# version 2 for more details (a copy is included in the LICENSE file that +# accompanied this code). +# +# You should have received a copy of the GNU General Public License version +# 2 along with this work; if not, write to the Free Software Foundation, +# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. +# +# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, +# CA 95054 USA or visit www.sun.com if you need additional information or +# have any questions. +# + +Instructions on adding a jvmti demo agent. + +Basically you want to mimic the jvmti demo agent "mtrace". + +* Create and populate a source directory at src/demo/jvmti + (Try and re-use code in agent_util area like src/demo/jvmti/mtrace) + (This should include a small README.txt document on what this demo is) + +* Make sure the appropriate "demo" copyright notice is added to all the + source files. + +* Edit src/share/demo/jvmti/index.html and add in reference to this demo. + +* Create make directory at make/mkdemo/jvmti + (Mimic make/mkdemo/jvmti/mtrace/Makefile) + +* Edit make/mkdemo/jvmti/Makefile and add in the new demo + +* Create test directory at test/demo/jvmti, create at least one test + (Use test/demo/jvmti/mtrace as a template) + +* Don't forget to SCCS in all the new files + +* Build and create images (cd make && gnumake && gnumake images) + (Do this on Solaris, Linux, and at least one Windows platform) + +* Verify that browsing build/*/j2sdk-images/demo/jvmti looks right + +* Run the tests: cd test/demo/jvmti && runregress . + (Do this on Solaris, Linux, and at least one Windows platform) + +Contact: jk-svc-group@sun.com for more information or help. +