/*

 * Copyright (c) 2012, 2019, 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_GC_SHARED_GCTRACE_HPP

#define SHARE_GC_SHARED_GCTRACE_HPP

#include "gc/shared/copyFailedInfo.hpp"

#include "gc/shared/gcCause.hpp"

#include "gc/shared/gcId.hpp"

#include "gc/shared/gcName.hpp"

#include "gc/shared/gcWhen.hpp"

#include "memory/referenceType.hpp"

#include "utilities/macros.hpp"

#include "utilities/ticks.hpp"

class GCHeapSummary;

class MetaspaceChunkFreeListSummary;

class MetaspaceSummary;

class PSHeapSummary;

class ReferenceProcessorStats;

class TimePartitions;

class BoolObjectClosure;

class SharedGCInfo {

 private:

  GCName _name;

  GCCause::Cause _cause;

  Ticks     _start_timestamp;

  Ticks     _end_timestamp;

  Tickspan  _sum_of_pauses;

  Tickspan  _longest_pause;

 public:

  SharedGCInfo(GCName name) :

    _name(name),

    _cause(GCCause::_last_gc_cause),

    _start_timestamp(),

    _end_timestamp(),

    _sum_of_pauses(),

    _longest_pause() {

  }

  void set_start_timestamp(const Ticks& timestamp) { _start_timestamp = timestamp; }

  const Ticks start_timestamp() const { return _start_timestamp; }

  void set_end_timestamp(const Ticks& timestamp) { _end_timestamp = timestamp; }

  const Ticks end_timestamp() const { return _end_timestamp; }

  void set_name(GCName name) { _name = name; }

  GCName name() const { return _name; }

  void set_cause(GCCause::Cause cause) { _cause = cause; }

  GCCause::Cause cause() const { return _cause; }

  void set_sum_of_pauses(const Tickspan& duration) { _sum_of_pauses = duration; }

  const Tickspan sum_of_pauses() const { return _sum_of_pauses; }

  void set_longest_pause(const Tickspan& duration) { _longest_pause = duration; }

  const Tickspan longest_pause() const { return _longest_pause; }

};

class ParallelOldGCInfo {

  void* _dense_prefix;

 public:

  ParallelOldGCInfo() : _dense_prefix(NULL) {}

  void report_dense_prefix(void* addr) {

    _dense_prefix = addr;

  }

  void* dense_prefix() const { return _dense_prefix; }

};

class GCTracer : public ResourceObj {

 protected:

  SharedGCInfo _shared_gc_info;

 public:

  void report_gc_start(GCCause::Cause cause, const Ticks& timestamp);

  void report_gc_end(const Ticks& timestamp, TimePartitions* time_partitions);

  void report_gc_heap_summary(GCWhen::Type when, const GCHeapSummary& heap_summary) const;

  void report_metaspace_summary(GCWhen::Type when, const MetaspaceSummary& metaspace_summary) const;

  void report_gc_reference_stats(const ReferenceProcessorStats& rp) const;

  void report_object_count_after_gc(BoolObjectClosure* object_filter) NOT_SERVICES_RETURN;

 protected:

  GCTracer(GCName name) : _shared_gc_info(name) {}

  virtual void report_gc_start_impl(GCCause::Cause cause, const Ticks& timestamp);

  virtual void report_gc_end_impl(const Ticks& timestamp, TimePartitions* time_partitions);

 private:

  void send_garbage_collection_event() const;

  void send_gc_heap_summary_event(GCWhen::Type when, const GCHeapSummary& heap_summary) const;

  void send_meta_space_summary_event(GCWhen::Type when, const MetaspaceSummary& meta_space_summary) const;

  void send_reference_stats_event(ReferenceType type, size_t count) const;

  void send_phase_events(TimePartitions* time_partitions) const;

};

class YoungGCTracer : public GCTracer {

  static const uint UNSET_TENURING_THRESHOLD = (uint) -1;

  uint _tenuring_threshold;

 protected:

  YoungGCTracer(GCName name) : GCTracer(name), _tenuring_threshold(UNSET_TENURING_THRESHOLD) {}

  virtual void report_gc_end_impl(const Ticks& timestamp, TimePartitions* time_partitions);

 public:

  void report_promotion_failed(const PromotionFailedInfo& pf_info) const;

  void report_tenuring_threshold(const uint tenuring_threshold);

  /*

   * Methods for reporting Promotion in new or outside PLAB Events.

   *

   * The object age is always required as it is not certain that the mark word

   * of the oop can be trusted at this stage.

   *

   * obj_size is the size of the promoted object in bytes.

   *

   * tenured should be true if the object has been promoted to the old

   * space during this GC, if the object is copied to survivor space

   * from young space or survivor space (aging) tenured should be false.

   *

   * plab_size is the size of the newly allocated PLAB in bytes.

   */

  bool should_report_promotion_events() const;

  bool should_report_promotion_in_new_plab_event() const;

  bool should_report_promotion_outside_plab_event() const;

  void report_promotion_in_new_plab_event(Klass* klass, size_t obj_size,

                                          uint age, bool tenured,

                                          size_t plab_size) const;

  void report_promotion_outside_plab_event(Klass* klass, size_t obj_size,

                                           uint age, bool tenured) const;

 private:

  void send_young_gc_event() const;

  void send_promotion_failed_event(const PromotionFailedInfo& pf_info) const;

  bool should_send_promotion_in_new_plab_event() const;

  bool should_send_promotion_outside_plab_event() const;

  void send_promotion_in_new_plab_event(Klass* klass, size_t obj_size,

                                        uint age, bool tenured,

                                        size_t plab_size) const;

  void send_promotion_outside_plab_event(Klass* klass, size_t obj_size,

                                         uint age, bool tenured) const;

};

class OldGCTracer : public GCTracer {

 protected:

  OldGCTracer(GCName name) : GCTracer(name) {}

  virtual void report_gc_end_impl(const Ticks& timestamp, TimePartitions* time_partitions);

 public:

  void report_concurrent_mode_failure();

 private:

  void send_old_gc_event() const;

  void send_concurrent_mode_failure_event();

};

class ParallelOldTracer : public OldGCTracer {

  ParallelOldGCInfo _parallel_old_gc_info;

 public:

  ParallelOldTracer() : OldGCTracer(ParallelOld) {}

  void report_dense_prefix(void* dense_prefix);

 protected:

  void report_gc_end_impl(const Ticks& timestamp, TimePartitions* time_partitions);

 private:

  void send_parallel_old_event() const;

};

class SerialOldTracer : public OldGCTracer {

 public:

  SerialOldTracer() : OldGCTracer(SerialOld) {}

};

class ParallelScavengeTracer : public YoungGCTracer {

 public:

  ParallelScavengeTracer() : YoungGCTracer(ParallelScavenge) {}

};

class DefNewTracer : public YoungGCTracer {

 public:

  DefNewTracer() : YoungGCTracer(DefNew) {}

};

class ParNewTracer : public YoungGCTracer {

 public:

  ParNewTracer() : YoungGCTracer(ParNew) {}

};

class CMSTracer : public OldGCTracer {

 public:

  CMSTracer() : OldGCTracer(ConcurrentMarkSweep) {}

};

#endif // SHARE_GC_SHARED_GCTRACE_HPP