/rust/registry/src/index.crates.io-6f17d22bba15001f/gimli-0.29.0/src/read/addr.rs
| Line | Count | Source (jump to first uncovered line) | 
| 1 |  | use crate::common::{DebugAddrBase, DebugAddrIndex, SectionId}; | 
| 2 |  | use crate::read::{Reader, ReaderOffset, Result, Section}; | 
| 3 |  |  | 
| 4 |  | /// The raw contents of the `.debug_addr` section. | 
| 5 |  | #[derive(Debug, Default, Clone, Copy)] | 
| 6 |  | pub struct DebugAddr<R> { | 
| 7 |  |     section: R, | 
| 8 |  | } | 
| 9 |  |  | 
| 10 |  | impl<R: Reader> DebugAddr<R> { | 
| 11 |  |     // TODO: add an iterator over the sets of addresses in the section. | 
| 12 |  |     // This is not needed for common usage of the section though. | 
| 13 |  |  | 
| 14 |  |     /// Returns the address at the given `base` and `index`. | 
| 15 |  |     /// | 
| 16 |  |     /// A set of addresses in the `.debug_addr` section consists of a header | 
| 17 |  |     /// followed by a series of addresses. | 
| 18 |  |     /// | 
| 19 |  |     /// The `base` must be the `DW_AT_addr_base` value from the compilation unit DIE. | 
| 20 |  |     /// This is an offset that points to the first address following the header. | 
| 21 |  |     /// | 
| 22 |  |     /// The `index` is the value of a `DW_FORM_addrx` attribute. | 
| 23 |  |     /// | 
| 24 |  |     /// The `address_size` must be the size of the address for the compilation unit. | 
| 25 |  |     /// This value must also match the header. However, note that we do not parse the | 
| 26 |  |     /// header to validate this, since locating the header is unreliable, and the GNU | 
| 27 |  |     /// extensions do not emit it. | 
| 28 | 0 |     pub fn get_address( | 
| 29 | 0 |         &self, | 
| 30 | 0 |         address_size: u8, | 
| 31 | 0 |         base: DebugAddrBase<R::Offset>, | 
| 32 | 0 |         index: DebugAddrIndex<R::Offset>, | 
| 33 | 0 |     ) -> Result<u64> { | 
| 34 | 0 |         let input = &mut self.section.clone(); | 
| 35 | 0 |         input.skip(base.0)?; | 
| 36 | 0 |         input.skip(R::Offset::from_u64( | 
| 37 | 0 |             index.0.into_u64() * u64::from(address_size), | 
| 38 | 0 |         )?)?; | 
| 39 | 0 |         input.read_address(address_size) | 
| 40 | 0 |     } Unexecuted instantiation: <gimli::read::addr::DebugAddr<gimli::read::endian_slice::EndianSlice<gimli::endianity::LittleEndian>>>::get_addressUnexecuted instantiation: <gimli::read::addr::DebugAddr<_>>::get_address | 
| 41 |  | } | 
| 42 |  |  | 
| 43 |  | impl<T> DebugAddr<T> { | 
| 44 |  |     /// Create a `DebugAddr` section that references the data in `self`. | 
| 45 |  |     /// | 
| 46 |  |     /// This is useful when `R` implements `Reader` but `T` does not. | 
| 47 |  |     /// | 
| 48 |  |     /// Used by `DwarfSections::borrow`. | 
| 49 | 0 |     pub fn borrow<'a, F, R>(&'a self, mut borrow: F) -> DebugAddr<R> | 
| 50 | 0 |     where | 
| 51 | 0 |         F: FnMut(&'a T) -> R, | 
| 52 | 0 |     { | 
| 53 | 0 |         borrow(&self.section).into() | 
| 54 | 0 |     } | 
| 55 |  | } | 
| 56 |  |  | 
| 57 |  | impl<R> Section<R> for DebugAddr<R> { | 
| 58 | 0 |     fn id() -> SectionId { | 
| 59 | 0 |         SectionId::DebugAddr | 
| 60 | 0 |     } Unexecuted instantiation: <gimli::read::addr::DebugAddr<gimli::read::endian_slice::EndianSlice<gimli::endianity::LittleEndian>> as gimli::read::Section<gimli::read::endian_slice::EndianSlice<gimli::endianity::LittleEndian>>>::idUnexecuted instantiation: <gimli::read::addr::DebugAddr<_> as gimli::read::Section<_>>::id | 
| 61 |  |  | 
| 62 | 0 |     fn reader(&self) -> &R { | 
| 63 | 0 |         &self.section | 
| 64 | 0 |     } | 
| 65 |  | } | 
| 66 |  |  | 
| 67 |  | impl<R> From<R> for DebugAddr<R> { | 
| 68 | 0 |     fn from(section: R) -> Self { | 
| 69 | 0 |         DebugAddr { section } | 
| 70 | 0 |     } Unexecuted instantiation: <gimli::read::addr::DebugAddr<gimli::read::endian_slice::EndianSlice<gimli::endianity::LittleEndian>> as core::convert::From<gimli::read::endian_slice::EndianSlice<gimli::endianity::LittleEndian>>>::fromUnexecuted instantiation: <gimli::read::addr::DebugAddr<_> as core::convert::From<_>>::from | 
| 71 |  | } | 
| 72 |  |  | 
| 73 |  | #[cfg(test)] | 
| 74 |  | mod tests { | 
| 75 |  |     use super::*; | 
| 76 |  |     use crate::read::EndianSlice; | 
| 77 |  |     use crate::test_util::GimliSectionMethods; | 
| 78 |  |     use crate::{Format, LittleEndian}; | 
| 79 |  |     use test_assembler::{Endian, Label, LabelMaker, Section}; | 
| 80 |  |  | 
| 81 |  |     #[test] | 
| 82 |  |     fn test_get_address() { | 
| 83 |  |         for format in [Format::Dwarf32, Format::Dwarf64] { | 
| 84 |  |             for address_size in [4, 8] { | 
| 85 |  |                 let zero = Label::new(); | 
| 86 |  |                 let length = Label::new(); | 
| 87 |  |                 let start = Label::new(); | 
| 88 |  |                 let first = Label::new(); | 
| 89 |  |                 let end = Label::new(); | 
| 90 |  |                 let mut section = Section::with_endian(Endian::Little) | 
| 91 |  |                     .mark(&zero) | 
| 92 |  |                     .initial_length(format, &length, &start) | 
| 93 |  |                     .D16(5) | 
| 94 |  |                     .D8(address_size) | 
| 95 |  |                     .D8(0) | 
| 96 |  |                     .mark(&first); | 
| 97 |  |                 for i in 0..20 { | 
| 98 |  |                     section = section.word(address_size, 1000 + i); | 
| 99 |  |                 } | 
| 100 |  |                 section = section.mark(&end); | 
| 101 |  |                 length.set_const((&end - &start) as u64); | 
| 102 |  |  | 
| 103 |  |                 let section = section.get_contents().unwrap(); | 
| 104 |  |                 let debug_addr = DebugAddr::from(EndianSlice::new(§ion, LittleEndian)); | 
| 105 |  |                 let base = DebugAddrBase((&first - &zero) as usize); | 
| 106 |  |  | 
| 107 |  |                 assert_eq!( | 
| 108 |  |                     debug_addr.get_address(address_size, base, DebugAddrIndex(0)), | 
| 109 |  |                     Ok(1000) | 
| 110 |  |                 ); | 
| 111 |  |                 assert_eq!( | 
| 112 |  |                     debug_addr.get_address(address_size, base, DebugAddrIndex(19)), | 
| 113 |  |                     Ok(1019) | 
| 114 |  |                 ); | 
| 115 |  |             } | 
| 116 |  |         } | 
| 117 |  |     } | 
| 118 |  | } |