nativeunwind

type IntervalCache interface {
	// HasIntervals returns true if interval data exists in the cache for a file with the provided
	// ID, or false otherwise.
	HasIntervals(exeID host.FileID) bool
	// GetIntervalData loads the interval data from the cache that is associated with `exeID`
	// into `interval`.
	GetIntervalData(exeID host.FileID, interval *stackdeltatypes.IntervalData) error
	// SaveIntervalData stores the provided `interval` that is associated with `exeID`
	// in the cache.
	SaveIntervalData(exeID host.FileID, interval *stackdeltatypes.IntervalData) error
	// GetCurrentCacheSize returns the current size of the cache in bytes. Or an error
	// otherwise.
	GetCurrentCacheSize() (uint64, error)
	// GetAndResetHitMissCounters returns the current hit and miss counters of the cache
	// and resets them to 0.
	GetAndResetHitMissCounters() (hit, miss uint64)
}

type StackDeltaProvider interface {
	// GetIntervalStructuresForFile inspects a single executable and extracts data that is needed
	// to rebuild the stack for traces of this executable.
	GetIntervalStructuresForFile(fileID host.FileID, elfRef *pfelf.Reference,
		interval *sdtypes.IntervalData) error

	// GetAndResetStatistics returns the internal statistics for this provider and resets all
	// values to 0.
	GetAndResetStatistics() Statistics
}

type Statistics struct {
	// Number of times for a hit of a cache entry.
	Hit uint64
	// Number of times for a miss of a cache entry.
	Miss uint64

	// Number of times extracting stack deltas failed.
	ExtractionErrors uint64
}