use core::fmt::Debug; use core::{result, str}; use crate::endian::{self, Endianness}; use crate::macho; use crate::pod::{Bytes, Pod}; use crate::read::{self, ObjectSegment, ReadError, Result}; use super::{MachHeader, MachOFile, MachOLoadCommand, MachOLoadCommandIterator, Section}; /// An iterator over the segments of a `MachOFile32`. pub type MachOSegmentIterator32<'data, 'file, Endian = Endianness> = MachOSegmentIterator<'data, 'file, macho::MachHeader32>; /// An iterator over the segments of a `MachOFile64`. pub type MachOSegmentIterator64<'data, 'file, Endian = Endianness> = MachOSegmentIterator<'data, 'file, macho::MachHeader64>; /// An iterator over the segments of a `MachOFile`. #[derive(Debug)] pub struct MachOSegmentIterator<'data, 'file, Mach> where 'data: 'file, Mach: MachHeader, { pub(super) file: &'file MachOFile<'data, Mach>, pub(super) commands: MachOLoadCommandIterator<'data, Mach::Endian>, } impl<'data, 'file, Mach: MachHeader> Iterator for MachOSegmentIterator<'data, 'file, Mach> { type Item = MachOSegment<'data, 'file, Mach>; fn next(&mut self) -> Option { loop { let command = self.commands.next().ok()??; if let Ok(Some((segment, _))) = Mach::Segment::from_command(command) { return Some(MachOSegment { file: self.file, segment, }); } } } } /// A segment of a `MachOFile32`. pub type MachOSegment32<'data, 'file, Endian = Endianness> = MachOSegment<'data, 'file, macho::MachHeader32>; /// A segment of a `MachOFile64`. pub type MachOSegment64<'data, 'file, Endian = Endianness> = MachOSegment<'data, 'file, macho::MachHeader64>; /// A segment of a `MachOFile`. #[derive(Debug)] pub struct MachOSegment<'data, 'file, Mach> where 'data: 'file, Mach: MachHeader, { file: &'file MachOFile<'data, Mach>, segment: &'data Mach::Segment, } impl<'data, 'file, Mach: MachHeader> MachOSegment<'data, 'file, Mach> { fn bytes(&self) -> Result> { self.segment .data(self.file.endian, self.file.data) .read_error("Invalid Mach-O segment size or offset") } } impl<'data, 'file, Mach: MachHeader> read::private::Sealed for MachOSegment<'data, 'file, Mach> {} impl<'data, 'file, Mach: MachHeader> ObjectSegment<'data> for MachOSegment<'data, 'file, Mach> { #[inline] fn address(&self) -> u64 { self.segment.vmaddr(self.file.endian).into() } #[inline] fn size(&self) -> u64 { self.segment.vmsize(self.file.endian).into() } #[inline] fn align(&self) -> u64 { // Page size. 0x1000 } #[inline] fn file_range(&self) -> (u64, u64) { self.segment.file_range(self.file.endian) } fn data(&self) -> Result<&'data [u8]> { Ok(self.bytes()?.0) } fn data_range(&self, address: u64, size: u64) -> Result> { Ok(read::data_range( self.bytes()?, self.address(), address, size, )) } #[inline] fn name(&self) -> Result> { Ok(Some( str::from_utf8(self.segment.name()) .ok() .read_error("Non UTF-8 Mach-O segment name")?, )) } } /// A trait for generic access to `SegmentCommand32` and `SegmentCommand64`. #[allow(missing_docs)] pub trait Segment: Debug + Pod { type Word: Into; type Endian: endian::Endian; type Section: Section; fn from_command(command: MachOLoadCommand) -> Result>; fn cmd(&self, endian: Self::Endian) -> u32; fn cmdsize(&self, endian: Self::Endian) -> u32; fn segname(&self) -> &[u8; 16]; fn vmaddr(&self, endian: Self::Endian) -> Self::Word; fn vmsize(&self, endian: Self::Endian) -> Self::Word; fn fileoff(&self, endian: Self::Endian) -> Self::Word; fn filesize(&self, endian: Self::Endian) -> Self::Word; fn maxprot(&self, endian: Self::Endian) -> u32; fn initprot(&self, endian: Self::Endian) -> u32; fn nsects(&self, endian: Self::Endian) -> u32; fn flags(&self, endian: Self::Endian) -> u32; /// Return the `segname` bytes up until the null terminator. fn name(&self) -> &[u8] { let segname = &self.segname()[..]; match segname.iter().position(|&x| x == 0) { Some(end) => &segname[..end], None => segname, } } /// Return the offset and size of the segment in the file. fn file_range(&self, endian: Self::Endian) -> (u64, u64) { (self.fileoff(endian).into(), self.filesize(endian).into()) } /// Get the segment data from the file data. /// /// Returns `Err` for invalid values. fn data<'data>( &self, endian: Self::Endian, data: Bytes<'data>, ) -> result::Result, ()> { let (offset, size) = self.file_range(endian); data.read_bytes_at(offset as usize, size as usize) } /// Get the array of sections from the data following the segment command. /// /// Returns `Err` for invalid values. fn sections<'data>( &self, endian: Self::Endian, data: Bytes<'data>, ) -> Result<&'data [Self::Section]> { data.read_slice_at(0, self.nsects(endian) as usize) .read_error("Invalid Mach-O number of sections") } } impl Segment for macho::SegmentCommand32 { type Word = u32; type Endian = Endian; type Section = macho::Section32; fn from_command(command: MachOLoadCommand) -> Result> { command.segment_32() } fn cmd(&self, endian: Self::Endian) -> u32 { self.cmd.get(endian) } fn cmdsize(&self, endian: Self::Endian) -> u32 { self.cmdsize.get(endian) } fn segname(&self) -> &[u8; 16] { &self.segname } fn vmaddr(&self, endian: Self::Endian) -> Self::Word { self.vmaddr.get(endian) } fn vmsize(&self, endian: Self::Endian) -> Self::Word { self.vmsize.get(endian) } fn fileoff(&self, endian: Self::Endian) -> Self::Word { self.fileoff.get(endian) } fn filesize(&self, endian: Self::Endian) -> Self::Word { self.filesize.get(endian) } fn maxprot(&self, endian: Self::Endian) -> u32 { self.maxprot.get(endian) } fn initprot(&self, endian: Self::Endian) -> u32 { self.initprot.get(endian) } fn nsects(&self, endian: Self::Endian) -> u32 { self.nsects.get(endian) } fn flags(&self, endian: Self::Endian) -> u32 { self.flags.get(endian) } } impl Segment for macho::SegmentCommand64 { type Word = u64; type Endian = Endian; type Section = macho::Section64; fn from_command(command: MachOLoadCommand) -> Result> { command.segment_64() } fn cmd(&self, endian: Self::Endian) -> u32 { self.cmd.get(endian) } fn cmdsize(&self, endian: Self::Endian) -> u32 { self.cmdsize.get(endian) } fn segname(&self) -> &[u8; 16] { &self.segname } fn vmaddr(&self, endian: Self::Endian) -> Self::Word { self.vmaddr.get(endian) } fn vmsize(&self, endian: Self::Endian) -> Self::Word { self.vmsize.get(endian) } fn fileoff(&self, endian: Self::Endian) -> Self::Word { self.fileoff.get(endian) } fn filesize(&self, endian: Self::Endian) -> Self::Word { self.filesize.get(endian) } fn maxprot(&self, endian: Self::Endian) -> u32 { self.maxprot.get(endian) } fn initprot(&self, endian: Self::Endian) -> u32 { self.initprot.get(endian) } fn nsects(&self, endian: Self::Endian) -> u32 { self.nsects.get(endian) } fn flags(&self, endian: Self::Endian) -> u32 { self.flags.get(endian) } }