< prev index next >

src/jdk.jcmd/share/classes/sun/tools/jcmd/Arguments.java

Print this page
rev 47329 : 8189102: All tools should support -?, -h and --help


  33     private boolean listProcesses = false;
  34     private boolean listCounters  = false;
  35     private boolean showUsage     = false;
  36     private String  command       = null;
  37     private String  processString = null;
  38 
  39     public boolean isListProcesses() { return listProcesses; }
  40     public boolean isListCounters() { return listCounters; }
  41     public boolean isShowUsage() { return showUsage; }
  42     public String getCommand() { return command; }
  43     public String getProcessString() { return processString; }
  44 
  45     public Arguments(String[] args) {
  46         if (args.length == 0 || args[0].equals("-l")) {
  47             listProcesses = true;
  48             /* list all processes */
  49             processString = "0";
  50             return;
  51         }
  52 
  53         if (args[0].equals("-h") || args[0].equals("-help") ) {

  54             showUsage = true;
  55             return;
  56         }
  57 
  58         processString = args[0];
  59 
  60         StringBuilder sb = new StringBuilder();
  61         for (int i = 1; i < args.length; i++) {
  62             if (args[i].equals("-f")) {
  63                 if (args.length == i + 1) {
  64                     throw new IllegalArgumentException(
  65                         "No file specified for parameter -f");
  66                 } else if (args.length == i + 2) {
  67                     try {
  68                         readCommandFile(args[i + 1]);
  69                     } catch(IOException e) {
  70                         throw new IllegalArgumentException(
  71                             "Could not read from file specified with -f option: "
  72                             + args[i + 1]);
  73                     }


  99                 }
 100                 command = sb.toString();
 101             }
 102     }
 103 
 104     public static void usage() {
 105         System.out.println("Usage: jcmd <pid | main class> <command ...|PerfCounter.print|-f file>");
 106         System.out.println("   or: jcmd -l                                                    ");
 107         System.out.println("   or: jcmd -h                                                    ");
 108         System.out.println("                                                                  ");
 109         System.out.println("  command must be a valid jcmd command for the selected jvm.      ");
 110         System.out.println("  Use the command \"help\" to see which commands are available.   ");
 111         System.out.println("  If the pid is 0, commands will be sent to all Java processes.   ");
 112         System.out.println("  The main class argument will be used to match (either partially ");
 113         System.out.println("  or fully) the class used to start Java.                         ");
 114         System.out.println("  If no options are given, lists Java processes (same as -l).     ");
 115         System.out.println("                                                                  ");
 116         System.out.println("  PerfCounter.print display the counters exposed by this process  ");
 117         System.out.println("  -f  read and execute commands from the file                     ");
 118         System.out.println("  -l  list JVM processes on the local machine                     ");
 119         System.out.println("  -h  this help                                                   ");
 120     }
 121 }


  33     private boolean listProcesses = false;
  34     private boolean listCounters  = false;
  35     private boolean showUsage     = false;
  36     private String  command       = null;
  37     private String  processString = null;
  38 
  39     public boolean isListProcesses() { return listProcesses; }
  40     public boolean isListCounters() { return listCounters; }
  41     public boolean isShowUsage() { return showUsage; }
  42     public String getCommand() { return command; }
  43     public String getProcessString() { return processString; }
  44 
  45     public Arguments(String[] args) {
  46         if (args.length == 0 || args[0].equals("-l")) {
  47             listProcesses = true;
  48             /* list all processes */
  49             processString = "0";
  50             return;
  51         }
  52 
  53         // -help: legacy. Undocumented.
  54         if (args[0].equals("-?") || args[0].equals("-h") || args[0].equals("--help") || args[0].equals("-help")) {
  55             showUsage = true;
  56             return;
  57         }
  58 
  59         processString = args[0];
  60 
  61         StringBuilder sb = new StringBuilder();
  62         for (int i = 1; i < args.length; i++) {
  63             if (args[i].equals("-f")) {
  64                 if (args.length == i + 1) {
  65                     throw new IllegalArgumentException(
  66                         "No file specified for parameter -f");
  67                 } else if (args.length == i + 2) {
  68                     try {
  69                         readCommandFile(args[i + 1]);
  70                     } catch(IOException e) {
  71                         throw new IllegalArgumentException(
  72                             "Could not read from file specified with -f option: "
  73                             + args[i + 1]);
  74                     }


 100                 }
 101                 command = sb.toString();
 102             }
 103     }
 104 
 105     public static void usage() {
 106         System.out.println("Usage: jcmd <pid | main class> <command ...|PerfCounter.print|-f file>");
 107         System.out.println("   or: jcmd -l                                                    ");
 108         System.out.println("   or: jcmd -h                                                    ");
 109         System.out.println("                                                                  ");
 110         System.out.println("  command must be a valid jcmd command for the selected jvm.      ");
 111         System.out.println("  Use the command \"help\" to see which commands are available.   ");
 112         System.out.println("  If the pid is 0, commands will be sent to all Java processes.   ");
 113         System.out.println("  The main class argument will be used to match (either partially ");
 114         System.out.println("  or fully) the class used to start Java.                         ");
 115         System.out.println("  If no options are given, lists Java processes (same as -l).     ");
 116         System.out.println("                                                                  ");
 117         System.out.println("  PerfCounter.print display the counters exposed by this process  ");
 118         System.out.println("  -f  read and execute commands from the file                     ");
 119         System.out.println("  -l  list JVM processes on the local machine                     ");
 120         System.out.println("  -? -h --help this help                                          ");
 121     }
 122 }
< prev index next >