hpx/runtime_distributed/runtime_fwd.hpp#

Defined in header hpx/runtime_distributed/runtime_fwd.hpp.

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

namespace hpx

Functions

runtime_distributed &get_runtime_distributed()#
runtime_distributed *&get_runtime_distributed_ptr()#
naming::gid_type const &get_locality()#

The function get_locality returns a reference to the locality prefix.

void start_active_counters(error_code &ec = throws)#

Start all active performance counters, optionally naming the section of code.

Note

As long as ec is not pre-initialized to hpx::throws this function doesn’t throw but returns the result code using the parameter ec. Otherwise it throws an instance of hpx::exception.

Note

The active counters are those which have been specified on the command line while executing the application (see command line option –hpx:print-counter)

Parameters

ec – [in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.

void reset_active_counters(error_code &ec = throws)#

Resets all active performance counters.

Note

As long as ec is not pre-initialized to hpx::throws this function doesn’t throw but returns the result code using the parameter ec. Otherwise it throws an instance of hpx::exception.

Note

The active counters are those which have been specified on the command line while executing the application (see command line option –hpx:print-counter)

Parameters

ec – [in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.

void reinit_active_counters(bool reset = true, error_code &ec = throws)#

Re-initialize all active performance counters.

Note

As long as ec is not pre-initialized to hpx::throws this function doesn’t throw but returns the result code using the parameter ec. Otherwise it throws an instance of hpx::exception.

Note

The active counters are those which have been specified on the command line while executing the application (see command line option –hpx:print-counter)

Parameters

  • reset – [in] Reset the current values before re-initializing counters (default: true)

  • ec – [in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.

void stop_active_counters(error_code &ec = throws)#

Stop all active performance counters.

Note

As long as ec is not pre-initialized to hpx::throws this function doesn’t throw but returns the result code using the parameter ec. Otherwise it throws an instance of hpx::exception.

Note

The active counters are those which have been specified on the command line while executing the application (see command line option –hpx:print-counter)

Parameters

ec – [in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.

void evaluate_active_counters(bool reset = false, char const *description = nullptr, error_code &ec = throws)#

Evaluate and output all active performance counters, optionally naming the point in code marked by this function.

Note

As long as ec is not pre-initialized to hpx::throws this function doesn’t throw but returns the result code using the parameter ec. Otherwise it throws an instance of hpx::exception.

Note

The output generated by this function is redirected to the destination specified by the corresponding command line options (see –hpx:print-counter-destination).

Note

The active counters are those which have been specified on the command line while executing the application (see command line option –hpx:print-counter)

Parameters

  • reset – [in] this is an optional flag allowing to reset the counter value after it has been evaluated.

  • description – [in] this is an optional value naming the point in the code marked by the call to this function.

  • ec – [in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.

serialization::binary_filter *create_binary_filter(char const *binary_filter_type, bool compress, serialization::binary_filter *next_filter = nullptr, error_code &ec = throws)#

Create an instance of a binary filter plugin.

Note

As long as ec is not pre-initialized to hpx::throws this function doesn’t throw but returns the result code using the parameter ec. Otherwise it throws an instance of hpx::exception.

Parameters

  • binary_filter_type – [in] The type of the binary filter to create

  • compress – [in] The created filter should support compression

  • next_filter – [in] Use this as the filter to dispatch the invocation into.

  • ec – [in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.