1 /*
   2  * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20  * or visit www.oracle.com if you need additional information or have any
  21  * questions.
  22  *
  23  */
  24 
  25 #include "precompiled.hpp"
  26 #include "classfile/altHashing.hpp"
  27 #include "classfile/javaClasses.hpp"
  28 #include "classfile/symbolTable.hpp"
  29 #include "classfile/systemDictionary.hpp"
  30 #include "gc_interface/collectedHeap.inline.hpp"
  31 #include "memory/allocation.inline.hpp"
  32 #include "memory/filemap.hpp"
  33 #include "memory/gcLocker.inline.hpp"
  34 #include "oops/oop.inline.hpp"
  35 #include "oops/oop.inline2.hpp"
  36 #include "runtime/mutexLocker.hpp"
  37 #include "utilities/hashtable.inline.hpp"
  38 #if INCLUDE_ALL_GCS
  39 #include "gc_implementation/g1/g1StringDedup.hpp"
  40 #endif
  41 
  42 // --------------------------------------------------------------------------
  43 
  44 // the number of buckets a thread claims
  45 const int ClaimChunkSize = 32;
  46 
  47 SymbolTable* SymbolTable::_the_table = NULL;
  48 // Static arena for symbols that are not deallocated
  49 Arena* SymbolTable::_arena = NULL;
  50 bool SymbolTable::_needs_rehashing = false;
  51 
  52 Symbol* SymbolTable::allocate_symbol(const u1* name, int len, bool c_heap, TRAPS) {
  53   assert (len <= Symbol::max_length(), "should be checked by caller");
  54 
  55   Symbol* sym;
  56 
  57   if (DumpSharedSpaces) {
  58     // Allocate all symbols to CLD shared metaspace
  59     sym = new (len, ClassLoaderData::the_null_class_loader_data(), THREAD) Symbol(name, len, -1);
  60   } else if (c_heap) {
  61     // refcount starts as 1
  62     sym = new (len, THREAD) Symbol(name, len, 1);
  63     assert(sym != NULL, "new should call vm_exit_out_of_memory if C_HEAP is exhausted");
  64   } else {
  65     // Allocate to global arena
  66     sym = new (len, arena(), THREAD) Symbol(name, len, -1);
  67   }
  68   return sym;
  69 }
  70 
  71 void SymbolTable::initialize_symbols(int arena_alloc_size) {
  72   // Initialize the arena for global symbols, size passed in depends on CDS.
  73   if (arena_alloc_size == 0) {
  74     _arena = new (mtSymbol) Arena();
  75   } else {
  76     _arena = new (mtSymbol) Arena(arena_alloc_size);
  77   }
  78 }
  79 
  80 // Call function for all symbols in the symbol table.
  81 void SymbolTable::symbols_do(SymbolClosure *cl) {
  82   const int n = the_table()->table_size();
  83   for (int i = 0; i < n; i++) {
  84     for (HashtableEntry<Symbol*, mtSymbol>* p = the_table()->bucket(i);
  85          p != NULL;
  86          p = p->next()) {
  87       cl->do_symbol(p->literal_addr());
  88     }
  89   }
  90 }
  91 
  92 int SymbolTable::_symbols_removed = 0;
  93 int SymbolTable::_symbols_counted = 0;
  94 volatile int SymbolTable::_parallel_claimed_idx = 0;
  95 
  96 void SymbolTable::buckets_unlink(int start_idx, int end_idx, int* processed, int* removed, size_t* memory_total) {
  97   for (int i = start_idx; i < end_idx; ++i) {
  98     HashtableEntry<Symbol*, mtSymbol>** p = the_table()->bucket_addr(i);
  99     HashtableEntry<Symbol*, mtSymbol>* entry = the_table()->bucket(i);
 100     while (entry != NULL) {
 101       // Shared entries are normally at the end of the bucket and if we run into
 102       // a shared entry, then there is nothing more to remove. However, if we
 103       // have rehashed the table, then the shared entries are no longer at the
 104       // end of the bucket.
 105       if (entry->is_shared() && !use_alternate_hashcode()) {
 106         break;
 107       }
 108       Symbol* s = entry->literal();
 109       (*memory_total) += s->size();
 110       (*processed)++;
 111       assert(s != NULL, "just checking");
 112       // If reference count is zero, remove.
 113       if (s->refcount() == 0) {
 114         assert(!entry->is_shared(), "shared entries should be kept live");
 115         delete s;
 116         (*removed)++;
 117         *p = entry->next();
 118         the_table()->free_entry(entry);
 119       } else {
 120         p = entry->next_addr();
 121       }
 122       // get next entry
 123       entry = (HashtableEntry<Symbol*, mtSymbol>*)HashtableEntry<Symbol*, mtSymbol>::make_ptr(*p);
 124     }
 125   }
 126 }
 127 
 128 // Remove unreferenced symbols from the symbol table
 129 // This is done late during GC.
 130 void SymbolTable::unlink(int* processed, int* removed) {
 131   size_t memory_total = 0;
 132   buckets_unlink(0, the_table()->table_size(), processed, removed, &memory_total);
 133   _symbols_removed += *removed;
 134   _symbols_counted += *processed;
 135   // Exclude printing for normal PrintGCDetails because people parse
 136   // this output.
 137   if (PrintGCDetails && Verbose && WizardMode) {
 138     gclog_or_tty->print(" [Symbols=%d size=" SIZE_FORMAT "K] ", *processed,
 139                         (memory_total*HeapWordSize)/1024);
 140   }
 141 }
 142 
 143 void SymbolTable::possibly_parallel_unlink(int* processed, int* removed) {
 144   const int limit = the_table()->table_size();
 145 
 146   size_t memory_total = 0;
 147 
 148   for (;;) {
 149     // Grab next set of buckets to scan
 150     int start_idx = Atomic::add(ClaimChunkSize, &_parallel_claimed_idx) - ClaimChunkSize;
 151     if (start_idx >= limit) {
 152       // End of table
 153       break;
 154     }
 155 
 156     int end_idx = MIN2(limit, start_idx + ClaimChunkSize);
 157     buckets_unlink(start_idx, end_idx, processed, removed, &memory_total);
 158   }
 159   Atomic::add(*processed, &_symbols_counted);
 160   Atomic::add(*removed, &_symbols_removed);
 161   // Exclude printing for normal PrintGCDetails because people parse
 162   // this output.
 163   if (PrintGCDetails && Verbose && WizardMode) {
 164     gclog_or_tty->print(" [Symbols: scanned=%d removed=%d size=" SIZE_FORMAT "K] ", *processed, *removed,
 165                         (memory_total*HeapWordSize)/1024);
 166   }
 167 }
 168 
 169 // Create a new table and using alternate hash code, populate the new table
 170 // with the existing strings.   Set flag to use the alternate hash code afterwards.
 171 void SymbolTable::rehash_table() {
 172   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
 173   // This should never happen with -Xshare:dump but it might in testing mode.
 174   if (DumpSharedSpaces) return;
 175   // Create a new symbol table
 176   SymbolTable* new_table = new SymbolTable();
 177 
 178   the_table()->move_to(new_table);
 179 
 180   // Delete the table and buckets (entries are reused in new table).
 181   delete _the_table;
 182   // Don't check if we need rehashing until the table gets unbalanced again.
 183   // Then rehash with a new global seed.
 184   _needs_rehashing = false;
 185   _the_table = new_table;
 186 }
 187 
 188 // Lookup a symbol in a bucket.
 189 
 190 Symbol* SymbolTable::lookup(int index, const char* name,
 191                               int len, unsigned int hash) {
 192   int count = 0;
 193   for (HashtableEntry<Symbol*, mtSymbol>* e = bucket(index); e != NULL; e = e->next()) {
 194     count++;  // count all entries in this bucket, not just ones with same hash
 195     if (e->hash() == hash) {
 196       Symbol* sym = e->literal();
 197       if (sym->equals(name, len)) {
 198         // something is referencing this symbol now.
 199         sym->increment_refcount();
 200         return sym;
 201       }
 202     }
 203   }
 204   // If the bucket size is too deep check if this hash code is insufficient.
 205   if (count >= BasicHashtable<mtSymbol>::rehash_count && !needs_rehashing()) {
 206     _needs_rehashing = check_rehash_table(count);
 207   }
 208   return NULL;
 209 }
 210 
 211 // Pick hashing algorithm.
 212 unsigned int SymbolTable::hash_symbol(const char* name, int len) {
 213   return use_alternate_hashcode() ?
 214            AltHashing::murmur3_32(seed(), (const jbyte*)name, len) :
 215            java_lang_String::hash_code(name, len);
 216 }
 217 
 218 
 219 // We take care not to be blocking while holding the
 220 // SymbolTable_lock. Otherwise, the system might deadlock, since the
 221 // symboltable is used during compilation (VM_thread) The lock free
 222 // synchronization is simplified by the fact that we do not delete
 223 // entries in the symbol table during normal execution (only during
 224 // safepoints).
 225 
 226 Symbol* SymbolTable::lookup_and_add(const char* name, int len, TRAPS) {
 227   unsigned int hashValue = hash_symbol(name, len);
 228   int index = the_table()->hash_to_index(hashValue);
 229 
 230   Symbol* s = the_table()->lookup(index, name, len, hashValue);
 231 
 232   // Found
 233   if (s != NULL) return s;
 234 
 235   // Grab SymbolTable_lock first.
 236   MutexLocker ml(SymbolTable_lock, THREAD);
 237 
 238   // Otherwise, add to symbol to table
 239   return the_table()->basic_add(index, (u1*)name, len, hashValue, true, CHECK_NULL);
 240 }
 241 
 242 Symbol* SymbolTable::lookup_and_add(const Symbol* sym, int begin, int end, TRAPS) {
 243   char* buffer;
 244   int index, len;
 245   unsigned int hashValue;
 246   char* name;
 247   {
 248     debug_only(No_Safepoint_Verifier nsv;)
 249 
 250     name = (char*)sym->base() + begin;
 251     len = end - begin;
 252     hashValue = hash_symbol(name, len);
 253     index = the_table()->hash_to_index(hashValue);
 254     Symbol* s = the_table()->lookup(index, name, len, hashValue);
 255 
 256     // Found
 257     if (s != NULL) return s;
 258   }
 259 
 260   // Otherwise, add to symbol to table. Copy to a C string first.
 261   char stack_buf[128];
 262   ResourceMark rm(THREAD);
 263   if (len <= 128) {
 264     buffer = stack_buf;
 265   } else {
 266     buffer = NEW_RESOURCE_ARRAY_IN_THREAD(THREAD, char, len);
 267   }
 268   for (int i=0; i<len; i++) {
 269     buffer[i] = name[i];
 270   }
 271   // Make sure there is no safepoint in the code above since name can't move.
 272   // We can't include the code in No_Safepoint_Verifier because of the
 273   // ResourceMark.
 274 
 275   // Grab SymbolTable_lock first.
 276   MutexLocker ml(SymbolTable_lock, THREAD);
 277 
 278   return the_table()->basic_add(index, (u1*)buffer, len, hashValue, true, CHECK_NULL);
 279 }
 280 
 281 Symbol* SymbolTable::lookup_and_hash(const char* name, int len,
 282                                    unsigned int& hash) {
 283   hash = hash_symbol(name, len);
 284   int index = the_table()->hash_to_index(hash);
 285 
 286   Symbol* s = the_table()->lookup(index, name, len, hash);
 287   return s;
 288 }
 289 
 290 // Look up the address of the literal in the SymbolTable for this Symbol*
 291 // Do not create any new symbols
 292 // Do not increment the reference count to keep this alive
 293 Symbol** SymbolTable::lookup_symbol_addr(Symbol* sym){
 294   unsigned int hash = hash_symbol((char*)sym->bytes(), sym->utf8_length());
 295   int index = the_table()->hash_to_index(hash);
 296 
 297   for (HashtableEntry<Symbol*, mtSymbol>* e = the_table()->bucket(index); e != NULL; e = e->next()) {
 298     if (e->hash() == hash) {
 299       Symbol* literal_sym = e->literal();
 300       if (sym == literal_sym) {
 301         return e->literal_addr();
 302       }
 303     }
 304   }
 305   return NULL;
 306 }
 307 
 308 // Suggestion: Push unicode-based lookup all the way into the hashing
 309 // and probing logic, so there is no need for convert_to_utf8 until
 310 // an actual new Symbol* is created.
 311 Symbol* SymbolTable::lookup_and_add_unicode(const jchar* name, int utf16_length, TRAPS) {
 312   int utf8_length = UNICODE::utf8_length((jchar*) name, utf16_length);
 313   char stack_buf[128];
 314   if (utf8_length < (int) sizeof(stack_buf)) {
 315     char* chars = stack_buf;
 316     UNICODE::convert_to_utf8(name, utf16_length, chars);
 317     return lookup_and_add(chars, utf8_length, THREAD);
 318   } else {
 319     ResourceMark rm(THREAD);
 320     char* chars = NEW_RESOURCE_ARRAY(char, utf8_length + 1);
 321     UNICODE::convert_to_utf8(name, utf16_length, chars);
 322     return lookup_and_add(chars, utf8_length, THREAD);
 323   }
 324 }
 325 
 326 Symbol* SymbolTable::lookup_and_hash_unicode(const jchar* name, int utf16_length,
 327                                            unsigned int& hash) {
 328   int utf8_length = UNICODE::utf8_length((jchar*) name, utf16_length);
 329   char stack_buf[128];
 330   if (utf8_length < (int) sizeof(stack_buf)) {
 331     char* chars = stack_buf;
 332     UNICODE::convert_to_utf8(name, utf16_length, chars);
 333     return lookup_and_hash(chars, utf8_length, hash);
 334   } else {
 335     ResourceMark rm;
 336     char* chars = NEW_RESOURCE_ARRAY(char, utf8_length + 1);
 337     UNICODE::convert_to_utf8(name, utf16_length, chars);
 338     return lookup_and_hash(chars, utf8_length, hash);
 339   }
 340 }
 341 
 342 void SymbolTable::add(ClassLoaderData* loader_data, constantPoolHandle cp,
 343                       int names_count,
 344                       const char** names, int* lengths, int* cp_indices,
 345                       unsigned int* hashValues, TRAPS) {
 346   // Grab SymbolTable_lock first.
 347   MutexLocker ml(SymbolTable_lock, THREAD);
 348 
 349   SymbolTable* table = the_table();
 350   bool added = table->basic_add(loader_data, cp, names_count, names, lengths,
 351                                 cp_indices, hashValues, CHECK);
 352   if (!added) {
 353     // do it the hard way
 354     for (int i=0; i<names_count; i++) {
 355       int index = table->hash_to_index(hashValues[i]);
 356       bool c_heap = !loader_data->is_the_null_class_loader_data();
 357       Symbol* sym = table->basic_add(index, (u1*)names[i], lengths[i], hashValues[i], c_heap, CHECK);
 358       cp->symbol_at_put(cp_indices[i], sym);
 359     }
 360   }
 361 }
 362 
 363 Symbol* SymbolTable::new_permanent_symbol(const char* name, TRAPS) {
 364   unsigned int hash;
 365   Symbol* result = SymbolTable::lookup_and_hash((char*)name, (int)strlen(name), hash);
 366   if (result != NULL) {
 367     return result;
 368   }
 369   // Grab SymbolTable_lock first.
 370   MutexLocker ml(SymbolTable_lock, THREAD);
 371 
 372   SymbolTable* table = the_table();
 373   int index = table->hash_to_index(hash);
 374   return table->basic_add(index, (u1*)name, (int)strlen(name), hash, false, THREAD);
 375 }
 376 
 377 Symbol* SymbolTable::basic_add(int index_arg, u1 *name, int len,
 378                                unsigned int hashValue_arg, bool c_heap, TRAPS) {
 379   assert(!Universe::heap()->is_in_reserved(name),
 380          "proposed name of symbol must be stable");
 381 
 382   // Don't allow symbols to be created which cannot fit in a Symbol*.
 383   if (len > Symbol::max_length()) {
 384     THROW_MSG_0(vmSymbols::java_lang_InternalError(),
 385                 "name is too long to represent");
 386   }
 387 
 388   // Cannot hit a safepoint in this function because the "this" pointer can move.
 389   No_Safepoint_Verifier nsv;
 390 
 391   // Check if the symbol table has been rehashed, if so, need to recalculate
 392   // the hash value and index.
 393   unsigned int hashValue;
 394   int index;
 395   if (use_alternate_hashcode()) {
 396     hashValue = hash_symbol((const char*)name, len);
 397     index = hash_to_index(hashValue);
 398   } else {
 399     hashValue = hashValue_arg;
 400     index = index_arg;
 401   }
 402 
 403   // Since look-up was done lock-free, we need to check if another
 404   // thread beat us in the race to insert the symbol.
 405   Symbol* test = lookup(index, (char*)name, len, hashValue);
 406   if (test != NULL) {
 407     // A race occurred and another thread introduced the symbol.
 408     assert(test->refcount() != 0, "lookup should have incremented the count");
 409     return test;
 410   }
 411 
 412   // Create a new symbol.
 413   Symbol* sym = allocate_symbol(name, len, c_heap, CHECK_NULL);
 414   assert(sym->equals((char*)name, len), "symbol must be properly initialized");
 415 
 416   HashtableEntry<Symbol*, mtSymbol>* entry = new_entry(hashValue, sym);
 417   add_entry(index, entry);
 418   return sym;
 419 }
 420 
 421 // This version of basic_add adds symbols in batch from the constant pool
 422 // parsing.
 423 bool SymbolTable::basic_add(ClassLoaderData* loader_data, constantPoolHandle cp,
 424                             int names_count,
 425                             const char** names, int* lengths,
 426                             int* cp_indices, unsigned int* hashValues,
 427                             TRAPS) {
 428   // Check symbol names are not too long.  If any are too long, don't add any.
 429   for (int i = 0; i< names_count; i++) {
 430     if (lengths[i] > Symbol::max_length()) {
 431       THROW_MSG_0(vmSymbols::java_lang_InternalError(),
 432                   "name is too long to represent");
 433     }
 434   }
 435 
 436   // Cannot hit a safepoint in this function because the "this" pointer can move.
 437   No_Safepoint_Verifier nsv;
 438 
 439   for (int i=0; i<names_count; i++) {
 440     // Check if the symbol table has been rehashed, if so, need to recalculate
 441     // the hash value.
 442     unsigned int hashValue;
 443     if (use_alternate_hashcode()) {
 444       hashValue = hash_symbol(names[i], lengths[i]);
 445     } else {
 446       hashValue = hashValues[i];
 447     }
 448     // Since look-up was done lock-free, we need to check if another
 449     // thread beat us in the race to insert the symbol.
 450     int index = hash_to_index(hashValue);
 451     Symbol* test = lookup(index, names[i], lengths[i], hashValue);
 452     if (test != NULL) {
 453       // A race occurred and another thread introduced the symbol, this one
 454       // will be dropped and collected. Use test instead.
 455       cp->symbol_at_put(cp_indices[i], test);
 456       assert(test->refcount() != 0, "lookup should have incremented the count");
 457     } else {
 458       // Create a new symbol.  The null class loader is never unloaded so these
 459       // are allocated specially in a permanent arena.
 460       bool c_heap = !loader_data->is_the_null_class_loader_data();
 461       Symbol* sym = allocate_symbol((const u1*)names[i], lengths[i], c_heap, CHECK_(false));
 462       assert(sym->equals(names[i], lengths[i]), "symbol must be properly initialized");  // why wouldn't it be???
 463       HashtableEntry<Symbol*, mtSymbol>* entry = new_entry(hashValue, sym);
 464       add_entry(index, entry);
 465       cp->symbol_at_put(cp_indices[i], sym);
 466     }
 467   }
 468   return true;
 469 }
 470 
 471 void SymbolTable::verify() {
 472   for (int i = 0; i < the_table()->table_size(); ++i) {
 473     HashtableEntry<Symbol*, mtSymbol>* p = the_table()->bucket(i);
 474     for ( ; p != NULL; p = p->next()) {
 475       Symbol* s = (Symbol*)(p->literal());
 476       guarantee(s != NULL, "symbol is NULL");
 477       unsigned int h = hash_symbol((char*)s->bytes(), s->utf8_length());
 478       guarantee(p->hash() == h, "broken hash in symbol table entry");
 479       guarantee(the_table()->hash_to_index(h) == i,
 480                 "wrong index in symbol table");
 481     }
 482   }
 483 }
 484 
 485 void SymbolTable::dump(outputStream* st) {
 486   the_table()->dump_table(st, "SymbolTable");
 487 }
 488 
 489 //---------------------------------------------------------------------------
 490 // Non-product code
 491 
 492 #ifndef PRODUCT
 493 
 494 void SymbolTable::print_histogram() {
 495   MutexLocker ml(SymbolTable_lock);
 496   const int results_length = 100;
 497   int results[results_length];
 498   int i,j;
 499 
 500   // initialize results to zero
 501   for (j = 0; j < results_length; j++) {
 502     results[j] = 0;
 503   }
 504 
 505   int total = 0;
 506   int max_symbols = 0;
 507   int out_of_range = 0;
 508   int memory_total = 0;
 509   int count = 0;
 510   for (i = 0; i < the_table()->table_size(); i++) {
 511     HashtableEntry<Symbol*, mtSymbol>* p = the_table()->bucket(i);
 512     for ( ; p != NULL; p = p->next()) {
 513       memory_total += p->literal()->size();
 514       count++;
 515       int counter = p->literal()->utf8_length();
 516       total += counter;
 517       if (counter < results_length) {
 518         results[counter]++;
 519       } else {
 520         out_of_range++;
 521       }
 522       max_symbols = MAX2(max_symbols, counter);
 523     }
 524   }
 525   tty->print_cr("Symbol Table:");
 526   tty->print_cr("Total number of symbols  %5d", count);
 527   tty->print_cr("Total size in memory     %5dK",
 528           (memory_total*HeapWordSize)/1024);
 529   tty->print_cr("Total counted            %5d", _symbols_counted);
 530   tty->print_cr("Total removed            %5d", _symbols_removed);
 531   if (_symbols_counted > 0) {
 532     tty->print_cr("Percent removed          %3.2f",
 533           ((float)_symbols_removed/(float)_symbols_counted)* 100);
 534   }
 535   tty->print_cr("Reference counts         %5d", Symbol::_total_count);
 536   tty->print_cr("Symbol arena size        %5d used %5d",
 537                  arena()->size_in_bytes(), arena()->used());
 538   tty->print_cr("Histogram of symbol length:");
 539   tty->print_cr("%8s %5d", "Total  ", total);
 540   tty->print_cr("%8s %5d", "Maximum", max_symbols);
 541   tty->print_cr("%8s %3.2f", "Average",
 542           ((float) total / (float) the_table()->table_size()));
 543   tty->print_cr("%s", "Histogram:");
 544   tty->print_cr(" %s %29s", "Length", "Number chains that length");
 545   for (i = 0; i < results_length; i++) {
 546     if (results[i] > 0) {
 547       tty->print_cr("%6d %10d", i, results[i]);
 548     }
 549   }
 550   if (Verbose) {
 551     int line_length = 70;
 552     tty->print_cr("%s %30s", " Length", "Number chains that length");
 553     for (i = 0; i < results_length; i++) {
 554       if (results[i] > 0) {
 555         tty->print("%4d", i);
 556         for (j = 0; (j < results[i]) && (j < line_length);  j++) {
 557           tty->print("%1s", "*");
 558         }
 559         if (j == line_length) {
 560           tty->print("%1s", "+");
 561         }
 562         tty->cr();
 563       }
 564     }
 565   }
 566   tty->print_cr(" %s %d: %d\n", "Number chains longer than",
 567                     results_length, out_of_range);
 568 }
 569 
 570 void SymbolTable::print() {
 571   for (int i = 0; i < the_table()->table_size(); ++i) {
 572     HashtableEntry<Symbol*, mtSymbol>** p = the_table()->bucket_addr(i);
 573     HashtableEntry<Symbol*, mtSymbol>* entry = the_table()->bucket(i);
 574     if (entry != NULL) {
 575       while (entry != NULL) {
 576         tty->print(PTR_FORMAT " ", entry->literal());
 577         entry->literal()->print();
 578         tty->print(" %d", entry->literal()->refcount());
 579         p = entry->next_addr();
 580         entry = (HashtableEntry<Symbol*, mtSymbol>*)HashtableEntry<Symbol*, mtSymbol>::make_ptr(*p);
 581       }
 582       tty->cr();
 583     }
 584   }
 585 }
 586 #endif // PRODUCT
 587 
 588 // --------------------------------------------------------------------------
 589 
 590 #ifdef ASSERT
 591 class StableMemoryChecker : public StackObj {
 592   enum { _bufsize = wordSize*4 };
 593 
 594   address _region;
 595   jint    _size;
 596   u1      _save_buf[_bufsize];
 597 
 598   int sample(u1* save_buf) {
 599     if (_size <= _bufsize) {
 600       memcpy(save_buf, _region, _size);
 601       return _size;
 602     } else {
 603       // copy head and tail
 604       memcpy(&save_buf[0],          _region,                      _bufsize/2);
 605       memcpy(&save_buf[_bufsize/2], _region + _size - _bufsize/2, _bufsize/2);
 606       return (_bufsize/2)*2;
 607     }
 608   }
 609 
 610  public:
 611   StableMemoryChecker(const void* region, jint size) {
 612     _region = (address) region;
 613     _size   = size;
 614     sample(_save_buf);
 615   }
 616 
 617   bool verify() {
 618     u1 check_buf[sizeof(_save_buf)];
 619     int check_size = sample(check_buf);
 620     return (0 == memcmp(_save_buf, check_buf, check_size));
 621   }
 622 
 623   void set_region(const void* region) { _region = (address) region; }
 624 };
 625 #endif
 626 
 627 
 628 // --------------------------------------------------------------------------
 629 StringTable* StringTable::_the_table = NULL;
 630 
 631 bool StringTable::_needs_rehashing = false;
 632 
 633 volatile int StringTable::_parallel_claimed_idx = 0;
 634 
 635 // Pick hashing algorithm
 636 unsigned int StringTable::hash_string(const jchar* s, int len) {
 637   return use_alternate_hashcode() ? AltHashing::murmur3_32(seed(), s, len) :
 638                                     java_lang_String::hash_code(s, len);
 639 }
 640 
 641 oop StringTable::lookup(int index, jchar* name,
 642                         int len, unsigned int hash) {
 643   int count = 0;
 644   for (HashtableEntry<oop, mtSymbol>* l = bucket(index); l != NULL; l = l->next()) {
 645     count++;
 646     if (l->hash() == hash) {
 647       if (java_lang_String::equals(l->literal(), name, len)) {
 648         return l->literal();
 649       }
 650     }
 651   }
 652   // If the bucket size is too deep check if this hash code is insufficient.
 653   if (count >= BasicHashtable<mtSymbol>::rehash_count && !needs_rehashing()) {
 654     _needs_rehashing = check_rehash_table(count);
 655   }
 656   return NULL;
 657 }
 658 
 659 
 660 oop StringTable::basic_add(int index_arg, Handle string, jchar* name,
 661                            int len, unsigned int hashValue_arg, TRAPS) {
 662 
 663   assert(java_lang_String::equals(string(), name, len),
 664          "string must be properly initialized");
 665   // Cannot hit a safepoint in this function because the "this" pointer can move.
 666   No_Safepoint_Verifier nsv;
 667 
 668   // Check if the symbol table has been rehashed, if so, need to recalculate
 669   // the hash value and index before second lookup.
 670   unsigned int hashValue;
 671   int index;
 672   if (use_alternate_hashcode()) {
 673     hashValue = hash_string(name, len);
 674     index = hash_to_index(hashValue);
 675   } else {
 676     hashValue = hashValue_arg;
 677     index = index_arg;
 678   }
 679 
 680   // Since look-up was done lock-free, we need to check if another
 681   // thread beat us in the race to insert the symbol.
 682 
 683   oop test = lookup(index, name, len, hashValue); // calls lookup(u1*, int)
 684   if (test != NULL) {
 685     // Entry already added
 686     return test;
 687   }
 688 
 689   HashtableEntry<oop, mtSymbol>* entry = new_entry(hashValue, string());
 690   add_entry(index, entry);
 691   return string();
 692 }
 693 
 694 
 695 oop StringTable::lookup(Symbol* symbol) {
 696   ResourceMark rm;
 697   int length;
 698   jchar* chars = symbol->as_unicode(length);
 699   return lookup(chars, length);
 700 }
 701 
 702 
 703 oop StringTable::lookup(jchar* name, int len) {
 704   unsigned int hash = hash_string(name, len);
 705   int index = the_table()->hash_to_index(hash);
 706   return the_table()->lookup(index, name, len, hash);
 707 }
 708 
 709 
 710 oop StringTable::intern(Handle string_or_null, jchar* name,
 711                         int len, TRAPS) {
 712   unsigned int hashValue = hash_string(name, len);
 713   int index = the_table()->hash_to_index(hashValue);
 714   oop found_string = the_table()->lookup(index, name, len, hashValue);
 715 
 716   // Found
 717   if (found_string != NULL) return found_string;
 718 
 719   debug_only(StableMemoryChecker smc(name, len * sizeof(name[0])));
 720   assert(!Universe::heap()->is_in_reserved(name),
 721          "proposed name of symbol must be stable");
 722 
 723   Handle string;
 724   // try to reuse the string if possible
 725   if (!string_or_null.is_null()) {
 726     string = string_or_null;
 727   } else {
 728     string = java_lang_String::create_from_unicode(name, len, CHECK_NULL);
 729   }
 730 
 731 #if INCLUDE_ALL_GCS
 732   if (G1StringDedup::is_enabled()) {
 733     // Deduplicate the string before it is interned. Note that we should never
 734     // deduplicate a string after it has been interned. Doing so will counteract
 735     // compiler optimizations done on e.g. interned string literals.
 736     G1StringDedup::deduplicate(string());
 737   }
 738 #endif
 739 
 740   // Grab the StringTable_lock before getting the_table() because it could
 741   // change at safepoint.
 742   MutexLocker ml(StringTable_lock, THREAD);
 743 
 744   // Otherwise, add to symbol to table
 745   return the_table()->basic_add(index, string, name, len,
 746                                 hashValue, CHECK_NULL);
 747 }
 748 
 749 oop StringTable::intern(Symbol* symbol, TRAPS) {
 750   if (symbol == NULL) return NULL;
 751   ResourceMark rm(THREAD);
 752   int length;
 753   jchar* chars = symbol->as_unicode(length);
 754   Handle string;
 755   oop result = intern(string, chars, length, CHECK_NULL);
 756   return result;
 757 }
 758 
 759 
 760 oop StringTable::intern(oop string, TRAPS)
 761 {
 762   if (string == NULL) return NULL;
 763   ResourceMark rm(THREAD);
 764   int length;
 765   Handle h_string (THREAD, string);
 766   jchar* chars = java_lang_String::as_unicode_string(string, length, CHECK_NULL);
 767   oop result = intern(h_string, chars, length, CHECK_NULL);
 768   return result;
 769 }
 770 
 771 
 772 oop StringTable::intern(const char* utf8_string, TRAPS) {
 773   if (utf8_string == NULL) return NULL;
 774   ResourceMark rm(THREAD);
 775   int length = UTF8::unicode_length(utf8_string);
 776   jchar* chars = NEW_RESOURCE_ARRAY(jchar, length);
 777   UTF8::convert_to_unicode(utf8_string, chars, length);
 778   Handle string;
 779   oop result = intern(string, chars, length, CHECK_NULL);
 780   return result;
 781 }
 782 
 783 void StringTable::unlink_or_oops_do(BoolObjectClosure* is_alive, OopClosure* f, int* processed, int* removed) {
 784   buckets_unlink_or_oops_do(is_alive, f, 0, the_table()->table_size(), processed, removed);
 785 }
 786 
 787 void StringTable::possibly_parallel_unlink_or_oops_do(BoolObjectClosure* is_alive, OopClosure* f, int* processed, int* removed) {
 788   // Readers of the table are unlocked, so we should only be removing
 789   // entries at a safepoint.
 790   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
 791   const int limit = the_table()->table_size();
 792 
 793   for (;;) {
 794     // Grab next set of buckets to scan
 795     int start_idx = Atomic::add(ClaimChunkSize, &_parallel_claimed_idx) - ClaimChunkSize;
 796     if (start_idx >= limit) {
 797       // End of table
 798       break;
 799     }
 800 
 801     int end_idx = MIN2(limit, start_idx + ClaimChunkSize);
 802     buckets_unlink_or_oops_do(is_alive, f, start_idx, end_idx, processed, removed);
 803   }
 804 }
 805 
 806 void StringTable::buckets_oops_do(OopClosure* f, int start_idx, int end_idx) {
 807   const int limit = the_table()->table_size();
 808 
 809   assert(0 <= start_idx && start_idx <= limit,
 810          err_msg("start_idx (%d) is out of bounds", start_idx));
 811   assert(0 <= end_idx && end_idx <= limit,
 812          err_msg("end_idx (%d) is out of bounds", end_idx));
 813   assert(start_idx <= end_idx,
 814          err_msg("Index ordering: start_idx=%d, end_idx=%d",
 815                  start_idx, end_idx));
 816 
 817   for (int i = start_idx; i < end_idx; i += 1) {
 818     HashtableEntry<oop, mtSymbol>* entry = the_table()->bucket(i);
 819     while (entry != NULL) {
 820       assert(!entry->is_shared(), "CDS not used for the StringTable");
 821 
 822       f->do_oop((oop*)entry->literal_addr());
 823 
 824       entry = entry->next();
 825     }
 826   }
 827 }
 828 
 829 void StringTable::buckets_unlink_or_oops_do(BoolObjectClosure* is_alive, OopClosure* f, int start_idx, int end_idx, int* processed, int* removed) {
 830   const int limit = the_table()->table_size();
 831 
 832   assert(0 <= start_idx && start_idx <= limit,
 833          err_msg("start_idx (%d) is out of bounds", start_idx));
 834   assert(0 <= end_idx && end_idx <= limit,
 835          err_msg("end_idx (%d) is out of bounds", end_idx));
 836   assert(start_idx <= end_idx,
 837          err_msg("Index ordering: start_idx=%d, end_idx=%d",
 838                  start_idx, end_idx));
 839 
 840   for (int i = start_idx; i < end_idx; ++i) {
 841     HashtableEntry<oop, mtSymbol>** p = the_table()->bucket_addr(i);
 842     HashtableEntry<oop, mtSymbol>* entry = the_table()->bucket(i);
 843     while (entry != NULL) {
 844       assert(!entry->is_shared(), "CDS not used for the StringTable");
 845 
 846       if (is_alive->do_object_b(entry->literal())) {
 847         if (f != NULL) {
 848           f->do_oop((oop*)entry->literal_addr());
 849         }
 850         p = entry->next_addr();
 851       } else {
 852         *p = entry->next();
 853         the_table()->free_entry(entry);
 854         (*removed)++;
 855       }
 856       (*processed)++;
 857       entry = *p;
 858     }
 859   }
 860 }
 861 
 862 void StringTable::oops_do(OopClosure* f) {
 863   buckets_oops_do(f, 0, the_table()->table_size());
 864 }
 865 
 866 void StringTable::possibly_parallel_oops_do(OopClosure* f) {
 867   const int limit = the_table()->table_size();
 868 
 869   for (;;) {
 870     // Grab next set of buckets to scan
 871     int start_idx = Atomic::add(ClaimChunkSize, &_parallel_claimed_idx) - ClaimChunkSize;
 872     if (start_idx >= limit) {
 873       // End of table
 874       break;
 875     }
 876 
 877     int end_idx = MIN2(limit, start_idx + ClaimChunkSize);
 878     buckets_oops_do(f, start_idx, end_idx);
 879   }
 880 }
 881 
 882 // This verification is part of Universe::verify() and needs to be quick.
 883 // See StringTable::verify_and_compare() below for exhaustive verification.
 884 void StringTable::verify() {
 885   for (int i = 0; i < the_table()->table_size(); ++i) {
 886     HashtableEntry<oop, mtSymbol>* p = the_table()->bucket(i);
 887     for ( ; p != NULL; p = p->next()) {
 888       oop s = p->literal();
 889       guarantee(s != NULL, "interned string is NULL");
 890       unsigned int h = java_lang_String::hash_string(s);
 891       guarantee(p->hash() == h, "broken hash in string table entry");
 892       guarantee(the_table()->hash_to_index(h) == i,
 893                 "wrong index in string table");
 894     }
 895   }
 896 }
 897 
 898 void StringTable::dump(outputStream* st) {
 899   the_table()->dump_table(st, "StringTable");
 900 }
 901 
 902 StringTable::VerifyRetTypes StringTable::compare_entries(
 903                                       int bkt1, int e_cnt1,
 904                                       HashtableEntry<oop, mtSymbol>* e_ptr1,
 905                                       int bkt2, int e_cnt2,
 906                                       HashtableEntry<oop, mtSymbol>* e_ptr2) {
 907   // These entries are sanity checked by verify_and_compare_entries()
 908   // before this function is called.
 909   oop str1 = e_ptr1->literal();
 910   oop str2 = e_ptr2->literal();
 911 
 912   if (str1 == str2) {
 913     tty->print_cr("ERROR: identical oop values (0x" PTR_FORMAT ") "
 914                   "in entry @ bucket[%d][%d] and entry @ bucket[%d][%d]",
 915                   (void *)str1, bkt1, e_cnt1, bkt2, e_cnt2);
 916     return _verify_fail_continue;
 917   }
 918 
 919   if (java_lang_String::equals(str1, str2)) {
 920     tty->print_cr("ERROR: identical String values in entry @ "
 921                   "bucket[%d][%d] and entry @ bucket[%d][%d]",
 922                   bkt1, e_cnt1, bkt2, e_cnt2);
 923     return _verify_fail_continue;
 924   }
 925 
 926   return _verify_pass;
 927 }
 928 
 929 StringTable::VerifyRetTypes StringTable::verify_entry(int bkt, int e_cnt,
 930                                       HashtableEntry<oop, mtSymbol>* e_ptr,
 931                                       StringTable::VerifyMesgModes mesg_mode) {
 932 
 933   VerifyRetTypes ret = _verify_pass;  // be optimistic
 934 
 935   oop str = e_ptr->literal();
 936   if (str == NULL) {
 937     if (mesg_mode == _verify_with_mesgs) {
 938       tty->print_cr("ERROR: NULL oop value in entry @ bucket[%d][%d]", bkt,
 939                     e_cnt);
 940     }
 941     // NULL oop means no more verifications are possible
 942     return _verify_fail_done;
 943   }
 944 
 945   if (str->klass() != SystemDictionary::String_klass()) {
 946     if (mesg_mode == _verify_with_mesgs) {
 947       tty->print_cr("ERROR: oop is not a String in entry @ bucket[%d][%d]",
 948                     bkt, e_cnt);
 949     }
 950     // not a String means no more verifications are possible
 951     return _verify_fail_done;
 952   }
 953 
 954   unsigned int h = java_lang_String::hash_string(str);
 955   if (e_ptr->hash() != h) {
 956     if (mesg_mode == _verify_with_mesgs) {
 957       tty->print_cr("ERROR: broken hash value in entry @ bucket[%d][%d], "
 958                     "bkt_hash=%d, str_hash=%d", bkt, e_cnt, e_ptr->hash(), h);
 959     }
 960     ret = _verify_fail_continue;
 961   }
 962 
 963   if (the_table()->hash_to_index(h) != bkt) {
 964     if (mesg_mode == _verify_with_mesgs) {
 965       tty->print_cr("ERROR: wrong index value for entry @ bucket[%d][%d], "
 966                     "str_hash=%d, hash_to_index=%d", bkt, e_cnt, h,
 967                     the_table()->hash_to_index(h));
 968     }
 969     ret = _verify_fail_continue;
 970   }
 971 
 972   return ret;
 973 }
 974 
 975 // See StringTable::verify() above for the quick verification that is
 976 // part of Universe::verify(). This verification is exhaustive and
 977 // reports on every issue that is found. StringTable::verify() only
 978 // reports on the first issue that is found.
 979 //
 980 // StringTable::verify_entry() checks:
 981 // - oop value != NULL (same as verify())
 982 // - oop value is a String
 983 // - hash(String) == hash in entry (same as verify())
 984 // - index for hash == index of entry (same as verify())
 985 //
 986 // StringTable::compare_entries() checks:
 987 // - oops are unique across all entries
 988 // - String values are unique across all entries
 989 //
 990 int StringTable::verify_and_compare_entries() {
 991   assert(StringTable_lock->is_locked(), "sanity check");
 992 
 993   int  fail_cnt = 0;
 994 
 995   // first, verify all the entries individually:
 996   for (int bkt = 0; bkt < the_table()->table_size(); bkt++) {
 997     HashtableEntry<oop, mtSymbol>* e_ptr = the_table()->bucket(bkt);
 998     for (int e_cnt = 0; e_ptr != NULL; e_ptr = e_ptr->next(), e_cnt++) {
 999       VerifyRetTypes ret = verify_entry(bkt, e_cnt, e_ptr, _verify_with_mesgs);
1000       if (ret != _verify_pass) {
1001         fail_cnt++;
1002       }
1003     }
1004   }
1005 
1006   // Optimization: if the above check did not find any failures, then
1007   // the comparison loop below does not need to call verify_entry()
1008   // before calling compare_entries(). If there were failures, then we
1009   // have to call verify_entry() to see if the entry can be passed to
1010   // compare_entries() safely. When we call verify_entry() in the loop
1011   // below, we do so quietly to void duplicate messages and we don't
1012   // increment fail_cnt because the failures have already been counted.
1013   bool need_entry_verify = (fail_cnt != 0);
1014 
1015   // second, verify all entries relative to each other:
1016   for (int bkt1 = 0; bkt1 < the_table()->table_size(); bkt1++) {
1017     HashtableEntry<oop, mtSymbol>* e_ptr1 = the_table()->bucket(bkt1);
1018     for (int e_cnt1 = 0; e_ptr1 != NULL; e_ptr1 = e_ptr1->next(), e_cnt1++) {
1019       if (need_entry_verify) {
1020         VerifyRetTypes ret = verify_entry(bkt1, e_cnt1, e_ptr1,
1021                                           _verify_quietly);
1022         if (ret == _verify_fail_done) {
1023           // cannot use the current entry to compare against other entries
1024           continue;
1025         }
1026       }
1027 
1028       for (int bkt2 = bkt1; bkt2 < the_table()->table_size(); bkt2++) {
1029         HashtableEntry<oop, mtSymbol>* e_ptr2 = the_table()->bucket(bkt2);
1030         int e_cnt2;
1031         for (e_cnt2 = 0; e_ptr2 != NULL; e_ptr2 = e_ptr2->next(), e_cnt2++) {
1032           if (bkt1 == bkt2 && e_cnt2 <= e_cnt1) {
1033             // skip the entries up to and including the one that
1034             // we're comparing against
1035             continue;
1036           }
1037 
1038           if (need_entry_verify) {
1039             VerifyRetTypes ret = verify_entry(bkt2, e_cnt2, e_ptr2,
1040                                               _verify_quietly);
1041             if (ret == _verify_fail_done) {
1042               // cannot compare against this entry
1043               continue;
1044             }
1045           }
1046 
1047           // compare two entries, report and count any failures:
1048           if (compare_entries(bkt1, e_cnt1, e_ptr1, bkt2, e_cnt2, e_ptr2)
1049               != _verify_pass) {
1050             fail_cnt++;
1051           }
1052         }
1053       }
1054     }
1055   }
1056   return fail_cnt;
1057 }
1058 
1059 // Create a new table and using alternate hash code, populate the new table
1060 // with the existing strings.   Set flag to use the alternate hash code afterwards.
1061 void StringTable::rehash_table() {
1062   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
1063   // This should never happen with -Xshare:dump but it might in testing mode.
1064   if (DumpSharedSpaces) return;
1065   StringTable* new_table = new StringTable();
1066 
1067   // Rehash the table
1068   the_table()->move_to(new_table);
1069 
1070   // Delete the table and buckets (entries are reused in new table).
1071   delete _the_table;
1072   // Don't check if we need rehashing until the table gets unbalanced again.
1073   // Then rehash with a new global seed.
1074   _needs_rehashing = false;
1075   _the_table = new_table;
1076 }