[apple/ld64.git] / doc / man / man1 / dyldinfo.1

.Dd November 10, 2010
.Dt dyldinfo 1
.Os Darwin
.Sh NAME
.Nm dyldinfo
.Nd "Displays information used by dyld in an executable"
.Sh SYNOPSIS
.Nm
.Op Fl arch Ar arch-name 
.Op Fl dylibs
.Op Fl rebase
.Op Fl bind
.Op Fl weak_bind
.Op Fl lazy_bind
.Op Fl export
.Op Fl opcodes
.Op Fl function_starts
.Ar file(s)
.Sh DESCRIPTION
Executables built for Mac OS X 10.6 and later have a new format for the
information in the __LINKEDIT segment.  The dyldinfo tool will display
that information.   
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl arch Ar arch
Only display the specified architecture.  Other architectures in a universal image are ignored.
.It Fl dylibs
Display the table of dylibs on which this image depends.
.It Fl rebase
Display the table of rebasing information.  Rebasing is what dyld does when an image is 
not loaded at its preferred address.  Typically, this involves updating pointers in the __DATA
segment which point within the image. 
.It Fl bind
Display the table of binding information.  These are the symbolic fix ups that dyld must
do when an image is loaded.
.It Fl weak_bind
Display the table of weak binding information.  Typically, only C++ progams will have any 
weak binding.  These are symbols which dyld must unique accross all images.
.It Fl lazy_bind
Display the table of lazy binding information. These are symbols which dyld delays binding
until they are first used.  Lazy binding is automatically used for all function calls to
functions in some external dylib.
.It Fl export
Display the table symbols which this image exports.
.It Fl opcodes
Display the low level opcodes used to encode all rebase and binding information.
.It Fl function_starts
Decodes the list of function start addresses.
.El
.Sh SEE ALSO
.Xr otool 1
.Xr nm 1
Commit	Line	Data
a645023d	1	.Dd November 10, 2010
55e3d2f6 A	2	.Dt dyldinfo 1
	3	.Os Darwin
	4	.Sh NAME
	5	.Nm dyldinfo
	6	.Nd "Displays information used by dyld in an executable"
	7	.Sh SYNOPSIS
	8	.Nm
	9	.Op Fl arch Ar arch-name
a645023d	10	.Op Fl dylibs
55e3d2f6 A	11	.Op Fl rebase
	12	.Op Fl bind
	13	.Op Fl weak_bind
	14	.Op Fl lazy_bind
	15	.Op Fl export
	16	.Op Fl opcodes
a645023d	17	.Op Fl function_starts
55e3d2f6 A	18	.Ar file(s)
	19	.Sh DESCRIPTION
	20	Executables built for Mac OS X 10.6 and later have a new format for the
	21	information in the __LINKEDIT segment. The dyldinfo tool will display
	22	that information.
	23	.Pp
	24	The options are as follows:
	25	.Bl -tag -width indent
	26	.It Fl arch Ar arch
	27	Only display the specified architecture. Other architectures in a universal image are ignored.
a645023d A	28	.It Fl dylibs
a645023d A	29	Display the table of dylibs on which this image depends.
55e3d2f6 A	30	.It Fl rebase
	31	Display the table of rebasing information. Rebasing is what dyld does when an image is
	32	not loaded at its preferred address. Typically, this involves updating pointers in the __DATA
a645023d	33	segment which point within the image.
55e3d2f6 A	34	.It Fl bind
	35	Display the table of binding information. These are the symbolic fix ups that dyld must
	36	do when an image is loaded.
	37	.It Fl weak_bind
	38	Display the table of weak binding information. Typically, only C++ progams will have any
	39	weak binding. These are symbols which dyld must unique accross all images.
	40	.It Fl lazy_bind
	41	Display the table of lazy binding information. These are symbols which dyld delays binding
	42	until they are first used. Lazy binding is automatically used for all function calls to
	43	functions in some external dylib.
	44	.It Fl export
	45	Display the table symbols which this image exports.
	46	.It Fl opcodes
	47	Display the low level opcodes used to encode all rebase and binding information.
a645023d A	48	.It Fl function_starts
a645023d A	49	Decodes the list of function start addresses.
55e3d2f6 A	50	.El
	51	.Sh SEE ALSO
	52	.Xr otool 1
	53	.Xr nm 1