< prev index next >
src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/SALauncher.java
Print this page
*** 44,114 ****
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]
// [options] <executable> <core> [server-id]
! System.out.println(" --serverid <id> \tA 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");
}
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");
}
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();
--- 44,136 ----
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>
! // // --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 (sadebugd).");
+ }
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 --connect option can be set to connect to a debug server (sadebugd).");
! System.out.println(" <--core --exe> and <--pid> and <--connect> 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 + " --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> A unique identifier for this debug server.");
return commonHelp("debugd");
}
private static boolean jinfoHelp() {
// --flags -> -flags
// --sysprops -> -sysprops
! 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> 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 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 To print all performance counters.");
! return commonHelpWithConnect("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);
--- 154,199 ----
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 == 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 (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,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);
--- 218,228 ----
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();
--- 247,270 ----
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=", "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,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) {
--- 276,314 ----
}
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, 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=", "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,295 ****
--- 322,335 ----
}
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,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();
--- 363,386 ----
} 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=", "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,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();
--- 392,428 ----
}
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, 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=", "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,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
--- 434,454 ----
}
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, 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.
--- 484,494 ----
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 >