src/share/vm/runtime/arguments.cpp

Wed, 20 Aug 2008 15:41:36 -0700

author
ysr
date
Wed, 20 Aug 2008 15:41:36 -0700
changeset 735
bfcb639d5bca
parent 711
aa8f54688692
child 760
93befa083681
child 791
1ee8caae33af
permissions
-rw-r--r--

6739357: CMS: Switch off CMSPrecleanRefLists1 until 6722113 can be fixed
Summary: Temporarily switch off the precleaning of Reference lists completely until related issues are fixed in 6722113.
Reviewed-by: jmasa, poonam, tonyp

     1 /*
     2  * Copyright 1997-2008 Sun Microsystems, Inc.  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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    20  * CA 95054 USA or visit www.sun.com if you need additional information or
    21  * have any questions.
    22  *
    23  */
    25 #include "incls/_precompiled.incl"
    26 #include "incls/_arguments.cpp.incl"
    28 #define DEFAULT_VENDOR_URL_BUG "http://java.sun.com/webapps/bugreport/crash.jsp"
    29 #define DEFAULT_JAVA_LAUNCHER  "generic"
    31 char**  Arguments::_jvm_flags_array             = NULL;
    32 int     Arguments::_num_jvm_flags               = 0;
    33 char**  Arguments::_jvm_args_array              = NULL;
    34 int     Arguments::_num_jvm_args                = 0;
    35 char*  Arguments::_java_command                 = NULL;
    36 SystemProperty* Arguments::_system_properties   = NULL;
    37 const char*  Arguments::_gc_log_filename        = NULL;
    38 bool   Arguments::_has_profile                  = false;
    39 bool   Arguments::_has_alloc_profile            = false;
    40 uintx  Arguments::_initial_heap_size            = 0;
    41 uintx  Arguments::_min_heap_size                = 0;
    42 Arguments::Mode Arguments::_mode                = _mixed;
    43 bool   Arguments::_java_compiler                = false;
    44 bool   Arguments::_xdebug_mode                  = false;
    45 const char*  Arguments::_java_vendor_url_bug    = DEFAULT_VENDOR_URL_BUG;
    46 const char*  Arguments::_sun_java_launcher      = DEFAULT_JAVA_LAUNCHER;
    47 int    Arguments::_sun_java_launcher_pid        = -1;
    49 // These parameters are reset in method parse_vm_init_args(JavaVMInitArgs*)
    50 bool   Arguments::_AlwaysCompileLoopMethods     = AlwaysCompileLoopMethods;
    51 bool   Arguments::_UseOnStackReplacement        = UseOnStackReplacement;
    52 bool   Arguments::_BackgroundCompilation        = BackgroundCompilation;
    53 bool   Arguments::_ClipInlining                 = ClipInlining;
    54 intx   Arguments::_Tier2CompileThreshold        = Tier2CompileThreshold;
    56 char*  Arguments::SharedArchivePath             = NULL;
    58 AgentLibraryList Arguments::_libraryList;
    59 AgentLibraryList Arguments::_agentList;
    61 abort_hook_t     Arguments::_abort_hook         = NULL;
    62 exit_hook_t      Arguments::_exit_hook          = NULL;
    63 vfprintf_hook_t  Arguments::_vfprintf_hook      = NULL;
    66 SystemProperty *Arguments::_java_ext_dirs = NULL;
    67 SystemProperty *Arguments::_java_endorsed_dirs = NULL;
    68 SystemProperty *Arguments::_sun_boot_library_path = NULL;
    69 SystemProperty *Arguments::_java_library_path = NULL;
    70 SystemProperty *Arguments::_java_home = NULL;
    71 SystemProperty *Arguments::_java_class_path = NULL;
    72 SystemProperty *Arguments::_sun_boot_class_path = NULL;
    74 char* Arguments::_meta_index_path = NULL;
    75 char* Arguments::_meta_index_dir = NULL;
    77 static bool force_client_mode = false;
    79 // Check if head of 'option' matches 'name', and sets 'tail' remaining part of option string
    81 static bool match_option(const JavaVMOption *option, const char* name,
    82                          const char** tail) {
    83   int len = (int)strlen(name);
    84   if (strncmp(option->optionString, name, len) == 0) {
    85     *tail = option->optionString + len;
    86     return true;
    87   } else {
    88     return false;
    89   }
    90 }
    92 static void logOption(const char* opt) {
    93   if (PrintVMOptions) {
    94     jio_fprintf(defaultStream::output_stream(), "VM option '%s'\n", opt);
    95   }
    96 }
    98 // Process java launcher properties.
    99 void Arguments::process_sun_java_launcher_properties(JavaVMInitArgs* args) {
   100   // See if sun.java.launcher or sun.java.launcher.pid is defined.
   101   // Must do this before setting up other system properties,
   102   // as some of them may depend on launcher type.
   103   for (int index = 0; index < args->nOptions; index++) {
   104     const JavaVMOption* option = args->options + index;
   105     const char* tail;
   107     if (match_option(option, "-Dsun.java.launcher=", &tail)) {
   108       process_java_launcher_argument(tail, option->extraInfo);
   109       continue;
   110     }
   111     if (match_option(option, "-Dsun.java.launcher.pid=", &tail)) {
   112       _sun_java_launcher_pid = atoi(tail);
   113       continue;
   114     }
   115   }
   116 }
   118 // Initialize system properties key and value.
   119 void Arguments::init_system_properties() {
   121   PropertyList_add(&_system_properties, new SystemProperty("java.vm.specification.version", "1.0", false));
   122   PropertyList_add(&_system_properties, new SystemProperty("java.vm.specification.name",
   123                                                                  "Java Virtual Machine Specification",  false));
   124   PropertyList_add(&_system_properties, new SystemProperty("java.vm.specification.vendor",
   125                                                                  "Sun Microsystems Inc.",  false));
   126   PropertyList_add(&_system_properties, new SystemProperty("java.vm.version", VM_Version::vm_release(),  false));
   127   PropertyList_add(&_system_properties, new SystemProperty("java.vm.name", VM_Version::vm_name(),  false));
   128   PropertyList_add(&_system_properties, new SystemProperty("java.vm.vendor", VM_Version::vm_vendor(),  false));
   129   PropertyList_add(&_system_properties, new SystemProperty("java.vm.info", VM_Version::vm_info_string(),  true));
   131   // following are JVMTI agent writeable properties.
   132   // Properties values are set to NULL and they are
   133   // os specific they are initialized in os::init_system_properties_values().
   134   _java_ext_dirs = new SystemProperty("java.ext.dirs", NULL,  true);
   135   _java_endorsed_dirs = new SystemProperty("java.endorsed.dirs", NULL,  true);
   136   _sun_boot_library_path = new SystemProperty("sun.boot.library.path", NULL,  true);
   137   _java_library_path = new SystemProperty("java.library.path", NULL,  true);
   138   _java_home =  new SystemProperty("java.home", NULL,  true);
   139   _sun_boot_class_path = new SystemProperty("sun.boot.class.path", NULL,  true);
   141   _java_class_path = new SystemProperty("java.class.path", "",  true);
   143   // Add to System Property list.
   144   PropertyList_add(&_system_properties, _java_ext_dirs);
   145   PropertyList_add(&_system_properties, _java_endorsed_dirs);
   146   PropertyList_add(&_system_properties, _sun_boot_library_path);
   147   PropertyList_add(&_system_properties, _java_library_path);
   148   PropertyList_add(&_system_properties, _java_home);
   149   PropertyList_add(&_system_properties, _java_class_path);
   150   PropertyList_add(&_system_properties, _sun_boot_class_path);
   152   // Set OS specific system properties values
   153   os::init_system_properties_values();
   154 }
   156 /**
   157  * Provide a slightly more user-friendly way of eliminating -XX flags.
   158  * When a flag is eliminated, it can be added to this list in order to
   159  * continue accepting this flag on the command-line, while issuing a warning
   160  * and ignoring the value.  Once the JDK version reaches the 'accept_until'
   161  * limit, we flatly refuse to admit the existence of the flag.  This allows
   162  * a flag to die correctly over JDK releases using HSX.
   163  */
   164 typedef struct {
   165   const char* name;
   166   JDK_Version obsoleted_in; // when the flag went away
   167   JDK_Version accept_until; // which version to start denying the existence
   168 } ObsoleteFlag;
   170 static ObsoleteFlag obsolete_jvm_flags[] = {
   171   { "UseTrainGC",                    JDK_Version::jdk(5), JDK_Version::jdk(7) },
   172   { "UseSpecialLargeObjectHandling", JDK_Version::jdk(5), JDK_Version::jdk(7) },
   173   { "UseOversizedCarHandling",       JDK_Version::jdk(5), JDK_Version::jdk(7) },
   174   { "TraceCarAllocation",            JDK_Version::jdk(5), JDK_Version::jdk(7) },
   175   { "PrintTrainGCProcessingStats",   JDK_Version::jdk(5), JDK_Version::jdk(7) },
   176   { "LogOfCarSpaceSize",             JDK_Version::jdk(5), JDK_Version::jdk(7) },
   177   { "OversizedCarThreshold",         JDK_Version::jdk(5), JDK_Version::jdk(7) },
   178   { "MinTickInterval",               JDK_Version::jdk(5), JDK_Version::jdk(7) },
   179   { "DefaultTickInterval",           JDK_Version::jdk(5), JDK_Version::jdk(7) },
   180   { "MaxTickInterval",               JDK_Version::jdk(5), JDK_Version::jdk(7) },
   181   { "DelayTickAdjustment",           JDK_Version::jdk(5), JDK_Version::jdk(7) },
   182   { "ProcessingToTenuringRatio",     JDK_Version::jdk(5), JDK_Version::jdk(7) },
   183   { "MinTrainLength",                JDK_Version::jdk(5), JDK_Version::jdk(7) },
   184   { "AppendRatio",         JDK_Version::jdk_update(6,10), JDK_Version::jdk(7) },
   185   { NULL, JDK_Version(0), JDK_Version(0) }
   186 };
   188 // Returns true if the flag is obsolete and fits into the range specified
   189 // for being ignored.  In the case that the flag is ignored, the 'version'
   190 // value is filled in with the version number when the flag became
   191 // obsolete so that that value can be displayed to the user.
   192 bool Arguments::is_newly_obsolete(const char *s, JDK_Version* version) {
   193   int i = 0;
   194   assert(version != NULL, "Must provide a version buffer");
   195   while (obsolete_jvm_flags[i].name != NULL) {
   196     const ObsoleteFlag& flag_status = obsolete_jvm_flags[i];
   197     // <flag>=xxx form
   198     // [-|+]<flag> form
   199     if ((strncmp(flag_status.name, s, strlen(flag_status.name)) == 0) ||
   200         ((s[0] == '+' || s[0] == '-') &&
   201         (strncmp(flag_status.name, &s[1], strlen(flag_status.name)) == 0))) {
   202       if (JDK_Version::current().compare(flag_status.accept_until) == -1) {
   203           *version = flag_status.obsoleted_in;
   204           return true;
   205       }
   206     }
   207     i++;
   208   }
   209   return false;
   210 }
   212 // Constructs the system class path (aka boot class path) from the following
   213 // components, in order:
   214 //
   215 //     prefix           // from -Xbootclasspath/p:...
   216 //     endorsed         // the expansion of -Djava.endorsed.dirs=...
   217 //     base             // from os::get_system_properties() or -Xbootclasspath=
   218 //     suffix           // from -Xbootclasspath/a:...
   219 //
   220 // java.endorsed.dirs is a list of directories; any jar or zip files in the
   221 // directories are added to the sysclasspath just before the base.
   222 //
   223 // This could be AllStatic, but it isn't needed after argument processing is
   224 // complete.
   225 class SysClassPath: public StackObj {
   226 public:
   227   SysClassPath(const char* base);
   228   ~SysClassPath();
   230   inline void set_base(const char* base);
   231   inline void add_prefix(const char* prefix);
   232   inline void add_suffix(const char* suffix);
   233   inline void reset_path(const char* base);
   235   // Expand the jar/zip files in each directory listed by the java.endorsed.dirs
   236   // property.  Must be called after all command-line arguments have been
   237   // processed (in particular, -Djava.endorsed.dirs=...) and before calling
   238   // combined_path().
   239   void expand_endorsed();
   241   inline const char* get_base()     const { return _items[_scp_base]; }
   242   inline const char* get_prefix()   const { return _items[_scp_prefix]; }
   243   inline const char* get_suffix()   const { return _items[_scp_suffix]; }
   244   inline const char* get_endorsed() const { return _items[_scp_endorsed]; }
   246   // Combine all the components into a single c-heap-allocated string; caller
   247   // must free the string if/when no longer needed.
   248   char* combined_path();
   250 private:
   251   // Utility routines.
   252   static char* add_to_path(const char* path, const char* str, bool prepend);
   253   static char* add_jars_to_path(char* path, const char* directory);
   255   inline void reset_item_at(int index);
   257   // Array indices for the items that make up the sysclasspath.  All except the
   258   // base are allocated in the C heap and freed by this class.
   259   enum {
   260     _scp_prefix,        // from -Xbootclasspath/p:...
   261     _scp_endorsed,      // the expansion of -Djava.endorsed.dirs=...
   262     _scp_base,          // the default sysclasspath
   263     _scp_suffix,        // from -Xbootclasspath/a:...
   264     _scp_nitems         // the number of items, must be last.
   265   };
   267   const char* _items[_scp_nitems];
   268   DEBUG_ONLY(bool _expansion_done;)
   269 };
   271 SysClassPath::SysClassPath(const char* base) {
   272   memset(_items, 0, sizeof(_items));
   273   _items[_scp_base] = base;
   274   DEBUG_ONLY(_expansion_done = false;)
   275 }
   277 SysClassPath::~SysClassPath() {
   278   // Free everything except the base.
   279   for (int i = 0; i < _scp_nitems; ++i) {
   280     if (i != _scp_base) reset_item_at(i);
   281   }
   282   DEBUG_ONLY(_expansion_done = false;)
   283 }
   285 inline void SysClassPath::set_base(const char* base) {
   286   _items[_scp_base] = base;
   287 }
   289 inline void SysClassPath::add_prefix(const char* prefix) {
   290   _items[_scp_prefix] = add_to_path(_items[_scp_prefix], prefix, true);
   291 }
   293 inline void SysClassPath::add_suffix(const char* suffix) {
   294   _items[_scp_suffix] = add_to_path(_items[_scp_suffix], suffix, false);
   295 }
   297 inline void SysClassPath::reset_item_at(int index) {
   298   assert(index < _scp_nitems && index != _scp_base, "just checking");
   299   if (_items[index] != NULL) {
   300     FREE_C_HEAP_ARRAY(char, _items[index]);
   301     _items[index] = NULL;
   302   }
   303 }
   305 inline void SysClassPath::reset_path(const char* base) {
   306   // Clear the prefix and suffix.
   307   reset_item_at(_scp_prefix);
   308   reset_item_at(_scp_suffix);
   309   set_base(base);
   310 }
   312 //------------------------------------------------------------------------------
   314 void SysClassPath::expand_endorsed() {
   315   assert(_items[_scp_endorsed] == NULL, "can only be called once.");
   317   const char* path = Arguments::get_property("java.endorsed.dirs");
   318   if (path == NULL) {
   319     path = Arguments::get_endorsed_dir();
   320     assert(path != NULL, "no default for java.endorsed.dirs");
   321   }
   323   char* expanded_path = NULL;
   324   const char separator = *os::path_separator();
   325   const char* const end = path + strlen(path);
   326   while (path < end) {
   327     const char* tmp_end = strchr(path, separator);
   328     if (tmp_end == NULL) {
   329       expanded_path = add_jars_to_path(expanded_path, path);
   330       path = end;
   331     } else {
   332       char* dirpath = NEW_C_HEAP_ARRAY(char, tmp_end - path + 1);
   333       memcpy(dirpath, path, tmp_end - path);
   334       dirpath[tmp_end - path] = '\0';
   335       expanded_path = add_jars_to_path(expanded_path, dirpath);
   336       FREE_C_HEAP_ARRAY(char, dirpath);
   337       path = tmp_end + 1;
   338     }
   339   }
   340   _items[_scp_endorsed] = expanded_path;
   341   DEBUG_ONLY(_expansion_done = true;)
   342 }
   344 // Combine the bootclasspath elements, some of which may be null, into a single
   345 // c-heap-allocated string.
   346 char* SysClassPath::combined_path() {
   347   assert(_items[_scp_base] != NULL, "empty default sysclasspath");
   348   assert(_expansion_done, "must call expand_endorsed() first.");
   350   size_t lengths[_scp_nitems];
   351   size_t total_len = 0;
   353   const char separator = *os::path_separator();
   355   // Get the lengths.
   356   int i;
   357   for (i = 0; i < _scp_nitems; ++i) {
   358     if (_items[i] != NULL) {
   359       lengths[i] = strlen(_items[i]);
   360       // Include space for the separator char (or a NULL for the last item).
   361       total_len += lengths[i] + 1;
   362     }
   363   }
   364   assert(total_len > 0, "empty sysclasspath not allowed");
   366   // Copy the _items to a single string.
   367   char* cp = NEW_C_HEAP_ARRAY(char, total_len);
   368   char* cp_tmp = cp;
   369   for (i = 0; i < _scp_nitems; ++i) {
   370     if (_items[i] != NULL) {
   371       memcpy(cp_tmp, _items[i], lengths[i]);
   372       cp_tmp += lengths[i];
   373       *cp_tmp++ = separator;
   374     }
   375   }
   376   *--cp_tmp = '\0';     // Replace the extra separator.
   377   return cp;
   378 }
   380 // Note:  path must be c-heap-allocated (or NULL); it is freed if non-null.
   381 char*
   382 SysClassPath::add_to_path(const char* path, const char* str, bool prepend) {
   383   char *cp;
   385   assert(str != NULL, "just checking");
   386   if (path == NULL) {
   387     size_t len = strlen(str) + 1;
   388     cp = NEW_C_HEAP_ARRAY(char, len);
   389     memcpy(cp, str, len);                       // copy the trailing null
   390   } else {
   391     const char separator = *os::path_separator();
   392     size_t old_len = strlen(path);
   393     size_t str_len = strlen(str);
   394     size_t len = old_len + str_len + 2;
   396     if (prepend) {
   397       cp = NEW_C_HEAP_ARRAY(char, len);
   398       char* cp_tmp = cp;
   399       memcpy(cp_tmp, str, str_len);
   400       cp_tmp += str_len;
   401       *cp_tmp = separator;
   402       memcpy(++cp_tmp, path, old_len + 1);      // copy the trailing null
   403       FREE_C_HEAP_ARRAY(char, path);
   404     } else {
   405       cp = REALLOC_C_HEAP_ARRAY(char, path, len);
   406       char* cp_tmp = cp + old_len;
   407       *cp_tmp = separator;
   408       memcpy(++cp_tmp, str, str_len + 1);       // copy the trailing null
   409     }
   410   }
   411   return cp;
   412 }
   414 // Scan the directory and append any jar or zip files found to path.
   415 // Note:  path must be c-heap-allocated (or NULL); it is freed if non-null.
   416 char* SysClassPath::add_jars_to_path(char* path, const char* directory) {
   417   DIR* dir = os::opendir(directory);
   418   if (dir == NULL) return path;
   420   char dir_sep[2] = { '\0', '\0' };
   421   size_t directory_len = strlen(directory);
   422   const char fileSep = *os::file_separator();
   423   if (directory[directory_len - 1] != fileSep) dir_sep[0] = fileSep;
   425   /* Scan the directory for jars/zips, appending them to path. */
   426   struct dirent *entry;
   427   char *dbuf = NEW_C_HEAP_ARRAY(char, os::readdir_buf_size(directory));
   428   while ((entry = os::readdir(dir, (dirent *) dbuf)) != NULL) {
   429     const char* name = entry->d_name;
   430     const char* ext = name + strlen(name) - 4;
   431     bool isJarOrZip = ext > name &&
   432       (os::file_name_strcmp(ext, ".jar") == 0 ||
   433        os::file_name_strcmp(ext, ".zip") == 0);
   434     if (isJarOrZip) {
   435       char* jarpath = NEW_C_HEAP_ARRAY(char, directory_len + 2 + strlen(name));
   436       sprintf(jarpath, "%s%s%s", directory, dir_sep, name);
   437       path = add_to_path(path, jarpath, false);
   438       FREE_C_HEAP_ARRAY(char, jarpath);
   439     }
   440   }
   441   FREE_C_HEAP_ARRAY(char, dbuf);
   442   os::closedir(dir);
   443   return path;
   444 }
   446 // Parses a memory size specification string.
   447 static bool atomll(const char *s, jlong* result) {
   448   jlong n = 0;
   449   int args_read = sscanf(s, os::jlong_format_specifier(), &n);
   450   if (args_read != 1) {
   451     return false;
   452   }
   453   while (*s != '\0' && isdigit(*s)) {
   454     s++;
   455   }
   456   // 4705540: illegal if more characters are found after the first non-digit
   457   if (strlen(s) > 1) {
   458     return false;
   459   }
   460   switch (*s) {
   461     case 'T': case 't':
   462       *result = n * G * K;
   463       return true;
   464     case 'G': case 'g':
   465       *result = n * G;
   466       return true;
   467     case 'M': case 'm':
   468       *result = n * M;
   469       return true;
   470     case 'K': case 'k':
   471       *result = n * K;
   472       return true;
   473     case '\0':
   474       *result = n;
   475       return true;
   476     default:
   477       return false;
   478   }
   479 }
   481 Arguments::ArgsRange Arguments::check_memory_size(jlong size, jlong min_size) {
   482   if (size < min_size) return arg_too_small;
   483   // Check that size will fit in a size_t (only relevant on 32-bit)
   484   if ((julong) size > max_uintx) return arg_too_big;
   485   return arg_in_range;
   486 }
   488 // Describe an argument out of range error
   489 void Arguments::describe_range_error(ArgsRange errcode) {
   490   switch(errcode) {
   491   case arg_too_big:
   492     jio_fprintf(defaultStream::error_stream(),
   493                 "The specified size exceeds the maximum "
   494                 "representable size.\n");
   495     break;
   496   case arg_too_small:
   497   case arg_unreadable:
   498   case arg_in_range:
   499     // do nothing for now
   500     break;
   501   default:
   502     ShouldNotReachHere();
   503   }
   504 }
   506 static bool set_bool_flag(char* name, bool value, FlagValueOrigin origin) {
   507   return CommandLineFlags::boolAtPut(name, &value, origin);
   508 }
   511 static bool set_fp_numeric_flag(char* name, char* value, FlagValueOrigin origin) {
   512   double v;
   513   if (sscanf(value, "%lf", &v) != 1) {
   514     return false;
   515   }
   517   if (CommandLineFlags::doubleAtPut(name, &v, origin)) {
   518     return true;
   519   }
   520   return false;
   521 }
   524 static bool set_numeric_flag(char* name, char* value, FlagValueOrigin origin) {
   525   jlong v;
   526   intx intx_v;
   527   bool is_neg = false;
   528   // Check the sign first since atomll() parses only unsigned values.
   529   if (*value == '-') {
   530     if (!CommandLineFlags::intxAt(name, &intx_v)) {
   531       return false;
   532     }
   533     value++;
   534     is_neg = true;
   535   }
   536   if (!atomll(value, &v)) {
   537     return false;
   538   }
   539   intx_v = (intx) v;
   540   if (is_neg) {
   541     intx_v = -intx_v;
   542   }
   543   if (CommandLineFlags::intxAtPut(name, &intx_v, origin)) {
   544     return true;
   545   }
   546   uintx uintx_v = (uintx) v;
   547   if (!is_neg && CommandLineFlags::uintxAtPut(name, &uintx_v, origin)) {
   548     return true;
   549   }
   550   return false;
   551 }
   554 static bool set_string_flag(char* name, const char* value, FlagValueOrigin origin) {
   555   if (!CommandLineFlags::ccstrAtPut(name, &value, origin))  return false;
   556   // Contract:  CommandLineFlags always returns a pointer that needs freeing.
   557   FREE_C_HEAP_ARRAY(char, value);
   558   return true;
   559 }
   561 static bool append_to_string_flag(char* name, const char* new_value, FlagValueOrigin origin) {
   562   const char* old_value = "";
   563   if (!CommandLineFlags::ccstrAt(name, &old_value))  return false;
   564   size_t old_len = old_value != NULL ? strlen(old_value) : 0;
   565   size_t new_len = strlen(new_value);
   566   const char* value;
   567   char* free_this_too = NULL;
   568   if (old_len == 0) {
   569     value = new_value;
   570   } else if (new_len == 0) {
   571     value = old_value;
   572   } else {
   573     char* buf = NEW_C_HEAP_ARRAY(char, old_len + 1 + new_len + 1);
   574     // each new setting adds another LINE to the switch:
   575     sprintf(buf, "%s\n%s", old_value, new_value);
   576     value = buf;
   577     free_this_too = buf;
   578   }
   579   (void) CommandLineFlags::ccstrAtPut(name, &value, origin);
   580   // CommandLineFlags always returns a pointer that needs freeing.
   581   FREE_C_HEAP_ARRAY(char, value);
   582   if (free_this_too != NULL) {
   583     // CommandLineFlags made its own copy, so I must delete my own temp. buffer.
   584     FREE_C_HEAP_ARRAY(char, free_this_too);
   585   }
   586   return true;
   587 }
   590 bool Arguments::parse_argument(const char* arg, FlagValueOrigin origin) {
   592   // range of acceptable characters spelled out for portability reasons
   593 #define NAME_RANGE  "[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_]"
   594 #define BUFLEN 255
   595   char name[BUFLEN+1];
   596   char dummy;
   598   if (sscanf(arg, "-%" XSTR(BUFLEN) NAME_RANGE "%c", name, &dummy) == 1) {
   599     return set_bool_flag(name, false, origin);
   600   }
   601   if (sscanf(arg, "+%" XSTR(BUFLEN) NAME_RANGE "%c", name, &dummy) == 1) {
   602     return set_bool_flag(name, true, origin);
   603   }
   605   char punct;
   606   if (sscanf(arg, "%" XSTR(BUFLEN) NAME_RANGE "%c", name, &punct) == 2 && punct == '=') {
   607     const char* value = strchr(arg, '=') + 1;
   608     Flag* flag = Flag::find_flag(name, strlen(name));
   609     if (flag != NULL && flag->is_ccstr()) {
   610       if (flag->ccstr_accumulates()) {
   611         return append_to_string_flag(name, value, origin);
   612       } else {
   613         if (value[0] == '\0') {
   614           value = NULL;
   615         }
   616         return set_string_flag(name, value, origin);
   617       }
   618     }
   619   }
   621   if (sscanf(arg, "%" XSTR(BUFLEN) NAME_RANGE ":%c", name, &punct) == 2 && punct == '=') {
   622     const char* value = strchr(arg, '=') + 1;
   623     // -XX:Foo:=xxx will reset the string flag to the given value.
   624     if (value[0] == '\0') {
   625       value = NULL;
   626     }
   627     return set_string_flag(name, value, origin);
   628   }
   630 #define SIGNED_FP_NUMBER_RANGE "[-0123456789.]"
   631 #define SIGNED_NUMBER_RANGE    "[-0123456789]"
   632 #define        NUMBER_RANGE    "[0123456789]"
   633   char value[BUFLEN + 1];
   634   char value2[BUFLEN + 1];
   635   if (sscanf(arg, "%" XSTR(BUFLEN) NAME_RANGE "=" "%" XSTR(BUFLEN) SIGNED_NUMBER_RANGE "." "%" XSTR(BUFLEN) NUMBER_RANGE "%c", name, value, value2, &dummy) == 3) {
   636     // Looks like a floating-point number -- try again with more lenient format string
   637     if (sscanf(arg, "%" XSTR(BUFLEN) NAME_RANGE "=" "%" XSTR(BUFLEN) SIGNED_FP_NUMBER_RANGE "%c", name, value, &dummy) == 2) {
   638       return set_fp_numeric_flag(name, value, origin);
   639     }
   640   }
   642 #define VALUE_RANGE "[-kmgtKMGT0123456789]"
   643   if (sscanf(arg, "%" XSTR(BUFLEN) NAME_RANGE "=" "%" XSTR(BUFLEN) VALUE_RANGE "%c", name, value, &dummy) == 2) {
   644     return set_numeric_flag(name, value, origin);
   645   }
   647   return false;
   648 }
   651 void Arguments::add_string(char*** bldarray, int* count, const char* arg) {
   652   assert(bldarray != NULL, "illegal argument");
   654   if (arg == NULL) {
   655     return;
   656   }
   658   int index = *count;
   660   // expand the array and add arg to the last element
   661   (*count)++;
   662   if (*bldarray == NULL) {
   663     *bldarray = NEW_C_HEAP_ARRAY(char*, *count);
   664   } else {
   665     *bldarray = REALLOC_C_HEAP_ARRAY(char*, *bldarray, *count);
   666   }
   667   (*bldarray)[index] = strdup(arg);
   668 }
   670 void Arguments::build_jvm_args(const char* arg) {
   671   add_string(&_jvm_args_array, &_num_jvm_args, arg);
   672 }
   674 void Arguments::build_jvm_flags(const char* arg) {
   675   add_string(&_jvm_flags_array, &_num_jvm_flags, arg);
   676 }
   678 // utility function to return a string that concatenates all
   679 // strings in a given char** array
   680 const char* Arguments::build_resource_string(char** args, int count) {
   681   if (args == NULL || count == 0) {
   682     return NULL;
   683   }
   684   size_t length = strlen(args[0]) + 1; // add 1 for the null terminator
   685   for (int i = 1; i < count; i++) {
   686     length += strlen(args[i]) + 1; // add 1 for a space
   687   }
   688   char* s = NEW_RESOURCE_ARRAY(char, length);
   689   strcpy(s, args[0]);
   690   for (int j = 1; j < count; j++) {
   691     strcat(s, " ");
   692     strcat(s, args[j]);
   693   }
   694   return (const char*) s;
   695 }
   697 void Arguments::print_on(outputStream* st) {
   698   st->print_cr("VM Arguments:");
   699   if (num_jvm_flags() > 0) {
   700     st->print("jvm_flags: "); print_jvm_flags_on(st);
   701   }
   702   if (num_jvm_args() > 0) {
   703     st->print("jvm_args: "); print_jvm_args_on(st);
   704   }
   705   st->print_cr("java_command: %s", java_command() ? java_command() : "<unknown>");
   706   st->print_cr("Launcher Type: %s", _sun_java_launcher);
   707 }
   709 void Arguments::print_jvm_flags_on(outputStream* st) {
   710   if (_num_jvm_flags > 0) {
   711     for (int i=0; i < _num_jvm_flags; i++) {
   712       st->print("%s ", _jvm_flags_array[i]);
   713     }
   714     st->print_cr("");
   715   }
   716 }
   718 void Arguments::print_jvm_args_on(outputStream* st) {
   719   if (_num_jvm_args > 0) {
   720     for (int i=0; i < _num_jvm_args; i++) {
   721       st->print("%s ", _jvm_args_array[i]);
   722     }
   723     st->print_cr("");
   724   }
   725 }
   727 bool Arguments::process_argument(const char* arg,
   728     jboolean ignore_unrecognized, FlagValueOrigin origin) {
   730   JDK_Version since = JDK_Version();
   732   if (parse_argument(arg, origin)) {
   733     // do nothing
   734   } else if (is_newly_obsolete(arg, &since)) {
   735     enum { bufsize = 256 };
   736     char buffer[bufsize];
   737     since.to_string(buffer, bufsize);
   738     jio_fprintf(defaultStream::error_stream(),
   739       "Warning: The flag %s has been EOL'd as of %s and will"
   740       " be ignored\n", arg, buffer);
   741   } else {
   742     if (!ignore_unrecognized) {
   743       jio_fprintf(defaultStream::error_stream(),
   744                   "Unrecognized VM option '%s'\n", arg);
   745       // allow for commandline "commenting out" options like -XX:#+Verbose
   746       if (strlen(arg) == 0 || arg[0] != '#') {
   747         return false;
   748       }
   749     }
   750   }
   751   return true;
   752 }
   755 bool Arguments::process_settings_file(const char* file_name, bool should_exist, jboolean ignore_unrecognized) {
   756   FILE* stream = fopen(file_name, "rb");
   757   if (stream == NULL) {
   758     if (should_exist) {
   759       jio_fprintf(defaultStream::error_stream(),
   760                   "Could not open settings file %s\n", file_name);
   761       return false;
   762     } else {
   763       return true;
   764     }
   765   }
   767   char token[1024];
   768   int  pos = 0;
   770   bool in_white_space = true;
   771   bool in_comment     = false;
   772   bool in_quote       = false;
   773   char quote_c        = 0;
   774   bool result         = true;
   776   int c = getc(stream);
   777   while(c != EOF) {
   778     if (in_white_space) {
   779       if (in_comment) {
   780         if (c == '\n') in_comment = false;
   781       } else {
   782         if (c == '#') in_comment = true;
   783         else if (!isspace(c)) {
   784           in_white_space = false;
   785           token[pos++] = c;
   786         }
   787       }
   788     } else {
   789       if (c == '\n' || (!in_quote && isspace(c))) {
   790         // token ends at newline, or at unquoted whitespace
   791         // this allows a way to include spaces in string-valued options
   792         token[pos] = '\0';
   793         logOption(token);
   794         result &= process_argument(token, ignore_unrecognized, CONFIG_FILE);
   795         build_jvm_flags(token);
   796         pos = 0;
   797         in_white_space = true;
   798         in_quote = false;
   799       } else if (!in_quote && (c == '\'' || c == '"')) {
   800         in_quote = true;
   801         quote_c = c;
   802       } else if (in_quote && (c == quote_c)) {
   803         in_quote = false;
   804       } else {
   805         token[pos++] = c;
   806       }
   807     }
   808     c = getc(stream);
   809   }
   810   if (pos > 0) {
   811     token[pos] = '\0';
   812     result &= process_argument(token, ignore_unrecognized, CONFIG_FILE);
   813     build_jvm_flags(token);
   814   }
   815   fclose(stream);
   816   return result;
   817 }
   819 //=============================================================================================================
   820 // Parsing of properties (-D)
   822 const char* Arguments::get_property(const char* key) {
   823   return PropertyList_get_value(system_properties(), key);
   824 }
   826 bool Arguments::add_property(const char* prop) {
   827   const char* eq = strchr(prop, '=');
   828   char* key;
   829   // ns must be static--its address may be stored in a SystemProperty object.
   830   const static char ns[1] = {0};
   831   char* value = (char *)ns;
   833   size_t key_len = (eq == NULL) ? strlen(prop) : (eq - prop);
   834   key = AllocateHeap(key_len + 1, "add_property");
   835   strncpy(key, prop, key_len);
   836   key[key_len] = '\0';
   838   if (eq != NULL) {
   839     size_t value_len = strlen(prop) - key_len - 1;
   840     value = AllocateHeap(value_len + 1, "add_property");
   841     strncpy(value, &prop[key_len + 1], value_len + 1);
   842   }
   844   if (strcmp(key, "java.compiler") == 0) {
   845     process_java_compiler_argument(value);
   846     FreeHeap(key);
   847     if (eq != NULL) {
   848       FreeHeap(value);
   849     }
   850     return true;
   851   }
   852   else if (strcmp(key, "sun.java.command") == 0) {
   854     _java_command = value;
   856     // don't add this property to the properties exposed to the java application
   857     FreeHeap(key);
   858     return true;
   859   }
   860   else if (strcmp(key, "sun.java.launcher.pid") == 0) {
   861     // launcher.pid property is private and is processed
   862     // in process_sun_java_launcher_properties();
   863     // the sun.java.launcher property is passed on to the java application
   864     FreeHeap(key);
   865     if (eq != NULL) {
   866       FreeHeap(value);
   867     }
   868     return true;
   869   }
   870   else if (strcmp(key, "java.vendor.url.bug") == 0) {
   871     // save it in _java_vendor_url_bug, so JVM fatal error handler can access
   872     // its value without going through the property list or making a Java call.
   873     _java_vendor_url_bug = value;
   874   }
   876   // Create new property and add at the end of the list
   877   PropertyList_unique_add(&_system_properties, key, value);
   878   return true;
   879 }
   881 //===========================================================================================================
   882 // Setting int/mixed/comp mode flags
   884 void Arguments::set_mode_flags(Mode mode) {
   885   // Set up default values for all flags.
   886   // If you add a flag to any of the branches below,
   887   // add a default value for it here.
   888   set_java_compiler(false);
   889   _mode                      = mode;
   891   // Ensure Agent_OnLoad has the correct initial values.
   892   // This may not be the final mode; mode may change later in onload phase.
   893   PropertyList_unique_add(&_system_properties, "java.vm.info",
   894      (char*)Abstract_VM_Version::vm_info_string());
   896   UseInterpreter             = true;
   897   UseCompiler                = true;
   898   UseLoopCounter             = true;
   900   // Default values may be platform/compiler dependent -
   901   // use the saved values
   902   ClipInlining               = Arguments::_ClipInlining;
   903   AlwaysCompileLoopMethods   = Arguments::_AlwaysCompileLoopMethods;
   904   UseOnStackReplacement      = Arguments::_UseOnStackReplacement;
   905   BackgroundCompilation      = Arguments::_BackgroundCompilation;
   906   Tier2CompileThreshold      = Arguments::_Tier2CompileThreshold;
   908   // Change from defaults based on mode
   909   switch (mode) {
   910   default:
   911     ShouldNotReachHere();
   912     break;
   913   case _int:
   914     UseCompiler              = false;
   915     UseLoopCounter           = false;
   916     AlwaysCompileLoopMethods = false;
   917     UseOnStackReplacement    = false;
   918     break;
   919   case _mixed:
   920     // same as default
   921     break;
   922   case _comp:
   923     UseInterpreter           = false;
   924     BackgroundCompilation    = false;
   925     ClipInlining             = false;
   926     break;
   927   }
   928 }
   931 // Conflict: required to use shared spaces (-Xshare:on), but
   932 // incompatible command line options were chosen.
   934 static void no_shared_spaces() {
   935   if (RequireSharedSpaces) {
   936     jio_fprintf(defaultStream::error_stream(),
   937       "Class data sharing is inconsistent with other specified options.\n");
   938     vm_exit_during_initialization("Unable to use shared archive.", NULL);
   939   } else {
   940     FLAG_SET_DEFAULT(UseSharedSpaces, false);
   941   }
   942 }
   945 // If the user has chosen ParallelGCThreads > 0, we set UseParNewGC
   946 // if it's not explictly set or unset. If the user has chosen
   947 // UseParNewGC and not explicitly set ParallelGCThreads we
   948 // set it, unless this is a single cpu machine.
   949 void Arguments::set_parnew_gc_flags() {
   950   assert(!UseSerialGC && !UseParallelGC, "control point invariant");
   952   // Turn off AdaptiveSizePolicy by default for parnew until it is
   953   // complete.
   954   if (UseParNewGC &&
   955       FLAG_IS_DEFAULT(UseAdaptiveSizePolicy)) {
   956     FLAG_SET_DEFAULT(UseAdaptiveSizePolicy, false);
   957   }
   959   if (FLAG_IS_DEFAULT(UseParNewGC) && ParallelGCThreads > 1) {
   960     FLAG_SET_DEFAULT(UseParNewGC, true);
   961   } else if (UseParNewGC && ParallelGCThreads == 0) {
   962     FLAG_SET_DEFAULT(ParallelGCThreads,
   963                      Abstract_VM_Version::parallel_worker_threads());
   964     if (FLAG_IS_DEFAULT(ParallelGCThreads) && ParallelGCThreads == 1) {
   965       FLAG_SET_DEFAULT(UseParNewGC, false);
   966     }
   967   }
   968   if (!UseParNewGC) {
   969     FLAG_SET_DEFAULT(ParallelGCThreads, 0);
   970   } else {
   971     no_shared_spaces();
   973     // By default YoungPLABSize and OldPLABSize are set to 4096 and 1024 correspondinly,
   974     // these settings are default for Parallel Scavenger. For ParNew+Tenured configuration
   975     // we set them to 1024 and 1024.
   976     // See CR 6362902.
   977     if (FLAG_IS_DEFAULT(YoungPLABSize)) {
   978       FLAG_SET_DEFAULT(YoungPLABSize, (intx)1024);
   979     }
   980     if (FLAG_IS_DEFAULT(OldPLABSize)) {
   981       FLAG_SET_DEFAULT(OldPLABSize, (intx)1024);
   982     }
   984     // AlwaysTenure flag should make ParNew to promote all at first collection.
   985     // See CR 6362902.
   986     if (AlwaysTenure) {
   987       FLAG_SET_CMDLINE(intx, MaxTenuringThreshold, 0);
   988     }
   989   }
   990 }
   992 // Adjust some sizes to suit CMS and/or ParNew needs; these work well on
   993 // sparc/solaris for certain applications, but would gain from
   994 // further optimization and tuning efforts, and would almost
   995 // certainly gain from analysis of platform and environment.
   996 void Arguments::set_cms_and_parnew_gc_flags() {
   997   if (UseSerialGC || UseParallelGC) {
   998     return;
   999   }
  1001   assert(UseConcMarkSweepGC, "CMS is expected to be on here");
  1003   // If we are using CMS, we prefer to UseParNewGC,
  1004   // unless explicitly forbidden.
  1005   if (!UseParNewGC && FLAG_IS_DEFAULT(UseParNewGC)) {
  1006     FLAG_SET_ERGO(bool, UseParNewGC, true);
  1009   // Turn off AdaptiveSizePolicy by default for cms until it is
  1010   // complete.
  1011   if (FLAG_IS_DEFAULT(UseAdaptiveSizePolicy)) {
  1012     FLAG_SET_DEFAULT(UseAdaptiveSizePolicy, false);
  1015   // In either case, adjust ParallelGCThreads and/or UseParNewGC
  1016   // as needed.
  1017   if (UseParNewGC) {
  1018     set_parnew_gc_flags();
  1021   // Now make adjustments for CMS
  1022   size_t young_gen_per_worker;
  1023   intx new_ratio;
  1024   size_t min_new_default;
  1025   intx tenuring_default;
  1026   if (CMSUseOldDefaults) {  // old defaults: "old" as of 6.0
  1027     if FLAG_IS_DEFAULT(CMSYoungGenPerWorker) {
  1028       FLAG_SET_ERGO(intx, CMSYoungGenPerWorker, 4*M);
  1030     young_gen_per_worker = 4*M;
  1031     new_ratio = (intx)15;
  1032     min_new_default = 4*M;
  1033     tenuring_default = (intx)0;
  1034   } else { // new defaults: "new" as of 6.0
  1035     young_gen_per_worker = CMSYoungGenPerWorker;
  1036     new_ratio = (intx)7;
  1037     min_new_default = 16*M;
  1038     tenuring_default = (intx)4;
  1041   // Preferred young gen size for "short" pauses
  1042   const uintx parallel_gc_threads =
  1043     (ParallelGCThreads == 0 ? 1 : ParallelGCThreads);
  1044   const size_t preferred_max_new_size_unaligned =
  1045     ScaleForWordSize(young_gen_per_worker * parallel_gc_threads);
  1046   const size_t preferred_max_new_size =
  1047     align_size_up(preferred_max_new_size_unaligned, os::vm_page_size());
  1049   // Unless explicitly requested otherwise, size young gen
  1050   // for "short" pauses ~ 4M*ParallelGCThreads
  1051   if (FLAG_IS_DEFAULT(MaxNewSize)) {  // MaxNewSize not set at command-line
  1052     if (!FLAG_IS_DEFAULT(NewSize)) {   // NewSize explicitly set at command-line
  1053       FLAG_SET_ERGO(uintx, MaxNewSize, MAX2(NewSize, preferred_max_new_size));
  1054     } else {
  1055       FLAG_SET_ERGO(uintx, MaxNewSize, preferred_max_new_size);
  1057     if(PrintGCDetails && Verbose) {
  1058       // Too early to use gclog_or_tty
  1059       tty->print_cr("Ergo set MaxNewSize: " SIZE_FORMAT, MaxNewSize);
  1062   // Unless explicitly requested otherwise, prefer a large
  1063   // Old to Young gen size so as to shift the collection load
  1064   // to the old generation concurrent collector
  1065   if (FLAG_IS_DEFAULT(NewRatio)) {
  1066     FLAG_SET_ERGO(intx, NewRatio, MAX2(NewRatio, new_ratio));
  1068     size_t min_new  = align_size_up(ScaleForWordSize(min_new_default), os::vm_page_size());
  1069     size_t prev_initial_size = initial_heap_size();
  1070     if (prev_initial_size != 0 && prev_initial_size < min_new+OldSize) {
  1071       set_initial_heap_size(min_new+OldSize);
  1072       // Currently minimum size and the initial heap sizes are the same.
  1073       set_min_heap_size(initial_heap_size());
  1074       if (PrintGCDetails && Verbose) {
  1075         warning("Initial heap size increased to " SIZE_FORMAT " M from "
  1076                 SIZE_FORMAT " M; use -XX:NewSize=... for finer control.",
  1077                 initial_heap_size()/M, prev_initial_size/M);
  1080     // MaxHeapSize is aligned down in collectorPolicy
  1081     size_t max_heap = align_size_down(MaxHeapSize,
  1082                                       CardTableRS::ct_max_alignment_constraint());
  1084     if(PrintGCDetails && Verbose) {
  1085       // Too early to use gclog_or_tty
  1086       tty->print_cr("CMS set min_heap_size: " SIZE_FORMAT
  1087            " initial_heap_size:  " SIZE_FORMAT
  1088            " max_heap: " SIZE_FORMAT,
  1089            min_heap_size(), initial_heap_size(), max_heap);
  1091     if (max_heap > min_new) {
  1092       // Unless explicitly requested otherwise, make young gen
  1093       // at least min_new, and at most preferred_max_new_size.
  1094       if (FLAG_IS_DEFAULT(NewSize)) {
  1095         FLAG_SET_ERGO(uintx, NewSize, MAX2(NewSize, min_new));
  1096         FLAG_SET_ERGO(uintx, NewSize, MIN2(preferred_max_new_size, NewSize));
  1097         if(PrintGCDetails && Verbose) {
  1098           // Too early to use gclog_or_tty
  1099           tty->print_cr("Ergo set NewSize: " SIZE_FORMAT, NewSize);
  1102       // Unless explicitly requested otherwise, size old gen
  1103       // so that it's at least 3X of NewSize to begin with;
  1104       // later NewRatio will decide how it grows; see above.
  1105       if (FLAG_IS_DEFAULT(OldSize)) {
  1106         if (max_heap > NewSize) {
  1107           FLAG_SET_ERGO(uintx, OldSize, MIN2(3*NewSize,  max_heap - NewSize));
  1108           if(PrintGCDetails && Verbose) {
  1109             // Too early to use gclog_or_tty
  1110             tty->print_cr("Ergo set OldSize: " SIZE_FORMAT, OldSize);
  1116   // Unless explicitly requested otherwise, definitely
  1117   // promote all objects surviving "tenuring_default" scavenges.
  1118   if (FLAG_IS_DEFAULT(MaxTenuringThreshold) &&
  1119       FLAG_IS_DEFAULT(SurvivorRatio)) {
  1120     FLAG_SET_ERGO(intx, MaxTenuringThreshold, tenuring_default);
  1122   // If we decided above (or user explicitly requested)
  1123   // `promote all' (via MaxTenuringThreshold := 0),
  1124   // prefer minuscule survivor spaces so as not to waste
  1125   // space for (non-existent) survivors
  1126   if (FLAG_IS_DEFAULT(SurvivorRatio) && MaxTenuringThreshold == 0) {
  1127     FLAG_SET_ERGO(intx, SurvivorRatio, MAX2((intx)1024, SurvivorRatio));
  1129   // If OldPLABSize is set and CMSParPromoteBlocksToClaim is not,
  1130   // set CMSParPromoteBlocksToClaim equal to OldPLABSize.
  1131   // This is done in order to make ParNew+CMS configuration to work
  1132   // with YoungPLABSize and OldPLABSize options.
  1133   // See CR 6362902.
  1134   if (!FLAG_IS_DEFAULT(OldPLABSize)) {
  1135     if (FLAG_IS_DEFAULT(CMSParPromoteBlocksToClaim)) {
  1136       // OldPLABSize is not the default value but CMSParPromoteBlocksToClaim
  1137       // is.  In this situtation let CMSParPromoteBlocksToClaim follow
  1138       // the value (either from the command line or ergonomics) of
  1139       // OldPLABSize.  Following OldPLABSize is an ergonomics decision.
  1140       FLAG_SET_ERGO(uintx, CMSParPromoteBlocksToClaim, OldPLABSize);
  1142     else {
  1143       // OldPLABSize and CMSParPromoteBlocksToClaim are both set.
  1144       // CMSParPromoteBlocksToClaim is a collector-specific flag, so
  1145       // we'll let it to take precedence.
  1146       jio_fprintf(defaultStream::error_stream(),
  1147                   "Both OldPLABSize and CMSParPromoteBlocksToClaim options are specified "
  1148                   "for the CMS collector. CMSParPromoteBlocksToClaim will take precedence.\n");
  1153 inline uintx max_heap_for_compressed_oops() {
  1154   LP64_ONLY(return oopDesc::OopEncodingHeapMax - MaxPermSize - os::vm_page_size());
  1155   NOT_LP64(return DefaultMaxRAM);
  1158 bool Arguments::should_auto_select_low_pause_collector() {
  1159   if (UseAutoGCSelectPolicy &&
  1160       !FLAG_IS_DEFAULT(MaxGCPauseMillis) &&
  1161       (MaxGCPauseMillis <= AutoGCSelectPauseMillis)) {
  1162     if (PrintGCDetails) {
  1163       // Cannot use gclog_or_tty yet.
  1164       tty->print_cr("Automatic selection of the low pause collector"
  1165        " based on pause goal of %d (ms)", MaxGCPauseMillis);
  1167     return true;
  1169   return false;
  1172 void Arguments::set_ergonomics_flags() {
  1173   // Parallel GC is not compatible with sharing. If one specifies
  1174   // that they want sharing explicitly, do not set ergonmics flags.
  1175   if (DumpSharedSpaces || ForceSharedSpaces) {
  1176     return;
  1179   if (os::is_server_class_machine() && !force_client_mode ) {
  1180     // If no other collector is requested explicitly,
  1181     // let the VM select the collector based on
  1182     // machine class and automatic selection policy.
  1183     if (!UseSerialGC &&
  1184         !UseConcMarkSweepGC &&
  1185         !UseParNewGC &&
  1186         !DumpSharedSpaces &&
  1187         FLAG_IS_DEFAULT(UseParallelGC)) {
  1188       if (should_auto_select_low_pause_collector()) {
  1189         FLAG_SET_ERGO(bool, UseConcMarkSweepGC, true);
  1190       } else {
  1191         FLAG_SET_ERGO(bool, UseParallelGC, true);
  1193       no_shared_spaces();
  1197 #ifdef _LP64
  1198   // Compressed Headers do not work with CMS, which uses a bit in the klass
  1199   // field offset to determine free list chunk markers.
  1200   // Check that UseCompressedOops can be set with the max heap size allocated
  1201   // by ergonomics.
  1202   if (MaxHeapSize <= max_heap_for_compressed_oops()) {
  1203     if (FLAG_IS_DEFAULT(UseCompressedOops)) {
  1204       // Turn off until bug is fixed.
  1205       // FLAG_SET_ERGO(bool, UseCompressedOops, true);
  1207   } else {
  1208     if (UseCompressedOops && !FLAG_IS_DEFAULT(UseCompressedOops)) {
  1209       // If specified, give a warning
  1210       if (UseConcMarkSweepGC){
  1211         warning("Compressed Oops does not work with CMS");
  1212       } else {
  1213         warning(
  1214           "Max heap size too large for Compressed Oops");
  1216       FLAG_SET_DEFAULT(UseCompressedOops, false);
  1219   // Also checks that certain machines are slower with compressed oops
  1220   // in vm_version initialization code.
  1221 #endif // _LP64
  1224 void Arguments::set_parallel_gc_flags() {
  1225   // If parallel old was requested, automatically enable parallel scavenge.
  1226   if (UseParallelOldGC && !UseParallelGC && FLAG_IS_DEFAULT(UseParallelGC)) {
  1227     FLAG_SET_DEFAULT(UseParallelGC, true);
  1230   // If no heap maximum was requested explicitly, use some reasonable fraction
  1231   // of the physical memory, up to a maximum of 1GB.
  1232   if (UseParallelGC) {
  1233     FLAG_SET_ERGO(uintx, ParallelGCThreads,
  1234                   Abstract_VM_Version::parallel_worker_threads());
  1236     if (FLAG_IS_DEFAULT(MaxHeapSize)) {
  1237       const uint64_t reasonable_fraction =
  1238         os::physical_memory() / DefaultMaxRAMFraction;
  1239       const uint64_t maximum_size = (uint64_t)
  1240                  (FLAG_IS_DEFAULT(DefaultMaxRAM) && UseCompressedOops ?
  1241                      MIN2(max_heap_for_compressed_oops(), DefaultMaxRAM) :
  1242                      DefaultMaxRAM);
  1243       size_t reasonable_max =
  1244         (size_t) os::allocatable_physical_memory(reasonable_fraction);
  1245       if (reasonable_max > maximum_size) {
  1246         reasonable_max = maximum_size;
  1248       if (PrintGCDetails && Verbose) {
  1249         // Cannot use gclog_or_tty yet.
  1250         tty->print_cr("  Max heap size for server class platform "
  1251                       SIZE_FORMAT, reasonable_max);
  1253       // If the initial_heap_size has not been set with -Xms,
  1254       // then set it as fraction of size of physical memory
  1255       // respecting the maximum and minimum sizes of the heap.
  1256       if (initial_heap_size() == 0) {
  1257         const uint64_t reasonable_initial_fraction =
  1258           os::physical_memory() / DefaultInitialRAMFraction;
  1259         const size_t reasonable_initial =
  1260           (size_t) os::allocatable_physical_memory(reasonable_initial_fraction);
  1261         const size_t minimum_size = NewSize + OldSize;
  1262         set_initial_heap_size(MAX2(MIN2(reasonable_initial, reasonable_max),
  1263                                   minimum_size));
  1264         // Currently the minimum size and the initial heap sizes are the same.
  1265         set_min_heap_size(initial_heap_size());
  1266         if (PrintGCDetails && Verbose) {
  1267           // Cannot use gclog_or_tty yet.
  1268           tty->print_cr("  Initial heap size for server class platform "
  1269                         SIZE_FORMAT, initial_heap_size());
  1271       } else {
  1272         // An minimum size was specified on the command line.  Be sure
  1273         // that the maximum size is consistent.
  1274         if (initial_heap_size() > reasonable_max) {
  1275           reasonable_max = initial_heap_size();
  1278       FLAG_SET_ERGO(uintx, MaxHeapSize, (uintx) reasonable_max);
  1281     // If InitialSurvivorRatio or MinSurvivorRatio were not specified, but the
  1282     // SurvivorRatio has been set, reset their default values to SurvivorRatio +
  1283     // 2.  By doing this we make SurvivorRatio also work for Parallel Scavenger.
  1284     // See CR 6362902 for details.
  1285     if (!FLAG_IS_DEFAULT(SurvivorRatio)) {
  1286       if (FLAG_IS_DEFAULT(InitialSurvivorRatio)) {
  1287          FLAG_SET_DEFAULT(InitialSurvivorRatio, SurvivorRatio + 2);
  1289       if (FLAG_IS_DEFAULT(MinSurvivorRatio)) {
  1290         FLAG_SET_DEFAULT(MinSurvivorRatio, SurvivorRatio + 2);
  1294     if (UseParallelOldGC) {
  1295       // Par compact uses lower default values since they are treated as
  1296       // minimums.  These are different defaults because of the different
  1297       // interpretation and are not ergonomically set.
  1298       if (FLAG_IS_DEFAULT(MarkSweepDeadRatio)) {
  1299         FLAG_SET_DEFAULT(MarkSweepDeadRatio, 1);
  1301       if (FLAG_IS_DEFAULT(PermMarkSweepDeadRatio)) {
  1302         FLAG_SET_DEFAULT(PermMarkSweepDeadRatio, 5);
  1308 // This must be called after ergonomics because we want bytecode rewriting
  1309 // if the server compiler is used, or if UseSharedSpaces is disabled.
  1310 void Arguments::set_bytecode_flags() {
  1311   // Better not attempt to store into a read-only space.
  1312   if (UseSharedSpaces) {
  1313     FLAG_SET_DEFAULT(RewriteBytecodes, false);
  1314     FLAG_SET_DEFAULT(RewriteFrequentPairs, false);
  1317   if (!RewriteBytecodes) {
  1318     FLAG_SET_DEFAULT(RewriteFrequentPairs, false);
  1322 // Aggressive optimization flags  -XX:+AggressiveOpts
  1323 void Arguments::set_aggressive_opts_flags() {
  1324 #ifdef COMPILER2
  1325   if (AggressiveOpts || !FLAG_IS_DEFAULT(AutoBoxCacheMax)) {
  1326     if (FLAG_IS_DEFAULT(EliminateAutoBox)) {
  1327       FLAG_SET_DEFAULT(EliminateAutoBox, true);
  1329     if (FLAG_IS_DEFAULT(AutoBoxCacheMax)) {
  1330       FLAG_SET_DEFAULT(AutoBoxCacheMax, 20000);
  1333     // Feed the cache size setting into the JDK
  1334     char buffer[1024];
  1335     sprintf(buffer, "java.lang.Integer.IntegerCache.high=%d", AutoBoxCacheMax);
  1336     add_property(buffer);
  1338   if (AggressiveOpts && FLAG_IS_DEFAULT(DoEscapeAnalysis)) {
  1339     FLAG_SET_DEFAULT(DoEscapeAnalysis, true);
  1341   if (AggressiveOpts && FLAG_IS_DEFAULT(SpecialArraysEquals)) {
  1342     FLAG_SET_DEFAULT(SpecialArraysEquals, true);
  1344 #endif
  1346   if (AggressiveOpts) {
  1347 // Sample flag setting code
  1348 //    if (FLAG_IS_DEFAULT(EliminateZeroing)) {
  1349 //      FLAG_SET_DEFAULT(EliminateZeroing, true);
  1350 //    }
  1354 //===========================================================================================================
  1355 // Parsing of java.compiler property
  1357 void Arguments::process_java_compiler_argument(char* arg) {
  1358   // For backwards compatibility, Djava.compiler=NONE or ""
  1359   // causes us to switch to -Xint mode UNLESS -Xdebug
  1360   // is also specified.
  1361   if (strlen(arg) == 0 || strcasecmp(arg, "NONE") == 0) {
  1362     set_java_compiler(true);    // "-Djava.compiler[=...]" most recently seen.
  1366 void Arguments::process_java_launcher_argument(const char* launcher, void* extra_info) {
  1367   _sun_java_launcher = strdup(launcher);
  1370 bool Arguments::created_by_java_launcher() {
  1371   assert(_sun_java_launcher != NULL, "property must have value");
  1372   return strcmp(DEFAULT_JAVA_LAUNCHER, _sun_java_launcher) != 0;
  1375 //===========================================================================================================
  1376 // Parsing of main arguments
  1378 bool Arguments::verify_percentage(uintx value, const char* name) {
  1379   if (value <= 100) {
  1380     return true;
  1382   jio_fprintf(defaultStream::error_stream(),
  1383               "%s of " UINTX_FORMAT " is invalid; must be between 0 and 100\n",
  1384               name, value);
  1385   return false;
  1388 static void set_serial_gc_flags() {
  1389   FLAG_SET_DEFAULT(UseSerialGC, true);
  1390   FLAG_SET_DEFAULT(UseParNewGC, false);
  1391   FLAG_SET_DEFAULT(UseConcMarkSweepGC, false);
  1392   FLAG_SET_DEFAULT(UseParallelGC, false);
  1393   FLAG_SET_DEFAULT(UseParallelOldGC, false);
  1396 static bool verify_serial_gc_flags() {
  1397   return (UseSerialGC &&
  1398         !(UseParNewGC || UseConcMarkSweepGC || UseParallelGC ||
  1399           UseParallelOldGC));
  1402 // Check consistency of GC selection
  1403 bool Arguments::check_gc_consistency() {
  1404   bool status = true;
  1405   // Ensure that the user has not selected conflicting sets
  1406   // of collectors. [Note: this check is merely a user convenience;
  1407   // collectors over-ride each other so that only a non-conflicting
  1408   // set is selected; however what the user gets is not what they
  1409   // may have expected from the combination they asked for. It's
  1410   // better to reduce user confusion by not allowing them to
  1411   // select conflicting combinations.
  1412   uint i = 0;
  1413   if (UseSerialGC)                       i++;
  1414   if (UseConcMarkSweepGC || UseParNewGC) i++;
  1415   if (UseParallelGC || UseParallelOldGC) i++;
  1416   if (i > 1) {
  1417     jio_fprintf(defaultStream::error_stream(),
  1418                 "Conflicting collector combinations in option list; "
  1419                 "please refer to the release notes for the combinations "
  1420                 "allowed\n");
  1421     status = false;
  1424   return status;
  1427 // Check the consistency of vm_init_args
  1428 bool Arguments::check_vm_args_consistency() {
  1429   // Method for adding checks for flag consistency.
  1430   // The intent is to warn the user of all possible conflicts,
  1431   // before returning an error.
  1432   // Note: Needs platform-dependent factoring.
  1433   bool status = true;
  1435 #if ( (defined(COMPILER2) && defined(SPARC)))
  1436   // NOTE: The call to VM_Version_init depends on the fact that VM_Version_init
  1437   // on sparc doesn't require generation of a stub as is the case on, e.g.,
  1438   // x86.  Normally, VM_Version_init must be called from init_globals in
  1439   // init.cpp, which is called by the initial java thread *after* arguments
  1440   // have been parsed.  VM_Version_init gets called twice on sparc.
  1441   extern void VM_Version_init();
  1442   VM_Version_init();
  1443   if (!VM_Version::has_v9()) {
  1444     jio_fprintf(defaultStream::error_stream(),
  1445                 "V8 Machine detected, Server requires V9\n");
  1446     status = false;
  1448 #endif /* COMPILER2 && SPARC */
  1450   // Allow both -XX:-UseStackBanging and -XX:-UseBoundThreads in non-product
  1451   // builds so the cost of stack banging can be measured.
  1452 #if (defined(PRODUCT) && defined(SOLARIS))
  1453   if (!UseBoundThreads && !UseStackBanging) {
  1454     jio_fprintf(defaultStream::error_stream(),
  1455                 "-UseStackBanging conflicts with -UseBoundThreads\n");
  1457      status = false;
  1459 #endif
  1461   if (TLABRefillWasteFraction == 0) {
  1462     jio_fprintf(defaultStream::error_stream(),
  1463                 "TLABRefillWasteFraction should be a denominator, "
  1464                 "not " SIZE_FORMAT "\n",
  1465                 TLABRefillWasteFraction);
  1466     status = false;
  1469   status = status && verify_percentage(MaxLiveObjectEvacuationRatio,
  1470                               "MaxLiveObjectEvacuationRatio");
  1471   status = status && verify_percentage(AdaptiveSizePolicyWeight,
  1472                               "AdaptiveSizePolicyWeight");
  1473   status = status && verify_percentage(AdaptivePermSizeWeight, "AdaptivePermSizeWeight");
  1474   status = status && verify_percentage(ThresholdTolerance, "ThresholdTolerance");
  1475   status = status && verify_percentage(MinHeapFreeRatio, "MinHeapFreeRatio");
  1476   status = status && verify_percentage(MaxHeapFreeRatio, "MaxHeapFreeRatio");
  1478   if (MinHeapFreeRatio > MaxHeapFreeRatio) {
  1479     jio_fprintf(defaultStream::error_stream(),
  1480                 "MinHeapFreeRatio (" UINTX_FORMAT ") must be less than or "
  1481                 "equal to MaxHeapFreeRatio (" UINTX_FORMAT ")\n",
  1482                 MinHeapFreeRatio, MaxHeapFreeRatio);
  1483     status = false;
  1485   // Keeping the heap 100% free is hard ;-) so limit it to 99%.
  1486   MinHeapFreeRatio = MIN2(MinHeapFreeRatio, (uintx) 99);
  1488   if (FullGCALot && FLAG_IS_DEFAULT(MarkSweepAlwaysCompactCount)) {
  1489     MarkSweepAlwaysCompactCount = 1;  // Move objects every gc.
  1492   status = status && verify_percentage(GCHeapFreeLimit, "GCHeapFreeLimit");
  1493   status = status && verify_percentage(GCTimeLimit, "GCTimeLimit");
  1494   if (GCTimeLimit == 100) {
  1495     // Turn off gc-overhead-limit-exceeded checks
  1496     FLAG_SET_DEFAULT(UseGCOverheadLimit, false);
  1499   status = status && verify_percentage(GCHeapFreeLimit, "GCHeapFreeLimit");
  1501   // Check user specified sharing option conflict with Parallel GC
  1502   bool cannot_share = (UseConcMarkSweepGC || UseParallelGC ||
  1503                        UseParallelOldGC || UseParNewGC ||
  1504                        SOLARIS_ONLY(UseISM) NOT_SOLARIS(UseLargePages));
  1506   if (cannot_share) {
  1507     // Either force sharing on by forcing the other options off, or
  1508     // force sharing off.
  1509     if (DumpSharedSpaces || ForceSharedSpaces) {
  1510       set_serial_gc_flags();
  1511       FLAG_SET_DEFAULT(SOLARIS_ONLY(UseISM) NOT_SOLARIS(UseLargePages), false);
  1512     } else {
  1513       no_shared_spaces();
  1517   status = status && check_gc_consistency();
  1519   if (_has_alloc_profile) {
  1520     if (UseParallelGC || UseParallelOldGC) {
  1521       jio_fprintf(defaultStream::error_stream(),
  1522                   "error:  invalid argument combination.\n"
  1523                   "Allocation profiling (-Xaprof) cannot be used together with "
  1524                   "Parallel GC (-XX:+UseParallelGC or -XX:+UseParallelOldGC).\n");
  1525       status = false;
  1527     if (UseConcMarkSweepGC) {
  1528       jio_fprintf(defaultStream::error_stream(),
  1529                   "error:  invalid argument combination.\n"
  1530                   "Allocation profiling (-Xaprof) cannot be used together with "
  1531                   "the CMS collector (-XX:+UseConcMarkSweepGC).\n");
  1532       status = false;
  1536   if (CMSIncrementalMode) {
  1537     if (!UseConcMarkSweepGC) {
  1538       jio_fprintf(defaultStream::error_stream(),
  1539                   "error:  invalid argument combination.\n"
  1540                   "The CMS collector (-XX:+UseConcMarkSweepGC) must be "
  1541                   "selected in order\nto use CMSIncrementalMode.\n");
  1542       status = false;
  1543     } else if (!UseTLAB) {
  1544       jio_fprintf(defaultStream::error_stream(),
  1545                   "error:  CMSIncrementalMode requires thread-local "
  1546                   "allocation buffers\n(-XX:+UseTLAB).\n");
  1547       status = false;
  1548     } else {
  1549       status = status && verify_percentage(CMSIncrementalDutyCycle,
  1550                                   "CMSIncrementalDutyCycle");
  1551       status = status && verify_percentage(CMSIncrementalDutyCycleMin,
  1552                                   "CMSIncrementalDutyCycleMin");
  1553       status = status && verify_percentage(CMSIncrementalSafetyFactor,
  1554                                   "CMSIncrementalSafetyFactor");
  1555       status = status && verify_percentage(CMSIncrementalOffset,
  1556                                   "CMSIncrementalOffset");
  1557       status = status && verify_percentage(CMSExpAvgFactor,
  1558                                   "CMSExpAvgFactor");
  1559       // If it was not set on the command line, set
  1560       // CMSInitiatingOccupancyFraction to 1 so icms can initiate cycles early.
  1561       if (CMSInitiatingOccupancyFraction < 0) {
  1562         FLAG_SET_DEFAULT(CMSInitiatingOccupancyFraction, 1);
  1567   if (UseNUMA && !UseTLAB) {
  1568     jio_fprintf(defaultStream::error_stream(),
  1569                 "error:  NUMA allocator (-XX:+UseNUMA) requires thread-local "
  1570                 "allocation\nbuffers (-XX:+UseTLAB).\n");
  1571     status = false;
  1574   // CMS space iteration, which FLSVerifyAllHeapreferences entails,
  1575   // insists that we hold the requisite locks so that the iteration is
  1576   // MT-safe. For the verification at start-up and shut-down, we don't
  1577   // yet have a good way of acquiring and releasing these locks,
  1578   // which are not visible at the CollectedHeap level. We want to
  1579   // be able to acquire these locks and then do the iteration rather
  1580   // than just disable the lock verification. This will be fixed under
  1581   // bug 4788986.
  1582   if (UseConcMarkSweepGC && FLSVerifyAllHeapReferences) {
  1583     if (VerifyGCStartAt == 0) {
  1584       warning("Heap verification at start-up disabled "
  1585               "(due to current incompatibility with FLSVerifyAllHeapReferences)");
  1586       VerifyGCStartAt = 1;      // Disable verification at start-up
  1588     if (VerifyBeforeExit) {
  1589       warning("Heap verification at shutdown disabled "
  1590               "(due to current incompatibility with FLSVerifyAllHeapReferences)");
  1591       VerifyBeforeExit = false; // Disable verification at shutdown
  1595   // Note: only executed in non-PRODUCT mode
  1596   if (!UseAsyncConcMarkSweepGC &&
  1597       (ExplicitGCInvokesConcurrent ||
  1598        ExplicitGCInvokesConcurrentAndUnloadsClasses)) {
  1599     jio_fprintf(defaultStream::error_stream(),
  1600                 "error: +ExplictGCInvokesConcurrent[AndUnloadsClasses] conflicts"
  1601                 " with -UseAsyncConcMarkSweepGC");
  1602     status = false;
  1605   return status;
  1608 bool Arguments::is_bad_option(const JavaVMOption* option, jboolean ignore,
  1609   const char* option_type) {
  1610   if (ignore) return false;
  1612   const char* spacer = " ";
  1613   if (option_type == NULL) {
  1614     option_type = ++spacer; // Set both to the empty string.
  1617   if (os::obsolete_option(option)) {
  1618     jio_fprintf(defaultStream::error_stream(),
  1619                 "Obsolete %s%soption: %s\n", option_type, spacer,
  1620       option->optionString);
  1621     return false;
  1622   } else {
  1623     jio_fprintf(defaultStream::error_stream(),
  1624                 "Unrecognized %s%soption: %s\n", option_type, spacer,
  1625       option->optionString);
  1626     return true;
  1630 static const char* user_assertion_options[] = {
  1631   "-da", "-ea", "-disableassertions", "-enableassertions", 0
  1632 };
  1634 static const char* system_assertion_options[] = {
  1635   "-dsa", "-esa", "-disablesystemassertions", "-enablesystemassertions", 0
  1636 };
  1638 // Return true if any of the strings in null-terminated array 'names' matches.
  1639 // If tail_allowed is true, then the tail must begin with a colon; otherwise,
  1640 // the option must match exactly.
  1641 static bool match_option(const JavaVMOption* option, const char** names, const char** tail,
  1642   bool tail_allowed) {
  1643   for (/* empty */; *names != NULL; ++names) {
  1644     if (match_option(option, *names, tail)) {
  1645       if (**tail == '\0' || tail_allowed && **tail == ':') {
  1646         return true;
  1650   return false;
  1653 Arguments::ArgsRange Arguments::parse_memory_size(const char* s,
  1654                                                   jlong* long_arg,
  1655                                                   jlong min_size) {
  1656   if (!atomll(s, long_arg)) return arg_unreadable;
  1657   return check_memory_size(*long_arg, min_size);
  1660 // Parse JavaVMInitArgs structure
  1662 jint Arguments::parse_vm_init_args(const JavaVMInitArgs* args) {
  1663   // For components of the system classpath.
  1664   SysClassPath scp(Arguments::get_sysclasspath());
  1665   bool scp_assembly_required = false;
  1667   // Save default settings for some mode flags
  1668   Arguments::_AlwaysCompileLoopMethods = AlwaysCompileLoopMethods;
  1669   Arguments::_UseOnStackReplacement    = UseOnStackReplacement;
  1670   Arguments::_ClipInlining             = ClipInlining;
  1671   Arguments::_BackgroundCompilation    = BackgroundCompilation;
  1672   Arguments::_Tier2CompileThreshold    = Tier2CompileThreshold;
  1674   // Parse JAVA_TOOL_OPTIONS environment variable (if present)
  1675   jint result = parse_java_tool_options_environment_variable(&scp, &scp_assembly_required);
  1676   if (result != JNI_OK) {
  1677     return result;
  1680   // Parse JavaVMInitArgs structure passed in
  1681   result = parse_each_vm_init_arg(args, &scp, &scp_assembly_required, COMMAND_LINE);
  1682   if (result != JNI_OK) {
  1683     return result;
  1686   // Parse _JAVA_OPTIONS environment variable (if present) (mimics classic VM)
  1687   result = parse_java_options_environment_variable(&scp, &scp_assembly_required);
  1688   if (result != JNI_OK) {
  1689     return result;
  1692   // Do final processing now that all arguments have been parsed
  1693   result = finalize_vm_init_args(&scp, scp_assembly_required);
  1694   if (result != JNI_OK) {
  1695     return result;
  1698   return JNI_OK;
  1702 jint Arguments::parse_each_vm_init_arg(const JavaVMInitArgs* args,
  1703                                        SysClassPath* scp_p,
  1704                                        bool* scp_assembly_required_p,
  1705                                        FlagValueOrigin origin) {
  1706   // Remaining part of option string
  1707   const char* tail;
  1709   // iterate over arguments
  1710   for (int index = 0; index < args->nOptions; index++) {
  1711     bool is_absolute_path = false;  // for -agentpath vs -agentlib
  1713     const JavaVMOption* option = args->options + index;
  1715     if (!match_option(option, "-Djava.class.path", &tail) &&
  1716         !match_option(option, "-Dsun.java.command", &tail) &&
  1717         !match_option(option, "-Dsun.java.launcher", &tail)) {
  1719         // add all jvm options to the jvm_args string. This string
  1720         // is used later to set the java.vm.args PerfData string constant.
  1721         // the -Djava.class.path and the -Dsun.java.command options are
  1722         // omitted from jvm_args string as each have their own PerfData
  1723         // string constant object.
  1724         build_jvm_args(option->optionString);
  1727     // -verbose:[class/gc/jni]
  1728     if (match_option(option, "-verbose", &tail)) {
  1729       if (!strcmp(tail, ":class") || !strcmp(tail, "")) {
  1730         FLAG_SET_CMDLINE(bool, TraceClassLoading, true);
  1731         FLAG_SET_CMDLINE(bool, TraceClassUnloading, true);
  1732       } else if (!strcmp(tail, ":gc")) {
  1733         FLAG_SET_CMDLINE(bool, PrintGC, true);
  1734         FLAG_SET_CMDLINE(bool, TraceClassUnloading, true);
  1735       } else if (!strcmp(tail, ":jni")) {
  1736         FLAG_SET_CMDLINE(bool, PrintJNIResolving, true);
  1738     // -da / -ea / -disableassertions / -enableassertions
  1739     // These accept an optional class/package name separated by a colon, e.g.,
  1740     // -da:java.lang.Thread.
  1741     } else if (match_option(option, user_assertion_options, &tail, true)) {
  1742       bool enable = option->optionString[1] == 'e';     // char after '-' is 'e'
  1743       if (*tail == '\0') {
  1744         JavaAssertions::setUserClassDefault(enable);
  1745       } else {
  1746         assert(*tail == ':', "bogus match by match_option()");
  1747         JavaAssertions::addOption(tail + 1, enable);
  1749     // -dsa / -esa / -disablesystemassertions / -enablesystemassertions
  1750     } else if (match_option(option, system_assertion_options, &tail, false)) {
  1751       bool enable = option->optionString[1] == 'e';     // char after '-' is 'e'
  1752       JavaAssertions::setSystemClassDefault(enable);
  1753     // -bootclasspath:
  1754     } else if (match_option(option, "-Xbootclasspath:", &tail)) {
  1755       scp_p->reset_path(tail);
  1756       *scp_assembly_required_p = true;
  1757     // -bootclasspath/a:
  1758     } else if (match_option(option, "-Xbootclasspath/a:", &tail)) {
  1759       scp_p->add_suffix(tail);
  1760       *scp_assembly_required_p = true;
  1761     // -bootclasspath/p:
  1762     } else if (match_option(option, "-Xbootclasspath/p:", &tail)) {
  1763       scp_p->add_prefix(tail);
  1764       *scp_assembly_required_p = true;
  1765     // -Xrun
  1766     } else if (match_option(option, "-Xrun", &tail)) {
  1767       if(tail != NULL) {
  1768         const char* pos = strchr(tail, ':');
  1769         size_t len = (pos == NULL) ? strlen(tail) : pos - tail;
  1770         char* name = (char*)memcpy(NEW_C_HEAP_ARRAY(char, len + 1), tail, len);
  1771         name[len] = '\0';
  1773         char *options = NULL;
  1774         if(pos != NULL) {
  1775           size_t len2 = strlen(pos+1) + 1; // options start after ':'.  Final zero must be copied.
  1776           options = (char*)memcpy(NEW_C_HEAP_ARRAY(char, len2), pos+1, len2);
  1778 #ifdef JVMTI_KERNEL
  1779         if ((strcmp(name, "hprof") == 0) || (strcmp(name, "jdwp") == 0)) {
  1780           warning("profiling and debugging agents are not supported with Kernel VM");
  1781         } else
  1782 #endif // JVMTI_KERNEL
  1783         add_init_library(name, options);
  1785     // -agentlib and -agentpath
  1786     } else if (match_option(option, "-agentlib:", &tail) ||
  1787           (is_absolute_path = match_option(option, "-agentpath:", &tail))) {
  1788       if(tail != NULL) {
  1789         const char* pos = strchr(tail, '=');
  1790         size_t len = (pos == NULL) ? strlen(tail) : pos - tail;
  1791         char* name = strncpy(NEW_C_HEAP_ARRAY(char, len + 1), tail, len);
  1792         name[len] = '\0';
  1794         char *options = NULL;
  1795         if(pos != NULL) {
  1796           options = strcpy(NEW_C_HEAP_ARRAY(char, strlen(pos + 1) + 1), pos + 1);
  1798 #ifdef JVMTI_KERNEL
  1799         if ((strcmp(name, "hprof") == 0) || (strcmp(name, "jdwp") == 0)) {
  1800           warning("profiling and debugging agents are not supported with Kernel VM");
  1801         } else
  1802 #endif // JVMTI_KERNEL
  1803         add_init_agent(name, options, is_absolute_path);
  1806     // -javaagent
  1807     } else if (match_option(option, "-javaagent:", &tail)) {
  1808       if(tail != NULL) {
  1809         char *options = strcpy(NEW_C_HEAP_ARRAY(char, strlen(tail) + 1), tail);
  1810         add_init_agent("instrument", options, false);
  1812     // -Xnoclassgc
  1813     } else if (match_option(option, "-Xnoclassgc", &tail)) {
  1814       FLAG_SET_CMDLINE(bool, ClassUnloading, false);
  1815     // -Xincgc: i-CMS
  1816     } else if (match_option(option, "-Xincgc", &tail)) {
  1817       FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, true);
  1818       FLAG_SET_CMDLINE(bool, CMSIncrementalMode, true);
  1819     // -Xnoincgc: no i-CMS
  1820     } else if (match_option(option, "-Xnoincgc", &tail)) {
  1821       FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, false);
  1822       FLAG_SET_CMDLINE(bool, CMSIncrementalMode, false);
  1823     // -Xconcgc
  1824     } else if (match_option(option, "-Xconcgc", &tail)) {
  1825       FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, true);
  1826     // -Xnoconcgc
  1827     } else if (match_option(option, "-Xnoconcgc", &tail)) {
  1828       FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, false);
  1829     // -Xbatch
  1830     } else if (match_option(option, "-Xbatch", &tail)) {
  1831       FLAG_SET_CMDLINE(bool, BackgroundCompilation, false);
  1832     // -Xmn for compatibility with other JVM vendors
  1833     } else if (match_option(option, "-Xmn", &tail)) {
  1834       jlong long_initial_eden_size = 0;
  1835       ArgsRange errcode = parse_memory_size(tail, &long_initial_eden_size, 1);
  1836       if (errcode != arg_in_range) {
  1837         jio_fprintf(defaultStream::error_stream(),
  1838                     "Invalid initial eden size: %s\n", option->optionString);
  1839         describe_range_error(errcode);
  1840         return JNI_EINVAL;
  1842       FLAG_SET_CMDLINE(uintx, MaxNewSize, (size_t) long_initial_eden_size);
  1843       FLAG_SET_CMDLINE(uintx, NewSize, (size_t) long_initial_eden_size);
  1844     // -Xms
  1845     } else if (match_option(option, "-Xms", &tail)) {
  1846       jlong long_initial_heap_size = 0;
  1847       ArgsRange errcode = parse_memory_size(tail, &long_initial_heap_size, 1);
  1848       if (errcode != arg_in_range) {
  1849         jio_fprintf(defaultStream::error_stream(),
  1850                     "Invalid initial heap size: %s\n", option->optionString);
  1851         describe_range_error(errcode);
  1852         return JNI_EINVAL;
  1854       set_initial_heap_size((size_t) long_initial_heap_size);
  1855       // Currently the minimum size and the initial heap sizes are the same.
  1856       set_min_heap_size(initial_heap_size());
  1857     // -Xmx
  1858     } else if (match_option(option, "-Xmx", &tail)) {
  1859       jlong long_max_heap_size = 0;
  1860       ArgsRange errcode = parse_memory_size(tail, &long_max_heap_size, 1);
  1861       if (errcode != arg_in_range) {
  1862         jio_fprintf(defaultStream::error_stream(),
  1863                     "Invalid maximum heap size: %s\n", option->optionString);
  1864         describe_range_error(errcode);
  1865         return JNI_EINVAL;
  1867       FLAG_SET_CMDLINE(uintx, MaxHeapSize, (size_t) long_max_heap_size);
  1868     // Xmaxf
  1869     } else if (match_option(option, "-Xmaxf", &tail)) {
  1870       int maxf = (int)(atof(tail) * 100);
  1871       if (maxf < 0 || maxf > 100) {
  1872         jio_fprintf(defaultStream::error_stream(),
  1873                     "Bad max heap free percentage size: %s\n",
  1874                     option->optionString);
  1875         return JNI_EINVAL;
  1876       } else {
  1877         FLAG_SET_CMDLINE(uintx, MaxHeapFreeRatio, maxf);
  1879     // Xminf
  1880     } else if (match_option(option, "-Xminf", &tail)) {
  1881       int minf = (int)(atof(tail) * 100);
  1882       if (minf < 0 || minf > 100) {
  1883         jio_fprintf(defaultStream::error_stream(),
  1884                     "Bad min heap free percentage size: %s\n",
  1885                     option->optionString);
  1886         return JNI_EINVAL;
  1887       } else {
  1888         FLAG_SET_CMDLINE(uintx, MinHeapFreeRatio, minf);
  1890     // -Xss
  1891     } else if (match_option(option, "-Xss", &tail)) {
  1892       jlong long_ThreadStackSize = 0;
  1893       ArgsRange errcode = parse_memory_size(tail, &long_ThreadStackSize, 1000);
  1894       if (errcode != arg_in_range) {
  1895         jio_fprintf(defaultStream::error_stream(),
  1896                     "Invalid thread stack size: %s\n", option->optionString);
  1897         describe_range_error(errcode);
  1898         return JNI_EINVAL;
  1900       // Internally track ThreadStackSize in units of 1024 bytes.
  1901       FLAG_SET_CMDLINE(intx, ThreadStackSize,
  1902                               round_to((int)long_ThreadStackSize, K) / K);
  1903     // -Xoss
  1904     } else if (match_option(option, "-Xoss", &tail)) {
  1905           // HotSpot does not have separate native and Java stacks, ignore silently for compatibility
  1906     // -Xmaxjitcodesize
  1907     } else if (match_option(option, "-Xmaxjitcodesize", &tail)) {
  1908       jlong long_ReservedCodeCacheSize = 0;
  1909       ArgsRange errcode = parse_memory_size(tail, &long_ReservedCodeCacheSize,
  1910                                             InitialCodeCacheSize);
  1911       if (errcode != arg_in_range) {
  1912         jio_fprintf(defaultStream::error_stream(),
  1913                     "Invalid maximum code cache size: %s\n",
  1914                     option->optionString);
  1915         describe_range_error(errcode);
  1916         return JNI_EINVAL;
  1918       FLAG_SET_CMDLINE(uintx, ReservedCodeCacheSize, (uintx)long_ReservedCodeCacheSize);
  1919     // -green
  1920     } else if (match_option(option, "-green", &tail)) {
  1921       jio_fprintf(defaultStream::error_stream(),
  1922                   "Green threads support not available\n");
  1923           return JNI_EINVAL;
  1924     // -native
  1925     } else if (match_option(option, "-native", &tail)) {
  1926           // HotSpot always uses native threads, ignore silently for compatibility
  1927     // -Xsqnopause
  1928     } else if (match_option(option, "-Xsqnopause", &tail)) {
  1929           // EVM option, ignore silently for compatibility
  1930     // -Xrs
  1931     } else if (match_option(option, "-Xrs", &tail)) {
  1932           // Classic/EVM option, new functionality
  1933       FLAG_SET_CMDLINE(bool, ReduceSignalUsage, true);
  1934     } else if (match_option(option, "-Xusealtsigs", &tail)) {
  1935           // change default internal VM signals used - lower case for back compat
  1936       FLAG_SET_CMDLINE(bool, UseAltSigs, true);
  1937     // -Xoptimize
  1938     } else if (match_option(option, "-Xoptimize", &tail)) {
  1939           // EVM option, ignore silently for compatibility
  1940     // -Xprof
  1941     } else if (match_option(option, "-Xprof", &tail)) {
  1942 #ifndef FPROF_KERNEL
  1943       _has_profile = true;
  1944 #else // FPROF_KERNEL
  1945       // do we have to exit?
  1946       warning("Kernel VM does not support flat profiling.");
  1947 #endif // FPROF_KERNEL
  1948     // -Xaprof
  1949     } else if (match_option(option, "-Xaprof", &tail)) {
  1950       _has_alloc_profile = true;
  1951     // -Xconcurrentio
  1952     } else if (match_option(option, "-Xconcurrentio", &tail)) {
  1953       FLAG_SET_CMDLINE(bool, UseLWPSynchronization, true);
  1954       FLAG_SET_CMDLINE(bool, BackgroundCompilation, false);
  1955       FLAG_SET_CMDLINE(intx, DeferThrSuspendLoopCount, 1);
  1956       FLAG_SET_CMDLINE(bool, UseTLAB, false);
  1957       FLAG_SET_CMDLINE(uintx, NewSizeThreadIncrease, 16 * K);  // 20Kb per thread added to new generation
  1959       // -Xinternalversion
  1960     } else if (match_option(option, "-Xinternalversion", &tail)) {
  1961       jio_fprintf(defaultStream::output_stream(), "%s\n",
  1962                   VM_Version::internal_vm_info_string());
  1963       vm_exit(0);
  1964 #ifndef PRODUCT
  1965     // -Xprintflags
  1966     } else if (match_option(option, "-Xprintflags", &tail)) {
  1967       CommandLineFlags::printFlags();
  1968       vm_exit(0);
  1969 #endif
  1970     // -D
  1971     } else if (match_option(option, "-D", &tail)) {
  1972       if (!add_property(tail)) {
  1973         return JNI_ENOMEM;
  1975       // Out of the box management support
  1976       if (match_option(option, "-Dcom.sun.management", &tail)) {
  1977         FLAG_SET_CMDLINE(bool, ManagementServer, true);
  1979     // -Xint
  1980     } else if (match_option(option, "-Xint", &tail)) {
  1981           set_mode_flags(_int);
  1982     // -Xmixed
  1983     } else if (match_option(option, "-Xmixed", &tail)) {
  1984           set_mode_flags(_mixed);
  1985     // -Xcomp
  1986     } else if (match_option(option, "-Xcomp", &tail)) {
  1987       // for testing the compiler; turn off all flags that inhibit compilation
  1988           set_mode_flags(_comp);
  1990     // -Xshare:dump
  1991     } else if (match_option(option, "-Xshare:dump", &tail)) {
  1992 #ifdef TIERED
  1993       FLAG_SET_CMDLINE(bool, DumpSharedSpaces, true);
  1994       set_mode_flags(_int);     // Prevent compilation, which creates objects
  1995 #elif defined(COMPILER2)
  1996       vm_exit_during_initialization(
  1997           "Dumping a shared archive is not supported on the Server JVM.", NULL);
  1998 #elif defined(KERNEL)
  1999       vm_exit_during_initialization(
  2000           "Dumping a shared archive is not supported on the Kernel JVM.", NULL);
  2001 #else
  2002       FLAG_SET_CMDLINE(bool, DumpSharedSpaces, true);
  2003       set_mode_flags(_int);     // Prevent compilation, which creates objects
  2004 #endif
  2005     // -Xshare:on
  2006     } else if (match_option(option, "-Xshare:on", &tail)) {
  2007       FLAG_SET_CMDLINE(bool, UseSharedSpaces, true);
  2008       FLAG_SET_CMDLINE(bool, RequireSharedSpaces, true);
  2009 #ifdef TIERED
  2010       FLAG_SET_CMDLINE(bool, ForceSharedSpaces, true);
  2011 #endif // TIERED
  2012     // -Xshare:auto
  2013     } else if (match_option(option, "-Xshare:auto", &tail)) {
  2014       FLAG_SET_CMDLINE(bool, UseSharedSpaces, true);
  2015       FLAG_SET_CMDLINE(bool, RequireSharedSpaces, false);
  2016     // -Xshare:off
  2017     } else if (match_option(option, "-Xshare:off", &tail)) {
  2018       FLAG_SET_CMDLINE(bool, UseSharedSpaces, false);
  2019       FLAG_SET_CMDLINE(bool, RequireSharedSpaces, false);
  2021     // -Xverify
  2022     } else if (match_option(option, "-Xverify", &tail)) {
  2023       if (strcmp(tail, ":all") == 0 || strcmp(tail, "") == 0) {
  2024         FLAG_SET_CMDLINE(bool, BytecodeVerificationLocal, true);
  2025         FLAG_SET_CMDLINE(bool, BytecodeVerificationRemote, true);
  2026       } else if (strcmp(tail, ":remote") == 0) {
  2027         FLAG_SET_CMDLINE(bool, BytecodeVerificationLocal, false);
  2028         FLAG_SET_CMDLINE(bool, BytecodeVerificationRemote, true);
  2029       } else if (strcmp(tail, ":none") == 0) {
  2030         FLAG_SET_CMDLINE(bool, BytecodeVerificationLocal, false);
  2031         FLAG_SET_CMDLINE(bool, BytecodeVerificationRemote, false);
  2032       } else if (is_bad_option(option, args->ignoreUnrecognized, "verification")) {
  2033         return JNI_EINVAL;
  2035     // -Xdebug
  2036     } else if (match_option(option, "-Xdebug", &tail)) {
  2037       // note this flag has been used, then ignore
  2038       set_xdebug_mode(true);
  2039     // -Xnoagent
  2040     } else if (match_option(option, "-Xnoagent", &tail)) {
  2041       // For compatibility with classic. HotSpot refuses to load the old style agent.dll.
  2042     } else if (match_option(option, "-Xboundthreads", &tail)) {
  2043       // Bind user level threads to kernel threads (Solaris only)
  2044       FLAG_SET_CMDLINE(bool, UseBoundThreads, true);
  2045     } else if (match_option(option, "-Xloggc:", &tail)) {
  2046       // Redirect GC output to the file. -Xloggc:<filename>
  2047       // ostream_init_log(), when called will use this filename
  2048       // to initialize a fileStream.
  2049       _gc_log_filename = strdup(tail);
  2050       FLAG_SET_CMDLINE(bool, PrintGC, true);
  2051       FLAG_SET_CMDLINE(bool, PrintGCTimeStamps, true);
  2052       FLAG_SET_CMDLINE(bool, TraceClassUnloading, true);
  2054     // JNI hooks
  2055     } else if (match_option(option, "-Xcheck", &tail)) {
  2056       if (!strcmp(tail, ":jni")) {
  2057         CheckJNICalls = true;
  2058       } else if (is_bad_option(option, args->ignoreUnrecognized,
  2059                                      "check")) {
  2060         return JNI_EINVAL;
  2062     } else if (match_option(option, "vfprintf", &tail)) {
  2063       _vfprintf_hook = CAST_TO_FN_PTR(vfprintf_hook_t, option->extraInfo);
  2064     } else if (match_option(option, "exit", &tail)) {
  2065       _exit_hook = CAST_TO_FN_PTR(exit_hook_t, option->extraInfo);
  2066     } else if (match_option(option, "abort", &tail)) {
  2067       _abort_hook = CAST_TO_FN_PTR(abort_hook_t, option->extraInfo);
  2068     // -XX:+AggressiveHeap
  2069     } else if (match_option(option, "-XX:+AggressiveHeap", &tail)) {
  2071       // This option inspects the machine and attempts to set various
  2072       // parameters to be optimal for long-running, memory allocation
  2073       // intensive jobs.  It is intended for machines with large
  2074       // amounts of cpu and memory.
  2076       // initHeapSize is needed since _initial_heap_size is 4 bytes on a 32 bit
  2077       // VM, but we may not be able to represent the total physical memory
  2078       // available (like having 8gb of memory on a box but using a 32bit VM).
  2079       // Thus, we need to make sure we're using a julong for intermediate
  2080       // calculations.
  2081       julong initHeapSize;
  2082       julong total_memory = os::physical_memory();
  2084       if (total_memory < (julong)256*M) {
  2085         jio_fprintf(defaultStream::error_stream(),
  2086                     "You need at least 256mb of memory to use -XX:+AggressiveHeap\n");
  2087         vm_exit(1);
  2090       // The heap size is half of available memory, or (at most)
  2091       // all of possible memory less 160mb (leaving room for the OS
  2092       // when using ISM).  This is the maximum; because adaptive sizing
  2093       // is turned on below, the actual space used may be smaller.
  2095       initHeapSize = MIN2(total_memory / (julong)2,
  2096                           total_memory - (julong)160*M);
  2098       // Make sure that if we have a lot of memory we cap the 32 bit
  2099       // process space.  The 64bit VM version of this function is a nop.
  2100       initHeapSize = os::allocatable_physical_memory(initHeapSize);
  2102       // The perm gen is separate but contiguous with the
  2103       // object heap (and is reserved with it) so subtract it
  2104       // from the heap size.
  2105       if (initHeapSize > MaxPermSize) {
  2106         initHeapSize = initHeapSize - MaxPermSize;
  2107       } else {
  2108         warning("AggressiveHeap and MaxPermSize values may conflict");
  2111       if (FLAG_IS_DEFAULT(MaxHeapSize)) {
  2112          FLAG_SET_CMDLINE(uintx, MaxHeapSize, initHeapSize);
  2113          set_initial_heap_size(MaxHeapSize);
  2114          // Currently the minimum size and the initial heap sizes are the same.
  2115          set_min_heap_size(initial_heap_size());
  2117       if (FLAG_IS_DEFAULT(NewSize)) {
  2118          // Make the young generation 3/8ths of the total heap.
  2119          FLAG_SET_CMDLINE(uintx, NewSize,
  2120                                 ((julong)MaxHeapSize / (julong)8) * (julong)3);
  2121          FLAG_SET_CMDLINE(uintx, MaxNewSize, NewSize);
  2124       FLAG_SET_DEFAULT(UseLargePages, true);
  2126       // Increase some data structure sizes for efficiency
  2127       FLAG_SET_CMDLINE(uintx, BaseFootPrintEstimate, MaxHeapSize);
  2128       FLAG_SET_CMDLINE(bool, ResizeTLAB, false);
  2129       FLAG_SET_CMDLINE(uintx, TLABSize, 256*K);
  2131       // See the OldPLABSize comment below, but replace 'after promotion'
  2132       // with 'after copying'.  YoungPLABSize is the size of the survivor
  2133       // space per-gc-thread buffers.  The default is 4kw.
  2134       FLAG_SET_CMDLINE(uintx, YoungPLABSize, 256*K);      // Note: this is in words
  2136       // OldPLABSize is the size of the buffers in the old gen that
  2137       // UseParallelGC uses to promote live data that doesn't fit in the
  2138       // survivor spaces.  At any given time, there's one for each gc thread.
  2139       // The default size is 1kw. These buffers are rarely used, since the
  2140       // survivor spaces are usually big enough.  For specjbb, however, there
  2141       // are occasions when there's lots of live data in the young gen
  2142       // and we end up promoting some of it.  We don't have a definite
  2143       // explanation for why bumping OldPLABSize helps, but the theory
  2144       // is that a bigger PLAB results in retaining something like the
  2145       // original allocation order after promotion, which improves mutator
  2146       // locality.  A minor effect may be that larger PLABs reduce the
  2147       // number of PLAB allocation events during gc.  The value of 8kw
  2148       // was arrived at by experimenting with specjbb.
  2149       FLAG_SET_CMDLINE(uintx, OldPLABSize, 8*K);  // Note: this is in words
  2151       // CompilationPolicyChoice=0 causes the server compiler to adopt
  2152       // a more conservative which-method-do-I-compile policy when one
  2153       // of the counters maintained by the interpreter trips.  The
  2154       // result is reduced startup time and improved specjbb and
  2155       // alacrity performance.  Zero is the default, but we set it
  2156       // explicitly here in case the default changes.
  2157       // See runtime/compilationPolicy.*.
  2158       FLAG_SET_CMDLINE(intx, CompilationPolicyChoice, 0);
  2160       // Enable parallel GC and adaptive generation sizing
  2161       FLAG_SET_CMDLINE(bool, UseParallelGC, true);
  2162       FLAG_SET_DEFAULT(ParallelGCThreads,
  2163                        Abstract_VM_Version::parallel_worker_threads());
  2165       // Encourage steady state memory management
  2166       FLAG_SET_CMDLINE(uintx, ThresholdTolerance, 100);
  2168       // This appears to improve mutator locality
  2169       FLAG_SET_CMDLINE(bool, ScavengeBeforeFullGC, false);
  2171       // Get around early Solaris scheduling bug
  2172       // (affinity vs other jobs on system)
  2173       // but disallow DR and offlining (5008695).
  2174       FLAG_SET_CMDLINE(bool, BindGCTaskThreadsToCPUs, true);
  2176     } else if (match_option(option, "-XX:+NeverTenure", &tail)) {
  2177       // The last option must always win.
  2178       FLAG_SET_CMDLINE(bool, AlwaysTenure, false);
  2179       FLAG_SET_CMDLINE(bool, NeverTenure, true);
  2180     } else if (match_option(option, "-XX:+AlwaysTenure", &tail)) {
  2181       // The last option must always win.
  2182       FLAG_SET_CMDLINE(bool, NeverTenure, false);
  2183       FLAG_SET_CMDLINE(bool, AlwaysTenure, true);
  2184     } else if (match_option(option, "-XX:+CMSPermGenSweepingEnabled", &tail) ||
  2185                match_option(option, "-XX:-CMSPermGenSweepingEnabled", &tail)) {
  2186       jio_fprintf(defaultStream::error_stream(),
  2187         "Please use CMSClassUnloadingEnabled in place of "
  2188         "CMSPermGenSweepingEnabled in the future\n");
  2189     } else if (match_option(option, "-XX:+UseGCTimeLimit", &tail)) {
  2190       FLAG_SET_CMDLINE(bool, UseGCOverheadLimit, true);
  2191       jio_fprintf(defaultStream::error_stream(),
  2192         "Please use -XX:+UseGCOverheadLimit in place of "
  2193         "-XX:+UseGCTimeLimit in the future\n");
  2194     } else if (match_option(option, "-XX:-UseGCTimeLimit", &tail)) {
  2195       FLAG_SET_CMDLINE(bool, UseGCOverheadLimit, false);
  2196       jio_fprintf(defaultStream::error_stream(),
  2197         "Please use -XX:-UseGCOverheadLimit in place of "
  2198         "-XX:-UseGCTimeLimit in the future\n");
  2199     // The TLE options are for compatibility with 1.3 and will be
  2200     // removed without notice in a future release.  These options
  2201     // are not to be documented.
  2202     } else if (match_option(option, "-XX:MaxTLERatio=", &tail)) {
  2203       // No longer used.
  2204     } else if (match_option(option, "-XX:+ResizeTLE", &tail)) {
  2205       FLAG_SET_CMDLINE(bool, ResizeTLAB, true);
  2206     } else if (match_option(option, "-XX:-ResizeTLE", &tail)) {
  2207       FLAG_SET_CMDLINE(bool, ResizeTLAB, false);
  2208     } else if (match_option(option, "-XX:+PrintTLE", &tail)) {
  2209       FLAG_SET_CMDLINE(bool, PrintTLAB, true);
  2210     } else if (match_option(option, "-XX:-PrintTLE", &tail)) {
  2211       FLAG_SET_CMDLINE(bool, PrintTLAB, false);
  2212     } else if (match_option(option, "-XX:TLEFragmentationRatio=", &tail)) {
  2213       // No longer used.
  2214     } else if (match_option(option, "-XX:TLESize=", &tail)) {
  2215       jlong long_tlab_size = 0;
  2216       ArgsRange errcode = parse_memory_size(tail, &long_tlab_size, 1);
  2217       if (errcode != arg_in_range) {
  2218         jio_fprintf(defaultStream::error_stream(),
  2219                     "Invalid TLAB size: %s\n", option->optionString);
  2220         describe_range_error(errcode);
  2221         return JNI_EINVAL;
  2223       FLAG_SET_CMDLINE(uintx, TLABSize, long_tlab_size);
  2224     } else if (match_option(option, "-XX:TLEThreadRatio=", &tail)) {
  2225       // No longer used.
  2226     } else if (match_option(option, "-XX:+UseTLE", &tail)) {
  2227       FLAG_SET_CMDLINE(bool, UseTLAB, true);
  2228     } else if (match_option(option, "-XX:-UseTLE", &tail)) {
  2229       FLAG_SET_CMDLINE(bool, UseTLAB, false);
  2230 SOLARIS_ONLY(
  2231     } else if (match_option(option, "-XX:+UsePermISM", &tail)) {
  2232       warning("-XX:+UsePermISM is obsolete.");
  2233       FLAG_SET_CMDLINE(bool, UseISM, true);
  2234     } else if (match_option(option, "-XX:-UsePermISM", &tail)) {
  2235       FLAG_SET_CMDLINE(bool, UseISM, false);
  2237     } else if (match_option(option, "-XX:+DisplayVMOutputToStderr", &tail)) {
  2238       FLAG_SET_CMDLINE(bool, DisplayVMOutputToStdout, false);
  2239       FLAG_SET_CMDLINE(bool, DisplayVMOutputToStderr, true);
  2240     } else if (match_option(option, "-XX:+DisplayVMOutputToStdout", &tail)) {
  2241       FLAG_SET_CMDLINE(bool, DisplayVMOutputToStderr, false);
  2242       FLAG_SET_CMDLINE(bool, DisplayVMOutputToStdout, true);
  2243     } else if (match_option(option, "-XX:+ExtendedDTraceProbes", &tail)) {
  2244 #ifdef SOLARIS
  2245       FLAG_SET_CMDLINE(bool, ExtendedDTraceProbes, true);
  2246       FLAG_SET_CMDLINE(bool, DTraceMethodProbes, true);
  2247       FLAG_SET_CMDLINE(bool, DTraceAllocProbes, true);
  2248       FLAG_SET_CMDLINE(bool, DTraceMonitorProbes, true);
  2249 #else // ndef SOLARIS
  2250       jio_fprintf(defaultStream::error_stream(),
  2251                   "ExtendedDTraceProbes flag is only applicable on Solaris\n");
  2252       return JNI_EINVAL;
  2253 #endif // ndef SOLARIS
  2254     } else
  2255 #ifdef ASSERT
  2256     if (match_option(option, "-XX:+FullGCALot", &tail)) {
  2257       FLAG_SET_CMDLINE(bool, FullGCALot, true);
  2258       // disable scavenge before parallel mark-compact
  2259       FLAG_SET_CMDLINE(bool, ScavengeBeforeFullGC, false);
  2260     } else
  2261 #endif
  2262     if (match_option(option, "-XX:ParCMSPromoteBlocksToClaim=", &tail)) {
  2263       julong cms_blocks_to_claim = (julong)atol(tail);
  2264       FLAG_SET_CMDLINE(uintx, CMSParPromoteBlocksToClaim, cms_blocks_to_claim);
  2265       jio_fprintf(defaultStream::error_stream(),
  2266         "Please use -XX:CMSParPromoteBlocksToClaim in place of "
  2267         "-XX:ParCMSPromoteBlocksToClaim in the future\n");
  2268     } else
  2269     if (match_option(option, "-XX:ParallelGCOldGenAllocBufferSize=", &tail)) {
  2270       jlong old_plab_size = 0;
  2271       ArgsRange errcode = parse_memory_size(tail, &old_plab_size, 1);
  2272       if (errcode != arg_in_range) {
  2273         jio_fprintf(defaultStream::error_stream(),
  2274                     "Invalid old PLAB size: %s\n", option->optionString);
  2275         describe_range_error(errcode);
  2276         return JNI_EINVAL;
  2278       FLAG_SET_CMDLINE(uintx, OldPLABSize, (julong)old_plab_size);
  2279       jio_fprintf(defaultStream::error_stream(),
  2280                   "Please use -XX:OldPLABSize in place of "
  2281                   "-XX:ParallelGCOldGenAllocBufferSize in the future\n");
  2282     } else
  2283     if (match_option(option, "-XX:ParallelGCToSpaceAllocBufferSize=", &tail)) {
  2284       jlong young_plab_size = 0;
  2285       ArgsRange errcode = parse_memory_size(tail, &young_plab_size, 1);
  2286       if (errcode != arg_in_range) {
  2287         jio_fprintf(defaultStream::error_stream(),
  2288                     "Invalid young PLAB size: %s\n", option->optionString);
  2289         describe_range_error(errcode);
  2290         return JNI_EINVAL;
  2292       FLAG_SET_CMDLINE(uintx, YoungPLABSize, (julong)young_plab_size);
  2293       jio_fprintf(defaultStream::error_stream(),
  2294                   "Please use -XX:YoungPLABSize in place of "
  2295                   "-XX:ParallelGCToSpaceAllocBufferSize in the future\n");
  2296     } else
  2297     if (match_option(option, "-XX:", &tail)) { // -XX:xxxx
  2298       // Skip -XX:Flags= since that case has already been handled
  2299       if (strncmp(tail, "Flags=", strlen("Flags=")) != 0) {
  2300         if (!process_argument(tail, args->ignoreUnrecognized, origin)) {
  2301           return JNI_EINVAL;
  2304     // Unknown option
  2305     } else if (is_bad_option(option, args->ignoreUnrecognized)) {
  2306       return JNI_ERR;
  2310   return JNI_OK;
  2313 jint Arguments::finalize_vm_init_args(SysClassPath* scp_p, bool scp_assembly_required) {
  2314   // This must be done after all -D arguments have been processed.
  2315   scp_p->expand_endorsed();
  2317   if (scp_assembly_required || scp_p->get_endorsed() != NULL) {
  2318     // Assemble the bootclasspath elements into the final path.
  2319     Arguments::set_sysclasspath(scp_p->combined_path());
  2322   // This must be done after all arguments have been processed.
  2323   // java_compiler() true means set to "NONE" or empty.
  2324   if (java_compiler() && !xdebug_mode()) {
  2325     // For backwards compatibility, we switch to interpreted mode if
  2326     // -Djava.compiler="NONE" or "" is specified AND "-Xdebug" was
  2327     // not specified.
  2328     set_mode_flags(_int);
  2330   if (CompileThreshold == 0) {
  2331     set_mode_flags(_int);
  2334 #ifdef TIERED
  2335   // If we are using tiered compilation in the tiered vm then c1 will
  2336   // do the profiling and we don't want to waste that time in the
  2337   // interpreter.
  2338   if (TieredCompilation) {
  2339     ProfileInterpreter = false;
  2340   } else {
  2341     // Since we are running vanilla server we must adjust the compile threshold
  2342     // unless the user has already adjusted it because the default threshold assumes
  2343     // we will run tiered.
  2345     if (FLAG_IS_DEFAULT(CompileThreshold)) {
  2346       CompileThreshold = Tier2CompileThreshold;
  2349 #endif // TIERED
  2351 #ifndef COMPILER2
  2352   // Don't degrade server performance for footprint
  2353   if (FLAG_IS_DEFAULT(UseLargePages) &&
  2354       MaxHeapSize < LargePageHeapSizeThreshold) {
  2355     // No need for large granularity pages w/small heaps.
  2356     // Note that large pages are enabled/disabled for both the
  2357     // Java heap and the code cache.
  2358     FLAG_SET_DEFAULT(UseLargePages, false);
  2359     SOLARIS_ONLY(FLAG_SET_DEFAULT(UseMPSS, false));
  2360     SOLARIS_ONLY(FLAG_SET_DEFAULT(UseISM, false));
  2362 #else
  2363   if (!FLAG_IS_DEFAULT(OptoLoopAlignment) && FLAG_IS_DEFAULT(MaxLoopPad)) {
  2364     FLAG_SET_DEFAULT(MaxLoopPad, OptoLoopAlignment-1);
  2366 #endif
  2368   if (!check_vm_args_consistency()) {
  2369     return JNI_ERR;
  2372   return JNI_OK;
  2375 jint Arguments::parse_java_options_environment_variable(SysClassPath* scp_p, bool* scp_assembly_required_p) {
  2376   return parse_options_environment_variable("_JAVA_OPTIONS", scp_p,
  2377                                             scp_assembly_required_p);
  2380 jint Arguments::parse_java_tool_options_environment_variable(SysClassPath* scp_p, bool* scp_assembly_required_p) {
  2381   return parse_options_environment_variable("JAVA_TOOL_OPTIONS", scp_p,
  2382                                             scp_assembly_required_p);
  2385 jint Arguments::parse_options_environment_variable(const char* name, SysClassPath* scp_p, bool* scp_assembly_required_p) {
  2386   const int N_MAX_OPTIONS = 64;
  2387   const int OPTION_BUFFER_SIZE = 1024;
  2388   char buffer[OPTION_BUFFER_SIZE];
  2390   // The variable will be ignored if it exceeds the length of the buffer.
  2391   // Don't check this variable if user has special privileges
  2392   // (e.g. unix su command).
  2393   if (os::getenv(name, buffer, sizeof(buffer)) &&
  2394       !os::have_special_privileges()) {
  2395     JavaVMOption options[N_MAX_OPTIONS];      // Construct option array
  2396     jio_fprintf(defaultStream::error_stream(),
  2397                 "Picked up %s: %s\n", name, buffer);
  2398     char* rd = buffer;                        // pointer to the input string (rd)
  2399     int i;
  2400     for (i = 0; i < N_MAX_OPTIONS;) {         // repeat for all options in the input string
  2401       while (isspace(*rd)) rd++;              // skip whitespace
  2402       if (*rd == 0) break;                    // we re done when the input string is read completely
  2404       // The output, option string, overwrites the input string.
  2405       // Because of quoting, the pointer to the option string (wrt) may lag the pointer to
  2406       // input string (rd).
  2407       char* wrt = rd;
  2409       options[i++].optionString = wrt;        // Fill in option
  2410       while (*rd != 0 && !isspace(*rd)) {     // unquoted strings terminate with a space or NULL
  2411         if (*rd == '\'' || *rd == '"') {      // handle a quoted string
  2412           int quote = *rd;                    // matching quote to look for
  2413           rd++;                               // don't copy open quote
  2414           while (*rd != quote) {              // include everything (even spaces) up until quote
  2415             if (*rd == 0) {                   // string termination means unmatched string
  2416               jio_fprintf(defaultStream::error_stream(),
  2417                           "Unmatched quote in %s\n", name);
  2418               return JNI_ERR;
  2420             *wrt++ = *rd++;                   // copy to option string
  2422           rd++;                               // don't copy close quote
  2423         } else {
  2424           *wrt++ = *rd++;                     // copy to option string
  2427       // Need to check if we're done before writing a NULL,
  2428       // because the write could be to the byte that rd is pointing to.
  2429       if (*rd++ == 0) {
  2430         *wrt = 0;
  2431         break;
  2433       *wrt = 0;                               // Zero terminate option
  2435     // Construct JavaVMInitArgs structure and parse as if it was part of the command line
  2436     JavaVMInitArgs vm_args;
  2437     vm_args.version = JNI_VERSION_1_2;
  2438     vm_args.options = options;
  2439     vm_args.nOptions = i;
  2440     vm_args.ignoreUnrecognized = false;
  2442     if (PrintVMOptions) {
  2443       const char* tail;
  2444       for (int i = 0; i < vm_args.nOptions; i++) {
  2445         const JavaVMOption *option = vm_args.options + i;
  2446         if (match_option(option, "-XX:", &tail)) {
  2447           logOption(tail);
  2452     return(parse_each_vm_init_arg(&vm_args, scp_p, scp_assembly_required_p, ENVIRON_VAR));
  2454   return JNI_OK;
  2457 // Parse entry point called from JNI_CreateJavaVM
  2459 jint Arguments::parse(const JavaVMInitArgs* args) {
  2461   // Sharing support
  2462   // Construct the path to the archive
  2463   char jvm_path[JVM_MAXPATHLEN];
  2464   os::jvm_path(jvm_path, sizeof(jvm_path));
  2465 #ifdef TIERED
  2466   if (strstr(jvm_path, "client") != NULL) {
  2467     force_client_mode = true;
  2469 #endif // TIERED
  2470   char *end = strrchr(jvm_path, *os::file_separator());
  2471   if (end != NULL) *end = '\0';
  2472   char *shared_archive_path = NEW_C_HEAP_ARRAY(char, strlen(jvm_path) +
  2473                                         strlen(os::file_separator()) + 20);
  2474   if (shared_archive_path == NULL) return JNI_ENOMEM;
  2475   strcpy(shared_archive_path, jvm_path);
  2476   strcat(shared_archive_path, os::file_separator());
  2477   strcat(shared_archive_path, "classes");
  2478   DEBUG_ONLY(strcat(shared_archive_path, "_g");)
  2479   strcat(shared_archive_path, ".jsa");
  2480   SharedArchivePath = shared_archive_path;
  2482   // Remaining part of option string
  2483   const char* tail;
  2485   // If flag "-XX:Flags=flags-file" is used it will be the first option to be processed.
  2486   bool settings_file_specified = false;
  2487   int index;
  2488   for (index = 0; index < args->nOptions; index++) {
  2489     const JavaVMOption *option = args->options + index;
  2490     if (match_option(option, "-XX:Flags=", &tail)) {
  2491       if (!process_settings_file(tail, true, args->ignoreUnrecognized)) {
  2492         return JNI_EINVAL;
  2494       settings_file_specified = true;
  2496     if (match_option(option, "-XX:+PrintVMOptions", &tail)) {
  2497       PrintVMOptions = true;
  2499     if (match_option(option, "-XX:-PrintVMOptions", &tail)) {
  2500       PrintVMOptions = false;
  2504   // Parse default .hotspotrc settings file
  2505   if (!settings_file_specified) {
  2506     if (!process_settings_file(".hotspotrc", false, args->ignoreUnrecognized)) {
  2507       return JNI_EINVAL;
  2511   if (PrintVMOptions) {
  2512     for (index = 0; index < args->nOptions; index++) {
  2513       const JavaVMOption *option = args->options + index;
  2514       if (match_option(option, "-XX:", &tail)) {
  2515         logOption(tail);
  2520   // Parse JavaVMInitArgs structure passed in, as well as JAVA_TOOL_OPTIONS and _JAVA_OPTIONS
  2521   jint result = parse_vm_init_args(args);
  2522   if (result != JNI_OK) {
  2523     return result;
  2526 #ifndef PRODUCT
  2527   if (TraceBytecodesAt != 0) {
  2528     TraceBytecodes = true;
  2530   if (CountCompiledCalls) {
  2531     if (UseCounterDecay) {
  2532       warning("UseCounterDecay disabled because CountCalls is set");
  2533       UseCounterDecay = false;
  2536 #endif // PRODUCT
  2538   if (PrintGCDetails) {
  2539     // Turn on -verbose:gc options as well
  2540     PrintGC = true;
  2541     if (FLAG_IS_DEFAULT(TraceClassUnloading)) {
  2542       TraceClassUnloading = true;
  2546 #ifdef SERIALGC
  2547   set_serial_gc_flags();
  2548 #endif // SERIALGC
  2549 #ifdef KERNEL
  2550   no_shared_spaces();
  2551 #endif // KERNEL
  2553   // Set flags based on ergonomics.
  2554   set_ergonomics_flags();
  2556   // Check the GC selections again.
  2557   if (!check_gc_consistency()) {
  2558     return JNI_EINVAL;
  2561   if (UseParallelGC || UseParallelOldGC) {
  2562     // Set some flags for ParallelGC if needed.
  2563     set_parallel_gc_flags();
  2564   } else if (UseConcMarkSweepGC) {
  2565     // Set some flags for CMS
  2566     set_cms_and_parnew_gc_flags();
  2567   } else if (UseParNewGC) {
  2568     // Set some flags for ParNew
  2569     set_parnew_gc_flags();
  2572 #ifdef SERIALGC
  2573   assert(verify_serial_gc_flags(), "SerialGC unset");
  2574 #endif // SERIALGC
  2576   // Set bytecode rewriting flags
  2577   set_bytecode_flags();
  2579   // Set flags if Aggressive optimization flags (-XX:+AggressiveOpts) enabled.
  2580   set_aggressive_opts_flags();
  2582 #ifdef CC_INTERP
  2583   // Biased locking is not implemented with c++ interpreter
  2584   FLAG_SET_DEFAULT(UseBiasedLocking, false);
  2585 #endif /* CC_INTERP */
  2587   if (PrintCommandLineFlags) {
  2588     CommandLineFlags::printSetFlags();
  2591 #ifdef ASSERT
  2592   if (PrintFlagsFinal) {
  2593     CommandLineFlags::printFlags();
  2595 #endif
  2597   return JNI_OK;
  2600 int Arguments::PropertyList_count(SystemProperty* pl) {
  2601   int count = 0;
  2602   while(pl != NULL) {
  2603     count++;
  2604     pl = pl->next();
  2606   return count;
  2609 const char* Arguments::PropertyList_get_value(SystemProperty *pl, const char* key) {
  2610   assert(key != NULL, "just checking");
  2611   SystemProperty* prop;
  2612   for (prop = pl; prop != NULL; prop = prop->next()) {
  2613     if (strcmp(key, prop->key()) == 0) return prop->value();
  2615   return NULL;
  2618 const char* Arguments::PropertyList_get_key_at(SystemProperty *pl, int index) {
  2619   int count = 0;
  2620   const char* ret_val = NULL;
  2622   while(pl != NULL) {
  2623     if(count >= index) {
  2624       ret_val = pl->key();
  2625       break;
  2627     count++;
  2628     pl = pl->next();
  2631   return ret_val;
  2634 char* Arguments::PropertyList_get_value_at(SystemProperty* pl, int index) {
  2635   int count = 0;
  2636   char* ret_val = NULL;
  2638   while(pl != NULL) {
  2639     if(count >= index) {
  2640       ret_val = pl->value();
  2641       break;
  2643     count++;
  2644     pl = pl->next();
  2647   return ret_val;
  2650 void Arguments::PropertyList_add(SystemProperty** plist, SystemProperty *new_p) {
  2651   SystemProperty* p = *plist;
  2652   if (p == NULL) {
  2653     *plist = new_p;
  2654   } else {
  2655     while (p->next() != NULL) {
  2656       p = p->next();
  2658     p->set_next(new_p);
  2662 void Arguments::PropertyList_add(SystemProperty** plist, const char* k, char* v) {
  2663   if (plist == NULL)
  2664     return;
  2666   SystemProperty* new_p = new SystemProperty(k, v, true);
  2667   PropertyList_add(plist, new_p);
  2670 // This add maintains unique property key in the list.
  2671 void Arguments::PropertyList_unique_add(SystemProperty** plist, const char* k, char* v) {
  2672   if (plist == NULL)
  2673     return;
  2675   // If property key exist then update with new value.
  2676   SystemProperty* prop;
  2677   for (prop = *plist; prop != NULL; prop = prop->next()) {
  2678     if (strcmp(k, prop->key()) == 0) {
  2679       prop->set_value(v);
  2680       return;
  2684   PropertyList_add(plist, k, v);
  2687 #ifdef KERNEL
  2688 char *Arguments::get_kernel_properties() {
  2689   // Find properties starting with kernel and append them to string
  2690   // We need to find out how long they are first because the URL's that they
  2691   // might point to could get long.
  2692   int length = 0;
  2693   SystemProperty* prop;
  2694   for (prop = _system_properties; prop != NULL; prop = prop->next()) {
  2695     if (strncmp(prop->key(), "kernel.", 7 ) == 0) {
  2696       length += (strlen(prop->key()) + strlen(prop->value()) + 5);  // "-D ="
  2699   // Add one for null terminator.
  2700   char *props = AllocateHeap(length + 1, "get_kernel_properties");
  2701   if (length != 0) {
  2702     int pos = 0;
  2703     for (prop = _system_properties; prop != NULL; prop = prop->next()) {
  2704       if (strncmp(prop->key(), "kernel.", 7 ) == 0) {
  2705         jio_snprintf(&props[pos], length-pos,
  2706                      "-D%s=%s ", prop->key(), prop->value());
  2707         pos = strlen(props);
  2711   // null terminate props in case of null
  2712   props[length] = '\0';
  2713   return props;
  2715 #endif // KERNEL
  2717 // Copies src into buf, replacing "%%" with "%" and "%p" with pid
  2718 // Returns true if all of the source pointed by src has been copied over to
  2719 // the destination buffer pointed by buf. Otherwise, returns false.
  2720 // Notes:
  2721 // 1. If the length (buflen) of the destination buffer excluding the
  2722 // NULL terminator character is not long enough for holding the expanded
  2723 // pid characters, it also returns false instead of returning the partially
  2724 // expanded one.
  2725 // 2. The passed in "buflen" should be large enough to hold the null terminator.
  2726 bool Arguments::copy_expand_pid(const char* src, size_t srclen,
  2727                                 char* buf, size_t buflen) {
  2728   const char* p = src;
  2729   char* b = buf;
  2730   const char* src_end = &src[srclen];
  2731   char* buf_end = &buf[buflen - 1];
  2733   while (p < src_end && b < buf_end) {
  2734     if (*p == '%') {
  2735       switch (*(++p)) {
  2736       case '%':         // "%%" ==> "%"
  2737         *b++ = *p++;
  2738         break;
  2739       case 'p':  {       //  "%p" ==> current process id
  2740         // buf_end points to the character before the last character so
  2741         // that we could write '\0' to the end of the buffer.
  2742         size_t buf_sz = buf_end - b + 1;
  2743         int ret = jio_snprintf(b, buf_sz, "%d", os::current_process_id());
  2745         // if jio_snprintf fails or the buffer is not long enough to hold
  2746         // the expanded pid, returns false.
  2747         if (ret < 0 || ret >= (int)buf_sz) {
  2748           return false;
  2749         } else {
  2750           b += ret;
  2751           assert(*b == '\0', "fail in copy_expand_pid");
  2752           if (p == src_end && b == buf_end + 1) {
  2753             // reach the end of the buffer.
  2754             return true;
  2757         p++;
  2758         break;
  2760       default :
  2761         *b++ = '%';
  2763     } else {
  2764       *b++ = *p++;
  2767   *b = '\0';
  2768   return (p == src_end); // return false if not all of the source was copied

mercurial