docs-6.2.4/source/lib/omnitrace-user/omnitrace/categories.h File Reference

docs-6.2.4/source/lib/omnitrace-user/omnitrace/categories.h File Reference#

omnitrace: docs-6.2.4/source/lib/omnitrace-user/omnitrace/categories.h File Reference

#include <stddef.h>
#include <stdint.h>

Classes
struct	omnitrace_annotation
	A struct containing annotation data to be included in the perfetto trace. More...

Typedefs
typedef enum OMNITRACE_CATEGORIES	omnitrace_category_t
	Identifier for categories. More...

typedef enum OMNITRACE_ANNOTATION_TYPE	omnitrace_annotation_type_t

typedef struct omnitrace_annotation	omnitrace_annotation_t

Enumerations
enum	OMNITRACE_CATEGORIES { OMNITRACE_CATEGORY_NONE = 0 , OMNITRACE_CATEGORY_PYTHON , OMNITRACE_CATEGORY_USER , OMNITRACE_CATEGORY_HOST , OMNITRACE_CATEGORY_DEVICE_HIP , OMNITRACE_CATEGORY_DEVICE_HSA , OMNITRACE_CATEGORY_ROCM_HIP , OMNITRACE_CATEGORY_ROCM_HSA , OMNITRACE_CATEGORY_ROCM_ROCTX , OMNITRACE_CATEGORY_ROCM_SMI , OMNITRACE_CATEGORY_ROCM_SMI_BUSY , OMNITRACE_CATEGORY_ROCM_SMI_TEMP , OMNITRACE_CATEGORY_ROCM_SMI_POWER , OMNITRACE_CATEGORY_ROCM_SMI_MEMORY_USAGE , OMNITRACE_CATEGORY_ROCM_RCCL , OMNITRACE_CATEGORY_ROCTRACER , OMNITRACE_CATEGORY_ROCPROFILER , OMNITRACE_CATEGORY_SAMPLING , OMNITRACE_CATEGORY_PTHREAD , OMNITRACE_CATEGORY_KOKKOS , OMNITRACE_CATEGORY_MPI , OMNITRACE_CATEGORY_OMPT , OMNITRACE_CATEGORY_PROCESS_SAMPLING , OMNITRACE_CATEGORY_COMM_DATA , OMNITRACE_CATEGORY_CAUSAL , OMNITRACE_CATEGORY_CPU_FREQ , OMNITRACE_CATEGORY_PROCESS_PAGE , OMNITRACE_CATEGORY_PROCESS_VIRT , OMNITRACE_CATEGORY_PROCESS_PEAK , OMNITRACE_CATEGORY_PROCESS_CONTEXT_SWITCH , OMNITRACE_CATEGORY_PROCESS_PAGE_FAULT , OMNITRACE_CATEGORY_PROCESS_USER_MODE_TIME , OMNITRACE_CATEGORY_PROCESS_KERNEL_MODE_TIME , OMNITRACE_CATEGORY_THREAD_WALL_TIME , OMNITRACE_CATEGORY_THREAD_CPU_TIME , OMNITRACE_CATEGORY_THREAD_PAGE_FAULT , OMNITRACE_CATEGORY_THREAD_PEAK_MEMORY , OMNITRACE_CATEGORY_THREAD_CONTEXT_SWITCH , OMNITRACE_CATEGORY_THREAD_HARDWARE_COUNTER , OMNITRACE_CATEGORY_KERNEL_HARDWARE_COUNTER , OMNITRACE_CATEGORY_NUMA , OMNITRACE_CATEGORY_TIMER_SAMPLING , OMNITRACE_CATEGORY_OVERFLOW_SAMPLING , OMNITRACE_CATEGORY_LAST }

