jdk8-mips64-public/hotspot: src/share/vm/gc_implementation/g1/g1ErgoVerbose.hpp@c2844108a708 (annotated)

src/share/vm/gc_implementation/g1/g1ErgoVerbose.hpp@c2844108a708 (annotated)

src/share/vm/gc_implementation/g1/g1ErgoVerbose.hpp

Thu, 23 Oct 2014 12:02:08 -0700

author: asaha
date: Thu, 23 Oct 2014 12:02:08 -0700
changeset 7476: c2844108a708
parent 3998: 7383557659bd
child 6876: 710a3c8b516e
child 9327: f96fcd9e1e1b
permissions: -rw-r--r--

Merge

 /*
  * Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.
  *
  * This code is distributed in the hope that it will be useful, but WITHOUT
  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  * version 2 for more details (a copy is included in the LICENSE file that
  * accompanied this code).
  *
  * You should have received a copy of the GNU General Public License version
  * 2 along with this work; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  *
  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  * or visit www.oracle.com if you need additional information or have any
  * questions.
  *
  */
 #ifndef SHARE_VM_GC_IMPLEMENTATION_G1_G1ERGOVERBOSE_HPP
 #define SHARE_VM_GC_IMPLEMENTATION_G1_G1ERGOVERBOSE_HPP
 #include "memory/allocation.hpp"
 #include "utilities/debug.hpp"
 // The log of G1's heuristic decisions comprises of a series of
 // records which have a similar format in order to maintain
 // consistency across records and ultimately easier parsing of the
 // output, if we ever choose to do that. Each record consists of:
 // * A time stamp to be able to easily correlate each record with
 // other events.
 // * A unique string to allow us to easily identify such records.
 // * The name of the heuristic the record corresponds to.
 // * An action string which describes the action that G1 did or is
 // about to do.
 // * An optional reason string which describes the reason for the
 // action.
 // * An optional number of name/value pairs which contributed to the
 // decision to take the action described in the record.
 //
 // Each record is associated with a "tag" which is the combination of
 // the heuristic the record corresponds to, as well as the min level
 // of verboseness at which the record should be printed. The tag is
 // checked against the current settings to determine whether the record
 // should be printed or not.
 // The available verboseness levels.
 typedef enum {
   // Determine which part of the tag is occupied by the level.
   ErgoLevelShift = 8,
   ErgoLevelMask = ~((1 << ErgoLevelShift) - 1),
   // ErgoLow is 0 so that we don't have to explicitly or a heuristic
   // id with ErgoLow to keep its use simpler.
   ErgoLow = 0,
   ErgoHigh = 1 << ErgoLevelShift
 } ErgoLevel;
 // The available heuristics.
 typedef enum {
   // Determines which part of the tag is occupied by the heuristic id.
   ErgoHeuristicMask = ~ErgoLevelMask,
   ErgoHeapSizing = 0,
   ErgoCSetConstruction,
   ErgoConcCycles,
   ErgoMixedGCs,
   ErgoHeuristicNum
 } ErgoHeuristic;
 class G1ErgoVerbose : AllStatic {
 private:
   // Determines the minimum verboseness level at which records will be
   // printed.
   static ErgoLevel _level;
   // Determines which heuristics are currently enabled.
   static bool _enabled[ErgoHeuristicNum];
   static ErgoLevel extract_level(int tag) {
     return (ErgoLevel) (tag & ErgoLevelMask);
   }
   static ErgoHeuristic extract_heuristic(int tag) {
     return (ErgoHeuristic) (tag & ErgoHeuristicMask);
   }
 public:
   // Needs to be explicitly called at GC initialization.
   static void initialize();
   static void set_level(ErgoLevel level);
   static void set_enabled(ErgoHeuristic h, bool enabled);
   // It is applied to all heuristics.
   static void set_enabled(bool enabled);
   static bool enabled(int tag) {
     ErgoLevel level = extract_level(tag);
     ErgoHeuristic n = extract_heuristic(tag);
     return level <= _level && _enabled[n];
   }
   // Extract the heuristic id from the tag and return a string with
   // its name.
   static const char* to_string(int tag);
 };
 // The macros below generate the format string for values of different
 // types and/or metrics.
 // The reason for the action is optional and is handled specially: the
 // reason string is concatenated here so it's not necessary to pass it
 // as a parameter.
 #define ergo_format_reason(_reason_) ", reason: " _reason_
 // Single parameter format strings
 #define ergo_format_str(_name_)      ", " _name_ ": %s"
 #define ergo_format_region(_name_)   ", " _name_ ": %u regions"
 #define ergo_format_byte(_name_)     ", " _name_ ": "SIZE_FORMAT" bytes"
 #define ergo_format_double(_name_)   ", " _name_ ": %1.2f"
 #define ergo_format_perc(_name_)     ", " _name_ ": %1.2f %%"
 #define ergo_format_ms(_name_)       ", " _name_ ": %1.2f ms"
 #define ergo_format_size(_name_)     ", " _name_ ": "SIZE_FORMAT
 // Double parameter format strings
 #define ergo_format_byte_perc(_name_)                                   \
                              ", " _name_ ": "SIZE_FORMAT" bytes (%1.2f %%)"
 // Generates the format string
 #define ergo_format(_extra_format_)                           \
   " %1.3f: [G1Ergonomics (%s) %s" _extra_format_ "]"
 // Conditionally, prints an ergonomic decision record. _extra_format_
 // is the format string for the optional items we'd like to print
 // (i.e., the decision's reason and any associated values). This
 // string should be built up using the ergo_*_format macros (see
 // above) to ensure consistency.
 //
 // Since we cannot rely on the compiler supporting variable argument
 // macros, this macro accepts a fixed number of arguments and passes
 // them to the print method. For convenience, we have wrapper macros
 // below which take a specific number of arguments and set the rest to
 // a default value.
 #define ergo_verbose_common(_tag_, _action_, _extra_format_,                \
                             _arg0_, _arg1_, _arg2_, _arg3_, _arg4_, _arg5_) \
   do {                                                                      \
     if (G1ErgoVerbose::enabled((_tag_))) {                                  \
       gclog_or_tty->print_cr(ergo_format(_extra_format_),                   \
                              os::elapsedTime(),                             \
                              G1ErgoVerbose::to_string((_tag_)),             \
                              (_action_),                                    \
                              (_arg0_), (_arg1_), (_arg2_),                  \
                              (_arg3_), (_arg4_), (_arg5_));                 \
     }                                                                       \
   } while (0)
 #define ergo_verbose(_tag_, _action_)                                   \
   ergo_verbose_common(_tag_, _action_, "", 0, 0, 0, 0, 0, 0)
 #define ergo_verbose0(_tag_, _action_, _extra_format_)                  \
   ergo_verbose_common(_tag_, _action_, _extra_format_, 0, 0, 0, 0, 0, 0)
 #define ergo_verbose1(_tag_, _action_, _extra_format_,                  \
                       _arg0_)                                           \
   ergo_verbose_common(_tag_, _action_, _extra_format_,                  \
                       _arg0_, 0, 0, 0, 0, 0)
 #define ergo_verbose2(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_)                                   \
   ergo_verbose_common(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, 0, 0, 0, 0)
 #define ergo_verbose3(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_)                           \
   ergo_verbose_common(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_, 0, 0, 0)
 #define ergo_verbose4(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_, _arg3_)                   \
   ergo_verbose_common(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_, _arg3_, 0, 0)
 #define ergo_verbose5(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_, _arg3_, _arg4_)           \
   ergo_verbose_common(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_, _arg3_, _arg4_, 0)
 #define ergo_verbose6(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_, _arg3_, _arg4_, _arg5_)   \
   ergo_verbose_common(_tag_, _action_, _extra_format_,                  \
                       _arg0_, _arg1_, _arg2_, _arg3_, _arg4_, _arg5_)
 #endif // SHARE_VM_GC_IMPLEMENTATION_G1_G1ERGOVERBOSE_HPP

Mercurial > jdk8-mips64-public > hotspot / annotate

src/share/vm/gc_implementation/g1/g1ErgoVerbose.hpp@c2844108a708 (annotated)

src/share/vm/gc_implementation/g1/g1ErgoVerbose.hpp