NV::Rules::IAction Class Reference
[NvRules Python garbage-collected classes.]

Action interface. More...

Public Types
enum	NameBase
	Basis for action names. More...
Public Member Functions
virtual PYRETURN IMetric *	add_double_metric (const char *value_name, IMetric::ValueKind value_kind, double value)=0
	Add a single floating point metric to this action.
virtual PYRETURN IMetric *	add_integer_metric (const char *value_name, IMetric::ValueKind value_kind, uint64_t value)=0
	Add a single integer metric to this action.
virtual PYRETURN IMutableMetric *	add_metric (const char *value_name)=0
	Add a single mutable metric to this action.
virtual PYRETURN IMetric *	add_string_metric (const char *value_name, IMetric::ValueKind value_kind, const char *value)=0
	Add a single string metric to this action.
virtual PYRETURN IMetric *	metric_by_name (const char *metric_name)=0
	Get a single metric by name.
virtual std::set< std::string >	metric_names ()=0
	Get the set of metric names.
virtual const char *	name (NameBase base=NameBase::FUNCTION)=0
	Get the action name.
virtual PYRETURN INvtxState *	nvtx_state ()=0
	Get the NVTX state associated with this action.
virtual std::string	ptx_by_pc (uint64_t address)=0
	Get the PTX for a function address within this action.
virtual std::string	sass_by_pc (uint64_t address)=0
	Get the disassembled SASS for a function address within this action.
virtual std::map< std::string, std::string >	source_files ()=0
	Get the source files associated with an action.
virtual PYRETURN ISourceInfo *	source_info (uint64_t address)=0
	Get the source info for a function address within this action.

---

Detailed Description

Represents an activity such as a CUDA kernel on a single range, for which zero or more metrics were collected

---

Member Enumeration Documentation

enum NV::Rules::IAction::NameBase

The basis determines how the action name is represented when calling name. FUNCTION is the minimal base name without parameters or return value. DEMANGLED is the demangled name, including parameters and return value. MANGLED is the mangled name, including parameters and return value.

---

Member Function Documentation

virtual PYRETURN IMetric* NV::Rules::IAction::add_double_metric	(	const char *	value_name,
		IMetric::ValueKind	value_kind,
		double	value
	)			[pure virtual]

Returns:

the new IMetric

Add a single floating point metric with name value_name and kind value_kind to this action

virtual PYRETURN IMetric* NV::Rules::IAction::add_integer_metric	(	const char *	value_name,
		IMetric::ValueKind	value_kind,
		uint64_t	value
	)			[pure virtual]

Returns:

the new IMetric

Add a single integer metric to with name value_name and kind value_kind this action.

virtual PYRETURN IMutableMetric* NV::Rules::IAction::add_metric

(

const char *

value_name

)

[pure virtual]

Returns:

the new IMutableMetric

Add a single, mutable metric with name value_name to this action. The metric is not initialized with any kind or value and needs to be assigned proper values and/or instances afterwards. IMutableMetric provides the following interface:

void set_double(IMetric::ValueKind value_kind, double value)

Return true if the value was set, false otherwise. Assign the metric a floating-point value of value_kind Acceptable kinds are FLOAT, DOUBLE or ANY (for which the implementation chooses the kind internally)

bool set_double(size_t instance, IMetric::ValueKind value_kind, double value)

Return true if the instance value was set, false otherwise. Assign the metric an instance floating-point value of value_kind Acceptable kinds are FLOAT, DOUBLE or ANY (for which the implementation chooses the kind internally)

void set_uint64(IMetric::ValueKind value_kind, uint64_t value)

Return true if the value was set, false otherwise. Assign the metric an integer value of value_kind Acceptable kinds are UINT32, UINT64 or ANY (for which the implementation chooses the kind internally)

bool set_uint64(size_t instance, IMetric::ValueKind value_kind, uint64_t value)

Return true if the instance value was set, false otherwise. Assign the metric an instance integer value of value_kind Acceptable kinds are UINT32, UINT64 or ANY (for which the implementation chooses the kind internally)

void set_string(IMetric::ValueKind value_kind, const char* value)

Return true if the value was set, false otherwise. Assign the metric a string value of value_kind Acceptable kinds are STRING or ANY (for which the implementation chooses the kind internally)

bool set_string(size_t instance, IMetric::ValueKind value_kind, const char* value)

Return true if the instance value was set, false otherwise. Assign the metric an instance string value of value_kind Acceptable kinds are STRING or ANY (for which the implementation chooses the kind internally)

IMutableMetric *mutable_correlation_ids()

Returns a new, mutable metric object representing the correlation IDs for the metric's instance values. Correlation IDs are used to associate instance values with the "instance" their value represents. In the returned new metric object, the correlation IDs are that object's instance values.

virtual PYRETURN IMetric* NV::Rules::IAction::add_string_metric	(	const char *	value_name,
		IMetric::ValueKind	value_kind,
		const char *	value
	)			[pure virtual]

Returns:

the new IMetric

Add a single string metric with name value_name and kind value_kind to this action

virtual PYRETURN IMetric* NV::Rules::IAction::metric_by_name

(

const char *

metric_name

)

[pure virtual]

Get a single IMetric by metric_name

virtual std::set<std::string> NV::Rules::IAction::metric_names

(

)

[pure virtual]

Get the set of metrics available for this action

virtual const char* NV::Rules::IAction::name

(

NameBase

base = NameBase::FUNCTION

)

[pure virtual]

Get the action name

virtual PYRETURN INvtxState* NV::Rules::IAction::nvtx_state

(

)

[pure virtual]

Returns:

a new INvtxState object if any NVTX state is available for this action.

virtual std::string NV::Rules::IAction::ptx_by_pc

(

uint64_t

address

)

[pure virtual]

Returns:

PTX string. An empty string is returned if no PTX is associated with this address

Get the PTX for a function address within this action. The address is expected to be absolute, i.e. as obtained from the correlation IDs of source-correlated metrics.

virtual std::string NV::Rules::IAction::sass_by_pc

(

uint64_t

address

)

[pure virtual]

Returns:

SASS string. An empty string is returned if no SASS is associated with this address

Get the disassembled SASS for a function address within this action. The address is expected to be absolute, i.e. as obtained from the correlation IDs of source-correlated metrics. The SASS may include formatting whitespace as generated by the disassembler.

virtual std::map<std::string, std::string> NV::Rules::IAction::source_files

(

)

[pure virtual]

Returns:

a map from file name to file content

Get the map of source files associated with this action, along with their content. If content is not available for a file (e.g. because it hadn't been imported into the report), the file name will map to an empty string.

virtual PYRETURN ISourceInfo* NV::Rules::IAction::source_info

(

uint64_t

address

)

[pure virtual]

Returns:

a new ISourceInfo object if it is available

Get the source info for address within this action. Addresses are commonly obtained as correlation ids of source-correlated metrics.