enum	OMNITRACE_ANNOTATION_TYPE { OMNITRACE_VALUE_NONE = 0 , OMNITRACE_VALUE_CSTR = 1 , OMNITRACE_STRING = OMNITRACE_VALUE_CSTR , OMNITRACE_VALUE_SIZE_T = 2 , OMNITRACE_SIZE_T = OMNITRACE_VALUE_SIZE_T , OMNITRACE_VALUE_INT64 = 3 , OMNITRACE_INT64 = OMNITRACE_VALUE_INT64 , OMNITRACE_I64 = OMNITRACE_VALUE_INT64 , OMNITRACE_VALUE_UINT64 = 4 , OMNITRACE_UINT64 = OMNITRACE_VALUE_UINT64 , OMNITRACE_U64 = OMNITRACE_VALUE_UINT64 , OMNITRACE_VALUE_FLOAT64 = 5 , OMNITRACE_FLOAT64 = OMNITRACE_VALUE_FLOAT64 , OMNITRACE_FP64 = OMNITRACE_VALUE_FLOAT64 , OMNITRACE_VALUE_VOID_P = 6 , OMNITRACE_VOID_P = OMNITRACE_VALUE_VOID_P , OMNITRACE_PTR = OMNITRACE_VALUE_VOID_P , OMNITRACE_VALUE_INT32 = 7 , OMNITRACE_INT32 = OMNITRACE_VALUE_INT32 , OMNITRACE_I32 = OMNITRACE_VALUE_INT32 , OMNITRACE_VALUE_UINT32 = 8 , OMNITRACE_UINT32 = OMNITRACE_VALUE_UINT32 , OMNITRACE_U32 = OMNITRACE_VALUE_UINT32 , OMNITRACE_VALUE_FLOAT32 = 9 , OMNITRACE_FLOAT32 = OMNITRACE_VALUE_FLOAT32 , OMNITRACE_FP32 = OMNITRACE_VALUE_FLOAT32 , OMNITRACE_VALUE_INT16 = 10 , OMNITRACE_INT16 = OMNITRACE_VALUE_INT16 , OMNITRACE_I16 = OMNITRACE_VALUE_INT16 , OMNITRACE_VALUE_UINT16 = 11 , OMNITRACE_UINT16 = OMNITRACE_VALUE_UINT16 , OMNITRACE_U16 = OMNITRACE_VALUE_UINT16 , OMNITRACE_VALUE_LAST }
	Identifier for the data type of the annotation. if the data type is not a pointer, pass the address of data. More...

Class Documentation

◆ omnitrace_annotation

struct omnitrace_annotation

A struct containing annotation data to be included in the perfetto trace.

#include <cstddef>
#include <cstdint>
 
double
compute_residual(size_t n, double* data);
 
double
compute(size_t n, double* data, size_t nitr, double tolerance)
{
    omnitrace_annotation_t _annotations[] = {
        { "iteration", OMNITRACE_VALUE_SIZE_T, nullptr },
        { "residual", OMNITRACE_VALUE_FLOAT64, nullptr },
        { "data", OMNITRACE_VALUE_PTR, data },
        { "size", OMNITRACE_VALUE_SIZE_T, &n },
        { "tolerance", OMNITRACE_VALUE_FLOAT64, &tolerance },
        nullptr
    };
 
    double residual = tolerance;
    for(size_t i = 0; i < nitr; ++i)
    {
        omnitrace_user_push_annotated_region("compute", &_annotations);
 
        residual = compute_residual(n, data);
 
        _annotations[0].value = &i;
        _annotations[1].value = &residual;
        omnitrace_user_pop_annotated_region("compute", &_annotations);
    }
 
    return residual;
}

Definition at line 177 of file categories.h.

Class Members
const char *	name	label for annotation
unsigned long	type	omnitrace_annotation_type_t
void *	value	data to annotate

Typedef Documentation

◆ omnitrace_annotation_t

omnitrace_annotation omnitrace_annotation_t

◆ omnitrace_annotation_type_t

OMNITRACE_ANNOTATION_TYPE omnitrace_annotation_type_t

◆ omnitrace_category_t

omnitrace_category_t

Identifier for categories.

Enumeration Type Documentation

◆ OMNITRACE_ANNOTATION_TYPE

enum OMNITRACE_ANNOTATION_TYPE

Identifier for the data type of the annotation. if the data type is not a pointer, pass the address of data.

Enumerator
OMNITRACE_VALUE_NONE
OMNITRACE_VALUE_CSTR
OMNITRACE_STRING
OMNITRACE_VALUE_SIZE_T
OMNITRACE_SIZE_T
OMNITRACE_VALUE_INT64
OMNITRACE_INT64
OMNITRACE_I64
OMNITRACE_VALUE_UINT64
OMNITRACE_UINT64
OMNITRACE_U64
OMNITRACE_VALUE_FLOAT64
OMNITRACE_FLOAT64
OMNITRACE_FP64
OMNITRACE_VALUE_VOID_P
OMNITRACE_VOID_P
OMNITRACE_PTR
OMNITRACE_VALUE_INT32
OMNITRACE_INT32
OMNITRACE_I32
OMNITRACE_VALUE_UINT32
OMNITRACE_UINT32
OMNITRACE_U32
OMNITRACE_VALUE_FLOAT32
OMNITRACE_FLOAT32
OMNITRACE_FP32
OMNITRACE_VALUE_INT16
OMNITRACE_INT16
OMNITRACE_I16
OMNITRACE_VALUE_UINT16
OMNITRACE_UINT16
OMNITRACE_U16
OMNITRACE_VALUE_LAST

