Skip to content

HDF5 file layout

Each HDF5 dump stores a kernel's execution context for replay in a file named krepe_<label>_<kernel_id>.h5.

/
Root attributes Kernel identity
  • kernel_label Kokkos kernel label
  • kernel_id Tool-local ID counting all kernel launches, across labels
  • kernel_invocation Invocation number for this label, starting at 1
in/ Allocations before the kernel
  • active_allocations Number of allocations in this snapshot
  • active_bytes Sum of bounded user-data sizes, including skipped allocations, in bytes
views/ Captured allocations
view_<index>_<label>/ One group per allocation
  • label Kokkos allocation label
  • space Memory space reported by the profiling hook
  • ptr Allocation pointer, stored as text
  • p_data User-data pointer after the allocation header, stored as text
  • size Bounded user-data size in bytes; 0 if empty or unbounded
  • reported_size Size reported by the allocation hook, in bytes
  • bytes_dumped 1 if bytes is present, including an empty dataset; 0 if skipped
  • skip_reason Present only when bytes_dumped = 0; explains why data was skipped
  • bytes Unsigned-byte dataset; present only when bytes_dumped = 1
out/ State of the allocations after the kernel
  • active_allocations Number of allocations in this snapshot
  • active_bytes Sum of bounded user-data sizes, including skipped allocations, in bytes
views/ Captured allocations
view_<index>_<label>/ One group per allocation
  • label Kokkos allocation label
  • space Memory space reported by the profiling hook
  • ptr Allocation pointer, stored as text
  • p_data User-data pointer after the allocation header, stored as text
  • size Bounded user-data size in bytes; 0 if empty or unbounded
  • reported_size Size reported by the allocation hook, in bytes
  • bytes_dumped 1 if bytes is present, including an empty dataset; 0 if skipped
  • skip_reason Present only when bytes_dumped = 0; explains why data was skipped
  • bytes Unsigned-byte dataset; present only when bytes_dumped = 1
policy/ Execution policy

Select the recorded policy type to see its fields

  • type "range"
  • space Execution space name
  • schedule Scheduling policy: static or dynamic
  • index_type_size Index type size, in bytes
  • index_type_signed Whether the index type is signed
  • begin Start index
  • end End index
  • chunk_size Chunk size parameter
  • type "mdrange"
  • space Execution space name
  • schedule Scheduling policy: static or dynamic
  • index_type_size Index type size, in bytes
  • index_type_signed Whether the index type is signed
  • rank Number of dimensions
  • outer_dir Outer iteration direction: left or right
  • inner_dir Inner iteration direction: left or right
  • begin int64_t dataset of start indices
  • end int64_t dataset of end indices
  • tile int64_t dataset of tile dimensions
  • type "team"
  • space Execution space name
  • schedule Scheduling policy: static or dynamic
  • index_type_size Index type size, in bytes
  • index_type_signed Whether the index type is signed
  • team_size Threads per team, or -1 for AUTO
  • league_size Number of teams
  • vector_length Vector lanes per team thread, or -1 for AUTO
  • team_scratch_0 Level 0 scratch bytes per team; -1 if unavailable
  • team_scratch_1 Level 1 scratch bytes per team; -1 if unavailable
  • thread_scratch_0 Level 0 scratch bytes per thread; -1 if unavailable
  • thread_scratch_1 Level 1 scratch bytes per thread; -1 if unavailable
  • chunk_size Chunk size parameter
  • type "scalar"
  • end End index
  • type "none" — no policy was recorded
metadata/ User metadata
  • <key> One string attribute per user key/value pair
functor/ Callable data for replay
  • functor Unsigned-byte dataset of the captured functor or lambda object
  • nvcc_inner_lambda Unsigned-byte dataset; always present, empty unless an NVCC extended host-device lambda was captured