You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by bu...@apache.org on 2010/12/24 22:30:17 UTC
svn commit: r781542 [1/3] -
/websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/
Author: buildbot
Date: Fri Dec 24 21:30:17 2010
New Revision: 781542
Log:
Staging update by buildbot
Added:
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/AbstractPlugin.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/EnvCheck.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/Plugin.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/Reporter.Message.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/Reporter.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/SubVM.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/SubVMTask.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/Util.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/package-frame.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/package-summary.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/package-tree.html
websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/package-use.html
Added: websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/AbstractPlugin.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/AbstractPlugin.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/AbstractPlugin.html Fri Dec 24 21:30:17 2010
@@ -0,0 +1,486 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:10 EST 2010 -->
+<TITLE>
+AbstractPlugin (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="com.sun.jini.tool.envcheck.AbstractPlugin class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="AbstractPlugin (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/AbstractPlugin.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html" title="class in com.sun.jini.tool.envcheck"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../index.html?com/sun/jini/tool/envcheck/AbstractPlugin.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="AbstractPlugin.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+com.sun.jini.tool.envcheck</FONT>
+<BR>
+Class AbstractPlugin</H2>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>com.sun.jini.tool.envcheck.AbstractPlugin</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html" title="interface in com.sun.jini.tool.envcheck">Plugin</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public abstract class <B>AbstractPlugin</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A><DT>implements <A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html" title="interface in com.sun.jini.tool.envcheck">Plugin</A></DL>
+</PRE>
+
+<P>
+Base class for plugins providing rudimentary I18N support
+<P>
+
+<P>
+<HR>
+
+<P>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected </CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#AbstractPlugin()">AbstractPlugin</A></B>()</CODE>
+
+<BR>
+ Initialize the base class by obtaining the resource bundle
+ associated with the instantiated class.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/ResourceBundle.html" title="class or interface in java.util">ResourceBundle</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#getBundle()">getBundle</A></B>()</CODE>
+
+<BR>
+ Get the resource bundle for this class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#getString(java.lang.String)">getString</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key)</CODE>
+
+<BR>
+ Get the format string associated with <code>key</code> from the
+ resource bundle for this class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#getString(java.lang.String, java.lang.Object)">getString</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> val)</CODE>
+
+<BR>
+ Get the format string associated with <code>key</code> from the
+ resource bundle for this class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#getString(java.lang.String, java.lang.Object, java.lang.Object)">getString</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> val1,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> val2)</CODE>
+
+<BR>
+ Get the format string associated with <code>key</code> from the
+ resource bundle for this class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#getString(java.lang.String, java.lang.Object, java.lang.Object, java.lang.Object)">getString</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> v1,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> v2,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> v3)</CODE>
+
+<BR>
+ Get the format string associated with <code>key</code> from the
+ resource bundle for this class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#handleUnexpectedSubtaskReturn(java.lang.Object, java.lang.String)">handleUnexpectedSubtaskReturn</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> returnedValue,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> source)</CODE>
+
+<BR>
+ Utility method which can be called to process objects of
+ unexpected type which are returned by a subtask.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#isPluginOption(java.lang.String)">isPluginOption</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> opt)</CODE>
+
+<BR>
+ Determine whether <code>arg</code> is a plugin-specific command-line
+ option for this plugin and save any necessary state.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html#taskName(java.lang.String)">taskName</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name)</CODE>
+
+<BR>
+ Return a fully qualified external class name for the given static
+ inner class name.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://
java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_com.sun.jini.tool.envcheck.Plugin"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from interface com.sun.jini.tool.envcheck.<A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html" title="interface in com.sun.jini.tool.envcheck">Plugin</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html#run(com.sun.jini.tool.envcheck.EnvCheck)">run</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="AbstractPlugin()"><!-- --></A><H3>
+AbstractPlugin</H3>
+<PRE>
+protected <B>AbstractPlugin</B>()</PRE>
+<DL>
+<DD>Initialize the base class by obtaining the resource bundle
+ associated with the instantiated class.
+<P>
+</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="isPluginOption(java.lang.String)"><!-- --></A><H3>
+isPluginOption</H3>
+<PRE>
+public boolean <B>isPluginOption</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> opt)</PRE>
+<DL>
+<DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html#isPluginOption(java.lang.String)">Plugin</A></CODE></B></DD>
+<DD>Determine whether <code>arg</code> is a plugin-specific command-line
+ option for this plugin and save any necessary state. State should
+ be saved in static fields since plugin instances may not be cached.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html#isPluginOption(java.lang.String)">isPluginOption</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html" title="interface in com.sun.jini.tool.envcheck">Plugin</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>opt</CODE> - the command-line option to examine
+<DT><B>Returns:</B><DD>true if the plugin supports this option</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getBundle()"><!-- --></A><H3>
+getBundle</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/ResourceBundle.html" title="class or interface in java.util">ResourceBundle</A> <B>getBundle</B>()</PRE>
+<DL>
+<DD>Get the resource bundle for this class.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the resource bundle</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getString(java.lang.String)"><!-- --></A><H3>
+getString</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getString</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key)</PRE>
+<DL>
+<DD>Get the format string associated with <code>key</code> from the
+ resource bundle for this class.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>key</CODE> - the key identifying the format string
+<DT><B>Returns:</B><DD>the format string</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getString(java.lang.String, java.lang.Object)"><!-- --></A><H3>
+getString</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getString</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> val)</PRE>
+<DL>
+<DD>Get the format string associated with <code>key</code> from the
+ resource bundle for this class.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>key</CODE> - the key identifying the format string<DD><CODE>val</CODE> - the value to associate with {0}
+<DT><B>Returns:</B><DD>the format string</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getString(java.lang.String, java.lang.Object, java.lang.Object)"><!-- --></A><H3>
+getString</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getString</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> val1,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> val2)</PRE>
+<DL>
+<DD>Get the format string associated with <code>key</code> from the
+ resource bundle for this class.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>key</CODE> - the key identifying the format string<DD><CODE>val1</CODE> - the value to associate with {0}<DD><CODE>val2</CODE> - the value to associate with {1}
+<DT><B>Returns:</B><DD>the format string</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getString(java.lang.String, java.lang.Object, java.lang.Object, java.lang.Object)"><!-- --></A><H3>
+getString</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getString</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> v1,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> v2,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> v3)</PRE>
+<DL>
+<DD>Get the format string associated with <code>key</code> from the
+ resource bundle for this class.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>key</CODE> - the key identifying the format string<DD><CODE>v1</CODE> - the value to associate with {0}<DD><CODE>v2</CODE> - the value to associate with {1}<DD><CODE>v3</CODE> - the value to associate with {2}
+<DT><B>Returns:</B><DD>the format string</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="taskName(java.lang.String)"><!-- --></A><H3>
+taskName</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>taskName</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name)</PRE>
+<DL>
+<DD>Return a fully qualified external class name for the given static
+ inner class name.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the unqualified name of the inner class
+<DT><B>Returns:</B><DD>the fully qualified name</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="handleUnexpectedSubtaskReturn(java.lang.Object, java.lang.String)"><!-- --></A><H3>
+handleUnexpectedSubtaskReturn</H3>
+<PRE>
+protected void <B>handleUnexpectedSubtaskReturn</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> returnedValue,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> source)</PRE>
+<DL>
+<DD>Utility method which can be called to process objects of
+ unexpected type which are returned by a subtask. If
+ <code>returnedValue</code> is not a <code>Throwable</code>,
+ then <code>Thread.dumpStack()</code> is called to help located
+ the source of the problem. Otherwise a stacktrace is printed;
+ the <code>-traces</code> option does not affect this trace.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>returnedValue</CODE> - the object returned by the subtask<DD><CODE>source</CODE> - descriptive text identifying the source at the time
+ the subtask was launched</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/AbstractPlugin.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html" title="class in com.sun.jini.tool.envcheck"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../index.html?com/sun/jini/tool/envcheck/AbstractPlugin.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="AbstractPlugin.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>
Added: websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/EnvCheck.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/EnvCheck.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/com/sun/jini/tool/envcheck/EnvCheck.html Fri Dec 24 21:30:17 2010
@@ -0,0 +1,976 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:10 EST 2010 -->
+<TITLE>
+EnvCheck (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="com.sun.jini.tool.envcheck.EnvCheck class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="EnvCheck (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/EnvCheck.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html" title="class in com.sun.jini.tool.envcheck"><B>PREV CLASS</B></A>
+ <A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html" title="interface in com.sun.jini.tool.envcheck"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../index.html?com/sun/jini/tool/envcheck/EnvCheck.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="EnvCheck.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+com.sun.jini.tool.envcheck</FONT>
+<BR>
+Class EnvCheck</H2>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>com.sun.jini.tool.envcheck.EnvCheck</B>
+</PRE>
+<HR>
+<DL>
+<DT><PRE>public class <B>EnvCheck</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></DL>
+</PRE>
+
+<P>
+Tool used to perform validity checks on the run-time environment of a client
+ or service. The output of this tool is a report; command-line options
+ control the verbosity and severity level at which report entries are
+ generated. A simple plugin architecture is implemented; a set of plugins
+ implementing a variety of checks is bundled with the tool, and support is
+ provided to allow additional plugins to be supplied by the user.
+ <p>
+ The following items are discussed below:
+ <ul>
+ <li><a href="#running">Running the Tool</a>
+ <li><a href="#processing">Processing Options</a>
+ <li><a href="#examples">Examples</a>
+ <li><a href="#plugins">Bundled Plugins</a>
+ </ul>
+
+ <a name="running"></a>
+ <h3>Running the Tool</h3>
+
+ This tool primarily validates the system properties and configuration
+ files used when starting the target client or service. This is accomplished
+ by providing the unmodified command line for launching the component as
+ arguments to the tool. Thus, for a service designed to be run by the
+ service starter having the hypothetical original command line:
+ <blockquote><pre>
+ java -Djava.security.policy=<var><b>my_policy</b></var> \
+ -jar <var><b>install_dir</b></var>/lib/start.jar mystart.config
+ </pre></blockquote>
+ the simplest invocation of the tool would be:
+ <blockquote><pre>
+ java -jar <var><b>install_dir</b></var>/lib/envcheck.jar \
+ java -Djava.security.policy=<var><b>my_policy</b></var> \
+ -jar <var><b>install_dir</b></var>/lib/start.jar mystart.config
+ </pre></blockquote>
+ Note that the entire command line, including the <code>java</code> command,
+ is supplied as arguments to the tool. The <code>java</code> command used to
+ run the tool may be different than the <code>java</code> command invoked by
+ the command line under test. The first token in the command line being
+ analyzed must not begin with a '-' and must end with the string "java".
+
+ <a name="processing"></a>
+ <h3>Processing Options</h3>
+ <p>
+ <dl>
+ <dt><b><code>-traces</code></b>
+ <dd>The implementation of a validity check may detect success or failure by
+ handling an expected exception. By default, an error message will be
+ generated in these cases, but the stack trace will be inhibited. This
+ option is a hint that stack traces are desired. It is the responsibility
+ of the individual plugin implementation to honor this option.
+ </dd>
+ <p>
+ <dt><b><code>-explain</code></b>
+ <dd>By default, the output of a validity check will be a short message with
+ enough detail to allow a knowledgeable user to interpret it; however, it
+ may not be understandable to a novice user. The <code>-explain</code>
+ option is a hint that may result in the generation of additional output
+ describing the purpose and context of the check. An explanation is output
+ the first time its associated message is output, and is not repeated. It
+ is the responsibility of the individual plugin implementation to honor
+ this option.
+ </dd>
+ <p>
+ <dt><b><code>-level</code> <var>info|warning|error</var></b>
+ <dd>The tool supports three severity levels for message generation.
+ <p>
+ <dl>
+ <dt><var>info</var>
+ <dd>'success' messages or other non-failure oriented configuration data
+ <dt><var>warning</var>
+ <dd>a condition or value has been detected that is 'legal', but which
+ could result in unintended behavior. An example is the use of
+ <code>localhost</code> in a codebase annotation.
+ <dt><var>error</var>
+ <dd>a condition has been detected that is likely due to an error
+ on the command line or in a configuration file. An example is
+ assigning the value of a non-existant file name to the
+ <code>java.util.logging.config.file</code> system property.
+ </dl>
+ <p>
+ This option is used to set the level at which message records are
+ generated. The default value is <var>warning</var>.
+ </dd>
+ <p>
+ <dt><b><code>-plugin</code> <var>file</var></b>
+
+ <dd>Identifies a JAR file containing user supplied plugins that will be run
+ after the standard plugins are run. All of the necessary support classes
+ and resources required to support the plugins must be included in this
+ file. The file must also include a resource named
+ <code>META-INF/services/com.sun.jini.tool.envcheck.Plugin</code>, which
+ contains the class names of the plugins to run listed one per line.
+ Every class listed must implement the
+ <code>com.sun.jini.tool.envcheck.Plugin</code> interface. This option
+ may be supplied zero or more times.
+ </dd>
+ <p>
+ <dt><b><code>-security</code></b>
+ <dd>A plugin specific option that is recognized by one of the bundled
+ plugins. Specifying this option will activate a number of JAAS and JSSE
+ checks. User supplied plugins wishing to recognize this option must
+ implement the <code>isPlugOption</code> method of the
+ <code>Plugin</code> interface.
+ </dd>
+ </dl>
+ <p>
+ <a name="examples"></a>
+ <h3>Examples</h3>
+
+ The following example will analyze a command line used to start a user
+ service. The command being analyzed defines a classpath and two system
+ properties, and names a class containing a <code>main</code> method:
+
+ <p>
+ <blockquote><pre>
+ java -jar <var><b>install_dir</b></var>/lib/envcheck.jar -level info -explain -traces \
+ java -cp <var><b>mylib_dir</b></var>/myservice.jar:/jini/lib/jsk-platform.jar \
+ -Djava.security.policy=<var><b>my_policy</b></var> \
+ -Djava.server.rmi.codebase=http://myhost/myservice-dl.jar \
+ myservice.MyServiceImpl
+ </blockquote></pre>
+ In this case, the tool is limited to performing validity checks on the
+ classpath, policy, and codebase values identified by the system properties
+ and options provided on the service command line. The <code>-level</code>,
+ <code>-explain</code>, and <code>-traces</code> options supplied will result
+ in the most verbose output possible from the tool.
+ <p>
+ The following example will analyze a command line used to start reggie using
+ the service starter. The command being analyzed uses a policy and service
+ starter configuration located in the working directory:
+ <p>
+ <blockquote><pre>
+ java -jar <var><b>install_dir</b></var>/lib/envcheck.jar -level error \
+ java -Djava.security.policy=<var><b>my_starterpolicy</b></var> \
+ -jar <var><b>install_dir</b></var>/lib/start.jar reggie.config
+ </blockquote></pre>
+ The tool can perform many more checks in this case because the
+ bundled plugins include built-in knowledge about the service starter
+ and its public configuration entries. The tool options used will minimize
+ the output produced by the tool.
+ <p>
+ <a name="plugins"></a>
+ <h3>Bundled Plugins</h3>
+ A set of plugins are loaded automatically by the tool to perform some
+ basic analysis.
+ <p>
+ If the command line being analyzed invokes the service starter, the tool will
+ create a <code>Configuration</code> from the arguments of the command line
+ being analyzed. Failure to create the <code>Configuration</code> will result
+ in termination of the tool, otherwise the
+ <code>com.sun.jini.start.ServiceDescriptor</code>s provided by the
+ <code>Configuration</code> are examined. The following checks are done for
+ each <code>ServiceDescriptor</code>:
+ <ul>
+ <li>Verify that the <code>getPolicy</code> method returns a reference to a
+ policy file that is valid and accessible
+ <li>Check whether that policy grants <code>AllPermissions</code> to all
+ protection domains
+ </ul>
+ The following checks are done for each
+ <code>NonActivatableServiceDescriptor</code> and each
+ <code>SharedActivatableServiceDescriptor</code>
+ <ul>
+ <li>Verify that calling <code>getServerConfigArgs</code> does not return
+ <code>null</code> or an empty array
+ <li>Verify that a <code>Configuration</code> can be constructed from those
+ args
+ <li>Verify that any entry in that <code>Configuration</code> named
+ <code>initialLookupGroups</code> does not have a value of
+ <code>ALL_GROUPS</code>
+ <li>Verify that the export codebase is defined. For each component in the
+ export codebase:
+ <ul>
+ <li>Verify that the URL is not malformed
+ <li>If it is an HTTPMD URL, verify that the necessary protocol handler
+ is installed
+ <li>Check that domain names are fully qualified
+ <li>Warn if an md5 HTTPMD URL is being used (md5 has a security hole)
+ <li>Verify that the host name in the URL can be resolved
+ <li>Verify that the host name does not resolve to a loopback address
+ <li>Verify that it's possible to open a connection using the URL
+ </ul>
+ <li>If the <code>-security</code> option was specified:
+ <ul>
+ <li>Verify that <code>javax.net.ssl.trustStore</code> is defined and
+ that the trust store it references is accessible
+ <li>Check whether <code>com.sun.jini.discovery.x500.trustStore</code>
+ is defined, and if so that the trust store it references is
+ accessible
+ <li>Check whether <code>javax.net.ssl.keyStore</code> is defined, and
+ if so that the key store it references is accessible
+ <li>Verify that a login configuration is defined and that it is
+ accessible and syntactically correct
+ </ul>
+ </ul>
+ The following checks are done for each
+ <code>SharedActivatableServiceDescriptor</code>:
+ <ul>
+ <li>Verify that any entry in that <code>Configuration</code> named
+ <code>persistenceDirectory</code> refers to either an empty directory
+ or a non-existant directory
+ </ul>
+ The following checks are done for each
+ <code>SharedActivationGroupDescriptor</code>:
+ <ul>
+ <li>Verify that the activation system is running
+ <li>Verify that the virtual machine (VM) created by that command is at
+ least version 1.4
+ <li>Verify that <code>jsk-policy.jar</code> is loaded from the extensions
+ directory
+
+ <li>Verify that <code>jsk-platform.jar</code> is in the classpath
+
+
+ <li>If <code>java.util.logging.config.file</code> is defined in the
+ properties returned by calling <code>getServerProperties</code> then
+ verify that the file it references is accessible
+ </ul>
+ A subset of these checks are performed on the command line being analyzed:
+ <ul>
+ <li>Codebase/URL checks based on the value of
+ <code>java.rmi.server.codebase</code>
+ <li>Policy file checks based on the value of
+ <code>java.security.policy</code>
+ <li>Check for <code>jsk-policy</code> being loaded by the extension
+ class loader
+ <li>Check for <code>jsk-platform</code> in the classpath
+ <li>Security checks if <code>-security</code> was specified
+ <li>The logging config file check
+ </ul>
+ In all cases, check that the local host name does not resolve to the
+ loopback address.
+<P>
+
+<P>
+<HR>
+
+<P>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#EnvCheck()">EnvCheck</A></B>()</CODE>
+
+<BR>
+ </TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#checkFile(java.lang.String, java.lang.String)">checkFile</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> prop,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> desc)</CODE>
+
+<BR>
+ Check for the existence of a file identified by a property
+ supplied on the command line being analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getArgs()">getArgs</A></B>()</CODE>
+
+<BR>
+ Get the command line arguments of the command being analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getClasspath()">getClasspath</A></B>()</CODE>
+
+<BR>
+ Get the classpath provided by the command line being analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../../../com/sun/jini/start/ServiceDescriptor.html" title="interface in com.sun.jini.start">ServiceDescriptor</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getDescriptors()">getDescriptors</A></B>()</CODE>
+
+<BR>
+ Return the <code>ServiceDescriptor</code>s contained in the service
+ starter configuration.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start">SharedActivationGroupDescriptor</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getGroupDescriptor()">getGroupDescriptor</A></B>()</CODE>
+
+<BR>
+ Return the <code>SharedActivationGroupDescriptor</code> contained in the
+ service starter configuration.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getJarToRun()">getJarToRun</A></B>()</CODE>
+
+<BR>
+ Return the name of the executable JAR file supplied on the
+ command line being analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getJavaCmd()">getJavaCmd</A></B>()</CODE>
+
+<BR>
+ Return the <code>java</code> command for the command line being analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html" title="class or interface in java.util">Properties</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getProperties()">getProperties</A></B>()</CODE>
+
+<BR>
+ Return a copy of the properties that were specified on the
+ command line being analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#getProperty(java.lang.String)">getProperty</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key)</CODE>
+
+<BR>
+ Return a property value that was specified on the command line being
+ analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#launch(com.sun.jini.start.NonActivatableServiceDescriptor, com.sun.jini.start.SharedActivationGroupDescriptor, java.lang.String)">launch</A></B>(<A HREF="../../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html" title="class in com.sun.jini.start">NonActivatableServiceDescriptor</A> d,
+ <A HREF="../../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start">SharedActivationGroupDescriptor</A> gd,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> taskName)</CODE>
+
+<BR>
+ Launch a subtask using the environment defined by the given service
+ descriptors.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#launch(com.sun.jini.start.NonActivatableServiceDescriptor, com.sun.jini.start.SharedActivationGroupDescriptor, java.lang.String, java.lang.String[])">launch</A></B>(<A HREF="../../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html" title="class in com.sun.jini.start">NonActivatableServiceDescriptor</A> d,
+ <A HREF="../../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start">SharedActivationGroupDescriptor</A> gd,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> taskName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</CODE>
+
+<BR>
+ Launch a subtask using the environment defined by the given service
+ descriptors.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#launch(java.lang.String)">launch</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> task)</CODE>
+
+<BR>
+ Launch a child VM using the <code>java</code> command, properties, and
+ options supplied on the command line.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#launch(java.lang.String, java.util.Properties, java.lang.String[], java.lang.String[])">launch</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> javaCmd,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html" title="class or interface in java.util">Properties</A> props,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] opts,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</CODE>
+
+<BR>
+ Launch a subtask VM using the <code>java</code> command given by
+ <code>javaCmd</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#launch(java.lang.String, java.lang.String[])">launch</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> task,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</CODE>
+
+<BR>
+ Launch a child VM using the <code>java</code> command, properties, and
+ options supplied on the command line being analyzed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#main(java.lang.String[])">main</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</CODE>
+
+<BR>
+ The entry point for the tool.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/sun/jini/tool/envcheck/EnvCheck.html#printStacks()">printStacks</A></B>()</CODE>
+
+<BR>
+ Return the flag indicating whether to output stack traces that
+ result from a check.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://
java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="EnvCheck()"><!-- --></A><H3>
+EnvCheck</H3>
+<PRE>
+public <B>EnvCheck</B>()</PRE>
+<DL>
+</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="main(java.lang.String[])"><!-- --></A><H3>
+main</H3>
+<PRE>
+public static void <B>main</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</PRE>
+<DL>
+<DD>The entry point for the tool. The localization resource bundle is
+ located, the plugins are loaded, and the checks are performed. The system
+ property <code>java.protocol.handler.pkgs</code> for the tool VM is set
+ to <code>net.jini.url</code> to ensure that the tool can manipulate
+ HTTPMD URLs.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>args</CODE> - the command line arguments</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getDescriptors()"><!-- --></A><H3>
+getDescriptors</H3>
+<PRE>
+public <A HREF="../../../../../com/sun/jini/start/ServiceDescriptor.html" title="interface in com.sun.jini.start">ServiceDescriptor</A>[] <B>getDescriptors</B>()</PRE>
+<DL>
+<DD>Return the <code>ServiceDescriptor</code>s contained in the service
+ starter configuration. If the command being analyzed does not invoke the
+ service starter, a zero-length array will be returned.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the descriptors in the starter configuration or an empty array</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getGroupDescriptor()"><!-- --></A><H3>
+getGroupDescriptor</H3>
+<PRE>
+public <A HREF="../../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start">SharedActivationGroupDescriptor</A> <B>getGroupDescriptor</B>()</PRE>
+<DL>
+<DD>Return the <code>SharedActivationGroupDescriptor</code> contained in the
+ service starter configuration. Returns <code>null</code> if there is no
+ such descriptor, or if the command being analyzed does not invoke the
+ service starter.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the <code>SharedActivationGroupDescriptor</code> or
+ <code>null</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getArgs()"><!-- --></A><H3>
+getArgs</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] <B>getArgs</B>()</PRE>
+<DL>
+<DD>Get the command line arguments of the command being analyzed.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the args</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="printStacks()"><!-- --></A><H3>
+printStacks</H3>
+<PRE>
+public boolean <B>printStacks</B>()</PRE>
+<DL>
+<DD>Return the flag indicating whether to output stack traces that
+ result from a check.
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="launch(java.lang.String, java.lang.String[])"><!-- --></A><H3>
+launch</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>launch</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> task,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</PRE>
+<DL>
+<DD>Launch a child VM using the <code>java</code> command, properties, and
+ options supplied on the command line being analyzed. If an executable JAR
+ file was specified, the classpath of the child VM consists of the JAR
+ file name augmented with the classpath of the tool and plugins. If a main
+ class was specified, the classpath of the child VM consists of the
+ <code>-cp/-classpath</code> option value of the command line being
+ analyzed augmented with the classpath of the tool and plugins.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>task</CODE> - the class name of the task to launch, which must implement
+ the <code>SubVMTask</code> interface<DD><CODE>args</CODE> - the arguments to pass to the main method of the task
+<DT><B>Returns:</B><DD>the result or exception returned by the subtask supplied as a
+ serialized object written on the subtask's
+ <code>System.out</code> stream.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="launch(java.lang.String)"><!-- --></A><H3>
+launch</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>launch</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> task)</PRE>
+<DL>
+<DD>Launch a child VM using the <code>java</code> command, properties, and
+ options supplied on the command line. If an executable JAR file was
+ specified, the classpath of the child VM consists of the JAR file name
+ augmented with the classpath of the tool and plugins. If a main class was
+ specified, the classpath of the child VM consists of the
+ <code>-cp/-classpath</code> option value of the command line being
+ analyzed augmented with the classpath of the tool and plugins.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>task</CODE> - the class name of the task to launch, which must implement
+ the <code>SubVMTask</code> interface
+<DT><B>Returns:</B><DD>the result or exception returned by the subtask supplied as a
+ serialized object written on the subtask's
+ <code>System.out</code> stream.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getProperty(java.lang.String)"><!-- --></A><H3>
+getProperty</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getProperty</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> key)</PRE>
+<DL>
+<DD>Return a property value that was specified on the command line being
+ analyzed. Only properties explicitly defined on the command line will
+ resolve to a value.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>key</CODE> - the name of the property
+<DT><B>Returns:</B><DD>the property value, or <code>null</code> if undefined</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getProperties()"><!-- --></A><H3>
+getProperties</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html" title="class or interface in java.util">Properties</A> <B>getProperties</B>()</PRE>
+<DL>
+<DD>Return a copy of the properties that were specified on the
+ command line being analyzed. The caller may modify the returned
+ properties object.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the properties, which may be empty</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="launch(java.lang.String, java.util.Properties, java.lang.String[], java.lang.String[])"><!-- --></A><H3>
+launch</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>launch</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> javaCmd,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html" title="class or interface in java.util">Properties</A> props,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] opts,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</PRE>
+<DL>
+<DD>Launch a subtask VM using the <code>java</code> command given by
+ <code>javaCmd</code>. If <code>javaCmd</code> is <code>null</code>, the
+ command to run is derived from the value of the <code>java.home</code>
+ property of the tool VM. The first value in <code>args</code> must name
+ a class that implements the <code>SubVMTask</code> interface. The
+ <code>props</code> and <code>opts</code> arrays must contain fully
+ formatted command line values for properties and options
+ (i.e. "-Dfoo=bar" or "-opt"). <code>opts</code> must include a
+ <code>-cp</code> or <code>-classpath</code> option and its value must
+ completely specify the classpath required to run the subtask.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>javaCmd</CODE> - the <code>java</code> command to execute, or
+ <code>null</code> to create another instance of the
+ tool VM<DD><CODE>props</CODE> - properties to define, which may be <code>null</code> or
+ empty<DD><CODE>opts</CODE> - options to define, which must include a classpath
+ definition<DD><CODE>args</CODE> - arguments to pass to the child VM
+<DT><B>Returns:</B><DD>the result or exception returned by the subtask supplied
+ as a serialized object written on the subtask's
+ <code>System.out</code> stream.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>opts</code> does not
+ include a classpath definition, or if <code>args[0]</code>
+ does not contain the name of a class that implements
+ <code>SubVMTask</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="launch(com.sun.jini.start.NonActivatableServiceDescriptor, com.sun.jini.start.SharedActivationGroupDescriptor, java.lang.String)"><!-- --></A><H3>
+launch</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>launch</B>(<A HREF="../../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html" title="class in com.sun.jini.start">NonActivatableServiceDescriptor</A> d,
+ <A HREF="../../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start">SharedActivationGroupDescriptor</A> gd,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> taskName)</PRE>
+<DL>
+<DD>Launch a subtask using the environment defined by the given service
+ descriptors. Calling this method is equivalent to calling
+ <code>launch(d, g, taskName, null)</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>d</CODE> - the services descriptor, which may be <code>null</code><DD><CODE>gd</CODE> - the group descriptor, which may be <code>null</code<DD><CODE>taskName</CODE> - the name of the subtask to run
+<DT><B>Returns:</B><DD>the result or exception returned by the subtask supplied as a
+ serialized object written on the subtask's
+ <code>System.out</code> stream.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="launch(com.sun.jini.start.NonActivatableServiceDescriptor, com.sun.jini.start.SharedActivationGroupDescriptor, java.lang.String, java.lang.String[])"><!-- --></A><H3>
+launch</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>launch</B>(<A HREF="../../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html" title="class in com.sun.jini.start">NonActivatableServiceDescriptor</A> d,
+ <A HREF="../../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start">SharedActivationGroupDescriptor</A> gd,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> taskName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] args)</PRE>
+<DL>
+<DD>Launch a subtask using the environment defined by the given service
+ descriptors.
+ <p>
+ If <code>d</code> and <code>gd</code> are both <code>null</code>, then
+ calling this method is equivalent to calling
+ <code>launch(taskName, args)</code>.
+ <p>
+
+ If <code>d</code> is <code>null</code> and <code>gd</code> is
+ non-<code>null</code> then the properties are taken from
+ <code>gd.getServerProperties()</code> and the
+ <code>java.security.policy</code> property is added or replaced with the
+ value of <code>gd.getPolicy()</code>. The options are taken from
+ <code>gd.getServerOptions()</code>, but any <code>-cp/-classpath</code>
+ option is discarded; a <code>-cp</code> option is added that is the value
+ of <code>gd.getClasspath()</code> augmented with the classpath of the
+ tool and plugins. If <code>gd.getServerCommand()</code> is
+ non-<code>null</code>, its value is used to invoke the child VM;
+ otherwise the <code>java</code> command of the command line being
+ analyzed is used. The arguments passed to the child VM consist of an
+ array whose first element is <code>taskName</code> and whose remaining
+ elements are taken from <code>args</code>.
+
+ <p>
+
+ If <code>d</code> is not <code>null</code>, but <code>gd</code> is
+ <code>null</code>, then if <code>d</code> is an instance of
+ <code>SharedActivatableServiceDescriptor</code> an
+ <code>IllegalArgumentException</code> is thrown. Otherwise the properties
+ and options are taken from the command line being analyzed. The
+ <code>java.security.policy</code> property is added or replaced using the
+ value of <code>d.getPolicy()</code>. The <code>-cp/-classpath</code>
+ option is replaced with the value of <code>d.getImportCodebase()</code>
+ augmented with the classpath of the tool and plugins. The arguments
+ passed to the child VM consist of <code>taskName</code> followed by
+ <code>args</code> if <code>args</code> is non-<code>null</code>, or
+ followed by <code>d.getServerConfigArgs()</code> otherwise. The VM is
+ invoked using the <code>java</code> command of the command line being
+ analyzed.
+
+ <p>
+
+ if <code>d</code> and <code>gd</code> are both non-<code>null</code> then
+ if <code>d</code> is an instance of
+ <code>SharedActivatableServiceDescriptor</code> then the properties,
+ options, and <code>java</code> command are taken from
+ <code>gd.getServerProperties()</code>,
+ <code>gd.getServerOptions()</code>, and
+ <code>gd.getServerCommand()</code>; however, if the value of
+ <code>gd.getServerCommand()</code> is <code>null</code>, the
+ <code>java</code> command is taken from the command line being
+ analysed. If <code>d</code> is not an instance of
+ <code>SharedActivatableServiceDescriptor</code> then the properties,
+ options, and <code>java</code> command are taken from the command line
+ being analyzed. In all cases the <code>java.security.policy</code>
+ property is added or replaced using the value of
+ <code>d.getPolicy()</code>. The <code>-cp/-classpath</code> option is
+ added or replaced with the value of <code>d.getImportCodebase()</code>
+ augmented with the value of the classpath of the tool and plugins. The
+ arguments passed to the child VM consist of <code>taskName</code>
+ followed by <code>args</code> if <code>args</code> is
+ non-<code>null</code>, or followed by
+ <code>d.getServerConfigArgs()</code> otherwise.
+
+ <p>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>d</CODE> - the service descriptor, which may be <code>null</code><DD><CODE>gd</CODE> - the group descriptor, which may be <code>null</code<DD><CODE>taskName</CODE> - the name of the subtask to run<DD><CODE>args</CODE> - the arguments to pass to the child VM, which may be
+ <code>null</code>
+<DT><B>Returns:</B><DD>the result or exception returned by the subtask supplied as a
+ serialized object written on the subtask's
+ <code>System.out</code> stream.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getJavaCmd()"><!-- --></A><H3>
+getJavaCmd</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getJavaCmd</B>()</PRE>
+<DL>
+<DD>Return the <code>java</code> command for the command line being analyzed.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the <code>java</code> command</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="checkFile(java.lang.String, java.lang.String)"><!-- --></A><H3>
+checkFile</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>checkFile</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> prop,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> desc)</PRE>
+<DL>
+<DD>Check for the existence of a file identified by a property
+ supplied on the command line being analyzed.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>prop</CODE> - the name of the property<DD><CODE>desc</CODE> - a brief description of the file
+<DT><B>Returns:</B><DD>the property value, or <code>null</code> if undefined</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getJarToRun()"><!-- --></A><H3>
+getJarToRun</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getJarToRun</B>()</PRE>
+<DL>
+<DD>Return the name of the executable JAR file supplied on the
+ command line being analyzed.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the JAR file name, or <code>null</code> if the command line
+ did not specify one.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getClasspath()"><!-- --></A><H3>
+getClasspath</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getClasspath</B>()</PRE>
+<DL>
+<DD>Get the classpath provided by the command line being analyzed. If
+ <code>getJarToRun()</code> returns a non-<code>null</code> value then
+ its value is returned. Otherwise the value supplied by the command
+ line <code>-cp/-classpath</code> option is returned.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the classpath supplied on the command line being analyzed.</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/EnvCheck.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../com/sun/jini/tool/envcheck/AbstractPlugin.html" title="class in com.sun.jini.tool.envcheck"><B>PREV CLASS</B></A>
+ <A HREF="../../../../../com/sun/jini/tool/envcheck/Plugin.html" title="interface in com.sun.jini.tool.envcheck"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../index.html?com/sun/jini/tool/envcheck/EnvCheck.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="EnvCheck.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>