< prev index next >
src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/SALauncher.java
Print this page
*** 44,67 ****
System.out.println(" jsnap --help\tto get more information");
return false;
}
private static boolean commonHelp(String mode) {
// --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.");
System.out.println(" --exe <executable for corefile>");
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();
System.out.println(" Examples: jhsdb " + mode + " --pid 1234");
System.out.println(" or jhsdb " + mode + " --core ./core.1234 --exe ./myexe");
return false;
}
private static boolean debugdHelp() {
// [options] <pid> [server-id]
--- 44,90 ----
System.out.println(" jsnap --help\tto get more information");
return false;
}
private static boolean commonHelp(String mode) {
+ return commonHelp(mode, false);
+ }
+
+ private static boolean commonHelpWithRemote(String mode) {
+ return commonHelp(mode, true);
+ }
+
+ private static boolean commonHelp(String mode, boolean canConnectToRemote) {
// --pid <pid>
// --exe <exe>
// --core <core>
! // --remote <[id@]server>
! System.out.println(" --pid <pid> \tTo attach to and operate on the given");
! System.out.println(" \tlive process.");
! System.out.println(" --core <corefile> \tTo operate on the given core file.");
System.out.println(" --exe <executable for corefile>");
+ if (canConnectToRemote) {
+ System.out.println(" --remote <[id@]server>\tTo operate on the remote debug server.");
+ }
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. 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 --remote option can be set to operate on a debug server.");
! System.out.println(" <--core --exe> and <--pid> and <--remote> are exclusive.");
! } else {
! System.out.println(" <--core --exe> and <--pid> are 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 + " --remote debugserver");
+ System.out.println(" or jhsdb " + mode + " --remote id@debugserver");
+ }
return false;
}
private static boolean debugdHelp() {
// [options] <pid> [server-id]
*** 74,84 ****
// --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");
}
private static boolean jmapHelp() {
// --heap -> -heap
// --binaryheap -> -heap:format=b
--- 97,107 ----
// --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 commonHelpWithRemote("jinfo");
}
private static boolean jmapHelp() {
// --heap -> -heap
// --binaryheap -> -heap:format=b
*** 87,114 ****
// --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");
}
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");
}
private static boolean jsnapHelp() {
System.out.println(" --all \tTo print all performance counters.");
! return commonHelp("jsnap");
}
private static boolean toolHelp(String toolName) {
if (toolName.equals("jstack")) {
return jstackHelp();
--- 110,137 ----
// --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 commonHelpWithRemote("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 commonHelpWithRemote("jstack");
}
private static boolean jsnapHelp() {
System.out.println(" --all \tTo print all performance counters.");
! return commonHelpWithRemote("jsnap");
}
private static boolean toolHelp(String toolName) {
if (toolName.equals("jstack")) {
return jstackHelp();
*** 132,169 ****
return commonHelp("clhsdb");
}
return launcherHelp();
}
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.");
}
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 (!pid.matches("^\\d+$")) {
throw new SAGetoptException("Invalid pid: " + pid);
}
newArgs.add(pid);
} else if (exe != null) {
! 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);
}
}
private static void runCLHSDB(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
--- 155,200 ----
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, String remote, boolean allowEmpty) {
! if (!allowEmpty && (pid == null) && (exe == null) && (remote == null)) {
! throw new SAGetoptException("You have to set --pid or --exe or --remote.");
}
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 != null) {
+ throw new SAGetoptException("Unnecessary argument: --remote");
} else if (!pid.matches("^\\d+$")) {
throw new SAGetoptException("Invalid pid: " + pid);
}
newArgs.add(pid);
} else if (exe != null) {
! if (remote != null) {
! throw new SAGetoptException("Unnecessary argument: --remote");
! } 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 != null) {
+ newArgs.add(remote);
}
}
private static void runCLHSDB(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
*** 188,198 ****
pid = sg.getOptarg();
continue;
}
}
! buildAttachArgs(newArgs, pid, exe, core, true);
CLHSDB.main(newArgs.toArray(new String[newArgs.size()]));
}
private static void runHSDB(String[] oldArgs) {
SAGetopt sg = new SAGetopt(oldArgs);
--- 219,229 ----
pid = sg.getOptarg();
continue;
}
}
! 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,239 ****
pid = sg.getOptarg();
continue;
}
}
! buildAttachArgs(newArgs, pid, exe, core, 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=",
"mixed", "locks"};
ArrayList<String> newArgs = new ArrayList();
String pid = null;
String exe = null;
String core = null;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
--- 248,271 ----
pid = sg.getOptarg();
continue;
}
}
! 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=", "remote=",
"mixed", "locks"};
ArrayList<String> newArgs = new ArrayList();
String pid = null;
String exe = null;
String core = null;
+ String remote = null;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
*** 245,278 ****
}
if (s.equals("pid")) {
pid = 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);
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=",
"heap", "binaryheap", "dumpfile=", "histo", "clstats", "finalizerinfo"};
ArrayList<String> newArgs = new ArrayList();
String pid = null;
String exe = null;
String core = null;
String s = null;
String dumpfile = null;
boolean requestHeapdump = false;
while((s = sg.next(null, longOpts)) != null) {
--- 277,315 ----
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("remote")) {
+ 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, 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=", "remote=",
"heap", "binaryheap", "dumpfile=", "histo", "clstats", "finalizerinfo"};
ArrayList<String> newArgs = new ArrayList();
String pid = null;
String exe = null;
String core = null;
+ String remote = null;
String s = null;
String dumpfile = null;
boolean requestHeapdump = false;
while((s = sg.next(null, longOpts)) != null) {
*** 286,295 ****
--- 323,336 ----
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("remote")) {
+ remote = sg.getOptarg();
+ continue;
+ }
if (s.equals("heap")) {
newArgs.add("-heap");
continue;
}
if (s.equals("binaryheap")) {
*** 323,345 ****
} else {
newArgs.add("-heap:format=b,file=" + dumpfile);
}
}
! buildAttachArgs(newArgs, pid, exe, core, 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=",
"flags", "sysprops"};
ArrayList<String> newArgs = new ArrayList();
String exe = null;
String pid = null;
String core = null;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
--- 364,387 ----
} else {
newArgs.add("-heap:format=b,file=" + dumpfile);
}
}
! 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=", "remote=",
"flags", "sysprops"};
ArrayList<String> newArgs = new ArrayList();
String exe = null;
String pid = null;
String core = null;
+ String remote = null;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
*** 351,382 ****
}
if (s.equals("pid")) {
pid = 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);
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"};
ArrayList<String> newArgs = new ArrayList();
String exe = null;
String pid = null;
String core = null;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
--- 393,429 ----
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("remote")) {
+ 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, 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=", "remote=", "all"};
ArrayList<String> newArgs = new ArrayList();
String exe = null;
String pid = null;
String core = null;
+ String remote = null;
String s = null;
while((s = sg.next(null, longOpts)) != null) {
if (s.equals("exe")) {
exe = sg.getOptarg();
*** 388,404 ****
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
if (s.equals("all")) {
newArgs.add("-a");
continue;
}
}
! buildAttachArgs(newArgs, pid, exe, core, false);
JSnap.main(newArgs.toArray(new String[newArgs.size()]));
}
private static void runDEBUGD(String[] oldArgs) {
// By default SA agent classes prefer Windows process debugger
--- 435,455 ----
}
if (s.equals("pid")) {
pid = sg.getOptarg();
continue;
}
+ if (s.equals("remote")) {
+ remote = sg.getOptarg();
+ continue;
+ }
if (s.equals("all")) {
newArgs.add("-a");
continue;
}
}
! 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,444 ****
serverid = sg.getOptarg();
continue;
}
}
! buildAttachArgs(newArgs, pid, exe, core, false);
if (serverid != null) {
newArgs.add(serverid);
}
// delegate to the actual SA debug server.
--- 485,495 ----
serverid = sg.getOptarg();
continue;
}
}
! buildAttachArgs(newArgs, pid, exe, core, NO_REMOTE, false);
if (serverid != null) {
newArgs.add(serverid);
}
// delegate to the actual SA debug server.
< prev index next >