Name: elR10090 Date: 04/17/2001



The default value assigned to the "home" argument for the:

    com.sun.jdi.connect.CommandLineLaunch

(which is the default connector) doesn't fit to the requirements
stated by the document:

    "Connection and Invocation Details"

While executing the "HomeTest.java" (see the sources below) against
recent Merlin (b60) and Ladybird (b21) bundles, I found that the
default value for "home" argument of the default connector doesn't
equal to the current value of "java.home" system property.

For the both Merlin and Ladybird products, the problem was observed
against the following platforms:
    - Solaris/SPARC
    - Linux
    - Windows
However, the test passes against:
    - Solaris/X86

Here is the sample test log:

    >>>> setenv JAVA_HOME /home/latkin/jdk1.3.1/solsparc
    >>>> setenv PATH ${JAVA_HOME}/bin:${PATH}
    >>>> setenv CLASSPATH .:${JAVA_HOME}/lib/tools.jar
    >>>> javac HomeTest.java
    >>>> java HomeTest ; echo Exit status: $status

    ERROR: default "home" argument differs from the "java.home" path:
    defaultArguments.home=/export/ld54/java/dest/jdk1.3.1-b21/solsparc
    Property("java.home")=/export/ld54/java/dest/jdk1.3.1-b21/solsparc/jre
    Exit status: 97

Following is the source code for "HomeTest.java":
-------------------------------------------------

/* @(#)HomeTest.java 1.1 01/04/17
 * Copyright 04/17/01 Sun Microsystems, Inc.
 */

import java.io.*;
import java.util.*;

import com.sun.jdi.*;
import com.sun.jdi.connect.*;

/**
 * Check if the "home" argument of the default connector's default
 * arguments is assigned properly. Particularly, the <i>Coonection
 * and Invocation Details</i> requires, that the "home" default
 * value equal to the current value of the "java.home" system property.
 *
 * @author Eugene I. Latkin
 * @version 1.1
 */
public class HomeTest {
    public static void main(String args[]) {
        int exitCode = run(args,System.out);
        System.exit(exitCode + 95);
        // JCK-like exit status
    }

    public static int run(String args[], PrintStream out) {
        VirtualMachineManager vmm = Bootstrap.virtualMachineManager();
        LaunchingConnector defaultConnector = vmm.defaultConnector();
        Map arguments = defaultConnector.defaultArguments();
        String argsHome = getValue(arguments,"home");
        String javaHome = System.getProperty("java.home");
        if (argsHome.equals(javaHome))
            return 0; // TEST PASSED
        out.println("ERROR: default \"home\" argument differs from" +
            " the \"java.home\" path:");
        out.println("defaultArguments.home=" + argsHome);
        out.println("Property(\"java.home\")=" + javaHome);
        return 2; // TEST FAILED
    }
    
    private static String getValue(Map arguments, String key) {
        Connector.Argument x = (Connector.StringArgument) arguments.get(key);
        return x.value();
    }
}

-------------------------------------------------

As a side effect, this bug prevents applications using the default
connector with the default value for "home" argument from starting
target VM with java_g at Solaris/X86 platform. See the bug:

    4433599 java_g is missed from $JAVA_HOME/jre/bin

======================================================================