Definition at line 96 of file categories.h.

     {
         // Do not use first enum value
         OMNITRACE_VALUE_NONE = 0,
         // arrange these in the order most likely to
         // be used since they have to be iterated over
         OMNITRACE_VALUE_CSTR    = 1,
         OMNITRACE_STRING        = OMNITRACE_VALUE_CSTR,
         OMNITRACE_VALUE_SIZE_T  = 2,
         OMNITRACE_SIZE_T        = OMNITRACE_VALUE_SIZE_T,
         OMNITRACE_VALUE_INT64   = 3,
         OMNITRACE_INT64         = OMNITRACE_VALUE_INT64,
         OMNITRACE_I64           = OMNITRACE_VALUE_INT64,
         OMNITRACE_VALUE_UINT64  = 4,
         OMNITRACE_UINT64        = OMNITRACE_VALUE_UINT64,
         OMNITRACE_U64           = OMNITRACE_VALUE_UINT64,
         OMNITRACE_VALUE_FLOAT64 = 5,
         OMNITRACE_FLOAT64       = OMNITRACE_VALUE_FLOAT64,
         OMNITRACE_FP64          = OMNITRACE_VALUE_FLOAT64,
         OMNITRACE_VALUE_VOID_P  = 6,
         OMNITRACE_VOID_P        = OMNITRACE_VALUE_VOID_P,
         OMNITRACE_PTR           = OMNITRACE_VALUE_VOID_P,
         OMNITRACE_VALUE_INT32   = 7,
         OMNITRACE_INT32         = OMNITRACE_VALUE_INT32,
         OMNITRACE_I32           = OMNITRACE_VALUE_INT32,
         OMNITRACE_VALUE_UINT32  = 8,
         OMNITRACE_UINT32        = OMNITRACE_VALUE_UINT32,
         OMNITRACE_U32           = OMNITRACE_VALUE_UINT32,
         OMNITRACE_VALUE_FLOAT32 = 9,
         OMNITRACE_FLOAT32       = OMNITRACE_VALUE_FLOAT32,
         OMNITRACE_FP32          = OMNITRACE_VALUE_FLOAT32,
         OMNITRACE_VALUE_INT16   = 10,
         OMNITRACE_INT16         = OMNITRACE_VALUE_INT16,
         OMNITRACE_I16           = OMNITRACE_VALUE_INT16,
         OMNITRACE_VALUE_UINT16  = 11,
         OMNITRACE_UINT16        = OMNITRACE_VALUE_UINT16,
         OMNITRACE_U16           = OMNITRACE_VALUE_UINT16,
         // the value of below enum is used for iterating
         // over the enum in C++ templates. It MUST
         // be the last enumerated id
         OMNITRACE_VALUE_LAST
     } omnitrace_annotation_type_t;

◆ OMNITRACE_CATEGORIES

enum OMNITRACE_CATEGORIES

Enumerator
OMNITRACE_CATEGORY_NONE
OMNITRACE_CATEGORY_PYTHON
OMNITRACE_CATEGORY_USER
OMNITRACE_CATEGORY_HOST
OMNITRACE_CATEGORY_DEVICE_HIP
OMNITRACE_CATEGORY_DEVICE_HSA
OMNITRACE_CATEGORY_ROCM_HIP
OMNITRACE_CATEGORY_ROCM_HSA
OMNITRACE_CATEGORY_ROCM_ROCTX
OMNITRACE_CATEGORY_ROCM_SMI
OMNITRACE_CATEGORY_ROCM_SMI_BUSY
OMNITRACE_CATEGORY_ROCM_SMI_TEMP
OMNITRACE_CATEGORY_ROCM_SMI_POWER
OMNITRACE_CATEGORY_ROCM_SMI_MEMORY_USAGE
OMNITRACE_CATEGORY_ROCM_RCCL
OMNITRACE_CATEGORY_ROCTRACER
OMNITRACE_CATEGORY_ROCPROFILER
OMNITRACE_CATEGORY_SAMPLING
OMNITRACE_CATEGORY_PTHREAD
OMNITRACE_CATEGORY_KOKKOS
OMNITRACE_CATEGORY_MPI
OMNITRACE_CATEGORY_OMPT
OMNITRACE_CATEGORY_PROCESS_SAMPLING
OMNITRACE_CATEGORY_COMM_DATA
OMNITRACE_CATEGORY_CAUSAL
OMNITRACE_CATEGORY_CPU_FREQ
OMNITRACE_CATEGORY_PROCESS_PAGE
OMNITRACE_CATEGORY_PROCESS_VIRT
OMNITRACE_CATEGORY_PROCESS_PEAK
OMNITRACE_CATEGORY_PROCESS_CONTEXT_SWITCH
OMNITRACE_CATEGORY_PROCESS_PAGE_FAULT
OMNITRACE_CATEGORY_PROCESS_USER_MODE_TIME
OMNITRACE_CATEGORY_PROCESS_KERNEL_MODE_TIME
OMNITRACE_CATEGORY_THREAD_WALL_TIME
OMNITRACE_CATEGORY_THREAD_CPU_TIME
OMNITRACE_CATEGORY_THREAD_PAGE_FAULT
OMNITRACE_CATEGORY_THREAD_PEAK_MEMORY
OMNITRACE_CATEGORY_THREAD_CONTEXT_SWITCH
OMNITRACE_CATEGORY_THREAD_HARDWARE_COUNTER
OMNITRACE_CATEGORY_KERNEL_HARDWARE_COUNTER
OMNITRACE_CATEGORY_NUMA
OMNITRACE_CATEGORY_TIMER_SAMPLING
OMNITRACE_CATEGORY_OVERFLOW_SAMPLING
OMNITRACE_CATEGORY_LAST

