#![no_std] use core::{cmp, mem, ptr}; pub const LOG_BUF_CAPACITY: usize = 8192; pub const LOG_FIELDS: usize = 7; #[repr(usize)] #[derive(Copy, Clone, Eq, PartialEq, Debug, Hash)] pub enum Level { /// The "error" level. /// /// Designates very serious errors. Error = 1, /// The "warn" level. /// /// Designates hazardous situations. Warn, /// The "info" level. /// /// Designates useful information. Info, /// The "debug" level. /// /// Designates lower priority information. Debug, /// The "trace" level. /// /// Designates very low priority, often extremely verbose, information. Trace, } #[repr(usize)] #[derive(Copy, Clone, Debug)] pub enum RecordField { Target = 1, Level, Module, File, Line, NumArgs, Log, } #[repr(usize)] #[derive(Copy, Clone, Debug)] pub enum ArgType { I8, I16, I32, I64, Isize, U8, U16, U32, U64, Usize, F32, F64, Str, } #[cfg(feature = "userspace")] mod userspace { use super::*; unsafe impl aya::Pod for RecordField {} unsafe impl aya::Pod for ArgType {} } struct TagLenValue<'a, T> { tag: T, value: &'a [u8], } impl<'a, T> TagLenValue<'a, T> where T: Copy, { #[inline(always)] pub(crate) fn new(tag: T, value: &'a [u8]) -> TagLenValue<'a, T> { TagLenValue { tag, value } } pub(crate) fn write(&self, mut buf: &mut [u8]) -> Result { let size = mem::size_of::() + mem::size_of::() + self.value.len(); let remaining = cmp::min(buf.len(), LOG_BUF_CAPACITY); // Check if the size doesn't exceed the buffer bounds. if size > remaining { return Err(()); } unsafe { ptr::write_unaligned(buf.as_mut_ptr() as *mut _, self.tag) }; buf = &mut buf[mem::size_of::()..]; unsafe { ptr::write_unaligned(buf.as_mut_ptr() as *mut _, self.value.len()) }; buf = &mut buf[mem::size_of::()..]; let len = cmp::min(buf.len(), self.value.len()); // The verifier isn't happy with `len` being unbounded, so compare it // with `LOG_BUF_CAPACITY`. if len > LOG_BUF_CAPACITY { return Err(()); } buf[..len].copy_from_slice(&self.value[..len]); Ok(size) } } pub trait WriteToBuf { #[allow(clippy::result_unit_err)] fn write(&self, buf: &mut [u8]) -> Result; } macro_rules! impl_write_to_buf { ($type:ident, $arg_type:expr) => { impl WriteToBuf for $type { fn write(&self, buf: &mut [u8]) -> Result { TagLenValue::::new($arg_type, &self.to_ne_bytes()).write(buf) } } }; } impl_write_to_buf!(i8, ArgType::I8); impl_write_to_buf!(i16, ArgType::I16); impl_write_to_buf!(i32, ArgType::I32); impl_write_to_buf!(i64, ArgType::I64); impl_write_to_buf!(isize, ArgType::Isize); impl_write_to_buf!(u8, ArgType::U8); impl_write_to_buf!(u16, ArgType::U16); impl_write_to_buf!(u32, ArgType::U32); impl_write_to_buf!(u64, ArgType::U64); impl_write_to_buf!(usize, ArgType::Usize); impl_write_to_buf!(f32, ArgType::F32); impl_write_to_buf!(f64, ArgType::F64); impl WriteToBuf for str { fn write(&self, buf: &mut [u8]) -> Result { TagLenValue::::new(ArgType::Str, self.as_bytes()).write(buf) } } #[allow(clippy::result_unit_err)] #[doc(hidden)] #[inline(always)] pub fn write_record_header( buf: &mut [u8], target: &str, level: Level, module: &str, file: &str, line: u32, num_args: usize, ) -> Result { let mut size = 0; for attr in [ TagLenValue::::new(RecordField::Target, target.as_bytes()), TagLenValue::::new(RecordField::Level, &(level as usize).to_ne_bytes()), TagLenValue::::new(RecordField::Module, module.as_bytes()), TagLenValue::::new(RecordField::File, file.as_bytes()), TagLenValue::::new(RecordField::Line, &line.to_ne_bytes()), TagLenValue::::new(RecordField::NumArgs, &num_args.to_ne_bytes()), ] { size += attr.write(&mut buf[size..])?; } Ok(size) } #[allow(clippy::result_unit_err)] #[doc(hidden)] pub fn write_record_message(buf: &mut [u8], msg: &str) -> Result { TagLenValue::::new(RecordField::Log, msg.as_bytes()).write(buf) }