rocprofiler-sdk-roctx/roctx.h File Reference

rocprofiler-sdk-roctx/roctx.h File Reference#

ROCTx developer API: rocprofiler-sdk-roctx/roctx.h File Reference
ROCTx developer API 1.0.0
ROCm Profiling API and tools
roctx.h File Reference

ROCTx API interface for AMD code annotation and profiling. More...

#include <stddef.h>
#include <stdint.h>
#include "rocprofiler-sdk-roctx/defines.h"
#include "rocprofiler-sdk-roctx/types.h"
#include "rocprofiler-sdk-roctx/version.h"
+ Include dependency graph for roctx.h:

Go to the source code of this file.

Macros

#define roctxRangeStart(message)   roctxRangeStartA(message)
 For future compatibility.
 
#define roctxMark(message)   roctxMarkA(message)
 For future compatibility.
 
#define roctxRangePush(message)   roctxRangePushA(message)
 For future compatibility.
 

Functions

void roctxMarkA (const char *message)
 
int roctxRangePushA (const char *message)
 
int roctxRangePop ()
 
roctx_range_id_t roctxRangeStartA (const char *message)
 Starts a process range.
 
void roctxRangeStop (roctx_range_id_t id)
 
int roctxProfilerPause (roctx_thread_id_t tid)
 Request any currently running profiling tool that is should stop collecting data.
 
int roctxProfilerResume (roctx_thread_id_t tid)
 Request any currently running profiling tool that is should resume collecting data.
 
int roctxNameOsThread (const char *name)
 Indicate to a profiling tool that, where possible, you would like the current CPU OS thread to be labeled by the provided name in the output of the profiling tool.
 
int roctxNameHsaAgent (const char *name, const struct hsa_agent_s *agent)
 Indicate to a profiling tool that, where possible, you would like the given HSA agent to be labeled by the provided name in the output of the profiling tool.
 
int roctxNameHipDevice (const char *name, int device_id)
 Indicate to a profiling tool that, where possible, you would like the given HIP device id to be labeled by the provided name in the output of the profiling tool.
 
int roctxNameHipStream (const char *name, const struct ihipStream_t *stream)
 Indicate to a profiling tool that, where possible, you would like the given HIP stream to be labeled by the provided name in the output of the profiling tool.
 
int roctxGetThreadId (roctx_thread_id_t *tid)
 Retrieve a id value for the current thread which will be identical to the id value a profiling tool gets via rocprofiler_get_thread_id(rocprofiler_thread_id_t*)
 

Detailed Description

ROCTx API interface for AMD code annotation and profiling.

Definition in file roctx.h.

Macro Definition Documentation

◆ roctxMark

#define roctxMark (   message)    roctxMarkA(message)

For future compatibility.

Definition at line 304 of file roctx.h.

◆ roctxRangePush

#define roctxRangePush (   message)    roctxRangePushA(message)

For future compatibility.

Definition at line 309 of file roctx.h.

◆ roctxRangeStart

#define roctxRangeStart (   message)    roctxRangeStartA(message)

For future compatibility.

Definition at line 299 of file roctx.h.