ConcurrentPhaseStatsBase.hpp

/*******************************************************************************
 * Copyright IBM Corp. and others 1991
 *
 * This program and the accompanying materials are made available under
 * the terms of the Eclipse Public License 2.0 which accompanies this
 * distribution and is available at https://www.eclipse.org/legal/epl-2.0/
 * or the Apache License, Version 2.0 which accompanies this distribution and
 * is available at https://www.apache.org/licenses/LICENSE-2.0.
 *
 * This Source Code may also be made available under the following
 * Secondary Licenses when the conditions for such availability set
 * forth in the Eclipse Public License, v. 2.0 are satisfied: GNU
 * General Public License, version 2 with the GNU Classpath
 * Exception [1] and GNU General Public License, version 2 with the
 * OpenJDK Assembly Exception [2].
 *
 * [1] https://www.gnu.org/software/classpath/license.html
 * [2] https://openjdk.org/legal/assembly-exception.html
 *
 * SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0 OR GPL-2.0-only WITH OpenJDK-assembly-exception-1.0
 *******************************************************************************/

/**
 * @file
 * @ingroup GC_Stats
 */

#if !defined(CONCURRENTPHASESTATSBASE_HPP_)
#define CONCURRENTPHASESTATSBASE_HPP_

#include "omrcfg.h"
#include "omrcomp.h"

#include "Base.hpp"

/**
  * @ingroup GC_Stats
 */
class MM_ConcurrentPhaseStatsBase : public MM_Base
{
	/* Data Members */
private:
protected:
public:
	uint64_t _startTime;
	uint64_t _endTime;
	uintptr_t _cycleID;	/**< The "_id" of the corresponding cycle */
	uintptr_t _scanTargetInBytes;	/**< The number of bytes a given concurrent task was expected to scan before terminating */
	uintptr_t _bytesScanned;	/**< The number of bytes a given concurrent task did scan before it terminated (can be lower than _scanTargetInBytes if the termination was asynchronously requested) */
	bool _terminationWasRequested;	/**< todo: remove after downstream projects start using _terminationRequestType */
	uintptr_t _concurrentCycleType;	/**< The "type" of the corresponding cycle */
	uintptr_t _concurrentMarkProcessStartTime; /**< CPU start time (user + sys time) at the start of a concurrent mark increment. This is not the same as wall clock time. Process system time might play a significant role when it comes to measuring GMP cost, so it is included here */
	enum TerminationRequestType {
		terminationRequest_None,
		terminationRequest_ByGC,
		terminationRequest_External
	};
	TerminationRequestType _terminationRequestType; /**< Reason for concurrent task termination, asynchronous external event or itself GC (work or survivor space exhausted etc). */
	/* Member Functions */
private:
protected:
public:

	bool isTerminationRequested() {
		return terminationRequest_None != _terminationRequestType;
	}
	bool isTerminationRequestExternal() {
		return terminationRequest_External == _terminationRequestType;
	}
	
	virtual void clear() {
		_startTime = 0;
		_endTime = 0;
		_cycleID = 0;
		_scanTargetInBytes = 0;
		_bytesScanned = 0;
		_terminationWasRequested = false;
		_concurrentMarkProcessStartTime = 0;
		_terminationRequestType = terminationRequest_None;
	}
	 
	MM_ConcurrentPhaseStatsBase(uintptr_t concurrentCycleType = OMR_GC_CYCLE_TYPE_DEFAULT)
		: MM_Base()
		, _startTime(0)
		, _endTime(0)
		, _cycleID(0)
		, _scanTargetInBytes(0)
		, _bytesScanned(0)
		, _terminationWasRequested(false)
		, _concurrentCycleType(concurrentCycleType)
		, _concurrentMarkProcessStartTime(0)
		, _terminationRequestType(terminationRequest_None)
	{}
}; 

#endif /* CONCURRENTPHASESTATSBASE_HPP_ */