1 /*
   2  * Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores,
  20  * CA 94065 USA or visit www.oracle.com if you need additional information or
  21  * have any questions.
  22  *
  23  */
  24 
  25 package sun.jvm.hotspot;
  26 
  27 import sun.jvm.hotspot.debugger.*;
  28 import sun.jvm.hotspot.debugger.dbx.*;
  29 import sun.jvm.hotspot.runtime.*;
  30 import sun.jvm.hotspot.oops.*;
  31 
  32 public class DebugServer {
  33   private void usage() {
  34     System.out.println("usage: java " + getClass().getName() + " <pid> [server id]");
  35     System.out.println("   or: java " + getClass().getName() + " <executable> <core> [server id]");
  36     System.out.println("\"pid\" must be the process ID of a HotSpot process.");
  37     System.out.println("If reading a core file, \"executable\" must (currently) be the");
  38     System.out.println("full path name to the precise java executable which generated");
  39     System.out.println("the core file (not, on Solaris, the \"java\" wrapper script in");
  40     System.out.println("the \"bin\" subdirectory of the JDK.)");
  41     System.out.println("The \"server id\" is a unique name for a specific remote debuggee.");
  42     System.exit(1);
  43   }
  44 
  45   public static void main(String[] args) {
  46     new DebugServer().run(args);
  47   }
  48 
  49   private void run(String[] args) {
  50     if ((args.length < 1) || (args.length > 3)) {
  51       usage();
  52     }
  53 
  54     // Attempt to handle "-h" or "-help"
  55     if (args[0].startsWith("-")) {
  56       usage();
  57     }
  58 
  59     int pid = 0;
  60     boolean usePid = false;
  61     String coreFileName = null;
  62     // FIXME: would be nice to pick this up from the core file
  63     // somehow, but that doesn't look possible. Should at least figure
  64     // it out from a path to the JDK.
  65     String javaExecutableName = null;
  66     String serverID = null;
  67 
  68     switch (args.length) {
  69        case 1:
  70          try {
  71            pid = Integer.parseInt(args[0]);
  72            usePid = true;
  73          } catch (NumberFormatException e) {
  74            usage();
  75          }
  76          break;
  77 
  78        case 2:
  79          // either we have pid and server id or exec file and core file
  80          try {
  81            pid = Integer.parseInt(args[0]);
  82            usePid = true;
  83            serverID = args[1];
  84          } catch (NumberFormatException e) {
  85            pid = -1;
  86            usePid = false;
  87            javaExecutableName = args[0];
  88            coreFileName = args[1];
  89          }
  90          break;
  91 
  92        case 3:
  93          javaExecutableName = args[0];
  94          coreFileName = args[1];
  95          serverID = args[2];
  96          break;
  97 
  98        default:
  99          // should not happend, taken care already.
 100          break;
 101     }
 102 
 103     final HotSpotAgent agent = new HotSpotAgent();
 104     try {
 105       if (usePid) {
 106         System.err.println("Attaching to process ID " + pid + " and starting RMI services, please wait...");
 107         agent.startServer(pid, serverID);
 108       } else {
 109         System.err.println("Attaching to core " + coreFileName +
 110                            " from executable " + javaExecutableName + " and starting RMI services, please wait...");
 111         agent.startServer(javaExecutableName, coreFileName, serverID);
 112       }
 113     }
 114     catch (DebuggerException e) {
 115       if (usePid) {
 116         System.err.print("Error attaching to process or starting server: ");
 117       } else {
 118         System.err.print("Error attaching to core file or starting server: ");
 119       }
 120       e.printStackTrace();
 121       System.exit(1);
 122     }
 123 
 124     // shutdown hook to clean-up the server in case of forced exit.
 125     Runtime.getRuntime().addShutdownHook(new java.lang.Thread(
 126                           new Runnable() {
 127                              public void run() {
 128                                 agent.shutdownServer();
 129                              }
 130                           }));
 131     System.err.println("Debugger attached and RMI services started.");
 132   }
 133 }