arguments.cpp revision 356:1ee8caae33af
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 */
24
25#include "incls/_precompiled.incl"
26#include "incls/_arguments.cpp.incl"
27
28#define DEFAULT_VENDOR_URL_BUG "http://java.sun.com/webapps/bugreport/crash.jsp"
29#define DEFAULT_JAVA_LAUNCHER  "generic"
30
31char**  Arguments::_jvm_flags_array             = NULL;
32int     Arguments::_num_jvm_flags               = 0;
33char**  Arguments::_jvm_args_array              = NULL;
34int     Arguments::_num_jvm_args                = 0;
35char*  Arguments::_java_command                 = NULL;
36SystemProperty* Arguments::_system_properties   = NULL;
37const char*  Arguments::_gc_log_filename        = NULL;
38bool   Arguments::_has_profile                  = false;
39bool   Arguments::_has_alloc_profile            = false;
40uintx  Arguments::_initial_heap_size            = 0;
41uintx  Arguments::_min_heap_size                = 0;
42Arguments::Mode Arguments::_mode                = _mixed;
43bool   Arguments::_java_compiler                = false;
44bool   Arguments::_xdebug_mode                  = false;
45const char*  Arguments::_java_vendor_url_bug    = DEFAULT_VENDOR_URL_BUG;
46const char*  Arguments::_sun_java_launcher      = DEFAULT_JAVA_LAUNCHER;
47int    Arguments::_sun_java_launcher_pid        = -1;
48
49// These parameters are reset in method parse_vm_init_args(JavaVMInitArgs*)
50bool   Arguments::_AlwaysCompileLoopMethods     = AlwaysCompileLoopMethods;
51bool   Arguments::_UseOnStackReplacement        = UseOnStackReplacement;
52bool   Arguments::_BackgroundCompilation        = BackgroundCompilation;
53bool   Arguments::_ClipInlining                 = ClipInlining;
54intx   Arguments::_Tier2CompileThreshold        = Tier2CompileThreshold;
55
56char*  Arguments::SharedArchivePath             = NULL;
57
58AgentLibraryList Arguments::_libraryList;
59AgentLibraryList Arguments::_agentList;
60
61abort_hook_t     Arguments::_abort_hook         = NULL;
62exit_hook_t      Arguments::_exit_hook          = NULL;
63vfprintf_hook_t  Arguments::_vfprintf_hook      = NULL;
64
65
66SystemProperty *Arguments::_java_ext_dirs = NULL;
67SystemProperty *Arguments::_java_endorsed_dirs = NULL;
68SystemProperty *Arguments::_sun_boot_library_path = NULL;
69SystemProperty *Arguments::_java_library_path = NULL;
70SystemProperty *Arguments::_java_home = NULL;
71SystemProperty *Arguments::_java_class_path = NULL;
72SystemProperty *Arguments::_sun_boot_class_path = NULL;
73
74char* Arguments::_meta_index_path = NULL;
75char* Arguments::_meta_index_dir = NULL;
76
77static bool force_client_mode = false;
78
79// Check if head of 'option' matches 'name', and sets 'tail' remaining part of option string
80
81static 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}
91
92static void logOption(const char* opt) {
93  if (PrintVMOptions) {
94    jio_fprintf(defaultStream::output_stream(), "VM option '%s'\n", opt);
95  }
96}
97
98// Process java launcher properties.
99void 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;
106
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}
117
118// Initialize system properties key and value.
119void Arguments::init_system_properties() {
120
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));
130
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);
140
141  _java_class_path = new SystemProperty("java.class.path", "",  true);
142
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);
151
152  // Set OS specific system properties values
153  os::init_system_properties_values();
154}
155
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 */
164typedef 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;
169
170static 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};
187
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.
192bool 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}
211
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.
225class SysClassPath: public StackObj {
226public:
227  SysClassPath(const char* base);
228  ~SysClassPath();
229
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);
234
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();
240
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]; }
245
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();
249
250private:
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);
254
255  inline void reset_item_at(int index);
256
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  };
266
267  const char* _items[_scp_nitems];
268  DEBUG_ONLY(bool _expansion_done;)
269};
270
271SysClassPath::SysClassPath(const char* base) {
272  memset(_items, 0, sizeof(_items));
273  _items[_scp_base] = base;
274  DEBUG_ONLY(_expansion_done = false;)
275}
276
277SysClassPath::~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}
284
285inline void SysClassPath::set_base(const char* base) {
286  _items[_scp_base] = base;
287}
288
289inline void SysClassPath::add_prefix(const char* prefix) {
290  _items[_scp_prefix] = add_to_path(_items[_scp_prefix], prefix, true);
291}
292
293inline void SysClassPath::add_suffix(const char* suffix) {
294  _items[_scp_suffix] = add_to_path(_items[_scp_suffix], suffix, false);
295}
296
297inline 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}
304
305inline 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}
311
312//------------------------------------------------------------------------------
313
314void SysClassPath::expand_endorsed() {
315  assert(_items[_scp_endorsed] == NULL, "can only be called once.");
316
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  }
322
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}
343
344// Combine the bootclasspath elements, some of which may be null, into a single
345// c-heap-allocated string.
346char* SysClassPath::combined_path() {
347  assert(_items[_scp_base] != NULL, "empty default sysclasspath");
348  assert(_expansion_done, "must call expand_endorsed() first.");
349
350  size_t lengths[_scp_nitems];
351  size_t total_len = 0;
352
353  const char separator = *os::path_separator();
354
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");
365
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}
379
380// Note:  path must be c-heap-allocated (or NULL); it is freed if non-null.
381char*
382SysClassPath::add_to_path(const char* path, const char* str, bool prepend) {
383  char *cp;
384
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;
395
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}
413
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.
416char* SysClassPath::add_jars_to_path(char* path, const char* directory) {
417  DIR* dir = os::opendir(directory);
418  if (dir == NULL) return path;
419
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;
424
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}
445
446// Parses a memory size specification string.
447static 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}
480
481Arguments::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}
487
488// Describe an argument out of range error
489void 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}
505
506static bool set_bool_flag(char* name, bool value, FlagValueOrigin origin) {
507  return CommandLineFlags::boolAtPut(name, &value, origin);
508}
509
510
511static 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  }
516
517  if (CommandLineFlags::doubleAtPut(name, &v, origin)) {
518    return true;
519  }
520  return false;
521}
522
523
524static 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}
552
553
554static 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}
560
561static 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}
588
589
590bool Arguments::parse_argument(const char* arg, FlagValueOrigin origin) {
591
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;
597
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  }
604
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  }
620
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  }
629
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  }
641
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  }
646
647  return false;
648}
649
650
651void Arguments::add_string(char*** bldarray, int* count, const char* arg) {
652  assert(bldarray != NULL, "illegal argument");
653
654  if (arg == NULL) {
655    return;
656  }
657
658  int index = *count;
659
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}
669
670void Arguments::build_jvm_args(const char* arg) {
671  add_string(&_jvm_args_array, &_num_jvm_args, arg);
672}
673
674void Arguments::build_jvm_flags(const char* arg) {
675  add_string(&_jvm_flags_array, &_num_jvm_flags, arg);
676}
677
678// utility function to return a string that concatenates all
679// strings in a given char** array
680const 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}
696
697void 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}
708
709void 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}
717
718void 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}
726
727bool Arguments::process_argument(const char* arg,
728    jboolean ignore_unrecognized, FlagValueOrigin origin) {
729
730  JDK_Version since = JDK_Version();
731
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}
753
754
755bool 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  }
766
767  char token[1024];
768  int  pos = 0;
769
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;
775
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}
818
819//=============================================================================================================
820// Parsing of properties (-D)
821
822const char* Arguments::get_property(const char* key) {
823  return PropertyList_get_value(system_properties(), key);
824}
825
826bool 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;
832
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';
837
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  }
843
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) {
853
854    _java_command = value;
855
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  }
875
876  // Create new property and add at the end of the list
877  PropertyList_unique_add(&_system_properties, key, value);
878  return true;
879}
880
881//===========================================================================================================
882// Setting int/mixed/comp mode flags
883
884void 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;
890
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());
895
896  UseInterpreter             = true;
897  UseCompiler                = true;
898  UseLoopCounter             = true;
899
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;
907
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}
929
930
931// Conflict: required to use shared spaces (-Xshare:on), but
932// incompatible command line options were chosen.
933
934static 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}
943
944
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.
949void Arguments::set_parnew_gc_flags() {
950  assert(!UseSerialGC && !UseParallelGC && !UseG1GC,
951         "control point invariant");
952  assert(UseParNewGC, "Error");
953
954  // Turn off AdaptiveSizePolicy by default for parnew until it is
955  // complete.
956  if (FLAG_IS_DEFAULT(UseAdaptiveSizePolicy)) {
957    FLAG_SET_DEFAULT(UseAdaptiveSizePolicy, false);
958  }
959
960  if (ParallelGCThreads == 0) {
961    FLAG_SET_DEFAULT(ParallelGCThreads,
962                     Abstract_VM_Version::parallel_worker_threads());
963    if (FLAG_IS_DEFAULT(ParallelGCThreads) && ParallelGCThreads == 1) {
964      FLAG_SET_DEFAULT(UseParNewGC, false);
965    }
966  }
967  if (!UseParNewGC) {
968    FLAG_SET_DEFAULT(ParallelGCThreads, 0);
969  } else {
970    no_shared_spaces();
971
972    // By default YoungPLABSize and OldPLABSize are set to 4096 and 1024 correspondinly,
973    // these settings are default for Parallel Scavenger. For ParNew+Tenured configuration
974    // we set them to 1024 and 1024.
975    // See CR 6362902.
976    if (FLAG_IS_DEFAULT(YoungPLABSize)) {
977      FLAG_SET_DEFAULT(YoungPLABSize, (intx)1024);
978    }
979    if (FLAG_IS_DEFAULT(OldPLABSize)) {
980      FLAG_SET_DEFAULT(OldPLABSize, (intx)1024);
981    }
982
983    // AlwaysTenure flag should make ParNew to promote all at first collection.
984    // See CR 6362902.
985    if (AlwaysTenure) {
986      FLAG_SET_CMDLINE(intx, MaxTenuringThreshold, 0);
987    }
988  }
989}
990
991// Adjust some sizes to suit CMS and/or ParNew needs; these work well on
992// sparc/solaris for certain applications, but would gain from
993// further optimization and tuning efforts, and would almost
994// certainly gain from analysis of platform and environment.
995void Arguments::set_cms_and_parnew_gc_flags() {
996  assert(!UseSerialGC && !UseParallelGC, "Error");
997  assert(UseConcMarkSweepGC, "CMS is expected to be on here");
998
999  // If we are using CMS, we prefer to UseParNewGC,
1000  // unless explicitly forbidden.
1001  if (FLAG_IS_DEFAULT(UseParNewGC)) {
1002    FLAG_SET_ERGO(bool, UseParNewGC, true);
1003  }
1004
1005  // Turn off AdaptiveSizePolicy by default for cms until it is
1006  // complete.
1007  if (FLAG_IS_DEFAULT(UseAdaptiveSizePolicy)) {
1008    FLAG_SET_DEFAULT(UseAdaptiveSizePolicy, false);
1009  }
1010
1011  // In either case, adjust ParallelGCThreads and/or UseParNewGC
1012  // as needed.
1013  if (UseParNewGC) {
1014    set_parnew_gc_flags();
1015  }
1016
1017  // Now make adjustments for CMS
1018  size_t young_gen_per_worker;
1019  intx new_ratio;
1020  size_t min_new_default;
1021  intx tenuring_default;
1022  if (CMSUseOldDefaults) {  // old defaults: "old" as of 6.0
1023    if FLAG_IS_DEFAULT(CMSYoungGenPerWorker) {
1024      FLAG_SET_ERGO(intx, CMSYoungGenPerWorker, 4*M);
1025    }
1026    young_gen_per_worker = 4*M;
1027    new_ratio = (intx)15;
1028    min_new_default = 4*M;
1029    tenuring_default = (intx)0;
1030  } else { // new defaults: "new" as of 6.0
1031    young_gen_per_worker = CMSYoungGenPerWorker;
1032    new_ratio = (intx)7;
1033    min_new_default = 16*M;
1034    tenuring_default = (intx)4;
1035  }
1036
1037  // Preferred young gen size for "short" pauses
1038  const uintx parallel_gc_threads =
1039    (ParallelGCThreads == 0 ? 1 : ParallelGCThreads);
1040  const size_t preferred_max_new_size_unaligned =
1041    ScaleForWordSize(young_gen_per_worker * parallel_gc_threads);
1042  const size_t preferred_max_new_size =
1043    align_size_up(preferred_max_new_size_unaligned, os::vm_page_size());
1044
1045  // Unless explicitly requested otherwise, size young gen
1046  // for "short" pauses ~ 4M*ParallelGCThreads
1047  if (FLAG_IS_DEFAULT(MaxNewSize)) {  // MaxNewSize not set at command-line
1048    if (!FLAG_IS_DEFAULT(NewSize)) {   // NewSize explicitly set at command-line
1049      FLAG_SET_ERGO(uintx, MaxNewSize, MAX2(NewSize, preferred_max_new_size));
1050    } else {
1051      FLAG_SET_ERGO(uintx, MaxNewSize, preferred_max_new_size);
1052    }
1053    if(PrintGCDetails && Verbose) {
1054      // Too early to use gclog_or_tty
1055      tty->print_cr("Ergo set MaxNewSize: " SIZE_FORMAT, MaxNewSize);
1056  }
1057  }
1058  // Unless explicitly requested otherwise, prefer a large
1059  // Old to Young gen size so as to shift the collection load
1060  // to the old generation concurrent collector
1061  if (FLAG_IS_DEFAULT(NewRatio)) {
1062    FLAG_SET_ERGO(intx, NewRatio, MAX2(NewRatio, new_ratio));
1063
1064    size_t min_new  = align_size_up(ScaleForWordSize(min_new_default), os::vm_page_size());
1065    size_t prev_initial_size = initial_heap_size();
1066    if (prev_initial_size != 0 && prev_initial_size < min_new+OldSize) {
1067      set_initial_heap_size(min_new+OldSize);
1068      // Currently minimum size and the initial heap sizes are the same.
1069      set_min_heap_size(initial_heap_size());
1070      if (PrintGCDetails && Verbose) {
1071        warning("Initial heap size increased to " SIZE_FORMAT " M from "
1072                SIZE_FORMAT " M; use -XX:NewSize=... for finer control.",
1073                initial_heap_size()/M, prev_initial_size/M);
1074      }
1075    }
1076    // MaxHeapSize is aligned down in collectorPolicy
1077    size_t max_heap = align_size_down(MaxHeapSize,
1078                                      CardTableRS::ct_max_alignment_constraint());
1079
1080    if(PrintGCDetails && Verbose) {
1081      // Too early to use gclog_or_tty
1082      tty->print_cr("CMS set min_heap_size: " SIZE_FORMAT
1083           " initial_heap_size:  " SIZE_FORMAT
1084           " max_heap: " SIZE_FORMAT,
1085           min_heap_size(), initial_heap_size(), max_heap);
1086    }
1087    if (max_heap > min_new) {
1088      // Unless explicitly requested otherwise, make young gen
1089      // at least min_new, and at most preferred_max_new_size.
1090      if (FLAG_IS_DEFAULT(NewSize)) {
1091        FLAG_SET_ERGO(uintx, NewSize, MAX2(NewSize, min_new));
1092        FLAG_SET_ERGO(uintx, NewSize, MIN2(preferred_max_new_size, NewSize));
1093        if(PrintGCDetails && Verbose) {
1094          // Too early to use gclog_or_tty
1095          tty->print_cr("Ergo set NewSize: " SIZE_FORMAT, NewSize);
1096        }
1097      }
1098      // Unless explicitly requested otherwise, size old gen
1099      // so that it's at least 3X of NewSize to begin with;
1100      // later NewRatio will decide how it grows; see above.
1101      if (FLAG_IS_DEFAULT(OldSize)) {
1102        if (max_heap > NewSize) {
1103          FLAG_SET_ERGO(uintx, OldSize, MIN2(3*NewSize,  max_heap - NewSize));
1104          if(PrintGCDetails && Verbose) {
1105            // Too early to use gclog_or_tty
1106            tty->print_cr("Ergo set OldSize: " SIZE_FORMAT, OldSize);
1107          }
1108        }
1109      }
1110    }
1111  }
1112  // Unless explicitly requested otherwise, definitely
1113  // promote all objects surviving "tenuring_default" scavenges.
1114  if (FLAG_IS_DEFAULT(MaxTenuringThreshold) &&
1115      FLAG_IS_DEFAULT(SurvivorRatio)) {
1116    FLAG_SET_ERGO(intx, MaxTenuringThreshold, tenuring_default);
1117  }
1118  // If we decided above (or user explicitly requested)
1119  // `promote all' (via MaxTenuringThreshold := 0),
1120  // prefer minuscule survivor spaces so as not to waste
1121  // space for (non-existent) survivors
1122  if (FLAG_IS_DEFAULT(SurvivorRatio) && MaxTenuringThreshold == 0) {
1123    FLAG_SET_ERGO(intx, SurvivorRatio, MAX2((intx)1024, SurvivorRatio));
1124  }
1125  // If OldPLABSize is set and CMSParPromoteBlocksToClaim is not,
1126  // set CMSParPromoteBlocksToClaim equal to OldPLABSize.
1127  // This is done in order to make ParNew+CMS configuration to work
1128  // with YoungPLABSize and OldPLABSize options.
1129  // See CR 6362902.
1130  if (!FLAG_IS_DEFAULT(OldPLABSize)) {
1131    if (FLAG_IS_DEFAULT(CMSParPromoteBlocksToClaim)) {
1132      // OldPLABSize is not the default value but CMSParPromoteBlocksToClaim
1133      // is.  In this situtation let CMSParPromoteBlocksToClaim follow
1134      // the value (either from the command line or ergonomics) of
1135      // OldPLABSize.  Following OldPLABSize is an ergonomics decision.
1136      FLAG_SET_ERGO(uintx, CMSParPromoteBlocksToClaim, OldPLABSize);
1137    }
1138    else {
1139      // OldPLABSize and CMSParPromoteBlocksToClaim are both set.
1140      // CMSParPromoteBlocksToClaim is a collector-specific flag, so
1141      // we'll let it to take precedence.
1142      jio_fprintf(defaultStream::error_stream(),
1143                  "Both OldPLABSize and CMSParPromoteBlocksToClaim options are specified "
1144                  "for the CMS collector. CMSParPromoteBlocksToClaim will take precedence.\n");
1145    }
1146  }
1147}
1148
1149inline uintx max_heap_for_compressed_oops() {
1150  LP64_ONLY(return oopDesc::OopEncodingHeapMax - MaxPermSize - os::vm_page_size());
1151  NOT_LP64(return DefaultMaxRAM);
1152}
1153
1154bool Arguments::should_auto_select_low_pause_collector() {
1155  if (UseAutoGCSelectPolicy &&
1156      !FLAG_IS_DEFAULT(MaxGCPauseMillis) &&
1157      (MaxGCPauseMillis <= AutoGCSelectPauseMillis)) {
1158    if (PrintGCDetails) {
1159      // Cannot use gclog_or_tty yet.
1160      tty->print_cr("Automatic selection of the low pause collector"
1161       " based on pause goal of %d (ms)", MaxGCPauseMillis);
1162    }
1163    return true;
1164  }
1165  return false;
1166}
1167
1168void Arguments::set_ergonomics_flags() {
1169  // Parallel GC is not compatible with sharing. If one specifies
1170  // that they want sharing explicitly, do not set ergonmics flags.
1171  if (DumpSharedSpaces || ForceSharedSpaces) {
1172    return;
1173  }
1174
1175  if (os::is_server_class_machine() && !force_client_mode ) {
1176    // If no other collector is requested explicitly,
1177    // let the VM select the collector based on
1178    // machine class and automatic selection policy.
1179    if (!UseSerialGC &&
1180        !UseConcMarkSweepGC &&
1181        !UseG1GC &&
1182        !UseParNewGC &&
1183        !DumpSharedSpaces &&
1184        FLAG_IS_DEFAULT(UseParallelGC)) {
1185      if (should_auto_select_low_pause_collector()) {
1186        FLAG_SET_ERGO(bool, UseConcMarkSweepGC, true);
1187      } else {
1188        FLAG_SET_ERGO(bool, UseParallelGC, true);
1189      }
1190      no_shared_spaces();
1191    }
1192  }
1193
1194#ifdef _LP64
1195  // Compressed Headers do not work with CMS, which uses a bit in the klass
1196  // field offset to determine free list chunk markers.
1197  // Check that UseCompressedOops can be set with the max heap size allocated
1198  // by ergonomics.
1199  if (MaxHeapSize <= max_heap_for_compressed_oops()) {
1200    if (FLAG_IS_DEFAULT(UseCompressedOops) && !UseG1GC) {
1201      // Turn off until bug is fixed.
1202      // the following line to return it to default status.
1203      // FLAG_SET_ERGO(bool, UseCompressedOops, true);
1204    } else if (UseCompressedOops && UseG1GC) {
1205      warning(" UseCompressedOops does not currently work with UseG1GC; switching off UseCompressedOops. ");
1206      FLAG_SET_DEFAULT(UseCompressedOops, false);
1207    }
1208  } else {
1209    if (UseCompressedOops && !FLAG_IS_DEFAULT(UseCompressedOops)) {
1210      warning("Max heap size too large for Compressed Oops");
1211      FLAG_SET_DEFAULT(UseCompressedOops, false);
1212    }
1213  }
1214  // Also checks that certain machines are slower with compressed oops
1215  // in vm_version initialization code.
1216#endif // _LP64
1217}
1218
1219void Arguments::set_parallel_gc_flags() {
1220  assert(UseParallelGC || UseParallelOldGC, "Error");
1221  // If parallel old was requested, automatically enable parallel scavenge.
1222  if (UseParallelOldGC && !UseParallelGC && FLAG_IS_DEFAULT(UseParallelGC)) {
1223    FLAG_SET_DEFAULT(UseParallelGC, true);
1224  }
1225
1226  // If no heap maximum was requested explicitly, use some reasonable fraction
1227  // of the physical memory, up to a maximum of 1GB.
1228  if (UseParallelGC) {
1229    FLAG_SET_ERGO(uintx, ParallelGCThreads,
1230                  Abstract_VM_Version::parallel_worker_threads());
1231
1232    // PS is a server collector, setup the heap sizes accordingly.
1233    set_server_heap_size();
1234    // If InitialSurvivorRatio or MinSurvivorRatio were not specified, but the
1235    // SurvivorRatio has been set, reset their default values to SurvivorRatio +
1236    // 2.  By doing this we make SurvivorRatio also work for Parallel Scavenger.
1237    // See CR 6362902 for details.
1238    if (!FLAG_IS_DEFAULT(SurvivorRatio)) {
1239      if (FLAG_IS_DEFAULT(InitialSurvivorRatio)) {
1240         FLAG_SET_DEFAULT(InitialSurvivorRatio, SurvivorRatio + 2);
1241      }
1242      if (FLAG_IS_DEFAULT(MinSurvivorRatio)) {
1243        FLAG_SET_DEFAULT(MinSurvivorRatio, SurvivorRatio + 2);
1244      }
1245    }
1246
1247    if (UseParallelOldGC) {
1248      // Par compact uses lower default values since they are treated as
1249      // minimums.  These are different defaults because of the different
1250      // interpretation and are not ergonomically set.
1251      if (FLAG_IS_DEFAULT(MarkSweepDeadRatio)) {
1252        FLAG_SET_DEFAULT(MarkSweepDeadRatio, 1);
1253      }
1254      if (FLAG_IS_DEFAULT(PermMarkSweepDeadRatio)) {
1255        FLAG_SET_DEFAULT(PermMarkSweepDeadRatio, 5);
1256      }
1257    }
1258  }
1259}
1260
1261void Arguments::set_g1_gc_flags() {
1262  assert(UseG1GC, "Error");
1263  // G1 is a server collector, setup the heap sizes accordingly.
1264  set_server_heap_size();
1265#ifdef COMPILER1
1266  FastTLABRefill = false;
1267#endif
1268  FLAG_SET_DEFAULT(ParallelGCThreads,
1269                     Abstract_VM_Version::parallel_worker_threads());
1270  if (ParallelGCThreads == 0) {
1271    FLAG_SET_DEFAULT(ParallelGCThreads,
1272                     Abstract_VM_Version::parallel_worker_threads
1273());
1274  }
1275  no_shared_spaces();
1276}
1277
1278void Arguments::set_server_heap_size() {
1279  if (FLAG_IS_DEFAULT(MaxHeapSize)) {
1280    const uint64_t reasonable_fraction =
1281      os::physical_memory() / DefaultMaxRAMFraction;
1282    const uint64_t maximum_size = (uint64_t)
1283                 (FLAG_IS_DEFAULT(DefaultMaxRAM) && UseCompressedOops ?
1284                     MIN2(max_heap_for_compressed_oops(), DefaultMaxRAM) :
1285                     DefaultMaxRAM);
1286    size_t reasonable_max =
1287      (size_t) os::allocatable_physical_memory(reasonable_fraction);
1288    if (reasonable_max > maximum_size) {
1289      reasonable_max = maximum_size;
1290    }
1291    if (PrintGCDetails && Verbose) {
1292      // Cannot use gclog_or_tty yet.
1293      tty->print_cr("  Max heap size for server class platform "
1294                    SIZE_FORMAT, reasonable_max);
1295    }
1296    // If the initial_heap_size has not been set with -Xms,
1297    // then set it as fraction of size of physical memory
1298    // respecting the maximum and minimum sizes of the heap.
1299    if (initial_heap_size() == 0) {
1300      const uint64_t reasonable_initial_fraction =
1301        os::physical_memory() / DefaultInitialRAMFraction;
1302      const size_t reasonable_initial =
1303        (size_t) os::allocatable_physical_memory(reasonable_initial_fraction);
1304      const size_t minimum_size = NewSize + OldSize;
1305      set_initial_heap_size(MAX2(MIN2(reasonable_initial, reasonable_max),
1306                                minimum_size));
1307      // Currently the minimum size and the initial heap sizes are the same.
1308      set_min_heap_size(initial_heap_size());
1309      if (PrintGCDetails && Verbose) {
1310        // Cannot use gclog_or_tty yet.
1311        tty->print_cr("  Initial heap size for server class platform "
1312                      SIZE_FORMAT, initial_heap_size());
1313      }
1314    } else {
1315      // A minimum size was specified on the command line.  Be sure
1316      // that the maximum size is consistent.
1317      if (initial_heap_size() > reasonable_max) {
1318        reasonable_max = initial_heap_size();
1319      }
1320    }
1321    FLAG_SET_ERGO(uintx, MaxHeapSize, (uintx) reasonable_max);
1322  }
1323}
1324
1325// This must be called after ergonomics because we want bytecode rewriting
1326// if the server compiler is used, or if UseSharedSpaces is disabled.
1327void Arguments::set_bytecode_flags() {
1328  // Better not attempt to store into a read-only space.
1329  if (UseSharedSpaces) {
1330    FLAG_SET_DEFAULT(RewriteBytecodes, false);
1331    FLAG_SET_DEFAULT(RewriteFrequentPairs, false);
1332  }
1333
1334  if (!RewriteBytecodes) {
1335    FLAG_SET_DEFAULT(RewriteFrequentPairs, false);
1336  }
1337}
1338
1339// Aggressive optimization flags  -XX:+AggressiveOpts
1340void Arguments::set_aggressive_opts_flags() {
1341#ifdef COMPILER2
1342  if (AggressiveOpts || !FLAG_IS_DEFAULT(AutoBoxCacheMax)) {
1343    if (FLAG_IS_DEFAULT(EliminateAutoBox)) {
1344      FLAG_SET_DEFAULT(EliminateAutoBox, true);
1345    }
1346    if (FLAG_IS_DEFAULT(AutoBoxCacheMax)) {
1347      FLAG_SET_DEFAULT(AutoBoxCacheMax, 20000);
1348    }
1349
1350    // Feed the cache size setting into the JDK
1351    char buffer[1024];
1352    sprintf(buffer, "java.lang.Integer.IntegerCache.high=%d", AutoBoxCacheMax);
1353    add_property(buffer);
1354  }
1355  if (AggressiveOpts && FLAG_IS_DEFAULT(DoEscapeAnalysis)) {
1356    FLAG_SET_DEFAULT(DoEscapeAnalysis, true);
1357  }
1358  if (AggressiveOpts && FLAG_IS_DEFAULT(SpecialArraysEquals)) {
1359    FLAG_SET_DEFAULT(SpecialArraysEquals, true);
1360  }
1361#endif
1362
1363  if (AggressiveOpts) {
1364// Sample flag setting code
1365//    if (FLAG_IS_DEFAULT(EliminateZeroing)) {
1366//      FLAG_SET_DEFAULT(EliminateZeroing, true);
1367//    }
1368  }
1369}
1370
1371//===========================================================================================================
1372// Parsing of java.compiler property
1373
1374void Arguments::process_java_compiler_argument(char* arg) {
1375  // For backwards compatibility, Djava.compiler=NONE or ""
1376  // causes us to switch to -Xint mode UNLESS -Xdebug
1377  // is also specified.
1378  if (strlen(arg) == 0 || strcasecmp(arg, "NONE") == 0) {
1379    set_java_compiler(true);    // "-Djava.compiler[=...]" most recently seen.
1380  }
1381}
1382
1383void Arguments::process_java_launcher_argument(const char* launcher, void* extra_info) {
1384  _sun_java_launcher = strdup(launcher);
1385}
1386
1387bool Arguments::created_by_java_launcher() {
1388  assert(_sun_java_launcher != NULL, "property must have value");
1389  return strcmp(DEFAULT_JAVA_LAUNCHER, _sun_java_launcher) != 0;
1390}
1391
1392//===========================================================================================================
1393// Parsing of main arguments
1394
1395bool Arguments::verify_percentage(uintx value, const char* name) {
1396  if (value <= 100) {
1397    return true;
1398  }
1399  jio_fprintf(defaultStream::error_stream(),
1400              "%s of " UINTX_FORMAT " is invalid; must be between 0 and 100\n",
1401              name, value);
1402  return false;
1403}
1404
1405static void set_serial_gc_flags() {
1406  FLAG_SET_DEFAULT(UseSerialGC, true);
1407  FLAG_SET_DEFAULT(UseParNewGC, false);
1408  FLAG_SET_DEFAULT(UseConcMarkSweepGC, false);
1409  FLAG_SET_DEFAULT(UseParallelGC, false);
1410  FLAG_SET_DEFAULT(UseParallelOldGC, false);
1411  FLAG_SET_DEFAULT(UseG1GC, false);
1412}
1413
1414static bool verify_serial_gc_flags() {
1415  return (UseSerialGC &&
1416        !(UseParNewGC || UseConcMarkSweepGC || UseG1GC ||
1417          UseParallelGC || UseParallelOldGC));
1418}
1419
1420// Check consistency of GC selection
1421bool Arguments::check_gc_consistency() {
1422  bool status = true;
1423  // Ensure that the user has not selected conflicting sets
1424  // of collectors. [Note: this check is merely a user convenience;
1425  // collectors over-ride each other so that only a non-conflicting
1426  // set is selected; however what the user gets is not what they
1427  // may have expected from the combination they asked for. It's
1428  // better to reduce user confusion by not allowing them to
1429  // select conflicting combinations.
1430  uint i = 0;
1431  if (UseSerialGC)                       i++;
1432  if (UseConcMarkSweepGC || UseParNewGC) i++;
1433  if (UseParallelGC || UseParallelOldGC) i++;
1434  if (i > 1) {
1435    jio_fprintf(defaultStream::error_stream(),
1436                "Conflicting collector combinations in option list; "
1437                "please refer to the release notes for the combinations "
1438                "allowed\n");
1439    status = false;
1440  }
1441
1442  return status;
1443}
1444
1445// Check the consistency of vm_init_args
1446bool Arguments::check_vm_args_consistency() {
1447  // Method for adding checks for flag consistency.
1448  // The intent is to warn the user of all possible conflicts,
1449  // before returning an error.
1450  // Note: Needs platform-dependent factoring.
1451  bool status = true;
1452
1453#if ( (defined(COMPILER2) && defined(SPARC)))
1454  // NOTE: The call to VM_Version_init depends on the fact that VM_Version_init
1455  // on sparc doesn't require generation of a stub as is the case on, e.g.,
1456  // x86.  Normally, VM_Version_init must be called from init_globals in
1457  // init.cpp, which is called by the initial java thread *after* arguments
1458  // have been parsed.  VM_Version_init gets called twice on sparc.
1459  extern void VM_Version_init();
1460  VM_Version_init();
1461  if (!VM_Version::has_v9()) {
1462    jio_fprintf(defaultStream::error_stream(),
1463                "V8 Machine detected, Server requires V9\n");
1464    status = false;
1465  }
1466#endif /* COMPILER2 && SPARC */
1467
1468  // Allow both -XX:-UseStackBanging and -XX:-UseBoundThreads in non-product
1469  // builds so the cost of stack banging can be measured.
1470#if (defined(PRODUCT) && defined(SOLARIS))
1471  if (!UseBoundThreads && !UseStackBanging) {
1472    jio_fprintf(defaultStream::error_stream(),
1473                "-UseStackBanging conflicts with -UseBoundThreads\n");
1474
1475     status = false;
1476  }
1477#endif
1478
1479  if (TLABRefillWasteFraction == 0) {
1480    jio_fprintf(defaultStream::error_stream(),
1481                "TLABRefillWasteFraction should be a denominator, "
1482                "not " SIZE_FORMAT "\n",
1483                TLABRefillWasteFraction);
1484    status = false;
1485  }
1486
1487  status = status && verify_percentage(MaxLiveObjectEvacuationRatio,
1488                              "MaxLiveObjectEvacuationRatio");
1489  status = status && verify_percentage(AdaptiveSizePolicyWeight,
1490                              "AdaptiveSizePolicyWeight");
1491  status = status && verify_percentage(AdaptivePermSizeWeight, "AdaptivePermSizeWeight");
1492  status = status && verify_percentage(ThresholdTolerance, "ThresholdTolerance");
1493  status = status && verify_percentage(MinHeapFreeRatio, "MinHeapFreeRatio");
1494  status = status && verify_percentage(MaxHeapFreeRatio, "MaxHeapFreeRatio");
1495
1496  if (MinHeapFreeRatio > MaxHeapFreeRatio) {
1497    jio_fprintf(defaultStream::error_stream(),
1498                "MinHeapFreeRatio (" UINTX_FORMAT ") must be less than or "
1499                "equal to MaxHeapFreeRatio (" UINTX_FORMAT ")\n",
1500                MinHeapFreeRatio, MaxHeapFreeRatio);
1501    status = false;
1502  }
1503  // Keeping the heap 100% free is hard ;-) so limit it to 99%.
1504  MinHeapFreeRatio = MIN2(MinHeapFreeRatio, (uintx) 99);
1505
1506  if (FullGCALot && FLAG_IS_DEFAULT(MarkSweepAlwaysCompactCount)) {
1507    MarkSweepAlwaysCompactCount = 1;  // Move objects every gc.
1508  }
1509
1510  status = status && verify_percentage(GCHeapFreeLimit, "GCHeapFreeLimit");
1511  status = status && verify_percentage(GCTimeLimit, "GCTimeLimit");
1512  if (GCTimeLimit == 100) {
1513    // Turn off gc-overhead-limit-exceeded checks
1514    FLAG_SET_DEFAULT(UseGCOverheadLimit, false);
1515  }
1516
1517  status = status && verify_percentage(GCHeapFreeLimit, "GCHeapFreeLimit");
1518
1519  // Check user specified sharing option conflict with Parallel GC
1520  bool cannot_share = (UseConcMarkSweepGC || UseG1GC || UseParNewGC ||
1521                       UseParallelGC || UseParallelOldGC ||
1522                       SOLARIS_ONLY(UseISM) NOT_SOLARIS(UseLargePages));
1523
1524  if (cannot_share) {
1525    // Either force sharing on by forcing the other options off, or
1526    // force sharing off.
1527    if (DumpSharedSpaces || ForceSharedSpaces) {
1528      set_serial_gc_flags();
1529      FLAG_SET_DEFAULT(SOLARIS_ONLY(UseISM) NOT_SOLARIS(UseLargePages), false);
1530    } else {
1531      no_shared_spaces();
1532    }
1533  }
1534
1535  status = status && check_gc_consistency();
1536
1537  if (_has_alloc_profile) {
1538    if (UseParallelGC || UseParallelOldGC) {
1539      jio_fprintf(defaultStream::error_stream(),
1540                  "error:  invalid argument combination.\n"
1541                  "Allocation profiling (-Xaprof) cannot be used together with "
1542                  "Parallel GC (-XX:+UseParallelGC or -XX:+UseParallelOldGC).\n");
1543      status = false;
1544    }
1545    if (UseConcMarkSweepGC) {
1546      jio_fprintf(defaultStream::error_stream(),
1547                  "error:  invalid argument combination.\n"
1548                  "Allocation profiling (-Xaprof) cannot be used together with "
1549                  "the CMS collector (-XX:+UseConcMarkSweepGC).\n");
1550      status = false;
1551    }
1552  }
1553
1554  if (CMSIncrementalMode) {
1555    if (!UseConcMarkSweepGC) {
1556      jio_fprintf(defaultStream::error_stream(),
1557                  "error:  invalid argument combination.\n"
1558                  "The CMS collector (-XX:+UseConcMarkSweepGC) must be "
1559                  "selected in order\nto use CMSIncrementalMode.\n");
1560      status = false;
1561    } else {
1562      status = status && verify_percentage(CMSIncrementalDutyCycle,
1563                                  "CMSIncrementalDutyCycle");
1564      status = status && verify_percentage(CMSIncrementalDutyCycleMin,
1565                                  "CMSIncrementalDutyCycleMin");
1566      status = status && verify_percentage(CMSIncrementalSafetyFactor,
1567                                  "CMSIncrementalSafetyFactor");
1568      status = status && verify_percentage(CMSIncrementalOffset,
1569                                  "CMSIncrementalOffset");
1570      status = status && verify_percentage(CMSExpAvgFactor,
1571                                  "CMSExpAvgFactor");
1572      // If it was not set on the command line, set
1573      // CMSInitiatingOccupancyFraction to 1 so icms can initiate cycles early.
1574      if (CMSInitiatingOccupancyFraction < 0) {
1575        FLAG_SET_DEFAULT(CMSInitiatingOccupancyFraction, 1);
1576      }
1577    }
1578  }
1579
1580  // CMS space iteration, which FLSVerifyAllHeapreferences entails,
1581  // insists that we hold the requisite locks so that the iteration is
1582  // MT-safe. For the verification at start-up and shut-down, we don't
1583  // yet have a good way of acquiring and releasing these locks,
1584  // which are not visible at the CollectedHeap level. We want to
1585  // be able to acquire these locks and then do the iteration rather
1586  // than just disable the lock verification. This will be fixed under
1587  // bug 4788986.
1588  if (UseConcMarkSweepGC && FLSVerifyAllHeapReferences) {
1589    if (VerifyGCStartAt == 0) {
1590      warning("Heap verification at start-up disabled "
1591              "(due to current incompatibility with FLSVerifyAllHeapReferences)");
1592      VerifyGCStartAt = 1;      // Disable verification at start-up
1593    }
1594    if (VerifyBeforeExit) {
1595      warning("Heap verification at shutdown disabled "
1596              "(due to current incompatibility with FLSVerifyAllHeapReferences)");
1597      VerifyBeforeExit = false; // Disable verification at shutdown
1598    }
1599  }
1600
1601  // Note: only executed in non-PRODUCT mode
1602  if (!UseAsyncConcMarkSweepGC &&
1603      (ExplicitGCInvokesConcurrent ||
1604       ExplicitGCInvokesConcurrentAndUnloadsClasses)) {
1605    jio_fprintf(defaultStream::error_stream(),
1606                "error: +ExplictGCInvokesConcurrent[AndUnloadsClasses] conflicts"
1607                " with -UseAsyncConcMarkSweepGC");
1608    status = false;
1609  }
1610
1611  return status;
1612}
1613
1614bool Arguments::is_bad_option(const JavaVMOption* option, jboolean ignore,
1615  const char* option_type) {
1616  if (ignore) return false;
1617
1618  const char* spacer = " ";
1619  if (option_type == NULL) {
1620    option_type = ++spacer; // Set both to the empty string.
1621  }
1622
1623  if (os::obsolete_option(option)) {
1624    jio_fprintf(defaultStream::error_stream(),
1625                "Obsolete %s%soption: %s\n", option_type, spacer,
1626      option->optionString);
1627    return false;
1628  } else {
1629    jio_fprintf(defaultStream::error_stream(),
1630                "Unrecognized %s%soption: %s\n", option_type, spacer,
1631      option->optionString);
1632    return true;
1633  }
1634}
1635
1636static const char* user_assertion_options[] = {
1637  "-da", "-ea", "-disableassertions", "-enableassertions", 0
1638};
1639
1640static const char* system_assertion_options[] = {
1641  "-dsa", "-esa", "-disablesystemassertions", "-enablesystemassertions", 0
1642};
1643
1644// Return true if any of the strings in null-terminated array 'names' matches.
1645// If tail_allowed is true, then the tail must begin with a colon; otherwise,
1646// the option must match exactly.
1647static bool match_option(const JavaVMOption* option, const char** names, const char** tail,
1648  bool tail_allowed) {
1649  for (/* empty */; *names != NULL; ++names) {
1650    if (match_option(option, *names, tail)) {
1651      if (**tail == '\0' || tail_allowed && **tail == ':') {
1652        return true;
1653      }
1654    }
1655  }
1656  return false;
1657}
1658
1659Arguments::ArgsRange Arguments::parse_memory_size(const char* s,
1660                                                  jlong* long_arg,
1661                                                  jlong min_size) {
1662  if (!atomll(s, long_arg)) return arg_unreadable;
1663  return check_memory_size(*long_arg, min_size);
1664}
1665
1666// Parse JavaVMInitArgs structure
1667
1668jint Arguments::parse_vm_init_args(const JavaVMInitArgs* args) {
1669  // For components of the system classpath.
1670  SysClassPath scp(Arguments::get_sysclasspath());
1671  bool scp_assembly_required = false;
1672
1673  // Save default settings for some mode flags
1674  Arguments::_AlwaysCompileLoopMethods = AlwaysCompileLoopMethods;
1675  Arguments::_UseOnStackReplacement    = UseOnStackReplacement;
1676  Arguments::_ClipInlining             = ClipInlining;
1677  Arguments::_BackgroundCompilation    = BackgroundCompilation;
1678  Arguments::_Tier2CompileThreshold    = Tier2CompileThreshold;
1679
1680  // Parse JAVA_TOOL_OPTIONS environment variable (if present)
1681  jint result = parse_java_tool_options_environment_variable(&scp, &scp_assembly_required);
1682  if (result != JNI_OK) {
1683    return result;
1684  }
1685
1686  // Parse JavaVMInitArgs structure passed in
1687  result = parse_each_vm_init_arg(args, &scp, &scp_assembly_required, COMMAND_LINE);
1688  if (result != JNI_OK) {
1689    return result;
1690  }
1691
1692  // Parse _JAVA_OPTIONS environment variable (if present) (mimics classic VM)
1693  result = parse_java_options_environment_variable(&scp, &scp_assembly_required);
1694  if (result != JNI_OK) {
1695    return result;
1696  }
1697
1698  // Do final processing now that all arguments have been parsed
1699  result = finalize_vm_init_args(&scp, scp_assembly_required);
1700  if (result != JNI_OK) {
1701    return result;
1702  }
1703
1704  return JNI_OK;
1705}
1706
1707
1708jint Arguments::parse_each_vm_init_arg(const JavaVMInitArgs* args,
1709                                       SysClassPath* scp_p,
1710                                       bool* scp_assembly_required_p,
1711                                       FlagValueOrigin origin) {
1712  // Remaining part of option string
1713  const char* tail;
1714
1715  // iterate over arguments
1716  for (int index = 0; index < args->nOptions; index++) {
1717    bool is_absolute_path = false;  // for -agentpath vs -agentlib
1718
1719    const JavaVMOption* option = args->options + index;
1720
1721    if (!match_option(option, "-Djava.class.path", &tail) &&
1722        !match_option(option, "-Dsun.java.command", &tail) &&
1723        !match_option(option, "-Dsun.java.launcher", &tail)) {
1724
1725        // add all jvm options to the jvm_args string. This string
1726        // is used later to set the java.vm.args PerfData string constant.
1727        // the -Djava.class.path and the -Dsun.java.command options are
1728        // omitted from jvm_args string as each have their own PerfData
1729        // string constant object.
1730        build_jvm_args(option->optionString);
1731    }
1732
1733    // -verbose:[class/gc/jni]
1734    if (match_option(option, "-verbose", &tail)) {
1735      if (!strcmp(tail, ":class") || !strcmp(tail, "")) {
1736        FLAG_SET_CMDLINE(bool, TraceClassLoading, true);
1737        FLAG_SET_CMDLINE(bool, TraceClassUnloading, true);
1738      } else if (!strcmp(tail, ":gc")) {
1739        FLAG_SET_CMDLINE(bool, PrintGC, true);
1740        FLAG_SET_CMDLINE(bool, TraceClassUnloading, true);
1741      } else if (!strcmp(tail, ":jni")) {
1742        FLAG_SET_CMDLINE(bool, PrintJNIResolving, true);
1743      }
1744    // -da / -ea / -disableassertions / -enableassertions
1745    // These accept an optional class/package name separated by a colon, e.g.,
1746    // -da:java.lang.Thread.
1747    } else if (match_option(option, user_assertion_options, &tail, true)) {
1748      bool enable = option->optionString[1] == 'e';     // char after '-' is 'e'
1749      if (*tail == '\0') {
1750        JavaAssertions::setUserClassDefault(enable);
1751      } else {
1752        assert(*tail == ':', "bogus match by match_option()");
1753        JavaAssertions::addOption(tail + 1, enable);
1754      }
1755    // -dsa / -esa / -disablesystemassertions / -enablesystemassertions
1756    } else if (match_option(option, system_assertion_options, &tail, false)) {
1757      bool enable = option->optionString[1] == 'e';     // char after '-' is 'e'
1758      JavaAssertions::setSystemClassDefault(enable);
1759    // -bootclasspath:
1760    } else if (match_option(option, "-Xbootclasspath:", &tail)) {
1761      scp_p->reset_path(tail);
1762      *scp_assembly_required_p = true;
1763    // -bootclasspath/a:
1764    } else if (match_option(option, "-Xbootclasspath/a:", &tail)) {
1765      scp_p->add_suffix(tail);
1766      *scp_assembly_required_p = true;
1767    // -bootclasspath/p:
1768    } else if (match_option(option, "-Xbootclasspath/p:", &tail)) {
1769      scp_p->add_prefix(tail);
1770      *scp_assembly_required_p = true;
1771    // -Xrun
1772    } else if (match_option(option, "-Xrun", &tail)) {
1773      if(tail != NULL) {
1774        const char* pos = strchr(tail, ':');
1775        size_t len = (pos == NULL) ? strlen(tail) : pos - tail;
1776        char* name = (char*)memcpy(NEW_C_HEAP_ARRAY(char, len + 1), tail, len);
1777        name[len] = '\0';
1778
1779        char *options = NULL;
1780        if(pos != NULL) {
1781          size_t len2 = strlen(pos+1) + 1; // options start after ':'.  Final zero must be copied.
1782          options = (char*)memcpy(NEW_C_HEAP_ARRAY(char, len2), pos+1, len2);
1783        }
1784#ifdef JVMTI_KERNEL
1785        if ((strcmp(name, "hprof") == 0) || (strcmp(name, "jdwp") == 0)) {
1786          warning("profiling and debugging agents are not supported with Kernel VM");
1787        } else
1788#endif // JVMTI_KERNEL
1789        add_init_library(name, options);
1790      }
1791    // -agentlib and -agentpath
1792    } else if (match_option(option, "-agentlib:", &tail) ||
1793          (is_absolute_path = match_option(option, "-agentpath:", &tail))) {
1794      if(tail != NULL) {
1795        const char* pos = strchr(tail, '=');
1796        size_t len = (pos == NULL) ? strlen(tail) : pos - tail;
1797        char* name = strncpy(NEW_C_HEAP_ARRAY(char, len + 1), tail, len);
1798        name[len] = '\0';
1799
1800        char *options = NULL;
1801        if(pos != NULL) {
1802          options = strcpy(NEW_C_HEAP_ARRAY(char, strlen(pos + 1) + 1), pos + 1);
1803        }
1804#ifdef JVMTI_KERNEL
1805        if ((strcmp(name, "hprof") == 0) || (strcmp(name, "jdwp") == 0)) {
1806          warning("profiling and debugging agents are not supported with Kernel VM");
1807        } else
1808#endif // JVMTI_KERNEL
1809        add_init_agent(name, options, is_absolute_path);
1810
1811      }
1812    // -javaagent
1813    } else if (match_option(option, "-javaagent:", &tail)) {
1814      if(tail != NULL) {
1815        char *options = strcpy(NEW_C_HEAP_ARRAY(char, strlen(tail) + 1), tail);
1816        add_init_agent("instrument", options, false);
1817      }
1818    // -Xnoclassgc
1819    } else if (match_option(option, "-Xnoclassgc", &tail)) {
1820      FLAG_SET_CMDLINE(bool, ClassUnloading, false);
1821    // -Xincgc: i-CMS
1822    } else if (match_option(option, "-Xincgc", &tail)) {
1823      FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, true);
1824      FLAG_SET_CMDLINE(bool, CMSIncrementalMode, true);
1825    // -Xnoincgc: no i-CMS
1826    } else if (match_option(option, "-Xnoincgc", &tail)) {
1827      FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, false);
1828      FLAG_SET_CMDLINE(bool, CMSIncrementalMode, false);
1829    // -Xconcgc
1830    } else if (match_option(option, "-Xconcgc", &tail)) {
1831      FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, true);
1832    // -Xnoconcgc
1833    } else if (match_option(option, "-Xnoconcgc", &tail)) {
1834      FLAG_SET_CMDLINE(bool, UseConcMarkSweepGC, false);
1835    // -Xbatch
1836    } else if (match_option(option, "-Xbatch", &tail)) {
1837      FLAG_SET_CMDLINE(bool, BackgroundCompilation, false);
1838    // -Xmn for compatibility with other JVM vendors
1839    } else if (match_option(option, "-Xmn", &tail)) {
1840      jlong long_initial_eden_size = 0;
1841      ArgsRange errcode = parse_memory_size(tail, &long_initial_eden_size, 1);
1842      if (errcode != arg_in_range) {
1843        jio_fprintf(defaultStream::error_stream(),
1844                    "Invalid initial eden size: %s\n", option->optionString);
1845        describe_range_error(errcode);
1846        return JNI_EINVAL;
1847      }
1848      FLAG_SET_CMDLINE(uintx, MaxNewSize, (size_t) long_initial_eden_size);
1849      FLAG_SET_CMDLINE(uintx, NewSize, (size_t) long_initial_eden_size);
1850    // -Xms
1851    } else if (match_option(option, "-Xms", &tail)) {
1852      jlong long_initial_heap_size = 0;
1853      ArgsRange errcode = parse_memory_size(tail, &long_initial_heap_size, 1);
1854      if (errcode != arg_in_range) {
1855        jio_fprintf(defaultStream::error_stream(),
1856                    "Invalid initial heap size: %s\n", option->optionString);
1857        describe_range_error(errcode);
1858        return JNI_EINVAL;
1859      }
1860      set_initial_heap_size((size_t) long_initial_heap_size);
1861      // Currently the minimum size and the initial heap sizes are the same.
1862      set_min_heap_size(initial_heap_size());
1863    // -Xmx
1864    } else if (match_option(option, "-Xmx", &tail)) {
1865      jlong long_max_heap_size = 0;
1866      ArgsRange errcode = parse_memory_size(tail, &long_max_heap_size, 1);
1867      if (errcode != arg_in_range) {
1868        jio_fprintf(defaultStream::error_stream(),
1869                    "Invalid maximum heap size: %s\n", option->optionString);
1870        describe_range_error(errcode);
1871        return JNI_EINVAL;
1872      }
1873      FLAG_SET_CMDLINE(uintx, MaxHeapSize, (size_t) long_max_heap_size);
1874    // Xmaxf
1875    } else if (match_option(option, "-Xmaxf", &tail)) {
1876      int maxf = (int)(atof(tail) * 100);
1877      if (maxf < 0 || maxf > 100) {
1878        jio_fprintf(defaultStream::error_stream(),
1879                    "Bad max heap free percentage size: %s\n",
1880                    option->optionString);
1881        return JNI_EINVAL;
1882      } else {
1883        FLAG_SET_CMDLINE(uintx, MaxHeapFreeRatio, maxf);
1884      }
1885    // Xminf
1886    } else if (match_option(option, "-Xminf", &tail)) {
1887      int minf = (int)(atof(tail) * 100);
1888      if (minf < 0 || minf > 100) {
1889        jio_fprintf(defaultStream::error_stream(),
1890                    "Bad min heap free percentage size: %s\n",
1891                    option->optionString);
1892        return JNI_EINVAL;
1893      } else {
1894        FLAG_SET_CMDLINE(uintx, MinHeapFreeRatio, minf);
1895      }
1896    // -Xss
1897    } else if (match_option(option, "-Xss", &tail)) {
1898      jlong long_ThreadStackSize = 0;
1899      ArgsRange errcode = parse_memory_size(tail, &long_ThreadStackSize, 1000);
1900      if (errcode != arg_in_range) {
1901        jio_fprintf(defaultStream::error_stream(),
1902                    "Invalid thread stack size: %s\n", option->optionString);
1903        describe_range_error(errcode);
1904        return JNI_EINVAL;
1905      }
1906      // Internally track ThreadStackSize in units of 1024 bytes.
1907      FLAG_SET_CMDLINE(intx, ThreadStackSize,
1908                              round_to((int)long_ThreadStackSize, K) / K);
1909    // -Xoss
1910    } else if (match_option(option, "-Xoss", &tail)) {
1911          // HotSpot does not have separate native and Java stacks, ignore silently for compatibility
1912    // -Xmaxjitcodesize
1913    } else if (match_option(option, "-Xmaxjitcodesize", &tail)) {
1914      jlong long_ReservedCodeCacheSize = 0;
1915      ArgsRange errcode = parse_memory_size(tail, &long_ReservedCodeCacheSize,
1916                                            InitialCodeCacheSize);
1917      if (errcode != arg_in_range) {
1918        jio_fprintf(defaultStream::error_stream(),
1919                    "Invalid maximum code cache size: %s\n",
1920                    option->optionString);
1921        describe_range_error(errcode);
1922        return JNI_EINVAL;
1923      }
1924      FLAG_SET_CMDLINE(uintx, ReservedCodeCacheSize, (uintx)long_ReservedCodeCacheSize);
1925    // -green
1926    } else if (match_option(option, "-green", &tail)) {
1927      jio_fprintf(defaultStream::error_stream(),
1928                  "Green threads support not available\n");
1929          return JNI_EINVAL;
1930    // -native
1931    } else if (match_option(option, "-native", &tail)) {
1932          // HotSpot always uses native threads, ignore silently for compatibility
1933    // -Xsqnopause
1934    } else if (match_option(option, "-Xsqnopause", &tail)) {
1935          // EVM option, ignore silently for compatibility
1936    // -Xrs
1937    } else if (match_option(option, "-Xrs", &tail)) {
1938          // Classic/EVM option, new functionality
1939      FLAG_SET_CMDLINE(bool, ReduceSignalUsage, true);
1940    } else if (match_option(option, "-Xusealtsigs", &tail)) {
1941          // change default internal VM signals used - lower case for back compat
1942      FLAG_SET_CMDLINE(bool, UseAltSigs, true);
1943    // -Xoptimize
1944    } else if (match_option(option, "-Xoptimize", &tail)) {
1945          // EVM option, ignore silently for compatibility
1946    // -Xprof
1947    } else if (match_option(option, "-Xprof", &tail)) {
1948#ifndef FPROF_KERNEL
1949      _has_profile = true;
1950#else // FPROF_KERNEL
1951      // do we have to exit?
1952      warning("Kernel VM does not support flat profiling.");
1953#endif // FPROF_KERNEL
1954    // -Xaprof
1955    } else if (match_option(option, "-Xaprof", &tail)) {
1956      _has_alloc_profile = true;
1957    // -Xconcurrentio
1958    } else if (match_option(option, "-Xconcurrentio", &tail)) {
1959      FLAG_SET_CMDLINE(bool, UseLWPSynchronization, true);
1960      FLAG_SET_CMDLINE(bool, BackgroundCompilation, false);
1961      FLAG_SET_CMDLINE(intx, DeferThrSuspendLoopCount, 1);
1962      FLAG_SET_CMDLINE(bool, UseTLAB, false);
1963      FLAG_SET_CMDLINE(uintx, NewSizeThreadIncrease, 16 * K);  // 20Kb per thread added to new generation
1964
1965      // -Xinternalversion
1966    } else if (match_option(option, "-Xinternalversion", &tail)) {
1967      jio_fprintf(defaultStream::output_stream(), "%s\n",
1968                  VM_Version::internal_vm_info_string());
1969      vm_exit(0);
1970#ifndef PRODUCT
1971    // -Xprintflags
1972    } else if (match_option(option, "-Xprintflags", &tail)) {
1973      CommandLineFlags::printFlags();
1974      vm_exit(0);
1975#endif
1976    // -D
1977    } else if (match_option(option, "-D", &tail)) {
1978      if (!add_property(tail)) {
1979        return JNI_ENOMEM;
1980      }
1981      // Out of the box management support
1982      if (match_option(option, "-Dcom.sun.management", &tail)) {
1983        FLAG_SET_CMDLINE(bool, ManagementServer, true);
1984      }
1985    // -Xint
1986    } else if (match_option(option, "-Xint", &tail)) {
1987          set_mode_flags(_int);
1988    // -Xmixed
1989    } else if (match_option(option, "-Xmixed", &tail)) {
1990          set_mode_flags(_mixed);
1991    // -Xcomp
1992    } else if (match_option(option, "-Xcomp", &tail)) {
1993      // for testing the compiler; turn off all flags that inhibit compilation
1994          set_mode_flags(_comp);
1995
1996    // -Xshare:dump
1997    } else if (match_option(option, "-Xshare:dump", &tail)) {
1998#ifdef TIERED
1999      FLAG_SET_CMDLINE(bool, DumpSharedSpaces, true);
2000      set_mode_flags(_int);     // Prevent compilation, which creates objects
2001#elif defined(COMPILER2)
2002      vm_exit_during_initialization(
2003          "Dumping a shared archive is not supported on the Server JVM.", NULL);
2004#elif defined(KERNEL)
2005      vm_exit_during_initialization(
2006          "Dumping a shared archive is not supported on the Kernel JVM.", NULL);
2007#else
2008      FLAG_SET_CMDLINE(bool, DumpSharedSpaces, true);
2009      set_mode_flags(_int);     // Prevent compilation, which creates objects
2010#endif
2011    // -Xshare:on
2012    } else if (match_option(option, "-Xshare:on", &tail)) {
2013      FLAG_SET_CMDLINE(bool, UseSharedSpaces, true);
2014      FLAG_SET_CMDLINE(bool, RequireSharedSpaces, true);
2015#ifdef TIERED
2016      FLAG_SET_CMDLINE(bool, ForceSharedSpaces, true);
2017#endif // TIERED
2018    // -Xshare:auto
2019    } else if (match_option(option, "-Xshare:auto", &tail)) {
2020      FLAG_SET_CMDLINE(bool, UseSharedSpaces, true);
2021      FLAG_SET_CMDLINE(bool, RequireSharedSpaces, false);
2022    // -Xshare:off
2023    } else if (match_option(option, "-Xshare:off", &tail)) {
2024      FLAG_SET_CMDLINE(bool, UseSharedSpaces, false);
2025      FLAG_SET_CMDLINE(bool, RequireSharedSpaces, false);
2026
2027    // -Xverify
2028    } else if (match_option(option, "-Xverify", &tail)) {
2029      if (strcmp(tail, ":all") == 0 || strcmp(tail, "") == 0) {
2030        FLAG_SET_CMDLINE(bool, BytecodeVerificationLocal, true);
2031        FLAG_SET_CMDLINE(bool, BytecodeVerificationRemote, true);
2032      } else if (strcmp(tail, ":remote") == 0) {
2033        FLAG_SET_CMDLINE(bool, BytecodeVerificationLocal, false);
2034        FLAG_SET_CMDLINE(bool, BytecodeVerificationRemote, true);
2035      } else if (strcmp(tail, ":none") == 0) {
2036        FLAG_SET_CMDLINE(bool, BytecodeVerificationLocal, false);
2037        FLAG_SET_CMDLINE(bool, BytecodeVerificationRemote, false);
2038      } else if (is_bad_option(option, args->ignoreUnrecognized, "verification")) {
2039        return JNI_EINVAL;
2040      }
2041    // -Xdebug
2042    } else if (match_option(option, "-Xdebug", &tail)) {
2043      // note this flag has been used, then ignore
2044      set_xdebug_mode(true);
2045    // -Xnoagent
2046    } else if (match_option(option, "-Xnoagent", &tail)) {
2047      // For compatibility with classic. HotSpot refuses to load the old style agent.dll.
2048    } else if (match_option(option, "-Xboundthreads", &tail)) {
2049      // Bind user level threads to kernel threads (Solaris only)
2050      FLAG_SET_CMDLINE(bool, UseBoundThreads, true);
2051    } else if (match_option(option, "-Xloggc:", &tail)) {
2052      // Redirect GC output to the file. -Xloggc:<filename>
2053      // ostream_init_log(), when called will use this filename
2054      // to initialize a fileStream.
2055      _gc_log_filename = strdup(tail);
2056      FLAG_SET_CMDLINE(bool, PrintGC, true);
2057      FLAG_SET_CMDLINE(bool, PrintGCTimeStamps, true);
2058      FLAG_SET_CMDLINE(bool, TraceClassUnloading, true);
2059
2060    // JNI hooks
2061    } else if (match_option(option, "-Xcheck", &tail)) {
2062      if (!strcmp(tail, ":jni")) {
2063        CheckJNICalls = true;
2064      } else if (is_bad_option(option, args->ignoreUnrecognized,
2065                                     "check")) {
2066        return JNI_EINVAL;
2067      }
2068    } else if (match_option(option, "vfprintf", &tail)) {
2069      _vfprintf_hook = CAST_TO_FN_PTR(vfprintf_hook_t, option->extraInfo);
2070    } else if (match_option(option, "exit", &tail)) {
2071      _exit_hook = CAST_TO_FN_PTR(exit_hook_t, option->extraInfo);
2072    } else if (match_option(option, "abort", &tail)) {
2073      _abort_hook = CAST_TO_FN_PTR(abort_hook_t, option->extraInfo);
2074    // -XX:+AggressiveHeap
2075    } else if (match_option(option, "-XX:+AggressiveHeap", &tail)) {
2076
2077      // This option inspects the machine and attempts to set various
2078      // parameters to be optimal for long-running, memory allocation
2079      // intensive jobs.  It is intended for machines with large
2080      // amounts of cpu and memory.
2081
2082      // initHeapSize is needed since _initial_heap_size is 4 bytes on a 32 bit
2083      // VM, but we may not be able to represent the total physical memory
2084      // available (like having 8gb of memory on a box but using a 32bit VM).
2085      // Thus, we need to make sure we're using a julong for intermediate
2086      // calculations.
2087      julong initHeapSize;
2088      julong total_memory = os::physical_memory();
2089
2090      if (total_memory < (julong)256*M) {
2091        jio_fprintf(defaultStream::error_stream(),
2092                    "You need at least 256mb of memory to use -XX:+AggressiveHeap\n");
2093        vm_exit(1);
2094      }
2095
2096      // The heap size is half of available memory, or (at most)
2097      // all of possible memory less 160mb (leaving room for the OS
2098      // when using ISM).  This is the maximum; because adaptive sizing
2099      // is turned on below, the actual space used may be smaller.
2100
2101      initHeapSize = MIN2(total_memory / (julong)2,
2102                          total_memory - (julong)160*M);
2103
2104      // Make sure that if we have a lot of memory we cap the 32 bit
2105      // process space.  The 64bit VM version of this function is a nop.
2106      initHeapSize = os::allocatable_physical_memory(initHeapSize);
2107
2108      // The perm gen is separate but contiguous with the
2109      // object heap (and is reserved with it) so subtract it
2110      // from the heap size.
2111      if (initHeapSize > MaxPermSize) {
2112        initHeapSize = initHeapSize - MaxPermSize;
2113      } else {
2114        warning("AggressiveHeap and MaxPermSize values may conflict");
2115      }
2116
2117      if (FLAG_IS_DEFAULT(MaxHeapSize)) {
2118         FLAG_SET_CMDLINE(uintx, MaxHeapSize, initHeapSize);
2119         set_initial_heap_size(MaxHeapSize);
2120         // Currently the minimum size and the initial heap sizes are the same.
2121         set_min_heap_size(initial_heap_size());
2122      }
2123      if (FLAG_IS_DEFAULT(NewSize)) {
2124         // Make the young generation 3/8ths of the total heap.
2125         FLAG_SET_CMDLINE(uintx, NewSize,
2126                                ((julong)MaxHeapSize / (julong)8) * (julong)3);
2127         FLAG_SET_CMDLINE(uintx, MaxNewSize, NewSize);
2128      }
2129
2130      FLAG_SET_DEFAULT(UseLargePages, true);
2131
2132      // Increase some data structure sizes for efficiency
2133      FLAG_SET_CMDLINE(uintx, BaseFootPrintEstimate, MaxHeapSize);
2134      FLAG_SET_CMDLINE(bool, ResizeTLAB, false);
2135      FLAG_SET_CMDLINE(uintx, TLABSize, 256*K);
2136
2137      // See the OldPLABSize comment below, but replace 'after promotion'
2138      // with 'after copying'.  YoungPLABSize is the size of the survivor
2139      // space per-gc-thread buffers.  The default is 4kw.
2140      FLAG_SET_CMDLINE(uintx, YoungPLABSize, 256*K);      // Note: this is in words
2141
2142      // OldPLABSize is the size of the buffers in the old gen that
2143      // UseParallelGC uses to promote live data that doesn't fit in the
2144      // survivor spaces.  At any given time, there's one for each gc thread.
2145      // The default size is 1kw. These buffers are rarely used, since the
2146      // survivor spaces are usually big enough.  For specjbb, however, there
2147      // are occasions when there's lots of live data in the young gen
2148      // and we end up promoting some of it.  We don't have a definite
2149      // explanation for why bumping OldPLABSize helps, but the theory
2150      // is that a bigger PLAB results in retaining something like the
2151      // original allocation order after promotion, which improves mutator
2152      // locality.  A minor effect may be that larger PLABs reduce the
2153      // number of PLAB allocation events during gc.  The value of 8kw
2154      // was arrived at by experimenting with specjbb.
2155      FLAG_SET_CMDLINE(uintx, OldPLABSize, 8*K);  // Note: this is in words
2156
2157      // CompilationPolicyChoice=0 causes the server compiler to adopt
2158      // a more conservative which-method-do-I-compile policy when one
2159      // of the counters maintained by the interpreter trips.  The
2160      // result is reduced startup time and improved specjbb and
2161      // alacrity performance.  Zero is the default, but we set it
2162      // explicitly here in case the default changes.
2163      // See runtime/compilationPolicy.*.
2164      FLAG_SET_CMDLINE(intx, CompilationPolicyChoice, 0);
2165
2166      // Enable parallel GC and adaptive generation sizing
2167      FLAG_SET_CMDLINE(bool, UseParallelGC, true);
2168      FLAG_SET_DEFAULT(ParallelGCThreads,
2169                       Abstract_VM_Version::parallel_worker_threads());
2170
2171      // Encourage steady state memory management
2172      FLAG_SET_CMDLINE(uintx, ThresholdTolerance, 100);
2173
2174      // This appears to improve mutator locality
2175      FLAG_SET_CMDLINE(bool, ScavengeBeforeFullGC, false);
2176
2177      // Get around early Solaris scheduling bug
2178      // (affinity vs other jobs on system)
2179      // but disallow DR and offlining (5008695).
2180      FLAG_SET_CMDLINE(bool, BindGCTaskThreadsToCPUs, true);
2181
2182    } else if (match_option(option, "-XX:+NeverTenure", &tail)) {
2183      // The last option must always win.
2184      FLAG_SET_CMDLINE(bool, AlwaysTenure, false);
2185      FLAG_SET_CMDLINE(bool, NeverTenure, true);
2186    } else if (match_option(option, "-XX:+AlwaysTenure", &tail)) {
2187      // The last option must always win.
2188      FLAG_SET_CMDLINE(bool, NeverTenure, false);
2189      FLAG_SET_CMDLINE(bool, AlwaysTenure, true);
2190    } else if (match_option(option, "-XX:+CMSPermGenSweepingEnabled", &tail) ||
2191               match_option(option, "-XX:-CMSPermGenSweepingEnabled", &tail)) {
2192      jio_fprintf(defaultStream::error_stream(),
2193        "Please use CMSClassUnloadingEnabled in place of "
2194        "CMSPermGenSweepingEnabled in the future\n");
2195    } else if (match_option(option, "-XX:+UseGCTimeLimit", &tail)) {
2196      FLAG_SET_CMDLINE(bool, UseGCOverheadLimit, true);
2197      jio_fprintf(defaultStream::error_stream(),
2198        "Please use -XX:+UseGCOverheadLimit in place of "
2199        "-XX:+UseGCTimeLimit in the future\n");
2200    } else if (match_option(option, "-XX:-UseGCTimeLimit", &tail)) {
2201      FLAG_SET_CMDLINE(bool, UseGCOverheadLimit, false);
2202      jio_fprintf(defaultStream::error_stream(),
2203        "Please use -XX:-UseGCOverheadLimit in place of "
2204        "-XX:-UseGCTimeLimit in the future\n");
2205    // The TLE options are for compatibility with 1.3 and will be
2206    // removed without notice in a future release.  These options
2207    // are not to be documented.
2208    } else if (match_option(option, "-XX:MaxTLERatio=", &tail)) {
2209      // No longer used.
2210    } else if (match_option(option, "-XX:+ResizeTLE", &tail)) {
2211      FLAG_SET_CMDLINE(bool, ResizeTLAB, true);
2212    } else if (match_option(option, "-XX:-ResizeTLE", &tail)) {
2213      FLAG_SET_CMDLINE(bool, ResizeTLAB, false);
2214    } else if (match_option(option, "-XX:+PrintTLE", &tail)) {
2215      FLAG_SET_CMDLINE(bool, PrintTLAB, true);
2216    } else if (match_option(option, "-XX:-PrintTLE", &tail)) {
2217      FLAG_SET_CMDLINE(bool, PrintTLAB, false);
2218    } else if (match_option(option, "-XX:TLEFragmentationRatio=", &tail)) {
2219      // No longer used.
2220    } else if (match_option(option, "-XX:TLESize=", &tail)) {
2221      jlong long_tlab_size = 0;
2222      ArgsRange errcode = parse_memory_size(tail, &long_tlab_size, 1);
2223      if (errcode != arg_in_range) {
2224        jio_fprintf(defaultStream::error_stream(),
2225                    "Invalid TLAB size: %s\n", option->optionString);
2226        describe_range_error(errcode);
2227        return JNI_EINVAL;
2228      }
2229      FLAG_SET_CMDLINE(uintx, TLABSize, long_tlab_size);
2230    } else if (match_option(option, "-XX:TLEThreadRatio=", &tail)) {
2231      // No longer used.
2232    } else if (match_option(option, "-XX:+UseTLE", &tail)) {
2233      FLAG_SET_CMDLINE(bool, UseTLAB, true);
2234    } else if (match_option(option, "-XX:-UseTLE", &tail)) {
2235      FLAG_SET_CMDLINE(bool, UseTLAB, false);
2236SOLARIS_ONLY(
2237    } else if (match_option(option, "-XX:+UsePermISM", &tail)) {
2238      warning("-XX:+UsePermISM is obsolete.");
2239      FLAG_SET_CMDLINE(bool, UseISM, true);
2240    } else if (match_option(option, "-XX:-UsePermISM", &tail)) {
2241      FLAG_SET_CMDLINE(bool, UseISM, false);
2242)
2243    } else if (match_option(option, "-XX:+DisplayVMOutputToStderr", &tail)) {
2244      FLAG_SET_CMDLINE(bool, DisplayVMOutputToStdout, false);
2245      FLAG_SET_CMDLINE(bool, DisplayVMOutputToStderr, true);
2246    } else if (match_option(option, "-XX:+DisplayVMOutputToStdout", &tail)) {
2247      FLAG_SET_CMDLINE(bool, DisplayVMOutputToStderr, false);
2248      FLAG_SET_CMDLINE(bool, DisplayVMOutputToStdout, true);
2249    } else if (match_option(option, "-XX:+ExtendedDTraceProbes", &tail)) {
2250#ifdef SOLARIS
2251      FLAG_SET_CMDLINE(bool, ExtendedDTraceProbes, true);
2252      FLAG_SET_CMDLINE(bool, DTraceMethodProbes, true);
2253      FLAG_SET_CMDLINE(bool, DTraceAllocProbes, true);
2254      FLAG_SET_CMDLINE(bool, DTraceMonitorProbes, true);
2255#else // ndef SOLARIS
2256      jio_fprintf(defaultStream::error_stream(),
2257                  "ExtendedDTraceProbes flag is only applicable on Solaris\n");
2258      return JNI_EINVAL;
2259#endif // ndef SOLARIS
2260    } else
2261#ifdef ASSERT
2262    if (match_option(option, "-XX:+FullGCALot", &tail)) {
2263      FLAG_SET_CMDLINE(bool, FullGCALot, true);
2264      // disable scavenge before parallel mark-compact
2265      FLAG_SET_CMDLINE(bool, ScavengeBeforeFullGC, false);
2266    } else
2267#endif
2268    if (match_option(option, "-XX:ParCMSPromoteBlocksToClaim=", &tail)) {
2269      julong cms_blocks_to_claim = (julong)atol(tail);
2270      FLAG_SET_CMDLINE(uintx, CMSParPromoteBlocksToClaim, cms_blocks_to_claim);
2271      jio_fprintf(defaultStream::error_stream(),
2272        "Please use -XX:CMSParPromoteBlocksToClaim in place of "
2273        "-XX:ParCMSPromoteBlocksToClaim in the future\n");
2274    } else
2275    if (match_option(option, "-XX:ParallelGCOldGenAllocBufferSize=", &tail)) {
2276      jlong old_plab_size = 0;
2277      ArgsRange errcode = parse_memory_size(tail, &old_plab_size, 1);
2278      if (errcode != arg_in_range) {
2279        jio_fprintf(defaultStream::error_stream(),
2280                    "Invalid old PLAB size: %s\n", option->optionString);
2281        describe_range_error(errcode);
2282        return JNI_EINVAL;
2283      }
2284      FLAG_SET_CMDLINE(uintx, OldPLABSize, (julong)old_plab_size);
2285      jio_fprintf(defaultStream::error_stream(),
2286                  "Please use -XX:OldPLABSize in place of "
2287                  "-XX:ParallelGCOldGenAllocBufferSize in the future\n");
2288    } else
2289    if (match_option(option, "-XX:ParallelGCToSpaceAllocBufferSize=", &tail)) {
2290      jlong young_plab_size = 0;
2291      ArgsRange errcode = parse_memory_size(tail, &young_plab_size, 1);
2292      if (errcode != arg_in_range) {
2293        jio_fprintf(defaultStream::error_stream(),
2294                    "Invalid young PLAB size: %s\n", option->optionString);
2295        describe_range_error(errcode);
2296        return JNI_EINVAL;
2297      }
2298      FLAG_SET_CMDLINE(uintx, YoungPLABSize, (julong)young_plab_size);
2299      jio_fprintf(defaultStream::error_stream(),
2300                  "Please use -XX:YoungPLABSize in place of "
2301                  "-XX:ParallelGCToSpaceAllocBufferSize in the future\n");
2302    } else
2303    if (match_option(option, "-XX:", &tail)) { // -XX:xxxx
2304      // Skip -XX:Flags= since that case has already been handled
2305      if (strncmp(tail, "Flags=", strlen("Flags=")) != 0) {
2306        if (!process_argument(tail, args->ignoreUnrecognized, origin)) {
2307          return JNI_EINVAL;
2308        }
2309      }
2310    // Unknown option
2311    } else if (is_bad_option(option, args->ignoreUnrecognized)) {
2312      return JNI_ERR;
2313    }
2314  }
2315
2316  return JNI_OK;
2317}
2318
2319jint Arguments::finalize_vm_init_args(SysClassPath* scp_p, bool scp_assembly_required) {
2320  // This must be done after all -D arguments have been processed.
2321  scp_p->expand_endorsed();
2322
2323  if (scp_assembly_required || scp_p->get_endorsed() != NULL) {
2324    // Assemble the bootclasspath elements into the final path.
2325    Arguments::set_sysclasspath(scp_p->combined_path());
2326  }
2327
2328  // This must be done after all arguments have been processed.
2329  // java_compiler() true means set to "NONE" or empty.
2330  if (java_compiler() && !xdebug_mode()) {
2331    // For backwards compatibility, we switch to interpreted mode if
2332    // -Djava.compiler="NONE" or "" is specified AND "-Xdebug" was
2333    // not specified.
2334    set_mode_flags(_int);
2335  }
2336  if (CompileThreshold == 0) {
2337    set_mode_flags(_int);
2338  }
2339
2340#ifdef TIERED
2341  // If we are using tiered compilation in the tiered vm then c1 will
2342  // do the profiling and we don't want to waste that time in the
2343  // interpreter.
2344  if (TieredCompilation) {
2345    ProfileInterpreter = false;
2346  } else {
2347    // Since we are running vanilla server we must adjust the compile threshold
2348    // unless the user has already adjusted it because the default threshold assumes
2349    // we will run tiered.
2350
2351    if (FLAG_IS_DEFAULT(CompileThreshold)) {
2352      CompileThreshold = Tier2CompileThreshold;
2353    }
2354  }
2355#endif // TIERED
2356
2357#ifndef COMPILER2
2358  // Don't degrade server performance for footprint
2359  if (FLAG_IS_DEFAULT(UseLargePages) &&
2360      MaxHeapSize < LargePageHeapSizeThreshold) {
2361    // No need for large granularity pages w/small heaps.
2362    // Note that large pages are enabled/disabled for both the
2363    // Java heap and the code cache.
2364    FLAG_SET_DEFAULT(UseLargePages, false);
2365    SOLARIS_ONLY(FLAG_SET_DEFAULT(UseMPSS, false));
2366    SOLARIS_ONLY(FLAG_SET_DEFAULT(UseISM, false));
2367  }
2368
2369#else
2370  if (!FLAG_IS_DEFAULT(OptoLoopAlignment) && FLAG_IS_DEFAULT(MaxLoopPad)) {
2371    FLAG_SET_DEFAULT(MaxLoopPad, OptoLoopAlignment-1);
2372  }
2373  // Temporary disable bulk zeroing reduction with G1. See CR 6627983.
2374  if (UseG1GC) {
2375    FLAG_SET_DEFAULT(ReduceBulkZeroing, false);
2376  }
2377#endif
2378
2379  if (!check_vm_args_consistency()) {
2380    return JNI_ERR;
2381  }
2382
2383  return JNI_OK;
2384}
2385
2386jint Arguments::parse_java_options_environment_variable(SysClassPath* scp_p, bool* scp_assembly_required_p) {
2387  return parse_options_environment_variable("_JAVA_OPTIONS", scp_p,
2388                                            scp_assembly_required_p);
2389}
2390
2391jint Arguments::parse_java_tool_options_environment_variable(SysClassPath* scp_p, bool* scp_assembly_required_p) {
2392  return parse_options_environment_variable("JAVA_TOOL_OPTIONS", scp_p,
2393                                            scp_assembly_required_p);
2394}
2395
2396jint Arguments::parse_options_environment_variable(const char* name, SysClassPath* scp_p, bool* scp_assembly_required_p) {
2397  const int N_MAX_OPTIONS = 64;
2398  const int OPTION_BUFFER_SIZE = 1024;
2399  char buffer[OPTION_BUFFER_SIZE];
2400
2401  // The variable will be ignored if it exceeds the length of the buffer.
2402  // Don't check this variable if user has special privileges
2403  // (e.g. unix su command).
2404  if (os::getenv(name, buffer, sizeof(buffer)) &&
2405      !os::have_special_privileges()) {
2406    JavaVMOption options[N_MAX_OPTIONS];      // Construct option array
2407    jio_fprintf(defaultStream::error_stream(),
2408                "Picked up %s: %s\n", name, buffer);
2409    char* rd = buffer;                        // pointer to the input string (rd)
2410    int i;
2411    for (i = 0; i < N_MAX_OPTIONS;) {         // repeat for all options in the input string
2412      while (isspace(*rd)) rd++;              // skip whitespace
2413      if (*rd == 0) break;                    // we re done when the input string is read completely
2414
2415      // The output, option string, overwrites the input string.
2416      // Because of quoting, the pointer to the option string (wrt) may lag the pointer to
2417      // input string (rd).
2418      char* wrt = rd;
2419
2420      options[i++].optionString = wrt;        // Fill in option
2421      while (*rd != 0 && !isspace(*rd)) {     // unquoted strings terminate with a space or NULL
2422        if (*rd == '\'' || *rd == '"') {      // handle a quoted string
2423          int quote = *rd;                    // matching quote to look for
2424          rd++;                               // don't copy open quote
2425          while (*rd != quote) {              // include everything (even spaces) up until quote
2426            if (*rd == 0) {                   // string termination means unmatched string
2427              jio_fprintf(defaultStream::error_stream(),
2428                          "Unmatched quote in %s\n", name);
2429              return JNI_ERR;
2430            }
2431            *wrt++ = *rd++;                   // copy to option string
2432          }
2433          rd++;                               // don't copy close quote
2434        } else {
2435          *wrt++ = *rd++;                     // copy to option string
2436        }
2437      }
2438      // Need to check if we're done before writing a NULL,
2439      // because the write could be to the byte that rd is pointing to.
2440      if (*rd++ == 0) {
2441        *wrt = 0;
2442        break;
2443      }
2444      *wrt = 0;                               // Zero terminate option
2445    }
2446    // Construct JavaVMInitArgs structure and parse as if it was part of the command line
2447    JavaVMInitArgs vm_args;
2448    vm_args.version = JNI_VERSION_1_2;
2449    vm_args.options = options;
2450    vm_args.nOptions = i;
2451    vm_args.ignoreUnrecognized = false;
2452
2453    if (PrintVMOptions) {
2454      const char* tail;
2455      for (int i = 0; i < vm_args.nOptions; i++) {
2456        const JavaVMOption *option = vm_args.options + i;
2457        if (match_option(option, "-XX:", &tail)) {
2458          logOption(tail);
2459        }
2460      }
2461    }
2462
2463    return(parse_each_vm_init_arg(&vm_args, scp_p, scp_assembly_required_p, ENVIRON_VAR));
2464  }
2465  return JNI_OK;
2466}
2467
2468// Parse entry point called from JNI_CreateJavaVM
2469
2470jint Arguments::parse(const JavaVMInitArgs* args) {
2471
2472  // Sharing support
2473  // Construct the path to the archive
2474  char jvm_path[JVM_MAXPATHLEN];
2475  os::jvm_path(jvm_path, sizeof(jvm_path));
2476#ifdef TIERED
2477  if (strstr(jvm_path, "client") != NULL) {
2478    force_client_mode = true;
2479  }
2480#endif // TIERED
2481  char *end = strrchr(jvm_path, *os::file_separator());
2482  if (end != NULL) *end = '\0';
2483  char *shared_archive_path = NEW_C_HEAP_ARRAY(char, strlen(jvm_path) +
2484                                        strlen(os::file_separator()) + 20);
2485  if (shared_archive_path == NULL) return JNI_ENOMEM;
2486  strcpy(shared_archive_path, jvm_path);
2487  strcat(shared_archive_path, os::file_separator());
2488  strcat(shared_archive_path, "classes");
2489  DEBUG_ONLY(strcat(shared_archive_path, "_g");)
2490  strcat(shared_archive_path, ".jsa");
2491  SharedArchivePath = shared_archive_path;
2492
2493  // Remaining part of option string
2494  const char* tail;
2495
2496  // If flag "-XX:Flags=flags-file" is used it will be the first option to be processed.
2497  bool settings_file_specified = false;
2498  int index;
2499  for (index = 0; index < args->nOptions; index++) {
2500    const JavaVMOption *option = args->options + index;
2501    if (match_option(option, "-XX:Flags=", &tail)) {
2502      if (!process_settings_file(tail, true, args->ignoreUnrecognized)) {
2503        return JNI_EINVAL;
2504      }
2505      settings_file_specified = true;
2506    }
2507    if (match_option(option, "-XX:+PrintVMOptions", &tail)) {
2508      PrintVMOptions = true;
2509    }
2510    if (match_option(option, "-XX:-PrintVMOptions", &tail)) {
2511      PrintVMOptions = false;
2512    }
2513  }
2514
2515  // Parse default .hotspotrc settings file
2516  if (!settings_file_specified) {
2517    if (!process_settings_file(".hotspotrc", false, args->ignoreUnrecognized)) {
2518      return JNI_EINVAL;
2519    }
2520  }
2521
2522  if (PrintVMOptions) {
2523    for (index = 0; index < args->nOptions; index++) {
2524      const JavaVMOption *option = args->options + index;
2525      if (match_option(option, "-XX:", &tail)) {
2526        logOption(tail);
2527      }
2528    }
2529  }
2530
2531
2532  // Parse JavaVMInitArgs structure passed in, as well as JAVA_TOOL_OPTIONS and _JAVA_OPTIONS
2533  jint result = parse_vm_init_args(args);
2534  if (result != JNI_OK) {
2535    return result;
2536  }
2537
2538  // These are hacks until G1 is fully supported and tested
2539  // but lets you force -XX:+UseG1GC in PRT and get it where it (mostly) works
2540  if (UseG1GC) {
2541    if (UseConcMarkSweepGC || UseParNewGC || UseParallelGC || UseParallelOldGC || UseSerialGC) {
2542#ifndef PRODUCT
2543      tty->print_cr("-XX:+UseG1GC is incompatible with other collectors, using UseG1GC");
2544#endif // PRODUCT
2545      UseConcMarkSweepGC = false;
2546      UseParNewGC        = false;
2547      UseParallelGC      = false;
2548      UseParallelOldGC   = false;
2549      UseSerialGC        = false;
2550    }
2551    no_shared_spaces();
2552  }
2553
2554#ifndef PRODUCT
2555  if (TraceBytecodesAt != 0) {
2556    TraceBytecodes = true;
2557  }
2558  if (CountCompiledCalls) {
2559    if (UseCounterDecay) {
2560      warning("UseCounterDecay disabled because CountCalls is set");
2561      UseCounterDecay = false;
2562    }
2563  }
2564#endif // PRODUCT
2565
2566  if (PrintGCDetails) {
2567    // Turn on -verbose:gc options as well
2568    PrintGC = true;
2569    if (FLAG_IS_DEFAULT(TraceClassUnloading)) {
2570      TraceClassUnloading = true;
2571    }
2572  }
2573
2574#ifdef SERIALGC
2575  set_serial_gc_flags();
2576#endif // SERIALGC
2577#ifdef KERNEL
2578  no_shared_spaces();
2579#endif // KERNEL
2580
2581  // Set flags based on ergonomics.
2582  set_ergonomics_flags();
2583
2584  // Check the GC selections again.
2585  if (!check_gc_consistency()) {
2586    return JNI_EINVAL;
2587  }
2588
2589  if (UseParallelGC || UseParallelOldGC) {
2590    // Set some flags for ParallelGC if needed.
2591    set_parallel_gc_flags();
2592  } else if (UseConcMarkSweepGC) {
2593    // Set some flags for CMS
2594    set_cms_and_parnew_gc_flags();
2595  } else if (UseParNewGC) {
2596    // Set some flags for ParNew
2597    set_parnew_gc_flags();
2598  }
2599  // Temporary; make the "if" an "else-if" before
2600  // we integrate G1. XXX
2601  if (UseG1GC) {
2602    // Set some flags for garbage-first, if needed.
2603    set_g1_gc_flags();
2604  }
2605
2606#ifdef SERIALGC
2607  assert(verify_serial_gc_flags(), "SerialGC unset");
2608#endif // SERIALGC
2609
2610  // Set bytecode rewriting flags
2611  set_bytecode_flags();
2612
2613  // Set flags if Aggressive optimization flags (-XX:+AggressiveOpts) enabled.
2614  set_aggressive_opts_flags();
2615
2616#ifdef CC_INTERP
2617  // Biased locking is not implemented with c++ interpreter
2618  FLAG_SET_DEFAULT(UseBiasedLocking, false);
2619#endif /* CC_INTERP */
2620
2621  if (PrintCommandLineFlags) {
2622    CommandLineFlags::printSetFlags();
2623  }
2624
2625#ifdef ASSERT
2626  if (PrintFlagsFinal) {
2627    CommandLineFlags::printFlags();
2628  }
2629#endif
2630
2631  return JNI_OK;
2632}
2633
2634int Arguments::PropertyList_count(SystemProperty* pl) {
2635  int count = 0;
2636  while(pl != NULL) {
2637    count++;
2638    pl = pl->next();
2639  }
2640  return count;
2641}
2642
2643const char* Arguments::PropertyList_get_value(SystemProperty *pl, const char* key) {
2644  assert(key != NULL, "just checking");
2645  SystemProperty* prop;
2646  for (prop = pl; prop != NULL; prop = prop->next()) {
2647    if (strcmp(key, prop->key()) == 0) return prop->value();
2648  }
2649  return NULL;
2650}
2651
2652const char* Arguments::PropertyList_get_key_at(SystemProperty *pl, int index) {
2653  int count = 0;
2654  const char* ret_val = NULL;
2655
2656  while(pl != NULL) {
2657    if(count >= index) {
2658      ret_val = pl->key();
2659      break;
2660    }
2661    count++;
2662    pl = pl->next();
2663  }
2664
2665  return ret_val;
2666}
2667
2668char* Arguments::PropertyList_get_value_at(SystemProperty* pl, int index) {
2669  int count = 0;
2670  char* ret_val = NULL;
2671
2672  while(pl != NULL) {
2673    if(count >= index) {
2674      ret_val = pl->value();
2675      break;
2676    }
2677    count++;
2678    pl = pl->next();
2679  }
2680
2681  return ret_val;
2682}
2683
2684void Arguments::PropertyList_add(SystemProperty** plist, SystemProperty *new_p) {
2685  SystemProperty* p = *plist;
2686  if (p == NULL) {
2687    *plist = new_p;
2688  } else {
2689    while (p->next() != NULL) {
2690      p = p->next();
2691    }
2692    p->set_next(new_p);
2693  }
2694}
2695
2696void Arguments::PropertyList_add(SystemProperty** plist, const char* k, char* v) {
2697  if (plist == NULL)
2698    return;
2699
2700  SystemProperty* new_p = new SystemProperty(k, v, true);
2701  PropertyList_add(plist, new_p);
2702}
2703
2704// This add maintains unique property key in the list.
2705void Arguments::PropertyList_unique_add(SystemProperty** plist, const char* k, char* v) {
2706  if (plist == NULL)
2707    return;
2708
2709  // If property key exist then update with new value.
2710  SystemProperty* prop;
2711  for (prop = *plist; prop != NULL; prop = prop->next()) {
2712    if (strcmp(k, prop->key()) == 0) {
2713      prop->set_value(v);
2714      return;
2715    }
2716  }
2717
2718  PropertyList_add(plist, k, v);
2719}
2720
2721#ifdef KERNEL
2722char *Arguments::get_kernel_properties() {
2723  // Find properties starting with kernel and append them to string
2724  // We need to find out how long they are first because the URL's that they
2725  // might point to could get long.
2726  int length = 0;
2727  SystemProperty* prop;
2728  for (prop = _system_properties; prop != NULL; prop = prop->next()) {
2729    if (strncmp(prop->key(), "kernel.", 7 ) == 0) {
2730      length += (strlen(prop->key()) + strlen(prop->value()) + 5);  // "-D ="
2731    }
2732  }
2733  // Add one for null terminator.
2734  char *props = AllocateHeap(length + 1, "get_kernel_properties");
2735  if (length != 0) {
2736    int pos = 0;
2737    for (prop = _system_properties; prop != NULL; prop = prop->next()) {
2738      if (strncmp(prop->key(), "kernel.", 7 ) == 0) {
2739        jio_snprintf(&props[pos], length-pos,
2740                     "-D%s=%s ", prop->key(), prop->value());
2741        pos = strlen(props);
2742      }
2743    }
2744  }
2745  // null terminate props in case of null
2746  props[length] = '\0';
2747  return props;
2748}
2749#endif // KERNEL
2750
2751// Copies src into buf, replacing "%%" with "%" and "%p" with pid
2752// Returns true if all of the source pointed by src has been copied over to
2753// the destination buffer pointed by buf. Otherwise, returns false.
2754// Notes:
2755// 1. If the length (buflen) of the destination buffer excluding the
2756// NULL terminator character is not long enough for holding the expanded
2757// pid characters, it also returns false instead of returning the partially
2758// expanded one.
2759// 2. The passed in "buflen" should be large enough to hold the null terminator.
2760bool Arguments::copy_expand_pid(const char* src, size_t srclen,
2761                                char* buf, size_t buflen) {
2762  const char* p = src;
2763  char* b = buf;
2764  const char* src_end = &src[srclen];
2765  char* buf_end = &buf[buflen - 1];
2766
2767  while (p < src_end && b < buf_end) {
2768    if (*p == '%') {
2769      switch (*(++p)) {
2770      case '%':         // "%%" ==> "%"
2771        *b++ = *p++;
2772        break;
2773      case 'p':  {       //  "%p" ==> current process id
2774        // buf_end points to the character before the last character so
2775        // that we could write '\0' to the end of the buffer.
2776        size_t buf_sz = buf_end - b + 1;
2777        int ret = jio_snprintf(b, buf_sz, "%d", os::current_process_id());
2778
2779        // if jio_snprintf fails or the buffer is not long enough to hold
2780        // the expanded pid, returns false.
2781        if (ret < 0 || ret >= (int)buf_sz) {
2782          return false;
2783        } else {
2784          b += ret;
2785          assert(*b == '\0', "fail in copy_expand_pid");
2786          if (p == src_end && b == buf_end + 1) {
2787            // reach the end of the buffer.
2788            return true;
2789          }
2790        }
2791        p++;
2792        break;
2793      }
2794      default :
2795        *b++ = '%';
2796      }
2797    } else {
2798      *b++ = *p++;
2799    }
2800  }
2801  *b = '\0';
2802  return (p == src_end); // return false if not all of the source was copied
2803}
2804