use crate::common::{ DebugAddrBase, DebugAddrIndex, DebugLocListsBase, DebugLocListsIndex, DwarfFileType, Encoding, LocationListsOffset, SectionId, }; use crate::constants; use crate::endianity::Endianity; use crate::read::{ lists::ListsHeader, DebugAddr, EndianSlice, Error, Expression, Range, RawRange, Reader, ReaderOffset, ReaderOffsetId, Result, Section, }; /// The raw contents of the `.debug_loc` section. #[derive(Debug, Default, Clone, Copy)] pub struct DebugLoc { pub(crate) section: R, } impl<'input, Endian> DebugLoc> where Endian: Endianity, { /// Construct a new `DebugLoc` instance from the data in the `.debug_loc` /// section. /// /// It is the caller's responsibility to read the `.debug_loc` section and /// present it as a `&[u8]` slice. That means using some ELF loader on /// Linux, a Mach-O loader on macOS, etc. /// /// ``` /// use gimli::{DebugLoc, LittleEndian}; /// /// # let buf = [0x00, 0x01, 0x02, 0x03]; /// # let read_debug_loc_section_somehow = || &buf; /// let debug_loc = DebugLoc::new(read_debug_loc_section_somehow(), LittleEndian); /// ``` pub fn new(section: &'input [u8], endian: Endian) -> Self { Self::from(EndianSlice::new(section, endian)) } } impl Section for DebugLoc { fn id() -> SectionId { SectionId::DebugLoc } fn reader(&self) -> &R { &self.section } } impl From for DebugLoc { fn from(section: R) -> Self { DebugLoc { section } } } /// The `DebugLocLists` struct represents the DWARF data /// found in the `.debug_loclists` section. #[derive(Debug, Default, Clone, Copy)] pub struct DebugLocLists { section: R, } impl<'input, Endian> DebugLocLists> where Endian: Endianity, { /// Construct a new `DebugLocLists` instance from the data in the `.debug_loclists` /// section. /// /// It is the caller's responsibility to read the `.debug_loclists` section and /// present it as a `&[u8]` slice. That means using some ELF loader on /// Linux, a Mach-O loader on macOS, etc. /// /// ``` /// use gimli::{DebugLocLists, LittleEndian}; /// /// # let buf = [0x00, 0x01, 0x02, 0x03]; /// # let read_debug_loclists_section_somehow = || &buf; /// let debug_loclists = DebugLocLists::new(read_debug_loclists_section_somehow(), LittleEndian); /// ``` pub fn new(section: &'input [u8], endian: Endian) -> Self { Self::from(EndianSlice::new(section, endian)) } } impl Section for DebugLocLists { fn id() -> SectionId { SectionId::DebugLocLists } fn reader(&self) -> &R { &self.section } } impl From for DebugLocLists { fn from(section: R) -> Self { DebugLocLists { section } } } pub(crate) type LocListsHeader = ListsHeader; impl DebugLocListsBase where Offset: ReaderOffset, { /// Returns a `DebugLocListsBase` with the default value of DW_AT_loclists_base /// for the given `Encoding` and `DwarfFileType`. pub fn default_for_encoding_and_file( encoding: Encoding, file_type: DwarfFileType, ) -> DebugLocListsBase { if encoding.version >= 5 && file_type == DwarfFileType::Dwo { // In .dwo files, the compiler omits the DW_AT_loclists_base attribute (because there is // only a single unit in the file) but we must skip past the header, which the attribute // would normally do for us. DebugLocListsBase(Offset::from_u8(LocListsHeader::size_for_encoding(encoding))) } else { DebugLocListsBase(Offset::from_u8(0)) } } } /// The DWARF data found in `.debug_loc` and `.debug_loclists` sections. #[derive(Debug, Default, Clone, Copy)] pub struct LocationLists { debug_loc: DebugLoc, debug_loclists: DebugLocLists, } impl LocationLists { /// Construct a new `LocationLists` instance from the data in the `.debug_loc` and /// `.debug_loclists` sections. pub fn new(debug_loc: DebugLoc, debug_loclists: DebugLocLists) -> LocationLists { LocationLists { debug_loc, debug_loclists, } } } impl LocationLists { /// Create a `LocationLists` that references the data in `self`. /// /// This is useful when `R` implements `Reader` but `T` does not. /// /// ## Example Usage /// /// ```rust,no_run /// # let load_section = || unimplemented!(); /// // Read the DWARF section into a `Vec` with whatever object loader you're using. /// let owned_section: gimli::LocationLists> = load_section(); /// // Create a reference to the DWARF section. /// let section = owned_section.borrow(|section| { /// gimli::EndianSlice::new(§ion, gimli::LittleEndian) /// }); /// ``` pub fn borrow<'a, F, R>(&'a self, mut borrow: F) -> LocationLists where F: FnMut(&'a T) -> R, { LocationLists { debug_loc: borrow(&self.debug_loc.section).into(), debug_loclists: borrow(&self.debug_loclists.section).into(), } } } impl LocationLists { /// Iterate over the `LocationListEntry`s starting at the given offset. /// /// The `unit_encoding` must match the compilation unit that the /// offset was contained in. /// /// The `base_address` should be obtained from the `DW_AT_low_pc` attribute in the /// `DW_TAG_compile_unit` entry for the compilation unit that contains this location /// list. /// /// Can be [used with /// `FallibleIterator`](./index.html#using-with-fallibleiterator). pub fn locations( &self, offset: LocationListsOffset, unit_encoding: Encoding, base_address: u64, debug_addr: &DebugAddr, debug_addr_base: DebugAddrBase, ) -> Result> { Ok(LocListIter::new( self.raw_locations(offset, unit_encoding)?, base_address, debug_addr.clone(), debug_addr_base, )) } /// Similar to `locations`, but with special handling for .dwo files. /// This should only been used when this `LocationLists` was loaded from a /// .dwo file. pub fn locations_dwo( &self, offset: LocationListsOffset, unit_encoding: Encoding, base_address: u64, debug_addr: &DebugAddr, debug_addr_base: DebugAddrBase, ) -> Result> { Ok(LocListIter::new( self.raw_locations_dwo(offset, unit_encoding)?, base_address, debug_addr.clone(), debug_addr_base, )) } /// Iterate over the raw `LocationListEntry`s starting at the given offset. /// /// The `unit_encoding` must match the compilation unit that the /// offset was contained in. /// /// This iterator does not perform any processing of the location entries, /// such as handling base addresses. /// /// Can be [used with /// `FallibleIterator`](./index.html#using-with-fallibleiterator). pub fn raw_locations( &self, offset: LocationListsOffset, unit_encoding: Encoding, ) -> Result> { let (mut input, format) = if unit_encoding.version <= 4 { (self.debug_loc.section.clone(), LocListsFormat::Bare) } else { (self.debug_loclists.section.clone(), LocListsFormat::Lle) }; input.skip(offset.0)?; Ok(RawLocListIter::new(input, unit_encoding, format)) } /// Similar to `raw_locations`, but with special handling for .dwo files. /// This should only been used when this `LocationLists` was loaded from a /// .dwo file. pub fn raw_locations_dwo( &self, offset: LocationListsOffset, unit_encoding: Encoding, ) -> Result> { let mut input = if unit_encoding.version <= 4 { // In the GNU split dwarf extension the locations are present in the // .debug_loc section but are encoded with the DW_LLE values used // for the DWARF 5 .debug_loclists section. self.debug_loc.section.clone() } else { self.debug_loclists.section.clone() }; input.skip(offset.0)?; Ok(RawLocListIter::new( input, unit_encoding, LocListsFormat::Lle, )) } /// Returns the `.debug_loclists` offset at the given `base` and `index`. /// /// The `base` must be the `DW_AT_loclists_base` value from the compilation unit DIE. /// This is an offset that points to the first entry following the header. /// /// The `index` is the value of a `DW_FORM_loclistx` attribute. pub fn get_offset( &self, unit_encoding: Encoding, base: DebugLocListsBase, index: DebugLocListsIndex, ) -> Result> { let format = unit_encoding.format; let input = &mut self.debug_loclists.section.clone(); input.skip(base.0)?; input.skip(R::Offset::from_u64( index.0.into_u64() * u64::from(format.word_size()), )?)?; input .read_offset(format) .map(|x| LocationListsOffset(base.0 + x)) } /// Call `Reader::lookup_offset_id` for each section, and return the first match. pub fn lookup_offset_id(&self, id: ReaderOffsetId) -> Option<(SectionId, R::Offset)> { self.debug_loc .lookup_offset_id(id) .or_else(|| self.debug_loclists.lookup_offset_id(id)) } } #[derive(Debug, Clone, Copy, PartialEq, Eq)] enum LocListsFormat { /// The bare location list format used before DWARF 5. Bare, /// The DW_LLE encoded range list format used in DWARF 5 and the non-standard GNU /// split dwarf extension. Lle, } /// A raw iterator over a location list. /// /// This iterator does not perform any processing of the location entries, /// such as handling base addresses. #[derive(Debug)] pub struct RawLocListIter { input: R, encoding: Encoding, format: LocListsFormat, } /// A raw entry in .debug_loclists. #[derive(Clone, Debug)] pub enum RawLocListEntry { /// A location from DWARF version <= 4. AddressOrOffsetPair { /// Start of range. May be an address or an offset. begin: u64, /// End of range. May be an address or an offset. end: u64, /// expression data: Expression, }, /// DW_LLE_base_address BaseAddress { /// base address addr: u64, }, /// DW_LLE_base_addressx BaseAddressx { /// base address addr: DebugAddrIndex, }, /// DW_LLE_startx_endx StartxEndx { /// start of range begin: DebugAddrIndex, /// end of range end: DebugAddrIndex, /// expression data: Expression, }, /// DW_LLE_startx_length StartxLength { /// start of range begin: DebugAddrIndex, /// length of range length: u64, /// expression data: Expression, }, /// DW_LLE_offset_pair OffsetPair { /// start of range begin: u64, /// end of range end: u64, /// expression data: Expression, }, /// DW_LLE_default_location DefaultLocation { /// expression data: Expression, }, /// DW_LLE_start_end StartEnd { /// start of range begin: u64, /// end of range end: u64, /// expression data: Expression, }, /// DW_LLE_start_length StartLength { /// start of range begin: u64, /// length of range length: u64, /// expression data: Expression, }, } fn parse_data(input: &mut R, encoding: Encoding) -> Result> { if encoding.version >= 5 { let len = R::Offset::from_u64(input.read_uleb128()?)?; Ok(Expression(input.split(len)?)) } else { // In the GNU split-dwarf extension this is a fixed 2 byte value. let len = R::Offset::from_u16(input.read_u16()?); Ok(Expression(input.split(len)?)) } } impl RawLocListEntry { /// Parse a location list entry from `.debug_loclists` fn parse(input: &mut R, encoding: Encoding, format: LocListsFormat) -> Result> { Ok(match format { LocListsFormat::Bare => { let range = RawRange::parse(input, encoding.address_size)?; if range.is_end() { None } else if range.is_base_address(encoding.address_size) { Some(RawLocListEntry::BaseAddress { addr: range.end }) } else { let len = R::Offset::from_u16(input.read_u16()?); let data = Expression(input.split(len)?); Some(RawLocListEntry::AddressOrOffsetPair { begin: range.begin, end: range.end, data, }) } } LocListsFormat::Lle => match constants::DwLle(input.read_u8()?) { constants::DW_LLE_end_of_list => None, constants::DW_LLE_base_addressx => Some(RawLocListEntry::BaseAddressx { addr: DebugAddrIndex(input.read_uleb128().and_then(R::Offset::from_u64)?), }), constants::DW_LLE_startx_endx => Some(RawLocListEntry::StartxEndx { begin: DebugAddrIndex(input.read_uleb128().and_then(R::Offset::from_u64)?), end: DebugAddrIndex(input.read_uleb128().and_then(R::Offset::from_u64)?), data: parse_data(input, encoding)?, }), constants::DW_LLE_startx_length => Some(RawLocListEntry::StartxLength { begin: DebugAddrIndex(input.read_uleb128().and_then(R::Offset::from_u64)?), length: if encoding.version >= 5 { input.read_uleb128()? } else { // In the GNU split-dwarf extension this is a fixed 4 byte value. input.read_u32()? as u64 }, data: parse_data(input, encoding)?, }), constants::DW_LLE_offset_pair => Some(RawLocListEntry::OffsetPair { begin: input.read_uleb128()?, end: input.read_uleb128()?, data: parse_data(input, encoding)?, }), constants::DW_LLE_default_location => Some(RawLocListEntry::DefaultLocation { data: parse_data(input, encoding)?, }), constants::DW_LLE_base_address => Some(RawLocListEntry::BaseAddress { addr: input.read_address(encoding.address_size)?, }), constants::DW_LLE_start_end => Some(RawLocListEntry::StartEnd { begin: input.read_address(encoding.address_size)?, end: input.read_address(encoding.address_size)?, data: parse_data(input, encoding)?, }), constants::DW_LLE_start_length => Some(RawLocListEntry::StartLength { begin: input.read_address(encoding.address_size)?, length: input.read_uleb128()?, data: parse_data(input, encoding)?, }), _ => { return Err(Error::InvalidAddressRange); } }, }) } } impl RawLocListIter { /// Construct a `RawLocListIter`. fn new(input: R, encoding: Encoding, format: LocListsFormat) -> RawLocListIter { RawLocListIter { input, encoding, format, } } /// Advance the iterator to the next location. pub fn next(&mut self) -> Result>> { if self.input.is_empty() { return Ok(None); } match RawLocListEntry::parse(&mut self.input, self.encoding, self.format) { Ok(entry) => { if entry.is_none() { self.input.empty(); } Ok(entry) } Err(e) => { self.input.empty(); Err(e) } } } } #[cfg(feature = "fallible-iterator")] impl fallible_iterator::FallibleIterator for RawLocListIter { type Item = RawLocListEntry; type Error = Error; fn next(&mut self) -> ::core::result::Result, Self::Error> { RawLocListIter::next(self) } } /// An iterator over a location list. /// /// This iterator internally handles processing of base address selection entries /// and list end entries. Thus, it only returns location entries that are valid /// and already adjusted for the base address. #[derive(Debug)] pub struct LocListIter { raw: RawLocListIter, base_address: u64, debug_addr: DebugAddr, debug_addr_base: DebugAddrBase, } impl LocListIter { /// Construct a `LocListIter`. fn new( raw: RawLocListIter, base_address: u64, debug_addr: DebugAddr, debug_addr_base: DebugAddrBase, ) -> LocListIter { LocListIter { raw, base_address, debug_addr, debug_addr_base, } } #[inline] fn get_address(&self, index: DebugAddrIndex) -> Result { self.debug_addr .get_address(self.raw.encoding.address_size, self.debug_addr_base, index) } /// Advance the iterator to the next location. pub fn next(&mut self) -> Result>> { loop { let raw_loc = match self.raw.next()? { Some(loc) => loc, None => return Ok(None), }; let loc = self.convert_raw(raw_loc)?; if loc.is_some() { return Ok(loc); } } } /// Return the next raw location. /// /// The raw location should be passed to `convert_raw`. #[doc(hidden)] pub fn next_raw(&mut self) -> Result>> { self.raw.next() } /// Convert a raw location into a location, and update the state of the iterator. /// /// The raw location should have been obtained from `next_raw`. #[doc(hidden)] pub fn convert_raw( &mut self, raw_loc: RawLocListEntry, ) -> Result>> { let mask = !0 >> (64 - self.raw.encoding.address_size * 8); let tombstone = if self.raw.encoding.version <= 4 { mask - 1 } else { mask }; let (range, data) = match raw_loc { RawLocListEntry::BaseAddress { addr } => { self.base_address = addr; return Ok(None); } RawLocListEntry::BaseAddressx { addr } => { self.base_address = self.get_address(addr)?; return Ok(None); } RawLocListEntry::StartxEndx { begin, end, data } => { let begin = self.get_address(begin)?; let end = self.get_address(end)?; (Range { begin, end }, data) } RawLocListEntry::StartxLength { begin, length, data, } => { let begin = self.get_address(begin)?; let end = begin.wrapping_add(length) & mask; (Range { begin, end }, data) } RawLocListEntry::DefaultLocation { data } => ( Range { begin: 0, end: u64::max_value(), }, data, ), RawLocListEntry::AddressOrOffsetPair { begin, end, data } | RawLocListEntry::OffsetPair { begin, end, data } => { if self.base_address == tombstone { return Ok(None); } let mut range = Range { begin, end }; range.add_base_address(self.base_address, self.raw.encoding.address_size); (range, data) } RawLocListEntry::StartEnd { begin, end, data } => (Range { begin, end }, data), RawLocListEntry::StartLength { begin, length, data, } => { let end = begin.wrapping_add(length) & mask; (Range { begin, end }, data) } }; if range.begin == tombstone { return Ok(None); } if range.begin > range.end { self.raw.input.empty(); return Err(Error::InvalidLocationAddressRange); } Ok(Some(LocationListEntry { range, data })) } } #[cfg(feature = "fallible-iterator")] impl fallible_iterator::FallibleIterator for LocListIter { type Item = LocationListEntry; type Error = Error; fn next(&mut self) -> ::core::result::Result, Self::Error> { LocListIter::next(self) } } /// A location list entry from the `.debug_loc` or `.debug_loclists` sections. #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct LocationListEntry { /// The address range that this location is valid for. pub range: Range, /// The data containing a single location description. pub data: Expression, } #[cfg(test)] mod tests { use super::*; use crate::common::Format; use crate::endianity::LittleEndian; use crate::read::{EndianSlice, Range}; use crate::test_util::GimliSectionMethods; use test_assembler::{Endian, Label, LabelMaker, Section}; #[test] fn test_loclists_32() { let tombstone = !0u32; let encoding = Encoding { format: Format::Dwarf32, version: 5, address_size: 4, }; let section = Section::with_endian(Endian::Little) .L32(0x0300_0000) .L32(0x0301_0300) .L32(0x0301_0400) .L32(0x0301_0500) .L32(tombstone) .L32(0x0301_0600); let buf = section.get_contents().unwrap(); let debug_addr = &DebugAddr::from(EndianSlice::new(&buf, LittleEndian)); let debug_addr_base = DebugAddrBase(0); let start = Label::new(); let first = Label::new(); let size = Label::new(); #[rustfmt::skip] let section = Section::with_endian(Endian::Little) // Header .mark(&start) .L32(&size) .L16(encoding.version) .L8(encoding.address_size) .L8(0) .L32(0) .mark(&first) // OffsetPair .L8(4).uleb(0x10200).uleb(0x10300).uleb(4).L32(2) // A base address selection followed by an OffsetPair. .L8(6).L32(0x0200_0000) .L8(4).uleb(0x10400).uleb(0x10500).uleb(4).L32(3) // An empty OffsetPair followed by a normal OffsetPair. .L8(4).uleb(0x10600).uleb(0x10600).uleb(4).L32(4) .L8(4).uleb(0x10800).uleb(0x10900).uleb(4).L32(5) // A StartEnd .L8(7).L32(0x201_0a00).L32(0x201_0b00).uleb(4).L32(6) // A StartLength .L8(8).L32(0x201_0c00).uleb(0x100).uleb(4).L32(7) // An OffsetPair that starts at 0. .L8(4).uleb(0).uleb(1).uleb(4).L32(8) // An OffsetPair that ends at -1. .L8(6).L32(0) .L8(4).uleb(0).uleb(0xffff_ffff).uleb(4).L32(9) // A DefaultLocation .L8(5).uleb(4).L32(10) // A BaseAddressx + OffsetPair .L8(1).uleb(0) .L8(4).uleb(0x10100).uleb(0x10200).uleb(4).L32(11) // A StartxEndx .L8(2).uleb(1).uleb(2).uleb(4).L32(12) // A StartxLength .L8(3).uleb(3).uleb(0x100).uleb(4).L32(13) // Tombstone entries, all of which should be ignored. // A BaseAddressx that is a tombstone. .L8(1).uleb(4) .L8(4).uleb(0x11100).uleb(0x11200).uleb(4).L32(20) // A BaseAddress that is a tombstone. .L8(6).L32(tombstone) .L8(4).uleb(0x11300).uleb(0x11400).uleb(4).L32(21) // A StartxEndx that is a tombstone. .L8(2).uleb(4).uleb(5).uleb(4).L32(22) // A StartxLength that is a tombstone. .L8(3).uleb(4).uleb(0x100).uleb(4).L32(23) // A StartEnd that is a tombstone. .L8(7).L32(tombstone).L32(0x201_1500).uleb(4).L32(24) // A StartLength that is a tombstone. .L8(8).L32(tombstone).uleb(0x100).uleb(4).L32(25) // A StartEnd (not ignored) .L8(7).L32(0x201_1600).L32(0x201_1700).uleb(4).L32(26) // A range end. .L8(0) // Some extra data. .L32(0xffff_ffff); size.set_const((§ion.here() - &start - 4) as u64); let buf = section.get_contents().unwrap(); let debug_loc = DebugLoc::new(&[], LittleEndian); let debug_loclists = DebugLocLists::new(&buf, LittleEndian); let loclists = LocationLists::new(debug_loc, debug_loclists); let offset = LocationListsOffset((&first - &start) as usize); let mut locations = loclists .locations(offset, encoding, 0x0100_0000, debug_addr, debug_addr_base) .unwrap(); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0101_0200, end: 0x0101_0300, }, data: Expression(EndianSlice::new(&[2, 0, 0, 0], LittleEndian)), })) ); // A base address selection followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0400, end: 0x0201_0500, }, data: Expression(EndianSlice::new(&[3, 0, 0, 0], LittleEndian)), })) ); // An empty location range followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0600, end: 0x0201_0600, }, data: Expression(EndianSlice::new(&[4, 0, 0, 0], LittleEndian)), })) ); assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0800, end: 0x0201_0900, }, data: Expression(EndianSlice::new(&[5, 0, 0, 0], LittleEndian)), })) ); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0a00, end: 0x0201_0b00, }, data: Expression(EndianSlice::new(&[6, 0, 0, 0], LittleEndian)), })) ); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0c00, end: 0x0201_0d00, }, data: Expression(EndianSlice::new(&[7, 0, 0, 0], LittleEndian)), })) ); // A location range that starts at 0. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0200_0000, end: 0x0200_0001, }, data: Expression(EndianSlice::new(&[8, 0, 0, 0], LittleEndian)), })) ); // A location range that ends at -1. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0000_0000, end: 0xffff_ffff, }, data: Expression(EndianSlice::new(&[9, 0, 0, 0], LittleEndian)), })) ); // A DefaultLocation. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0, end: u64::max_value(), }, data: Expression(EndianSlice::new(&[10, 0, 0, 0], LittleEndian)), })) ); // A BaseAddressx + OffsetPair assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0301_0100, end: 0x0301_0200, }, data: Expression(EndianSlice::new(&[11, 0, 0, 0], LittleEndian)), })) ); // A StartxEndx assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0301_0300, end: 0x0301_0400, }, data: Expression(EndianSlice::new(&[12, 0, 0, 0], LittleEndian)), })) ); // A StartxLength assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0301_0500, end: 0x0301_0600, }, data: Expression(EndianSlice::new(&[13, 0, 0, 0], LittleEndian)), })) ); // A StartEnd location following the tombstones assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_1600, end: 0x0201_1700, }, data: Expression(EndianSlice::new(&[26, 0, 0, 0], LittleEndian)), })) ); // A location list end. assert_eq!(locations.next(), Ok(None)); // An offset at the end of buf. let mut locations = loclists .locations( LocationListsOffset(buf.len()), encoding, 0x0100_0000, debug_addr, debug_addr_base, ) .unwrap(); assert_eq!(locations.next(), Ok(None)); } #[test] fn test_loclists_64() { let tombstone = !0u64; let encoding = Encoding { format: Format::Dwarf64, version: 5, address_size: 8, }; let section = Section::with_endian(Endian::Little) .L64(0x0300_0000) .L64(0x0301_0300) .L64(0x0301_0400) .L64(0x0301_0500) .L64(tombstone) .L64(0x0301_0600); let buf = section.get_contents().unwrap(); let debug_addr = &DebugAddr::from(EndianSlice::new(&buf, LittleEndian)); let debug_addr_base = DebugAddrBase(0); let start = Label::new(); let first = Label::new(); let size = Label::new(); #[rustfmt::skip] let section = Section::with_endian(Endian::Little) // Header .mark(&start) .L32(0xffff_ffff) .L64(&size) .L16(encoding.version) .L8(encoding.address_size) .L8(0) .L32(0) .mark(&first) // OffsetPair .L8(4).uleb(0x10200).uleb(0x10300).uleb(4).L32(2) // A base address selection followed by an OffsetPair. .L8(6).L64(0x0200_0000) .L8(4).uleb(0x10400).uleb(0x10500).uleb(4).L32(3) // An empty OffsetPair followed by a normal OffsetPair. .L8(4).uleb(0x10600).uleb(0x10600).uleb(4).L32(4) .L8(4).uleb(0x10800).uleb(0x10900).uleb(4).L32(5) // A StartEnd .L8(7).L64(0x201_0a00).L64(0x201_0b00).uleb(4).L32(6) // A StartLength .L8(8).L64(0x201_0c00).uleb(0x100).uleb(4).L32(7) // An OffsetPair that starts at 0. .L8(4).uleb(0).uleb(1).uleb(4).L32(8) // An OffsetPair that ends at -1. .L8(6).L64(0) .L8(4).uleb(0).uleb(0xffff_ffff).uleb(4).L32(9) // A DefaultLocation .L8(5).uleb(4).L32(10) // A BaseAddressx + OffsetPair .L8(1).uleb(0) .L8(4).uleb(0x10100).uleb(0x10200).uleb(4).L32(11) // A StartxEndx .L8(2).uleb(1).uleb(2).uleb(4).L32(12) // A StartxLength .L8(3).uleb(3).uleb(0x100).uleb(4).L32(13) // Tombstone entries, all of which should be ignored. // A BaseAddressx that is a tombstone. .L8(1).uleb(4) .L8(4).uleb(0x11100).uleb(0x11200).uleb(4).L32(20) // A BaseAddress that is a tombstone. .L8(6).L64(tombstone) .L8(4).uleb(0x11300).uleb(0x11400).uleb(4).L32(21) // A StartxEndx that is a tombstone. .L8(2).uleb(4).uleb(5).uleb(4).L32(22) // A StartxLength that is a tombstone. .L8(3).uleb(4).uleb(0x100).uleb(4).L32(23) // A StartEnd that is a tombstone. .L8(7).L64(tombstone).L64(0x201_1500).uleb(4).L32(24) // A StartLength that is a tombstone. .L8(8).L64(tombstone).uleb(0x100).uleb(4).L32(25) // A StartEnd (not ignored) .L8(7).L64(0x201_1600).L64(0x201_1700).uleb(4).L32(26) // A range end. .L8(0) // Some extra data. .L32(0xffff_ffff); size.set_const((§ion.here() - &start - 12) as u64); let buf = section.get_contents().unwrap(); let debug_loc = DebugLoc::new(&[], LittleEndian); let debug_loclists = DebugLocLists::new(&buf, LittleEndian); let loclists = LocationLists::new(debug_loc, debug_loclists); let offset = LocationListsOffset((&first - &start) as usize); let mut locations = loclists .locations(offset, encoding, 0x0100_0000, debug_addr, debug_addr_base) .unwrap(); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0101_0200, end: 0x0101_0300, }, data: Expression(EndianSlice::new(&[2, 0, 0, 0], LittleEndian)), })) ); // A base address selection followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0400, end: 0x0201_0500, }, data: Expression(EndianSlice::new(&[3, 0, 0, 0], LittleEndian)), })) ); // An empty location range followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0600, end: 0x0201_0600, }, data: Expression(EndianSlice::new(&[4, 0, 0, 0], LittleEndian)), })) ); assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0800, end: 0x0201_0900, }, data: Expression(EndianSlice::new(&[5, 0, 0, 0], LittleEndian)), })) ); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0a00, end: 0x0201_0b00, }, data: Expression(EndianSlice::new(&[6, 0, 0, 0], LittleEndian)), })) ); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0c00, end: 0x0201_0d00, }, data: Expression(EndianSlice::new(&[7, 0, 0, 0], LittleEndian)), })) ); // A location range that starts at 0. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0200_0000, end: 0x0200_0001, }, data: Expression(EndianSlice::new(&[8, 0, 0, 0], LittleEndian)), })) ); // A location range that ends at -1. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0000_0000, end: 0xffff_ffff, }, data: Expression(EndianSlice::new(&[9, 0, 0, 0], LittleEndian)), })) ); // A DefaultLocation. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0, end: u64::max_value(), }, data: Expression(EndianSlice::new(&[10, 0, 0, 0], LittleEndian)), })) ); // A BaseAddressx + OffsetPair assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0301_0100, end: 0x0301_0200, }, data: Expression(EndianSlice::new(&[11, 0, 0, 0], LittleEndian)), })) ); // A StartxEndx assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0301_0300, end: 0x0301_0400, }, data: Expression(EndianSlice::new(&[12, 0, 0, 0], LittleEndian)), })) ); // A StartxLength assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0301_0500, end: 0x0301_0600, }, data: Expression(EndianSlice::new(&[13, 0, 0, 0], LittleEndian)), })) ); // A StartEnd location following the tombstones assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_1600, end: 0x0201_1700, }, data: Expression(EndianSlice::new(&[26, 0, 0, 0], LittleEndian)), })) ); // A location list end. assert_eq!(locations.next(), Ok(None)); // An offset at the end of buf. let mut locations = loclists .locations( LocationListsOffset(buf.len()), encoding, 0x0100_0000, debug_addr, debug_addr_base, ) .unwrap(); assert_eq!(locations.next(), Ok(None)); } #[test] fn test_location_list_32() { let tombstone = !0u32 - 1; let start = Label::new(); let first = Label::new(); #[rustfmt::skip] let section = Section::with_endian(Endian::Little) // A location before the offset. .mark(&start) .L32(0x10000).L32(0x10100).L16(4).L32(1) .mark(&first) // A normal location. .L32(0x10200).L32(0x10300).L16(4).L32(2) // A base address selection followed by a normal location. .L32(0xffff_ffff).L32(0x0200_0000) .L32(0x10400).L32(0x10500).L16(4).L32(3) // An empty location range followed by a normal location. .L32(0x10600).L32(0x10600).L16(4).L32(4) .L32(0x10800).L32(0x10900).L16(4).L32(5) // A location range that starts at 0. .L32(0).L32(1).L16(4).L32(6) // A location range that ends at -1. .L32(0xffff_ffff).L32(0x0000_0000) .L32(0).L32(0xffff_ffff).L16(4).L32(7) // A normal location with tombstone. .L32(tombstone).L32(tombstone).L16(4).L32(8) // A base address selection with tombstone followed by a normal location. .L32(0xffff_ffff).L32(tombstone) .L32(0x10a00).L32(0x10b00).L16(4).L32(9) // A location list end. .L32(0).L32(0) // Some extra data. .L32(0); let buf = section.get_contents().unwrap(); let debug_loc = DebugLoc::new(&buf, LittleEndian); let debug_loclists = DebugLocLists::new(&[], LittleEndian); let loclists = LocationLists::new(debug_loc, debug_loclists); let offset = LocationListsOffset((&first - &start) as usize); let debug_addr = &DebugAddr::from(EndianSlice::new(&[], LittleEndian)); let debug_addr_base = DebugAddrBase(0); let encoding = Encoding { format: Format::Dwarf32, version: 4, address_size: 4, }; let mut locations = loclists .locations(offset, encoding, 0x0100_0000, debug_addr, debug_addr_base) .unwrap(); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0101_0200, end: 0x0101_0300, }, data: Expression(EndianSlice::new(&[2, 0, 0, 0], LittleEndian)), })) ); // A base address selection followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0400, end: 0x0201_0500, }, data: Expression(EndianSlice::new(&[3, 0, 0, 0], LittleEndian)), })) ); // An empty location range followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0600, end: 0x0201_0600, }, data: Expression(EndianSlice::new(&[4, 0, 0, 0], LittleEndian)), })) ); assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0800, end: 0x0201_0900, }, data: Expression(EndianSlice::new(&[5, 0, 0, 0], LittleEndian)), })) ); // A location range that starts at 0. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0200_0000, end: 0x0200_0001, }, data: Expression(EndianSlice::new(&[6, 0, 0, 0], LittleEndian)), })) ); // A location range that ends at -1. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0000_0000, end: 0xffff_ffff, }, data: Expression(EndianSlice::new(&[7, 0, 0, 0], LittleEndian)), })) ); // A location list end. assert_eq!(locations.next(), Ok(None)); // An offset at the end of buf. let mut locations = loclists .locations( LocationListsOffset(buf.len()), encoding, 0x0100_0000, debug_addr, debug_addr_base, ) .unwrap(); assert_eq!(locations.next(), Ok(None)); } #[test] fn test_location_list_64() { let tombstone = !0u64 - 1; let start = Label::new(); let first = Label::new(); #[rustfmt::skip] let section = Section::with_endian(Endian::Little) // A location before the offset. .mark(&start) .L64(0x10000).L64(0x10100).L16(4).L32(1) .mark(&first) // A normal location. .L64(0x10200).L64(0x10300).L16(4).L32(2) // A base address selection followed by a normal location. .L64(0xffff_ffff_ffff_ffff).L64(0x0200_0000) .L64(0x10400).L64(0x10500).L16(4).L32(3) // An empty location range followed by a normal location. .L64(0x10600).L64(0x10600).L16(4).L32(4) .L64(0x10800).L64(0x10900).L16(4).L32(5) // A location range that starts at 0. .L64(0).L64(1).L16(4).L32(6) // A location range that ends at -1. .L64(0xffff_ffff_ffff_ffff).L64(0x0000_0000) .L64(0).L64(0xffff_ffff_ffff_ffff).L16(4).L32(7) // A normal location with tombstone. .L64(tombstone).L64(tombstone).L16(4).L32(8) // A base address selection with tombstone followed by a normal location. .L64(0xffff_ffff_ffff_ffff).L64(tombstone) .L64(0x10a00).L64(0x10b00).L16(4).L32(9) // A location list end. .L64(0).L64(0) // Some extra data. .L64(0); let buf = section.get_contents().unwrap(); let debug_loc = DebugLoc::new(&buf, LittleEndian); let debug_loclists = DebugLocLists::new(&[], LittleEndian); let loclists = LocationLists::new(debug_loc, debug_loclists); let offset = LocationListsOffset((&first - &start) as usize); let debug_addr = &DebugAddr::from(EndianSlice::new(&[], LittleEndian)); let debug_addr_base = DebugAddrBase(0); let encoding = Encoding { format: Format::Dwarf64, version: 4, address_size: 8, }; let mut locations = loclists .locations(offset, encoding, 0x0100_0000, debug_addr, debug_addr_base) .unwrap(); // A normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0101_0200, end: 0x0101_0300, }, data: Expression(EndianSlice::new(&[2, 0, 0, 0], LittleEndian)), })) ); // A base address selection followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0400, end: 0x0201_0500, }, data: Expression(EndianSlice::new(&[3, 0, 0, 0], LittleEndian)), })) ); // An empty location range followed by a normal location. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0600, end: 0x0201_0600, }, data: Expression(EndianSlice::new(&[4, 0, 0, 0], LittleEndian)), })) ); assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0201_0800, end: 0x0201_0900, }, data: Expression(EndianSlice::new(&[5, 0, 0, 0], LittleEndian)), })) ); // A location range that starts at 0. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0200_0000, end: 0x0200_0001, }, data: Expression(EndianSlice::new(&[6, 0, 0, 0], LittleEndian)), })) ); // A location range that ends at -1. assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0, end: 0xffff_ffff_ffff_ffff, }, data: Expression(EndianSlice::new(&[7, 0, 0, 0], LittleEndian)), })) ); // A location list end. assert_eq!(locations.next(), Ok(None)); // An offset at the end of buf. let mut locations = loclists .locations( LocationListsOffset(buf.len()), encoding, 0x0100_0000, debug_addr, debug_addr_base, ) .unwrap(); assert_eq!(locations.next(), Ok(None)); } #[test] fn test_locations_invalid() { #[rustfmt::skip] let section = Section::with_endian(Endian::Little) // An invalid location range. .L32(0x20000).L32(0x10000).L16(4).L32(1) // An invalid range after wrapping. .L32(0x20000).L32(0xff01_0000).L16(4).L32(2); let buf = section.get_contents().unwrap(); let debug_loc = DebugLoc::new(&buf, LittleEndian); let debug_loclists = DebugLocLists::new(&[], LittleEndian); let loclists = LocationLists::new(debug_loc, debug_loclists); let debug_addr = &DebugAddr::from(EndianSlice::new(&[], LittleEndian)); let debug_addr_base = DebugAddrBase(0); let encoding = Encoding { format: Format::Dwarf32, version: 4, address_size: 4, }; // An invalid location range. let mut locations = loclists .locations( LocationListsOffset(0x0), encoding, 0x0100_0000, debug_addr, debug_addr_base, ) .unwrap(); assert_eq!(locations.next(), Err(Error::InvalidLocationAddressRange)); // An invalid location range after wrapping. let mut locations = loclists .locations( LocationListsOffset(14), encoding, 0x0100_0000, debug_addr, debug_addr_base, ) .unwrap(); assert_eq!(locations.next(), Err(Error::InvalidLocationAddressRange)); // An invalid offset. match loclists.locations( LocationListsOffset(buf.len() + 1), encoding, 0x0100_0000, debug_addr, debug_addr_base, ) { Err(Error::UnexpectedEof(_)) => {} otherwise => panic!("Unexpected result: {:?}", otherwise), } } #[test] fn test_get_offset() { for format in vec![Format::Dwarf32, Format::Dwarf64] { let encoding = Encoding { format, version: 5, address_size: 4, }; let zero = Label::new(); let length = Label::new(); let start = Label::new(); let first = Label::new(); let end = Label::new(); let mut section = Section::with_endian(Endian::Little) .mark(&zero) .initial_length(format, &length, &start) .D16(encoding.version) .D8(encoding.address_size) .D8(0) .D32(20) .mark(&first); for i in 0..20 { section = section.word(format.word_size(), 1000 + i); } section = section.mark(&end); length.set_const((&end - &start) as u64); let section = section.get_contents().unwrap(); let debug_loc = DebugLoc::from(EndianSlice::new(&[], LittleEndian)); let debug_loclists = DebugLocLists::from(EndianSlice::new(§ion, LittleEndian)); let locations = LocationLists::new(debug_loc, debug_loclists); let base = DebugLocListsBase((&first - &zero) as usize); assert_eq!( locations.get_offset(encoding, base, DebugLocListsIndex(0)), Ok(LocationListsOffset(base.0 + 1000)) ); assert_eq!( locations.get_offset(encoding, base, DebugLocListsIndex(19)), Ok(LocationListsOffset(base.0 + 1019)) ); } } #[test] fn test_loclists_gnu_v4_split_dwarf() { #[rustfmt::skip] let buf = [ 0x03, // DW_LLE_startx_length 0x00, // ULEB encoded b7 0x08, 0x00, 0x00, 0x00, // Fixed 4 byte length of 8 0x03, 0x00, // Fixed two byte length of the location 0x11, 0x00, // DW_OP_constu 0 0x9f, // DW_OP_stack_value // Padding data //0x99, 0x99, 0x99, 0x99 ]; let data_buf = [0x11, 0x00, 0x9f]; let expected_data = EndianSlice::new(&data_buf, LittleEndian); let debug_loc = DebugLoc::new(&buf, LittleEndian); let debug_loclists = DebugLocLists::new(&[], LittleEndian); let loclists = LocationLists::new(debug_loc, debug_loclists); let debug_addr = &DebugAddr::from(EndianSlice::new(&[0x01, 0x02, 0x03, 0x04], LittleEndian)); let debug_addr_base = DebugAddrBase(0); let encoding = Encoding { format: Format::Dwarf32, version: 4, address_size: 4, }; // An invalid location range. let mut locations = loclists .locations_dwo( LocationListsOffset(0x0), encoding, 0, debug_addr, debug_addr_base, ) .unwrap(); assert_eq!( locations.next(), Ok(Some(LocationListEntry { range: Range { begin: 0x0403_0201, end: 0x0403_0209 }, data: Expression(expected_data), })) ); } }