DynamoRIO
dynamorio::drmemtrace::memtrace_stream_t Class Referenceabstract

#include <memtrace_stream.h>

Inheritance diagram for dynamorio::drmemtrace::memtrace_stream_t:
dynamorio::drmemtrace::default_memtrace_stream_t dynamorio::drmemtrace::reader_t dynamorio::drmemtrace::record_reader_t dynamorio::drmemtrace::scheduler_tmpl_t< RecordType, ReaderType >::stream_t dynamorio::drmemtrace::record_file_reader_t< T >

Public Member Functions

virtual ~memtrace_stream_t ()
 
virtual uint64_t get_record_ordinal () const =0
 
virtual uint64_t get_instruction_ordinal () const =0
 
virtual std::string get_stream_name () const =0
 
virtual uint64_t get_last_timestamp () const =0
 
virtual uint64_t get_first_timestamp () const =0
 
virtual uint64_t get_version () const =0
 
virtual uint64_t get_filetype () const =0
 
virtual uint64_t get_cache_line_size () const =0
 
virtual uint64_t get_chunk_instr_count () const =0
 
virtual uint64_t get_page_size () const =0
 
virtual bool is_record_synthetic () const
 
virtual int64_t get_output_cpuid () const
 

Detailed Description

< DrMemtrace tracing + simulation infrastructure namespace. This is an interface for obtaining information from analysis tools on the full stream of memory reference records.

Constructor & Destructor Documentation

◆ ~memtrace_stream_t()

virtual dynamorio::drmemtrace::memtrace_stream_t::~memtrace_stream_t ( )
inlinevirtual

Destructor.

Member Function Documentation

◆ get_cache_line_size()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_cache_line_size ( ) const
pure virtual

◆ get_chunk_instr_count()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_chunk_instr_count ( ) const
pure virtual

◆ get_filetype()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_filetype ( ) const
pure virtual

Returns the OFFLINE_FILE_TYPE_* bitfields of type offline_file_type_t identifying the architecture and other key high-level attributes of the trace from the TRACE_MARKER_TYPE_FILETYPE record in the trace header.

Implemented in dynamorio::drmemtrace::scheduler_tmpl_t< RecordType, ReaderType >::stream_t, dynamorio::drmemtrace::default_memtrace_stream_t, dynamorio::drmemtrace::record_reader_t, and dynamorio::drmemtrace::reader_t.

◆ get_first_timestamp()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_first_timestamp ( ) const
pure virtual

◆ get_instruction_ordinal()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_instruction_ordinal ( ) const
pure virtual

Returns the count of instructions from the start of the trace to this point. This includes instructions skipped over and not presented to any tool.

Implemented in dynamorio::drmemtrace::scheduler_tmpl_t< RecordType, ReaderType >::stream_t, dynamorio::drmemtrace::default_memtrace_stream_t, dynamorio::drmemtrace::record_reader_t, and dynamorio::drmemtrace::reader_t.

◆ get_last_timestamp()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_last_timestamp ( ) const
pure virtual

◆ get_output_cpuid()

virtual int64_t dynamorio::drmemtrace::memtrace_stream_t::get_output_cpuid ( ) const
inlinevirtual

Returns a unique identifier for the current "output cpu". Generally this only applies when using SHARD_BY_CORE. For dynamic schedules, the identifier is typically an output cpu ordinal. For replaying an as-traced schedule, the identifier is typically the original input cpu which is now mapped directly to this output. If not implemented for the current mode, -1 is returned.

Reimplemented in dynamorio::drmemtrace::scheduler_tmpl_t< RecordType, ReaderType >::stream_t.

◆ get_page_size()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_page_size ( ) const
pure virtual

◆ get_record_ordinal()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_record_ordinal ( ) const
pure virtual

Returns the count of memref_t records from the start of the trace to this point. This includes records skipped over and not presented to any tool. It does not include synthetic records (see is_record_synthetic()).

Implemented in dynamorio::drmemtrace::scheduler_tmpl_t< RecordType, ReaderType >::stream_t, dynamorio::drmemtrace::default_memtrace_stream_t, dynamorio::drmemtrace::record_reader_t, and dynamorio::drmemtrace::reader_t.

◆ get_stream_name()

virtual std::string dynamorio::drmemtrace::memtrace_stream_t::get_stream_name ( ) const
pure virtual

Returns a name for the memtrace stream. For stored offline traces, this is the base name of the trace on disk. For online traces, this is the name of the pipe.

Implemented in dynamorio::drmemtrace::scheduler_tmpl_t< RecordType, ReaderType >::stream_t, dynamorio::drmemtrace::record_file_reader_t< T >, and dynamorio::drmemtrace::default_memtrace_stream_t.

◆ get_version()

virtual uint64_t dynamorio::drmemtrace::memtrace_stream_t::get_version ( ) const
pure virtual

◆ is_record_synthetic()

virtual bool dynamorio::drmemtrace::memtrace_stream_t::is_record_synthetic ( ) const
inlinevirtual

Returns whether the current record was synthesized and inserted into the record stream and was not present in the original stream. This is true for timestamp and cpuid headers duplicated after skipping ahead, as well as cpuid markers inserted for synthetic schedules. Such records do not count toward the record count and get_record_ordinal() will return the value of the prior record.

Reimplemented in dynamorio::drmemtrace::scheduler_tmpl_t< RecordType, ReaderType >::stream_t, and dynamorio::drmemtrace::reader_t.


The documentation for this class was generated from the following file:
  • /home/runner/work/dynamorio/dynamorio/build_release-64/clients/include/drmemtrace/memtrace_stream.h