Module minidump_writer::mach

Contains various helpers to improve and expand on the bindings provided by mach2

Modules

• task
  This module corresponds to mach/task.defs.
• task_info
  This module roughly corresponds to mach/task_info.h.

Structs

• Dylib
  Dynamically linked shared libraries are identified by two things. The pathname (the name of the library as found for execution), and the compatibility version number. The pathname must match and the compatibility number in the user of the library must be greater than or equal to the library being used. The time stamp is used to record the time a library was built and copied into user so it can be use to determined if the library used at runtime is exactly the same as used to built the program.
• DylibCommand
  A dynamically linked shared library (filetype == MH_DYLIB in the mach header) contains a dylib_command (cmd == LC_ID_DYLIB) to identify the library. An object that uses a dynamically linked shared library also contains a dylib_command (cmd == LC_LOAD_DYLIB, LC_LOAD_WEAK_DYLIB, or LC_REEXPORT_DYLIB) for each library it uses.
• DylinkerCommand
• LoadCommandBase
  Every load command is a variable sized struct depending on its type, but they all include the fields in this struct at the beginning
• LoadCommands
  A block of load commands for a particular image
• LoadCommandsIter
• MachHeader
  The header at the beginning of every (valid) Mach image
• SegmentCommand64
  The 64-bit segment load command indicates that a part of this file is to be mapped into a 64-bit task’s address space. If the 64-bit segment has sections then section_64 structures directly follow the 64-bit segment command and their size is reflected in cmdsize.
• ThreadState
• UuidCommand
  The uuid load command contains a single 128-bit unique random number that identifies an object produced by the static link editor.
• vm_region_submap_info_64

Enums

• KernelError
  A Mach kernel error.
• LoadCommand
  A single load command
• LoadCommandKind
  Load command constants from usr/include/mach-o/loader.h

Constants

• KERN_SUCCESS
• MH_DYLINKER
  <usr/include/mach-o/loader.h>, the file type dyld, the dynamic loader
• MH_EXECUTE
  <usr/include/mach-o/loader.h>, the file type for the main executable image
• MH_MAGIC_64
• THREAD_STATE_FLAVOR
  x86_THREAD_STATE64 in /usr/include/mach/i386/thread_status.h
• THREAD_STATE_MAX

Traits

• TaskInfo
  Minimal trait that just pairs a structure that can be filled out by mach2::task::task_info with the “flavor” that tells it the info we actually want to retrieve
• ThreadInfo
  Minimal trait that just pairs a structure that can be filled out by thread_info with the “flavor” that tells it the info we actually want to retrieve

Functions

• int_sysctl_by_name
  Retrieves an i32 sysctl by name and casts it to the specified integer type. Returns the default value if retrieval fails or the value is out of bounds of the specified integer type.
• mach_task_self^⚠
• mach_vm_deallocate^⚠
• mach_vm_read^⚠
• mach_vm_region_recurse^⚠
• pid_for_task^⚠
  From <usr/include/mach/mach_traps.h>, this retrieves the normal PID for the specified task as the syscalls from BSD use PIDs, not mach ports.
• sysctl_by_name
  Retrieves an integer sysctl by name. Returns the default value if retrieval fails.
• sysctl_string
  Retrieves a string sysctl by name. Returns an empty string if the retrieval fails or the string can’t be converted to utf-8.
• task_threads^⚠
• thread_get_state^⚠
• thread_info^⚠
  Fomr <user/include/mach/thread_act.h>, this retrieves thread info for the for the specified thread.

Type Aliases

• ArchThreadState
• kern_return_t
• mach_port_name_t