hpx/tracing/backends/empty.hpp

hpx/tracing/backends/empty.hpp#

Defined in header hpx/tracing/backends/empty.hpp.

See Public API for a list of names and headers that are part of the public HPX API.

namespace hpx
namespace tracing

Typedefs

bool(*)() enable_parent_task_handler_type

Functions

inline constexpr annotation_handle create_annotation_handle(char const*) noexcept#
inline constexpr void set_thread_name(char const *name) noexcept#

Set the OS thread name in the profiler timeline.

inline constexpr char const *rename_region(char const *name) noexcept#

Rename the currently active region on this thread; returns the previous name, or the caller’s input if no rename occurred.

constexpr task_timer_data create_task_timer(threads::thread_description const&, std::uint32_t, threads::thread_id const&) noexcept#
constexpr void update_task_timer(task_timer_data&, char const*) noexcept#
constexpr void task_staged(char const*, void const* = nullptr) noexcept#
constexpr void task_created(char const*, void const*, void const* = nullptr) noexcept#
constexpr void task_executing(void const*, char const*, std::size_t) noexcept#
constexpr void task_yielded(void const*, char const*) noexcept#
constexpr void task_suspended(void const*, char const*, char const* = nullptr) noexcept#
constexpr void task_resumed(void const*, char const*, char const* = nullptr) noexcept#
constexpr void task_completed(void const*, char const*) noexcept#
constexpr void task_deleted(void const*) noexcept#
constexpr void future_fulfilled(void const*, char const* = nullptr) noexcept#

Producer-side signal: future state fulfilled (no-op stub).

Producer-side signal: future state fulfilled (no-op stub for ITTNotify).

Producer-side signal: future state fulfilled (no-op stub for APEX).

constexpr void future_exception_set(void const*, char const* = nullptr) noexcept#

Producer-side signal: future exception set (no-op stub).

Producer-side signal: future exception set (no-op stub for ITTNotify).

Producer-side signal: future exception set (no-op stub for APEX).

constexpr void continuation_run(void const* = nullptr) noexcept#

Consumer-side signal: continuation started (no-op stub).

Consumer-side signal: continuation started (no-op stub for ITTNotify).

Consumer-side signal: continuation started (no-op stub for APEX).

constexpr void continuation_finished(void const* = nullptr) noexcept#

Consumer-side signal: continuation finished (no-op stub).

Consumer-side signal: continuation finished (no-op stub for ITTNotify).

Consumer-side signal: continuation finished (no-op stub for APEX).

constexpr void handle_on_completed_fired(void const* = nullptr) noexcept#

Consumer-side signal: handle_on_completed fired (no-op stub).

Consumer-side signal: handle_on_completed fired (no-op stub for ITTNotify).

Consumer-side signal: handle_on_completed fired (no-op stub for APEX).

constexpr void work_stolen(std::size_t, std::size_t, void const*, char const* = nullptr) noexcept#

Signal emitted when a worker thread steals a task from another worker.

inline constexpr void frame_mark(char const* = nullptr) noexcept#

Frame boundary marker (no-op stub).

Frame boundary marker.

Frame boundary marker (no-op stub for APEX).

Emit a frame/stage boundary marker in Tracy timeline.

Parameters:

name – Optional name for the frame/stage.

inline constexpr void os_thread_sleep(std::size_t num_thread) noexcept#

Point message emitted just before an OS worker thread suspends on its condition variable.

Parameters:

num_thread – Index of the worker thread entering sleep.

constexpr void tracing_init(char const*, int, char**, std::uint32_t = 0, std::uint32_t = 1, std::string_view = {}) noexcept#
constexpr void tracing_finalize() noexcept#
inline constexpr void register_thread(char const*) noexcept#
constexpr void create_counter(std::string const&, std::string const&) noexcept#
constexpr void sample_counter(std::string const&, std::string const&, double) noexcept#
inline constexpr void send_parcel(std::uint64_t, std::uint64_t, std::uint64_t, std::uint64_t) noexcept#

Parcel-send signal: parcel handed to parcelport (no-op stub).

Parcel-send signal: parcel handed to parcelport (no-op stub for ITTNotify).

Parcel-send signal: parcel handed to parcelport (APEX shim).

Parcel-send signal: a parcel has been handed to the parcelport for transmission.

Parameters:

  • tag_msb – High 64 bits of the parcel id.

  • tag_lsb – Low 64 bits of the parcel id. Together with tag_msb they form the full 128-bit id used to pair events across localities; lsb alone restarts per locality and would produce false matches.

  • size – Wire size of the parcel in bytes.

  • target_locality_id – Destination locality id, or naming::invalid_locality_id if unknown.

inline constexpr void recv_parcel(std::uint64_t, std::uint64_t, std::uint64_t) noexcept#

Parcel-receive signal: parcel arrived (no-op stub).

Parcel-receive signal: parcel arrived (no-op stub for ITTNotify).

Parcel-receive signal: parcel arrived (APEX shim).

Parcel-receive signal: a parcel has arrived and its header has been deserialized.

Parameters:

  • tag_msb – High 64 bits of the parcel id.

  • tag_lsb – Low 64 bits of the parcel id.

  • source_locality_id – Sending locality id, or naming::invalid_locality_id when the parcel has no source id yet (pre-AGAS handshake parcels).

inline constexpr void parcel_scheduled(std::uint64_t, std::uint64_t, std::uint64_t, std::uint64_t) noexcept#

Parcel-scheduled signal: action entered local scheduler (no-op stub).

Parcel-scheduled signal: action entered local scheduler (no-op stub for ITTNotify).

Parcel-scheduled signal: action entered local scheduler (no-op stub for APEX).

Parcel-scheduled signal: an action carried by a parcel has been placed onto the local scheduler. Fires for deferred receives (zero-copy or multi-parcel message), for AGAS-routed parcels, and for parcels the AGAS re-route chain delivered after a migration detection. Does not fire for the non-deferred path where load_schedule schedules inline.

Parameters:

  • tag_msb – High 64 bits of the parcel id.

  • tag_lsb – Low 64 bits of the parcel id.

  • source_locality_id – Sending locality id (see recv_parcel).

  • source_thread_id – Parent HPX thread id captured on the sender; may be 0 when unavailable.

constexpr void set_enable_parent_task_handler(enable_parent_task_handler_type) noexcept#
struct annotation_handle#
struct region_init_data
struct loop_context

Public Functions

inline explicit constexpr loop_context() noexcept#
~loop_context() = default#
loop_context(loop_context const&) = delete#
loop_context &operator=(loop_context const&) = delete#
struct region

Public Functions

inline explicit constexpr region(loop_context&, region_init_data const&, std::size_t) noexcept#
struct mark_event

Public Functions

inline explicit constexpr mark_event(char const*) noexcept#
struct fiber_region_init_data
struct fiber_region

Public Functions

inline explicit constexpr fiber_region(fiber_region_init_data const&, std::size_t) noexcept#
struct fiber_suspend_region

Public Functions

inline explicit constexpr fiber_suspend_region(char const*) noexcept#
struct background_work_region

Public Functions

inline explicit constexpr background_work_region(std::size_t = 0) noexcept#
struct task_timer_data

Public Static Functions

static inline constexpr bool valid() noexcept#
Contents