< prev index next >

src/jdk.jcmd/share/classes/sun/tools/jstack/JStack.java

Print this page
rev 48074 : 8189102: All tools should support -?, -h and --help
Reviewed-by: kvn, jjg, weijun, alanb, rfield, ksrini
   1 /*
   2  * Copyright (c) 2005, 2013, 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.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


  39  * obtained the thread dump from a target process using the VM attach mechanism
  40  */
  41 public class JStack {
  42 
  43     public static void main(String[] args) throws Exception {
  44         if (args.length == 0) {
  45             usage(1); // no arguments
  46         }
  47 
  48         checkForUnsupportedOptions(args);
  49 
  50         boolean locks = false;
  51 
  52         // Parse the options (arguments starting with "-" )
  53         int optionCount = 0;
  54         while (optionCount < args.length) {
  55             String arg = args[optionCount];
  56             if (!arg.startsWith("-")) {
  57                 break;
  58             }
  59             if (arg.equals("-help") || arg.equals("-h")) {




  60                 usage(0);
  61             }
  62             else {
  63                 if (arg.equals("-l")) {
  64                     locks = true;
  65                 } else {
  66                     usage(1);
  67                 }
  68             }
  69             optionCount++;
  70         }
  71 
  72         // Next we check the parameter count.
  73         int paramCount = args.length - optionCount;
  74         if (paramCount != 1) {
  75             usage(1);
  76         }
  77 
  78         // pass -l to thread dump operation to get extra lock info
  79         String pidArg = args[optionCount];


 154 
 155         if (paramCount > 1) {
 156             SAOptionError("More than one non-option argument");
 157         }
 158     }
 159 
 160     private static void SAOptionError(String msg) {
 161         System.err.println("Error: " + msg);
 162         System.err.println("Cannot connect to core dump or remote debug server. Use jhsdb jstack instead");
 163         System.exit(1);
 164     }
 165 
 166     // print usage message
 167     private static void usage(int exit) {
 168         System.err.println("Usage:");
 169         System.err.println("    jstack [-l] <pid>");
 170         System.err.println("        (to connect to running process)");
 171         System.err.println("");
 172         System.err.println("Options:");
 173         System.err.println("    -l  long listing. Prints additional information about locks");
 174         System.err.println("    -h or -help to print this help message");
 175         System.exit(exit);
 176     }
 177 }
   1 /*
   2  * Copyright (c) 2005, 2017, 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.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


  39  * obtained the thread dump from a target process using the VM attach mechanism
  40  */
  41 public class JStack {
  42 
  43     public static void main(String[] args) throws Exception {
  44         if (args.length == 0) {
  45             usage(1); // no arguments
  46         }
  47 
  48         checkForUnsupportedOptions(args);
  49 
  50         boolean locks = false;
  51 
  52         // Parse the options (arguments starting with "-" )
  53         int optionCount = 0;
  54         while (optionCount < args.length) {
  55             String arg = args[optionCount];
  56             if (!arg.startsWith("-")) {
  57                 break;
  58             }
  59             if (arg.equals("-?")     ||
  60                 arg.equals("-h")     ||
  61                 arg.equals("--help") ||
  62                 // -help: legacy.
  63                 arg.equals("-help")) {
  64                 usage(0);
  65             }
  66             else {
  67                 if (arg.equals("-l")) {
  68                     locks = true;
  69                 } else {
  70                     usage(1);
  71                 }
  72             }
  73             optionCount++;
  74         }
  75 
  76         // Next we check the parameter count.
  77         int paramCount = args.length - optionCount;
  78         if (paramCount != 1) {
  79             usage(1);
  80         }
  81 
  82         // pass -l to thread dump operation to get extra lock info
  83         String pidArg = args[optionCount];


 158 
 159         if (paramCount > 1) {
 160             SAOptionError("More than one non-option argument");
 161         }
 162     }
 163 
 164     private static void SAOptionError(String msg) {
 165         System.err.println("Error: " + msg);
 166         System.err.println("Cannot connect to core dump or remote debug server. Use jhsdb jstack instead");
 167         System.exit(1);
 168     }
 169 
 170     // print usage message
 171     private static void usage(int exit) {
 172         System.err.println("Usage:");
 173         System.err.println("    jstack [-l] <pid>");
 174         System.err.println("        (to connect to running process)");
 175         System.err.println("");
 176         System.err.println("Options:");
 177         System.err.println("    -l  long listing. Prints additional information about locks");
 178         System.err.println("    -? -h --help -help to print this help message");
 179         System.exit(exit);
 180     }
 181 }
< prev index next >