rarias/ovni
rarias/ovni
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Document usage rules for the mark API

Browse Source
This commit is contained in:
Rodrigo Arias 2024-07-22 17:50:00 +02:00
parent 5448b5c0ec
commit 038b9d8564
1 changed files with 13 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/user/runtime/mark.md
View File

@ -25,6 +25,11 @@ The default with flags set to zero, is to create a channel that can hold a
single value only (see [channels](../../dev/channels.md)). To use a stack of single value only (see [channels](../../dev/channels.md)). To use a stack of
values add the `OVNI_MARK_STACK` value to the flags. values add the `OVNI_MARK_STACK` value to the flags.
Only one thread among all nodes needs to define a type to be available globally,
but the same type can be defined from multiple threads, as long as the same
flags and title argument are used. The idea is to avoid having to check if the
type was already defined or not.
### Define labels (optional) ### Define labels (optional)
The values that are written to the channel can have labels to display in the The values that are written to the channel can have labels to display in the
@ -37,6 +42,14 @@ Use the following call to register a label for a value in a given type.
void ovni_mark_label(int32_t type, int64_t value, const char *label); void ovni_mark_label(int32_t type, int64_t value, const char *label);
``` ```
A value can only have at most a single label associated. Multiple threads can
call the `ovni_mark_label()` with the same type and value as long as they use
the same label. New labels for the same type can be associated from different
threads, as long as the values are different.
All value and label pairs are combined from all threads and will be available in
the Paraver view for each type.
### Emit events ### Emit events
All mark channels begin with the default value *null*, which is not shown in All mark channels begin with the default value *null*, which is not shown in