Struct LogEntry 

#[repr(C, align(8))]
pub struct LogEntry {
    seq: AtomicUsize,
    level: LogLevel,
    cpu_id: usize,
    length: usize,
    task_id: u32,
    timestamp: usize,
    message: [u8; 256],
}

带有元数据和消息的单个日志条目

该结构体经过精心布局，用于无锁同步：

• seq 字段用作生产者和消费者之间的同步点
• 带有 8 字节对齐的 C 表示形式确保了正确的原子访问
• 字段顺序经过优化以最小化填充

Fields

seq: AtomicUsize

用于同步的序列号（必须是第一个字段）

level: LogLevel

日志级别 (Emergency, Error, Info, 等)

cpu_id: usize

生成此日志的 CPU ID

length: usize

消息的实际长度（以字节为单位）

task_id: u32

生成此日志的任务/进程 ID

timestamp: usize

创建日志时的时间戳

message: [u8; 256]

用于日志消息的固定大小缓冲区

Implementations

impl LogEntry

pub const fn empty() -> Self

创建一个空的日志条目（用于初始化）

这是一个 const fn，因此可以在编译时进行评估， 允许对全局缓冲区进行常数初始化。

pub(super) fn from_args( level: LogLevel, cpu_id: usize, task_id: u32, timestamp: usize, args: Arguments<'_>, ) -> Self

从格式化参数创建日志条目

参数

• level - 日志级别
• cpu_id - 生成日志的 CPU ID
• task_id - 生成日志的任务 ID
• timestamp - 日志的时间戳
• args - 来自 format_args! 宏的格式化参数

pub fn message(&self) -> &str

将日志消息作为字符串切片返回

pub fn level(&self) -> LogLevel

返回日志级别

pub fn cpu_id(&self) -> usize

返回生成此日志的 CPU ID

pub fn task_id(&self) -> u32

返回生成此日志的任务 ID

pub fn timestamp(&self) -> usize

返回此日志的时间戳

impl LogEntry

pub(super) unsafe fn copy_data_to(&self, dest: *mut LogEntry)

将日志数据复制到缓冲区槽中（供内部使用）

复制除 seq 字段外的所有字段，seq 字段必须 通过 publish() 单独设置，以确保正确的内存顺序。

安全性

dest 必须指向环形缓冲区中有效的 LogEntry

pub(super) unsafe fn publish(&self, dest: *mut LogEntry, seq_num: usize)

通过设置其序列号来发布条目（供内部使用）

使用 Release 内存顺序，以确保在序列号更新之前， 所有数据写入对其他核心都是可见的。

安全性

dest 必须指向环形缓冲区中有效的 LogEntry

pub(super) unsafe fn is_ready( &self, slot_ptr: *const LogEntry, expected_seq: usize, ) -> bool

检查槽是否已准备好读取（供内部使用）

使用 Acquire 内存顺序与生产者在 publish() 中的 Release 存储配对， 确保正确的同步。

安全性

slot_ptr 必须指向环形缓冲区中有效的 LogEntry

Trait Implementations

impl Clone for LogEntry

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LogEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for LogEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.