Dosyalar
rocm-systems/source/lib/omnitrace/library/state.hpp
T
Jonathan R. Madsen 642b6b95ca Support external (i.e. user-defined) trace annotations (#195)
* Support external (i.e. user-defined) trace annotations

- tweaked the python examples to be more balanced
- updated the user-api example to conform to user API changes
- moved the get/set for State and ThreadState to state.{hpp,cpp}
- introduced user-provided trace annotations
- added perfetto python category
- moved coverage impl files around
- created enumerations for mapping category enums to category types
- created enumerations for mapping annotation type enums to annotation values
- moved tracing::add_perfetto_annotations to tracing/annotation.hpp
- utility make_index_sequence_range
- libomnitrace-dl: omnitrace_push_category_region
- libomnitrace-dl: omnitrace_pop_category_region
- libomnitrace-user: omnitrace_user_push_annotated_region
- libomnitrace-user: omnitrace_user_pop_annotated_region
- libpyomnitrace: support extra annotations via annotate_trace config value
  - filename
  - line
  - last attempted instr in bytecode (lasti)
  - argcount
  - num local variables
  - stacksize
- omnitrace-python: -a / --annotate-traces option

* tweak ubuntu-focal workflow

* Fix installation of omnitrace-user headers

* ubuntu-focal-codecov workflow update

- Install texinfo

* Update timemory submodule
2022-11-11 07:31:14 -06:00

103 satır
2.9 KiB
C++

// MIT License
//
// Copyright (c) 2022 Advanced Micro Devices, Inc. All Rights Reserved.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.
#pragma once
#include "library/defines.hpp"
#include <string>
namespace omnitrace
{
// used for specifying the state of omnitrace
enum class State : unsigned short
{
PreInit = 0,
Init,
Active,
Finalized,
Disabled,
};
// used for specifying the state of omnitrace
enum class ThreadState : unsigned short
{
Enabled = 0,
Internal,
Completed,
Disabled,
};
enum class Mode : unsigned short
{
Trace = 0,
Sampling,
Coverage
};
//
// Runtime configuration data
//
State
get_state() OMNITRACE_HOT;
ThreadState
get_thread_state() OMNITRACE_HOT;
/// returns old state
State set_state(State) OMNITRACE_COLD; // does not change often
/// returns old state
ThreadState set_thread_state(ThreadState) OMNITRACE_HOT; // changes often
/// return current state (state change may be ignored)
ThreadState push_thread_state(ThreadState) OMNITRACE_HOT;
/// return current state (state change may be ignored)
ThreadState
pop_thread_state() OMNITRACE_HOT;
struct scoped_thread_state
{
OMNITRACE_INLINE scoped_thread_state(ThreadState _v) { push_thread_state(_v); }
OMNITRACE_INLINE ~scoped_thread_state() { pop_thread_state(); }
};
} // namespace omnitrace
#define OMNITRACE_SCOPED_THREAD_STATE(STATE) \
::omnitrace::scoped_thread_state OMNITRACE_VARIABLE(_scoped_thread_state_, __LINE__) \
{ \
::omnitrace::STATE \
}
namespace std
{
std::string
to_string(omnitrace::State _v);
std::string
to_string(omnitrace::ThreadState _v);
std::string
to_string(omnitrace::Mode _v);
} // namespace std