1 /* 2 * Copyright (c) 2002, 2012, 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 #ifndef SHARE_VM_GC_INTERFACE_GCCAUSE_HPP 26 #define SHARE_VM_GC_INTERFACE_GCCAUSE_HPP 27 28 #include "memory/allocation.hpp" 29 30 // 31 // This class exposes implementation details of the various 32 // collector(s), and we need to be very careful with it. If 33 // use of this class grows, we should split it into public 34 // and implementation-private "causes". 35 // 36 37 class GCCause : public AllStatic { 38 public: 39 enum Cause { 40 /* public */ 41 _java_lang_system_gc, 42 _full_gc_alot, 43 _scavenge_alot, 44 _allocation_profiler, 45 _jvmti_force_gc, 46 _gc_locker, 47 _heap_inspection, 48 _heap_dump, 49 50 /* implementation independent, but reserved for GC use */ 51 _no_gc, 52 _no_cause_specified, 53 _allocation_failure, 54 55 /* implementation specific */ 56 57 _tenured_generation_full, 58 _metadata_GC_threshold, 59 60 _cms_generation_full, 61 _cms_initial_mark, 62 _cms_final_remark, 63 _cms_concurrent_mark, 64 65 _old_generation_expanded_on_last_scavenge, 66 _old_generation_too_full_to_scavenge, 67 _adaptive_size_policy, 68 69 _g1_inc_collection_pause, 70 _g1_humongous_allocation, 71 72 _last_ditch_collection, 73 _last_gc_cause 74 }; 75 76 inline static bool is_user_requested_gc(GCCause::Cause cause) { 77 return (cause == GCCause::_java_lang_system_gc || 78 cause == GCCause::_jvmti_force_gc); 79 } 80 81 inline static bool is_serviceability_requested_gc(GCCause::Cause 82 cause) { 83 return (cause == GCCause::_jvmti_force_gc || 84 cause == GCCause::_heap_inspection || 85 cause == GCCause::_heap_dump); 86 } 87 88 // Return a string describing the GCCause. 89 static const char* to_string(GCCause::Cause cause); 90 }; 91 92 // Helper class for doing logging that includes the GC Cause 93 // as a string. 94 class GCCauseString : StackObj { 95 private: 96 static const int _length = 128; 97 char _buffer[_length]; 98 int _position; 99 100 public: 101 GCCauseString(const char* prefix, GCCause::Cause cause) { 102 if (PrintGCCause) { 103 _position = jio_snprintf(_buffer, _length, "%s (%s) ", prefix, GCCause::to_string(cause)); 104 } else { 105 _position = jio_snprintf(_buffer, _length, "%s ", prefix); 106 } 107 assert(_position >= 0 && _position <= _length, 108 err_msg("Need to increase the buffer size in GCCauseString? %d", _position)); 109 } 110 111 GCCauseString& append(const char* str) { 112 int res = jio_snprintf(_buffer + _position, _length - _position, "%s", str); 113 _position += res; 114 assert(res >= 0 && _position <= _length, 115 err_msg("Need to increase the buffer size in GCCauseString? %d", res)); 116 return *this; 117 } 118 119 operator const char*() { 120 return _buffer; 121 } 122 }; 123 124 #endif // SHARE_VM_GC_INTERFACE_GCCAUSE_HPP