< prev index next >
src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/SALauncher.java
Print this page
@@ -44,71 +44,93 @@
System.out.println(" jsnap --help\tto get more information");
return false;
}
private static boolean commonHelp(String mode) {
+ return commonHelp(mode, false);
+ }
+
+ private static boolean commonHelpWithConnect(String mode) {
+ return commonHelp(mode, true);
+ }
+
+ private static boolean commonHelp(String mode, boolean canConnectToRemote) {
// --pid <pid>
// --exe <exe>
// --core <core>
- System.out.println(" --pid <pid> \tTo attach to and operate on the given live process.");
- System.out.println(" --core <corefile>\tTo operate on the given core file.");
+ // --connect [<id>@]<host>
+ System.out.println(" --pid <pid> To attach to and operate on the given live process.");
+ System.out.println(" --core <corefile> To operate on the given core file.");
System.out.println(" --exe <executable for corefile>");
+ if (canConnectToRemote) {
+ System.out.println(" --connect [<id>@]<host> To connect to a remote debug server (debugd).");
+ }
System.out.println();
System.out.println(" The --core and --exe options must be set together to give the core");
- System.out.println(" file, and associated executable, to operate on. Otherwise the --pid");
- System.out.println(" option can be set to operate on a live process.");
- System.out.println(" The arguments for --exe and --core can use absolute or relative paths.");
+ System.out.println(" file, and associated executable, to operate on. They can use");
+ System.out.println(" absolute or relative paths.");
+ System.out.println(" The --pid option can be set to operate on a live process.");
+ if (canConnectToRemote) {
+ System.out.println(" The --connect option can be set to connect to a debug server (debugd).");
+ System.out.println(" --core, --pid, and --connect are mutually exclusive.");
+ } else {
+ System.out.println(" --core and --pid are mutually exclusive.");
+ }
System.out.println();
System.out.println(" Examples: jhsdb " + mode + " --pid 1234");
System.out.println(" or jhsdb " + mode + " --core ./core.1234 --exe ./myexe");
+ if (canConnectToRemote) {
+ System.out.println(" or jhsdb " + mode + " --connect debugserver");
+ System.out.println(" or jhsdb " + mode + " --connect id@debugserver");
+ }
return false;
}
private static boolean debugdHelp() {
// [options] <pid> [server-id]
// [options] <executable> <core> [server-id]
- System.out.println(" --serverid <id> \tA unique identifier for this debug server.");
+ System.out.println(" --serverid <id> A unique identifier for this debug server.");
return commonHelp("debugd");
}
private static boolean jinfoHelp() {
// --flags -> -flags
// --sysprops -> -sysprops
- System.out.println(" --flags \tTo print VM flags.");
- System.out.println(" --sysprops \tTo print Java System properties.");
- System.out.println(" <no option> \tTo print both of the above.");
- return commonHelp("jinfo");
+ System.out.println(" --flags To print VM flags.");
+ System.out.println(" --sysprops To print Java System properties.");
+ System.out.println(" <no option> To print both of the above.");
+ return commonHelpWithConnect("jinfo");
}
private static boolean jmapHelp() {
// --heap -> -heap
// --binaryheap -> -heap:format=b
// --histo -> -histo
// --clstats -> -clstats
// --finalizerinfo -> -finalizerinfo
- System.out.println(" <no option> \tTo print same info as Solaris pmap.");
- System.out.println(" --heap \tTo print java heap summary.");
- System.out.println(" --binaryheap \tTo dump java heap in hprof binary format.");
- System.out.println(" --dumpfile <name>\tThe name of the dump file.");
- System.out.println(" --histo \tTo print histogram of java object heap.");
- System.out.println(" --clstats \tTo print class loader statistics.");
- System.out.println(" --finalizerinfo \tTo print information on objects awaiting finalization.");
- return commonHelp("jmap");
+ System.out.println(" <no option> To print same info as Solaris pmap.");
+ System.out.println(" --heap To print java heap summary.");
+ System.out.println(" --binaryheap To dump java heap in hprof binary format.");
+ System.out.println(" --dumpfile <name> The name of the dump file.");
+ System.out.println(" --histo To print histogram of java object heap.");
+ System.out.println(" --clstats To print class loader statistics.");
+ System.out.println(" --finalizerinfo To print information on objects awaiting finalization.");
+ return commonHelpWithConnect("jmap");
}
private static boolean jstackHelp() {
// --locks -> -l
// --mixed -> -m
- System.out.println(" --locks \tTo print java.util.concurrent locks.");
- System.out.println(" --mixed \tTo print both Java and native frames (mixed mode).");
- return commonHelp("jstack");
+ System.out.println(" --locks To print java.util.concurrent locks.");
+ System.out.println(" --mixed To print both Java and native frames (mixed mode).");
+ return commonHelpWithConnect("jstack");
}
private static boolean jsnapHelp() {
- System.out.println(" --all \tTo print all performance counters.");
- return commonHelp("jsnap");
+ System.out.println(" --all To print all performance counters.");
+ return commonHelpWithConnect("jsnap");
}
private static boolean toolHelp(String toolName) {
if (toolName.equals("jstack")) {
return jstackHelp();
@@ -132,38 +154,46 @@
return commonHelp("clhsdb");
}
return launcherHelp();
}
+ private static final String NO_REMOTE = null;
+
private static void buildAttachArgs(ArrayList<String> newArgs, String pid,
- String exe, String core, boolean allowEmpty) {
- if (!allowEmpty && (pid == null) && (exe == null)) {
- throw new SAGetoptException("You have to set --pid or --exe.");
+ String exe, String core, String remote, boolean allowEmpty) {
+ if (!allowEmpty && (pid == null) && (exe == null) && (remote == NO_REMOTE)) {
+ throw new SAGetoptException("You have to set --pid or --exe or --connect.");
}
if (pid != null) { // Attach to live process
if (exe != null) {
throw new SAGetoptException("Unnecessary argument: --exe");
} else if (core != null) {
throw new SAGetoptException("Unnecessary argument: --core");
+ } else if (remote != NO_REMOTE) {
+ throw new SAGetoptException("Unnecessary argument: --connect");
} else if (!pid.matches("^\\d+$")) {
throw new SAGetoptException("Invalid pid: " + pid);
}
newArgs.add(pid);
} else if (exe != null) {
- if (exe.length() == 0) {
+ if (remote != NO_REMOTE) {
+ throw new SAGetoptException("Unnecessary argument: --connect");
+ } else if (exe.length() == 0) {
throw new SAGetoptException("You have to set --exe.");
}
newArgs.add(exe);
if ((core == null) || (core.length() == 0)) {
throw new SAGetoptException("You have to set --core.");
}
newArgs.add(core);
+ } else if (remote != NO_REMOTE) {
+ newArgs.add(remote);
}
}
private static void runCLHSDB(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
@@ -188,11 +218,11 @@
pid = sg.getOptarg();
continue;
}
}
- buildAttachArgs(newArgs, pid, exe, core, true);
+ buildAttachArgs(newArgs, pid, exe, core, NO_REMOTE, true);
CLHSDB.main(newArgs.toArray(new String[newArgs.size()]));
}
private static void runHSDB(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
@@ -217,23 +247,24 @@
pid = sg.getOptarg();
continue;
}
}
- buildAttachArgs(newArgs, pid, exe, core, true);
+ buildAttachArgs(newArgs, pid, exe, core, NO_REMOTE, true);
HSDB.main(newArgs.toArray(new String[newArgs.size()]));
}
private static void runJSTACK(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
- String[] longOpts = {"exe=", "core=", "pid=",
+ String[] longOpts = {"exe=", "core=", "pid=", "connect=",
"mixed", "locks"};
ArrayList<String> newArgs = new ArrayList();
String pid = null;
String exe = null;
String core = null;
+ String remote = NO_REMOTE;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
@@ -245,34 +276,39 @@
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("connect")) {
+ remote = sg.getOptarg();
+ continue;
+ }
if (s.equals("mixed")) {
newArgs.add("-m");
continue;
}
if (s.equals("locks")) {
newArgs.add("-l");
continue;
}
}
- buildAttachArgs(newArgs, pid, exe, core, false);
+ buildAttachArgs(newArgs, pid, exe, core, remote, false);
JStack jstack = new JStack(false, false);
jstack.runWithArgs(newArgs.toArray(new String[newArgs.size()]));
}
private static void runJMAP(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
- String[] longOpts = {"exe=", "core=", "pid=",
+ String[] longOpts = {"exe=", "core=", "pid=", "connect=",
"heap", "binaryheap", "dumpfile=", "histo", "clstats", "finalizerinfo"};
ArrayList<String> newArgs = new ArrayList();
String pid = null;
String exe = null;
String core = null;
+ String remote = NO_REMOTE;
String s = null;
String dumpfile = null;
boolean requestHeapdump = false;
while((s = sg.next(null, longOpts)) != null) {
@@ -286,10 +322,14 @@
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("connect")) {
+ remote = sg.getOptarg();
+ continue;
+ }
if (s.equals("heap")) {
newArgs.add("-heap");
continue;
}
if (s.equals("binaryheap")) {
@@ -323,23 +363,24 @@
} else {
newArgs.add("-heap:format=b,file=" + dumpfile);
}
}
- buildAttachArgs(newArgs, pid, exe, core, false);
+ buildAttachArgs(newArgs, pid, exe, core, remote, false);
JMap.main(newArgs.toArray(new String[newArgs.size()]));
}
private static void runJINFO(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
- String[] longOpts = {"exe=", "core=", "pid=",
+ String[] longOpts = {"exe=", "core=", "pid=", "connect=",
"flags", "sysprops"};
ArrayList<String> newArgs = new ArrayList();
String exe = null;
String pid = null;
String core = null;
+ String remote = NO_REMOTE;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
@@ -351,32 +392,37 @@
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("connect")) {
+ remote = sg.getOptarg();
+ continue;
+ }
if (s.equals("flags")) {
newArgs.add("-flags");
continue;
}
if (s.equals("sysprops")) {
newArgs.add("-sysprops");
continue;
}
}
- buildAttachArgs(newArgs, pid, exe, core, false);
+ buildAttachArgs(newArgs, pid, exe, core, remote, false);
JInfo.main(newArgs.toArray(new String[newArgs.size()]));
}
private static void runJSNAP(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
- String[] longOpts = {"exe=", "core=", "pid=", "all"};
+ String[] longOpts = {"exe=", "core=", "pid=", "connect=", "all"};
ArrayList<String> newArgs = new ArrayList();
String exe = null;
String pid = null;
String core = null;
+ String remote = NO_REMOTE;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
@@ -388,17 +434,21 @@
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("connect")) {
+ remote = sg.getOptarg();
+ continue;
+ }
if (s.equals("all")) {
newArgs.add("-a");
continue;
}
}
- buildAttachArgs(newArgs, pid, exe, core, false);
+ buildAttachArgs(newArgs, pid, exe, core, remote, false);
JSnap.main(newArgs.toArray(new String[newArgs.size()]));
}
private static void runDEBUGD(String[] oldArgs) {
// By default SA agent classes prefer Windows process debugger
@@ -434,11 +484,11 @@
serverid = sg.getOptarg();
continue;
}
}
- buildAttachArgs(newArgs, pid, exe, core, false);
+ buildAttachArgs(newArgs, pid, exe, core, NO_REMOTE, false);
if (serverid != null) {
newArgs.add(serverid);
}
// delegate to the actual SA debug server.
< prev index next >