Definition at line 37 of file categories.h.

     {
         // Do not use first enum value
         OMNITRACE_CATEGORY_NONE = 0,
         // arrange these in the order most likely to
         // be used since they have to be iterated over
         OMNITRACE_CATEGORY_PYTHON,
         OMNITRACE_CATEGORY_USER,
         OMNITRACE_CATEGORY_HOST,
         OMNITRACE_CATEGORY_DEVICE_HIP,
         OMNITRACE_CATEGORY_DEVICE_HSA,
         OMNITRACE_CATEGORY_ROCM_HIP,
         OMNITRACE_CATEGORY_ROCM_HSA,
         OMNITRACE_CATEGORY_ROCM_ROCTX,
         OMNITRACE_CATEGORY_ROCM_SMI,
         OMNITRACE_CATEGORY_ROCM_SMI_BUSY,
         OMNITRACE_CATEGORY_ROCM_SMI_TEMP,
         OMNITRACE_CATEGORY_ROCM_SMI_POWER,
         OMNITRACE_CATEGORY_ROCM_SMI_MEMORY_USAGE,
         OMNITRACE_CATEGORY_ROCM_RCCL,
         OMNITRACE_CATEGORY_ROCTRACER,
         OMNITRACE_CATEGORY_ROCPROFILER,
         OMNITRACE_CATEGORY_SAMPLING,
         OMNITRACE_CATEGORY_PTHREAD,
         OMNITRACE_CATEGORY_KOKKOS,
         OMNITRACE_CATEGORY_MPI,
         OMNITRACE_CATEGORY_OMPT,
         OMNITRACE_CATEGORY_PROCESS_SAMPLING,
         OMNITRACE_CATEGORY_COMM_DATA,
         OMNITRACE_CATEGORY_CAUSAL,
         OMNITRACE_CATEGORY_CPU_FREQ,
         OMNITRACE_CATEGORY_PROCESS_PAGE,
         OMNITRACE_CATEGORY_PROCESS_VIRT,
         OMNITRACE_CATEGORY_PROCESS_PEAK,
         OMNITRACE_CATEGORY_PROCESS_CONTEXT_SWITCH,
         OMNITRACE_CATEGORY_PROCESS_PAGE_FAULT,
         OMNITRACE_CATEGORY_PROCESS_USER_MODE_TIME,
         OMNITRACE_CATEGORY_PROCESS_KERNEL_MODE_TIME,
         OMNITRACE_CATEGORY_THREAD_WALL_TIME,
         OMNITRACE_CATEGORY_THREAD_CPU_TIME,
         OMNITRACE_CATEGORY_THREAD_PAGE_FAULT,
         OMNITRACE_CATEGORY_THREAD_PEAK_MEMORY,
         OMNITRACE_CATEGORY_THREAD_CONTEXT_SWITCH,
         OMNITRACE_CATEGORY_THREAD_HARDWARE_COUNTER,
         OMNITRACE_CATEGORY_KERNEL_HARDWARE_COUNTER,
         OMNITRACE_CATEGORY_NUMA,
         OMNITRACE_CATEGORY_TIMER_SAMPLING,
         OMNITRACE_CATEGORY_OVERFLOW_SAMPLING,
         OMNITRACE_CATEGORY_LAST
         // the value of below enum is used for iterating
         // over the enum in C++ templates. It MUST
         // be the last enumerated id
     } omnitrace_category_t;