blob: c4858db22ca3efe9b07ea9ab395e9c77a6d7b60e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
//! Gecko profiler state.
/// Whether the Gecko profiler is currently active.
/// A typical use of this API:
/// ```rust
/// if gecko_profiler::is_active() {
/// // do something.
/// }
/// ```
///
/// This implementation must be kept in sync with
/// `mozilla::profiler::detail::RacyFeatures::IsActive`.
#[cfg(feature = "enabled")]
#[inline]
pub fn is_active() -> bool {
use crate::gecko_bindings::structs::mozilla::profiler::detail;
let active_and_features = get_active_and_features();
(active_and_features & detail::RacyFeatures_Active) != 0
}
/// Always false when MOZ_GECKO_PROFILER is not defined.
#[cfg(not(feature = "enabled"))]
#[inline]
pub fn is_active() -> bool {
false
}
/// Whether the Gecko Profiler can accept markers.
/// Similar to `is_active`, but with some extra checks that determine if the
/// profiler would currently store markers. So this should be used before
/// doing some potentially-expensive work that's used in a marker. E.g.:
///
/// ```rust
/// if gecko_profiler::can_accept_markers() {
/// // Do something expensive and add the marker with that data.
/// }
/// ```
///
/// This implementation must be kept in sync with
/// `mozilla::profiler::detail::RacyFeatures::IsActiveAndUnpaused`.
#[cfg(feature = "enabled")]
#[inline]
pub fn can_accept_markers() -> bool {
use crate::gecko_bindings::structs::mozilla::profiler::detail;
let active_and_features = get_active_and_features();
(active_and_features & detail::RacyFeatures_Active) != 0
&& (active_and_features & detail::RacyFeatures_Paused) == 0
}
/// Always false when MOZ_GECKO_PROFILER is not defined.
#[cfg(not(feature = "enabled"))]
#[inline]
pub fn can_accept_markers() -> bool {
false
}
/// Returns the value of atomic `RacyFeatures::sActiveAndFeatures` from the C++ side.
#[cfg(feature = "enabled")]
#[inline]
fn get_active_and_features() -> u32 {
use crate::gecko_bindings::structs::mozilla::profiler::detail;
use std::sync::atomic::{AtomicU32, Ordering};
// This is reaching for the C++ atomic value instead of calling an FFI
// function to return this value. Because, calling an FFI function is much
// more expensive compared to this method. That's why it's worth to go with
// this solution for performance. But it's crucial to keep the implementation
// of this and the callers in sync with the C++ counterparts.
let active_and_features: &AtomicU32 = unsafe {
let ptr: *const u32 = std::ptr::addr_of!(detail::RacyFeatures_sActiveAndFeatures);
// TODO: Switch this to use `AtomicU32::from_ptr` once our Rust MSRV is at least 1.75.0
&*ptr.cast()
};
active_and_features.load(Ordering::Relaxed)
}
|
