eventheader_macros 0.5.0

Rust macros for eventheader-encoded Linux Tracepoints via user_events
Documentation 
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

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT license.

#![allow(clippy::needless_return)]

//! Implements the macros that are exported by the eventheader crate.
//!
//! # Changelog
//!
//! ## v0.4.1 (2025-02-28)
//! - Handle invisible delimiters to support use of eventheader macros from
//!   within other macros.
//!
//! ## v0.3.0 (2023-06-29)
//! - If no consumers have enabled a tracepoint, the kernel now returns
//!   `EBADF`. The eventheader crate has been updated to be consistent with
//!   the new behavior.
//!
//! ## v0.2.0 (2023-05-16)
//! - Add support for macro-based logging.

extern crate proc_macro;
use proc_macro::{Span, TokenStream};

use crate::enabled_generator::EnabledGenerator;
use crate::enabled_info::EnabledInfo;
use crate::event_generator::EventGenerator;
use crate::event_info::EventInfo;
use crate::provider_generator::ProviderGenerator;
use crate::provider_info::ProviderInfo;

#[proc_macro]
pub fn define_provider(arg_tokens: TokenStream) -> TokenStream {
    let call_site = Span::call_site();
    return match ProviderInfo::try_from_tokens(call_site, arg_tokens) {
        Err(error_tokens) => error_tokens,
        Ok(prov) => ProviderGenerator::new(call_site).generate(prov),
    };
}

#[proc_macro]
pub fn provider_enabled(arg_tokens: TokenStream) -> TokenStream {
    let call_site = Span::call_site();
    return match EnabledInfo::try_from_tokens(call_site, arg_tokens) {
        Err(error_tokens) => error_tokens,
        Ok(enabled) => EnabledGenerator::new(call_site).generate(enabled),
    };
}

#[proc_macro]
pub fn write_event(arg_tokens: TokenStream) -> TokenStream {
    let call_site = Span::call_site();
    return match EventInfo::try_from_tokens(call_site, arg_tokens) {
        Err(error_tokens) => error_tokens,
        Ok(prov) => EventGenerator::new(call_site).generate(prov),
    };
}

mod enabled_generator;
mod enabled_info;
mod enums;
mod errors;
mod event_generator;
mod event_info;
mod expression;
mod field_info;
mod field_option;
mod field_options;
mod ident_builder;
mod parser;
mod provider_generator;
mod provider_info;
mod strings;
mod tree;