// Copyright 2018 The Chromium OS Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #![recursion_limit = "256"] extern crate proc_macro; extern crate proc_macro2; #[macro_use] extern crate quote; #[macro_use] extern crate syn; use std::string::String; use std::vec::Vec; use proc_macro2::{Span, TokenStream}; use syn::{Data, DeriveInput, Fields, Ident}; type Result = std::result::Result; /// The function that derives the actual implementation. #[proc_macro_attribute] pub fn bitfield( _args: proc_macro::TokenStream, input: proc_macro::TokenStream, ) -> proc_macro::TokenStream { let derive_input = parse_macro_input!(input as DeriveInput); bitfield_impl(derive_input).into() } fn bitfield_impl(ast: DeriveInput) -> TokenStream { if !ast.generics.params.is_empty() { return quote! { compile_error!("#[bitfield] does not support generic parameters"); }; } let name = ast.ident.clone(); let test_mod_ident = Ident::new( format!("test_{}", name.to_string().to_lowercase()).as_str(), Span::call_site(), ); let vis = ast.vis.clone(); let attrs = ast.attrs.clone(); // Visibility. let vis = quote!(#vis); let fields = match get_struct_fields(ast) { Ok(f) => f, Err(err_str) => { return quote! { compile_error!(#err_str); }; } }; let struct_def = get_struct_def(&vis, &name, fields.as_slice()); let bits_impl = get_bits_impl(&name); let fields_impl = get_fields_impl(fields.as_slice()); let tests_impl = get_tests_impl(&name, fields.as_slice()); let debug_fmt_impl = get_debug_fmt_impl(&name, fields.as_slice()); quote! { #(#attrs)* #struct_def #bits_impl impl #name { #(#fields_impl)* } #debug_fmt_impl #[cfg(test)] mod #test_mod_ident { use super::*; #(#tests_impl)* } } } // Unwrap ast to get the named fields. Anything unexpected will be treated as an // error. // We only care about field names and types. // "myfield : BitField3" -> ("myfield", Token(BitField3)) fn get_struct_fields(ast: DeriveInput) -> Result> { let fields = match ast.data { Data::Struct(data_struct) => match data_struct.fields { Fields::Named(fields_named) => fields_named.named, _ => { return Err(format!("Schema must have named fields.")); } }, _ => { return Err(format!("Schema must be a struct.")); } }; let mut vec = Vec::new(); for field in fields { let ident = match field.ident { Some(ident) => ident, None => { return Err(format!( "Unknown Error. bit_field_derive library might have a bug." )); } }; let ty = field.ty; vec.push((ident.to_string(), quote!(#ty))); } Ok(vec) } fn get_struct_def( vis: &TokenStream, name: &Ident, fields: &[(String, TokenStream)], ) -> TokenStream { let mut field_types = Vec::new(); for &(ref _name, ref ty) in fields { field_types.push(ty.clone()); } // `(BitField1::FIELD_WIDTH + BitField3::FIELD_WIDTH + ...)` let data_size_in_bits = quote! { ( #( <#field_types as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize )+* ) }; quote! { #[repr(C)] #vis struct #name { data: [u8; #data_size_in_bits / 8], } impl #name { pub fn new() -> #name { let _: ::bit_field::Check<[u8; #data_size_in_bits % 8]>; #name { data: [0; #data_size_in_bits / 8], } } } } } // Implement setter and getter for all fields. fn get_fields_impl(fields: &[(String, TokenStream)]) -> Vec { let mut impls = Vec::new(); // This vec keeps track of types before this field, used to generate the offset. let mut current_types = vec![quote!(::bit_field::BitField0)]; for &(ref name, ref ty) in fields { // Creating two copies of current types. As they are going to be moved in quote!. let ct0 = current_types.clone(); let ct1 = current_types.clone(); let getter_ident = Ident::new(format!("get_{}", name).as_str(), Span::call_site()); let setter_ident = Ident::new(format!("set_{}", name).as_str(), Span::call_site()); impls.push(quote! { pub fn #getter_ident(&self) -> <#ty as ::bit_field::BitFieldSpecifier>::DefaultFieldType { let offset = #(<#ct0 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize)+*; let val = self.get(offset, <#ty as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH); <#ty as ::bit_field::BitFieldSpecifier>::from_u64(val) } pub fn #setter_ident(&mut self, val: <#ty as ::bit_field::BitFieldSpecifier>::DefaultFieldType) { let val = <#ty as ::bit_field::BitFieldSpecifier>::into_u64(val); debug_assert!(val <= ::bit_field::max::<#ty>()); let offset = #(<#ct1 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize)+*; self.set(offset, <#ty as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH, val) } }); current_types.push(ty.clone()); } impls } // Implement setter and getter for all fields. fn get_debug_fmt_impl(name: &Ident, fields: &[(String, TokenStream)]) -> TokenStream { // print fields: let mut impls = Vec::new(); for &(ref name, ref _ty) in fields { let getter_ident = Ident::new(format!("get_{}", name).as_str(), Span::call_site()); impls.push(quote! { .field(#name, &self.#getter_ident()) }); } let name_str = format!("{}", name); quote! { impl std::fmt::Debug for #name { fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result { f.debug_struct(#name_str) #(#impls)* .finish() } } } } // Implement test. fn get_tests_impl(struct_name: &Ident, fields: &[(String, TokenStream)]) -> Vec { let mut field_types = Vec::new(); for &(ref _name, ref ty) in fields { field_types.push(ty.clone()); } let field_types2 = field_types.clone(); let mut impls = Vec::new(); impls.push(quote! { #[test] fn test_total_size() { let total_size = #(<#field_types as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize)+*; assert_eq!(total_size % 8, 0); } }); impls.push(quote! { #[test] fn test_bits_boundary() { let fields_sizes = vec![#(<#field_types2 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize),*]; let mut sum = 0usize; for s in fields_sizes { if sum % 64 == 0 { assert!(s <= 64); } else { if (sum + s) % 64 != 0 { assert_eq!(sum / 64, (sum + s) / 64); } } sum += s; } } }); for &(ref name, ref ty) in fields { let testname = Ident::new( format!("test_{}", name.as_str()).as_str(), Span::call_site(), ); let getter_ident = Ident::new(format!("get_{}", name.as_str()).as_str(), Span::call_site()); let setter_ident = Ident::new(format!("set_{}", name.as_str()).as_str(), Span::call_site()); impls.push(quote! { #[test] fn #testname() { let mut a = #struct_name::new(); let val = <#ty as ::bit_field::BitFieldSpecifier>::into_u64(a.#getter_ident()); assert_eq!(val, 0); let val = <#ty as ::bit_field::BitFieldSpecifier>::from_u64(::bit_field::max::<#ty>()); a.#setter_ident(val); let val = <#ty as ::bit_field::BitFieldSpecifier>::into_u64(a.#getter_ident()); assert_eq!(val, ::bit_field::max::<#ty>()); } }); } impls } fn get_bits_impl(name: &Ident) -> TokenStream { quote! { impl #name { #[inline] fn check_access(&self, offset: usize, width: u8) { debug_assert!(width <= 64); debug_assert!(offset / 8 < self.data.len()); debug_assert!((offset + (width as usize)) <= (self.data.len() * 8)); } #[inline] pub fn get_bit(&self, offset: usize) -> bool { self.check_access(offset, 1); let byte_index = offset / 8; let bit_offset = offset % 8; let byte = self.data[byte_index]; let mask = 1 << bit_offset; byte & mask == mask } #[inline] pub fn set_bit(&mut self, offset: usize, val: bool) { self.check_access(offset, 1); let byte_index = offset / 8; let bit_offset = offset % 8; let byte = &mut self.data[byte_index]; let mask = 1 << bit_offset; if val { *byte |= mask; } else { *byte &= !mask; } } #[inline] pub fn get(&self, offset: usize, width: u8) -> u64 { self.check_access(offset, width); let mut val = 0; for i in 0..(width as usize) { if self.get_bit(i + offset) { val |= 1 << i; } } val } #[inline] pub fn set(&mut self, offset: usize, width: u8, val: u64) { self.check_access(offset, width); for i in 0..(width as usize) { let mask = 1 << i; let val_bit_is_set = val & mask == mask; self.set_bit(i + offset, val_bit_is_set); } } } } } // Only intended to be used from the bit_field crate. This macro emits the // marker types bit_field::BitField0 through bit_field::BitField64. #[proc_macro] #[doc(hidden)] pub fn define_bit_field_specifiers(_input: proc_macro::TokenStream) -> proc_macro::TokenStream { let mut code = TokenStream::new(); for width in 0u8..=64 { let span = Span::call_site(); let long_name = Ident::new(&format!("BitField{}", width), span); let short_name = Ident::new(&format!("B{}", width), span); let default_field_type = if width <= 8 { quote!(u8) } else if width <= 16 { quote!(u16) } else if width <= 32 { quote!(u32) } else { quote!(u64) }; code.extend(quote! { pub struct #long_name; pub use self::#long_name as #short_name; impl BitFieldSpecifier for #long_name { const FIELD_WIDTH: u8 = #width; type DefaultFieldType = #default_field_type; #[inline] fn from_u64(val: u64) -> Self::DefaultFieldType { val as Self::DefaultFieldType } #[inline] fn into_u64(val: Self::DefaultFieldType) -> u64 { val as u64 } } impl private::Sealed for #long_name {} }); } code.into() } #[cfg(test)] mod tests { use super::*; #[test] fn end_to_end() { let input: DeriveInput = parse_quote! { #[derive(Clone)] struct MyBitField { a: BitField1, b: BitField2, c: BitField5, } }; let expected = quote! { #[derive(Clone)] #[repr(C)] struct MyBitField { data: [u8; (::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize) / 8], } impl MyBitField { pub fn new() -> MyBitField { let _: ::bit_field::Check<[ u8; (::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize) % 8 ]>; MyBitField { data: [0; (::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize) / 8], } } } impl MyBitField { #[inline] fn check_access(&self, offset: usize, width: u8) { debug_assert!(width <= 64); debug_assert!(offset / 8 < self.data.len()); debug_assert!((offset + (width as usize)) <= (self.data.len() * 8)); } #[inline] pub fn get_bit(&self, offset: usize) -> bool { self.check_access(offset, 1); let byte_index = offset / 8; let bit_offset = offset % 8; let byte = self.data[byte_index]; let mask = 1 << bit_offset; byte & mask == mask } #[inline] pub fn set_bit(&mut self, offset: usize, val: bool) { self.check_access(offset, 1); let byte_index = offset / 8; let bit_offset = offset % 8; let byte = &mut self.data[byte_index]; let mask = 1 << bit_offset; if val { *byte |= mask; } else { *byte &= !mask; } } #[inline] pub fn get(&self, offset: usize, width: u8) -> u64 { self.check_access(offset, width); let mut val = 0; for i in 0..(width as usize) { if self.get_bit(i + offset) { val |= 1 << i; } } val } #[inline] pub fn set(&mut self, offset: usize, width: u8, val: u64) { self.check_access(offset, width); for i in 0..(width as usize) { let mask = 1 << i; let val_bit_is_set = val & mask == mask; self.set_bit(i + offset, val_bit_is_set); } } } impl MyBitField { pub fn get_a(&self) -> ::DefaultFieldType { let offset = <::bit_field::BitField0 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize; let val = self.get(offset, ::FIELD_WIDTH); ::from_u64(val) } pub fn set_a(&mut self, val: ::DefaultFieldType) { let val = ::into_u64(val); debug_assert!(val <= ::bit_field::max::()); let offset = <::bit_field::BitField0 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize; self.set(offset, ::FIELD_WIDTH, val) } pub fn get_b(&self) -> ::DefaultFieldType { let offset = <::bit_field::BitField0 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize; let val = self.get(offset, ::FIELD_WIDTH); ::from_u64(val) } pub fn set_b(&mut self, val: ::DefaultFieldType) { let val = ::into_u64(val); debug_assert!(val <= ::bit_field::max::()); let offset = <::bit_field::BitField0 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize; self.set(offset, ::FIELD_WIDTH, val) } pub fn get_c(&self) -> ::DefaultFieldType { let offset = <::bit_field::BitField0 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize; let val = self.get(offset, ::FIELD_WIDTH); ::from_u64(val) } pub fn set_c(&mut self, val: ::DefaultFieldType) { let val = ::into_u64(val); debug_assert!(val <= ::bit_field::max::()); let offset = <::bit_field::BitField0 as ::bit_field::BitFieldSpecifier>::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize; self.set(offset, ::FIELD_WIDTH, val) } } impl std::fmt::Debug for MyBitField { fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result { f.debug_struct("MyBitField") .field("a", &self.get_a()) .field("b", &self.get_b()) .field("c", &self.get_c()) .finish() } } #[cfg(test)] mod test_mybitfield { use super::*; #[test] fn test_total_size() { let total_size = ::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize + ::FIELD_WIDTH as usize; assert_eq!(total_size % 8, 0); } #[test] fn test_bits_boundary() { let fields_sizes = vec![ ::FIELD_WIDTH as usize, ::FIELD_WIDTH as usize, ::FIELD_WIDTH as usize ]; let mut sum = 0usize; for s in fields_sizes { if sum % 64 == 0 { assert!(s <= 64); } else { if (sum + s) % 64 != 0 { assert_eq!(sum / 64, (sum + s) / 64); } } sum += s; } } #[test] fn test_a() { let mut a = MyBitField::new(); let val = ::into_u64(a.get_a()); assert_eq!(val, 0); let val = ::from_u64(::bit_field::max::()); a.set_a(val); let val = ::into_u64(a.get_a()); assert_eq!(val, ::bit_field::max::()); } #[test] fn test_b() { let mut a = MyBitField::new(); let val = ::into_u64(a.get_b()); assert_eq!(val, 0); let val = ::from_u64(::bit_field::max::()); a.set_b(val); let val = ::into_u64(a.get_b()); assert_eq!(val, ::bit_field::max::()); } #[test] fn test_c() { let mut a = MyBitField::new(); let val = ::into_u64(a.get_c()); assert_eq!(val, 0); let val = ::from_u64(::bit_field::max::()); a.set_c(val); let val = ::into_u64(a.get_c()); assert_eq!(val, ::bit_field::max::()); } } }; assert_eq!(bitfield_impl(input).to_string(), expected.to_string()); } }