annotate src/share/vm/memory/freeBlockDictionary.hpp @ 6026:9f059abe8cf2

7131629: Generalize the CMS free list code Summary: Make the FreeChunk, FreeList, TreeList, and BinaryTreeDictionary classes usable outside CMS. Reviewed-by: brutisso, johnc, jwilhelm Contributed-by: coleen.phillimore@oracle.com
author jmasa
date Thu, 29 Mar 2012 19:46:24 -0700
parents src/share/vm/gc_implementation/concurrentMarkSweep/freeBlockDictionary.hpp@f95d63e2154a
children f69a5d43dc19
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
2 * Copyright (c) 2001, 2012, Oracle and/or its affiliates. All rights reserved.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a61af66fc99e Initial load
duke
parents:
diff changeset
4 *
a61af66fc99e Initial load
duke
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
a61af66fc99e Initial load
duke
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
a61af66fc99e Initial load
duke
parents:
diff changeset
7 * published by the Free Software Foundation.
a61af66fc99e Initial load
duke
parents:
diff changeset
8 *
a61af66fc99e Initial load
duke
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
a61af66fc99e Initial load
duke
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a61af66fc99e Initial load
duke
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
a61af66fc99e Initial load
duke
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
a61af66fc99e Initial load
duke
parents:
diff changeset
13 * accompanied this code).
a61af66fc99e Initial load
duke
parents:
diff changeset
14 *
a61af66fc99e Initial load
duke
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
a61af66fc99e Initial load
duke
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
a61af66fc99e Initial load
duke
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a61af66fc99e Initial load
duke
parents:
diff changeset
18 *
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 1145
diff changeset
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 1145
diff changeset
20 * or visit www.oracle.com if you need additional information or have any
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 1145
diff changeset
21 * questions.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
22 *
a61af66fc99e Initial load
duke
parents:
diff changeset
23 */
a61af66fc99e Initial load
duke
parents:
diff changeset
24
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
25 #ifndef SHARE_VM_MEMORY_FREEBLOCKDICTIONARY_HPP
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
26 #define SHARE_VM_MEMORY_FREEBLOCKDICTIONARY_HPP
1972
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
27
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
28 #include "memory/allocation.hpp"
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
29 #include "runtime/mutex.hpp"
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
30 #include "utilities/debug.hpp"
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
31 #include "utilities/globalDefinitions.hpp"
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
32 #include "utilities/ostream.hpp"
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
33
0
a61af66fc99e Initial load
duke
parents:
diff changeset
34 // A FreeBlockDictionary is an abstract superclass that will allow
a61af66fc99e Initial load
duke
parents:
diff changeset
35 // a number of alternative implementations in the future.
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
36 template <class Chunk>
0
a61af66fc99e Initial load
duke
parents:
diff changeset
37 class FreeBlockDictionary: public CHeapObj {
a61af66fc99e Initial load
duke
parents:
diff changeset
38 public:
a61af66fc99e Initial load
duke
parents:
diff changeset
39 enum Dither {
a61af66fc99e Initial load
duke
parents:
diff changeset
40 atLeast,
a61af66fc99e Initial load
duke
parents:
diff changeset
41 exactly,
a61af66fc99e Initial load
duke
parents:
diff changeset
42 roughly
a61af66fc99e Initial load
duke
parents:
diff changeset
43 };
a61af66fc99e Initial load
duke
parents:
diff changeset
44 enum DictionaryChoice {
a61af66fc99e Initial load
duke
parents:
diff changeset
45 dictionaryBinaryTree = 0,
a61af66fc99e Initial load
duke
parents:
diff changeset
46 dictionarySplayTree = 1,
a61af66fc99e Initial load
duke
parents:
diff changeset
47 dictionarySkipList = 2
a61af66fc99e Initial load
duke
parents:
diff changeset
48 };
a61af66fc99e Initial load
duke
parents:
diff changeset
49
a61af66fc99e Initial load
duke
parents:
diff changeset
50 private:
a61af66fc99e Initial load
duke
parents:
diff changeset
51 NOT_PRODUCT(Mutex* _lock;)
a61af66fc99e Initial load
duke
parents:
diff changeset
52
a61af66fc99e Initial load
duke
parents:
diff changeset
53 public:
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
54 virtual void removeChunk(Chunk* fc) = 0;
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
55 virtual Chunk* getChunk(size_t size, Dither dither = atLeast) = 0;
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
56 virtual void returnChunk(Chunk* chunk) = 0;
0
a61af66fc99e Initial load
duke
parents:
diff changeset
57 virtual size_t totalChunkSize(debug_only(const Mutex* lock)) const = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
58 virtual size_t maxChunkSize() const = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
59 virtual size_t minSize() const = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
60 // Reset the dictionary to the initial conditions for a single
a61af66fc99e Initial load
duke
parents:
diff changeset
61 // block.
a61af66fc99e Initial load
duke
parents:
diff changeset
62 virtual void reset(HeapWord* addr, size_t size) = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
63 virtual void reset() = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
64
a61af66fc99e Initial load
duke
parents:
diff changeset
65 virtual void dictCensusUpdate(size_t size, bool split, bool birth) = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
66 virtual bool coalDictOverPopulated(size_t size) = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
67 virtual void beginSweepDictCensus(double coalSurplusPercent,
1145
e018e6884bd8 6631166: CMS: better heuristics when combatting fragmentation
ysr
parents: 269
diff changeset
68 float inter_sweep_current, float inter_sweep_estimate,
e018e6884bd8 6631166: CMS: better heuristics when combatting fragmentation
ysr
parents: 269
diff changeset
69 float intra__sweep_current) = 0;
0
a61af66fc99e Initial load
duke
parents:
diff changeset
70 virtual void endSweepDictCensus(double splitSurplusPercent) = 0;
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
71 virtual Chunk* findLargestDict() const = 0;
0
a61af66fc99e Initial load
duke
parents:
diff changeset
72 // verify that the given chunk is in the dictionary.
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
73 virtual bool verifyChunkInFreeLists(Chunk* tc) const = 0;
0
a61af66fc99e Initial load
duke
parents:
diff changeset
74
a61af66fc99e Initial load
duke
parents:
diff changeset
75 // Sigma_{all_free_blocks} (block_size^2)
a61af66fc99e Initial load
duke
parents:
diff changeset
76 virtual double sum_of_squared_block_sizes() const = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
77
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
78 virtual Chunk* find_chunk_ends_at(HeapWord* target) const = 0;
0
a61af66fc99e Initial load
duke
parents:
diff changeset
79 virtual void inc_totalSize(size_t v) = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
80 virtual void dec_totalSize(size_t v) = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
81
a61af66fc99e Initial load
duke
parents:
diff changeset
82 NOT_PRODUCT (
a61af66fc99e Initial load
duke
parents:
diff changeset
83 virtual size_t sumDictReturnedBytes() = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
84 virtual void initializeDictReturnedBytes() = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
85 virtual size_t totalCount() = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
86 )
a61af66fc99e Initial load
duke
parents:
diff changeset
87
a61af66fc99e Initial load
duke
parents:
diff changeset
88 virtual void reportStatistics() const {
a61af66fc99e Initial load
duke
parents:
diff changeset
89 gclog_or_tty->print("No statistics available");
a61af66fc99e Initial load
duke
parents:
diff changeset
90 }
a61af66fc99e Initial load
duke
parents:
diff changeset
91
a61af66fc99e Initial load
duke
parents:
diff changeset
92 virtual void printDictCensus() const = 0;
1145
e018e6884bd8 6631166: CMS: better heuristics when combatting fragmentation
ysr
parents: 269
diff changeset
93 virtual void print_free_lists(outputStream* st) const = 0;
0
a61af66fc99e Initial load
duke
parents:
diff changeset
94
a61af66fc99e Initial load
duke
parents:
diff changeset
95 virtual void verify() const = 0;
a61af66fc99e Initial load
duke
parents:
diff changeset
96
a61af66fc99e Initial load
duke
parents:
diff changeset
97 Mutex* par_lock() const PRODUCT_RETURN0;
a61af66fc99e Initial load
duke
parents:
diff changeset
98 void set_par_lock(Mutex* lock) PRODUCT_RETURN;
a61af66fc99e Initial load
duke
parents:
diff changeset
99 void verify_par_locked() const PRODUCT_RETURN;
a61af66fc99e Initial load
duke
parents:
diff changeset
100 };
1972
f95d63e2154a 6989984: Use standard include model for Hospot
stefank
parents: 1552
diff changeset
101
6026
9f059abe8cf2 7131629: Generalize the CMS free list code
jmasa
parents: 1972
diff changeset
102 #endif // SHARE_VM_MEMORY_FREEBLOCKDICTIONARY_HPP