Struct apple_codesign::CodeDirectoryBlob
source · pub struct CodeDirectoryBlob<'a> {Show 25 fields
pub version: u32,
pub flags: CodeSignatureFlags,
pub code_limit: u32,
pub digest_size: u8,
pub digest_type: DigestType,
pub platform: u8,
pub page_size: u32,
pub spare2: u32,
pub scatter_offset: Option<u32>,
pub spare3: Option<u32>,
pub code_limit_64: Option<u64>,
pub exec_seg_base: Option<u64>,
pub exec_seg_limit: Option<u64>,
pub exec_seg_flags: Option<ExecutableSegmentFlags>,
pub runtime: Option<u32>,
pub pre_encrypt_offset: Option<u32>,
pub linkage_hash_type: Option<u8>,
pub linkage_truncated: Option<u8>,
pub spare4: Option<u16>,
pub linkage_offset: Option<u32>,
pub linkage_size: Option<u32>,
pub ident: Cow<'a, str>,
pub team_name: Option<Cow<'a, str>>,
pub code_digests: Vec<Digest<'a>>,
pub special_digests: BTreeMap<CodeSigningSlot, Digest<'a>>,
}
Expand description
Represents a code directory blob entry.
This struct is versioned and has been extended over time.
The struct here represents a superset of all fields in all versions.
The parser will set Option<T>
fields to None
for instances
where the version is lower than the version that field was introduced in.
Fields§
§version: u32
Compatibility version.
flags: CodeSignatureFlags
Setup and mode flags.
code_limit: u32
Limit to main image signature range.
This is the file-level offset to stop digesting code data at.
It likely corresponds to the file-offset offset where the
embedded signature data starts in the __LINKEDIT
segment.
digest_size: u8
Size of each slot/code digest in bytes.
digest_type: DigestType
Type of content digest being used.
platform: u8
Platform identifier. 0 if not platform binary.
page_size: u32
Page size in bytes. (stored as log u8)
spare2: u32
Unused (must be 0).
scatter_offset: Option<u32>
Offset of optional scatter vector.
spare3: Option<u32>
Unused (must be 0).
code_limit_64: Option<u64>
Limit to main image signature range, 64 bits.
exec_seg_base: Option<u64>
Offset of executable segment.
exec_seg_limit: Option<u64>
Limit of executable segment.
exec_seg_flags: Option<ExecutableSegmentFlags>
Executable segment flags.
runtime: Option<u32>
§pre_encrypt_offset: Option<u32>
§linkage_hash_type: Option<u8>
§linkage_truncated: Option<u8>
§spare4: Option<u16>
§linkage_offset: Option<u32>
§linkage_size: Option<u32>
§ident: Cow<'a, str>
§team_name: Option<Cow<'a, str>>
§code_digests: Vec<Digest<'a>>
§special_digests: BTreeMap<CodeSigningSlot, Digest<'a>>
Implementations§
source§impl<'a> CodeDirectoryBlob<'a>
impl<'a> CodeDirectoryBlob<'a>
sourcepub fn slot_digests(&self) -> &BTreeMap<CodeSigningSlot, Digest<'a>>
pub fn slot_digests(&self) -> &BTreeMap<CodeSigningSlot, Digest<'a>>
Obtain the mapping of slots to digests.
sourcepub fn slot_digest(&self, slot: CodeSigningSlot) -> Option<&Digest<'a>>
pub fn slot_digest(&self, slot: CodeSigningSlot) -> Option<&Digest<'a>>
Obtain the recorded digest for a given CodeSigningSlot.
sourcepub fn set_slot_digest(
&mut self,
slot: CodeSigningSlot,
digest: impl Into<Digest<'a>>
) -> Result<(), AppleCodesignError>
pub fn set_slot_digest( &mut self, slot: CodeSigningSlot, digest: impl Into<Digest<'a>> ) -> Result<(), AppleCodesignError>
Set the digest for a given slot.
sourcepub fn adjust_version(&mut self, target: Option<MachoTarget>) -> u32
pub fn adjust_version(&mut self, target: Option<MachoTarget>) -> u32
Adjust the version of the data structure according to what fields are set.
Returns the old version.
sourcepub fn clear_newer_fields(&mut self)
pub fn clear_newer_fields(&mut self)
Clears optional fields that are newer than the current version.
The C structure is versioned and our Rust struct is a superset of all versions. While our serializer should omit too new fields for a given version, it is possible for some optional fields to be set when they wouldn’t get serialized.
Calling this function will set fields not present in the current version to None.
pub fn to_owned(&self) -> CodeDirectoryBlob<'static>
Trait Implementations§
source§impl<'a> Blob<'a> for CodeDirectoryBlob<'a>
impl<'a> Blob<'a> for CodeDirectoryBlob<'a>
source§fn from_blob_bytes(data: &'a [u8]) -> Result<Self, AppleCodesignError>
fn from_blob_bytes(data: &'a [u8]) -> Result<Self, AppleCodesignError>
source§fn serialize_payload(&self) -> Result<Vec<u8>, AppleCodesignError>
fn serialize_payload(&self) -> Result<Vec<u8>, AppleCodesignError>
source§fn to_blob_bytes(&self) -> Result<Vec<u8>, AppleCodesignError>
fn to_blob_bytes(&self) -> Result<Vec<u8>, AppleCodesignError>
source§fn digest_with(
&self,
hash_type: DigestType
) -> Result<Vec<u8>, AppleCodesignError>
fn digest_with( &self, hash_type: DigestType ) -> Result<Vec<u8>, AppleCodesignError>
source§impl<'a> Debug for CodeDirectoryBlob<'a>
impl<'a> Debug for CodeDirectoryBlob<'a>
source§impl<'a> Default for CodeDirectoryBlob<'a>
impl<'a> Default for CodeDirectoryBlob<'a>
source§fn default() -> CodeDirectoryBlob<'a>
fn default() -> CodeDirectoryBlob<'a>
source§impl<'a> From<CodeDirectoryBlob<'a>> for BlobData<'a>
impl<'a> From<CodeDirectoryBlob<'a>> for BlobData<'a>
source§fn from(b: CodeDirectoryBlob<'a>) -> Self
fn from(b: CodeDirectoryBlob<'a>) -> Self
source§impl<'a> TryFrom<CodeDirectoryBlob<'a>> for CodeDirectory
impl<'a> TryFrom<CodeDirectoryBlob<'a>> for CodeDirectory
§type Error = AppleCodesignError
type Error = AppleCodesignError
Auto Trait Implementations§
impl<'a> RefUnwindSafe for CodeDirectoryBlob<'a>
impl<'a> Send for CodeDirectoryBlob<'a>
impl<'a> Sync for CodeDirectoryBlob<'a>
impl<'a> Unpin for CodeDirectoryBlob<'a>
impl<'a> UnwindSafe for CodeDirectoryBlob<'a>
Blanket Implementations§
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere T: 'a,
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where &'a Self: for<'a> IntoIterator,
§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere T: ?Sized,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> Rwhere
Self: Borrow<B>,
B: 'a + ?Sized,
R: 'a,
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> Rwhere Self: Borrow<B>, B: 'a + ?Sized, R: 'a,
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> Rwhere
Self: BorrowMut<B>,
B: 'a + ?Sized,
R: 'a,
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R ) -> Rwhere Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> Rwhere
Self: AsRef<U>,
U: 'a + ?Sized,
R: 'a,
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> Rwhere Self: AsRef<U>, U: 'a + ?Sized, R: 'a,
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> Rwhere
Self: AsMut<U>,
U: 'a + ?Sized,
R: 'a,
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> Rwhere Self: AsMut<U>, U: 'a + ?Sized, R: 'a,
self
, then passes self.as_mut()
into the pipe
function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Selfwhere Self: Borrow<B>, B: ?Sized,
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere Self: BorrowMut<B>, B: ?Sized,
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Selfwhere Self: AsRef<R>, R: ?Sized,
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere Self: AsMut<R>, R: ?Sized,
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Selfwhere
Self: Deref<Target = T>,
T: ?Sized,
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Selfwhere Self: Deref<Target = T>, T: ?Sized,
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere
Self: DerefMut<Target = T> + Deref,
T: ?Sized,
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere Self: DerefMut<Target = T> + Deref, T: ?Sized,
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Selfwhere Self: Borrow<B>, B: ?Sized,
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere Self: BorrowMut<B>, B: ?Sized,
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Selfwhere Self: AsRef<R>, R: ?Sized,
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere Self: AsMut<R>, R: ?Sized,
.tap_ref_mut()
only in debug builds, and is erased in release
builds.