Description
Root namespace for bounded, in-memory debugging utilities.
Clock
function Clock return Timestamp
Read the platform monotonic clock in nanosecond units. The backend is mach_absolute_time on Darwin and CLOCK_MONOTONIC_RAW on Linux; actual resolution remains platform-dependent.
Return value
Nanoseconds from the platform monotonic origin
Raised exceptions
- Program_Error
The platform clock read failed
Closed_Error
Closed_Error : exception;
Raised when a producer operation is attempted after terminal closure.
First_Producer
function First_Producer (Producer_Count : Positive) return Positive
Select producer one for tracers that do not configure automatic producer selection. Producer_Count is accepted so this function has the same profile as an application-supplied selector.
Parameters
- Producer_Count
Number of configured producer shards
Return value
One
Overflow_Policy
type Overflow_Policy is (Overwrite_Oldest, Drop_Newest, Block_Producer);
Behavior selected when a tracer's bounded message storage is full.
Enumeration literals
- Overwrite_Oldest
Retain producer progress and the newest evidence while counting overwritten messages.
- Drop_Newest
Preserve retained evidence and count each newly submitted message that cannot be retained.
- Block_Producer
Preserve every accepted message by waiting for a consumer to release retained capacity.
Timestamp
type Timestamp is new Interfaces.Unsigned_64;
Nanoseconds from a platform monotonic origin. Values are suitable for ordering and elapsed-time calculation, not conversion to wall time.