Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
MACH(3)			   Library Functions Manual		       MACH(3)

       machbytype,  machbyname - machine-independent access to executables and

       #include	<u.h>
       #include	<libc.h>
       #include	<mach.h>

       void machbytype(int type)

       int machbyname(char *name)

       extern Mach *mach;

       Libmach provides	an interface for accessing the	executable  files  and
       executing  images  of various architectures and operating systems.  The
       interface is machine-independent, meaning that, for example, Mac	 OS  X
       core  dumps may be inspected using an x86 Linux machine and vice	versa.
       In its current form, the	library	is mainly useful for writing debuggers
       of one sort or another.

       An  architecture	is described primarily by a Mach structure, which con-
       tains data structures and parameters describing the  particular	archi-
       tecture.	  Most	library	functions assume that the global variable mach
       points at the structure for the architecture being debugged.  It	is set
       implicitly  by crackhdr (see mach-file(3)) and can be set explicitly by
       calling machbyname or machbytype.

       There is	no operating system-specific structure akin  to	 mach.	 Typi-
       cally  the  choice of operating system on a particular architecture af-
       fects only the executable and  core  dump  formats;  the	 various  file
       parsers	deduce	the  operating	system	from information in the	binary
       files themselves	and adjust accordingly.

       The supported architectures are 386 (Intel 32-bit x86) 386  and	later)
       and power (IBM PowerPC, typically running Mac OS	X).

       Other manual pages describe the library functions in detail.

       Mach-cmd(3)  describes  some convenience	routines for attaching to pro-
       cesses and core files.

       Mach-file(3) describes the manipulation of binary files.

       Mach-map(3) describes the interface to address spaces and register sets
       in executable files and executing programs.

       Mach-stack(3) describes support for unwinding the stack.

       Mach-swap(3) describes helper functions for accessing data in a partic-
       ular byte order.

       Mach-symbol(3) describes	the interface to debugging symbol information.


       mach-file(3), mach-map(3), mach-stack(3), mach-swap(3), mach-symbol(3)



Want to link to this manual page? Use this URL:

home | help