freebsd-dev/usr.bin/ldd/ldd.1

.\" $FreeBSD$
.\"
.Dd October 22, 1993
.Dt LDD 1
.Os FreeBSD
.Sh NAME
.Nm ldd
.Nd list dynamic object dependencies
.Sh SYNOPSIS
.Nm ldd
.Op Fl v
.Op Fl f Ar format
.Ar program ...
.Sh DESCRIPTION
.Nm ldd
displays all shared objects that are needed to run the given program.
Contrary to nm(1), the list includes
.Dq indirect
dependencies that are the result of needed shared objects which themselves
depend on yet other shared objects.
.Pp
Zero, one or two
.Fl f
options may be given.
The argument is a format string passed to
.Xr rtld 1
and allows customization of
.Nm ldd Ns 's
output.
See
.Xr rtld 1
for a list of recognized conversion characters.
.Pp
The
.Fl v
option displays an verbose listing of the dynamic linking headers
encoded in the executable.  See the source code and include
files for the definitive meaning of all the fields.
.Sh SEE ALSO
.Xr ld 1 ,
.Xr nm 1
.Sh HISTORY
A
.Nm ldd
utility first appeared in SunOS 4.0, it appeared in its current form
in FreeBSD 1.1.
.Pp
The
.Fl v
support is based on code written by John Polstra <jdp@polstra.com>
Add $FreeBSD$ lines to man pages that are missing them to make it easier for translation teams. PR: docs/13418 Submitted by: Alexey Zelkin <phantom@cris.net> 1999-08-28 23:23:38 +00:00			`.\" $FreeBSD$`
			`.\"`
Imported NetBSD's ld for shared libs. 1993-11-03 23:41:59 +00:00			`.Dd October 22, 1993`
			`.Dt LDD 1`
Updated to recent version of Paul K.'s shlib code. This code has better warning handling and allows for link-time warnings with a modified version of gas. Note: Not all of the newer bits were updated such as some of the non-x86 machine-dependant code is relevant to FreeBSD right now. Obtained from: NetBSD 1994-12-23 22:31:35 +00:00			`.Os FreeBSD`
Imported NetBSD's ld for shared libs. 1993-11-03 23:41:59 +00:00			`.Sh NAME`
			`.Nm ldd`
			`.Nd list dynamic object dependencies`
			`.Sh SYNOPSIS`
			`.Nm ldd`
Incorporate John Polstra's sods.c display of the details about the dynamic linking information in the executable. It's quite extensive. It's connected to ldd's (new) -v option. 1996-10-01 02:16:16 +00:00			`.Op Fl v`
Made the synopsis in the man page conform to the style guide. Made the usage message conform to the style guide. Don't use the implementation variable `__progname'. 1996-11-30 16:12:46 +00:00			`.Op Fl f Ar format`
Support for specifying printf-like output specs to control the ldd output as present in the new rtld version. Obtained from: NetBSD Reviewed by: nate, jdp 1996-10-01 01:34:32 +00:00			`.Ar program ...`
Imported NetBSD's ld for shared libs. 1993-11-03 23:41:59 +00:00			`.Sh DESCRIPTION`
			`.Nm ldd`
			`displays all shared objects that are needed to run the given program.`
			`Contrary to nm(1), the list includes`
			`.Dq indirect`
fix a few spelling changes Submitted by: Josh Gilliam Closes PR's: 4429, 4431-4438 PS: He has agreed to submit all contrib fixes back to the original author. 1997-08-30 12:22:49 +00:00			`dependencies that are the result of needed shared objects which themselves`
Imported NetBSD's ld for shared libs. 1993-11-03 23:41:59 +00:00			`depend on yet other shared objects.`
Support for specifying printf-like output specs to control the ldd output as present in the new rtld version. Obtained from: NetBSD Reviewed by: nate, jdp 1996-10-01 01:34:32 +00:00			`.Pp`
			`Zero, one or two`
			`.Fl f`
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. 2000-03-01 12:20:22 +00:00			`options may be given.`
			`The argument is a format string passed to`
Support for specifying printf-like output specs to control the ldd output as present in the new rtld version. Obtained from: NetBSD Reviewed by: nate, jdp 1996-10-01 01:34:32 +00:00			`.Xr rtld 1`
			`and allows customization of`
			`.Nm ldd Ns 's`
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. 2000-03-01 12:20:22 +00:00			`output.`
			`See`
Support for specifying printf-like output specs to control the ldd output as present in the new rtld version. Obtained from: NetBSD Reviewed by: nate, jdp 1996-10-01 01:34:32 +00:00			`.Xr rtld 1`
Use consistent spelling, writeable -> writable (recall prior debate over this? :-) initialise -> initialize recognise -> recognize Merry Christmas! :) 1997-12-25 09:36:42 +00:00			`for a list of recognized conversion characters.`
Incorporate John Polstra's sods.c display of the details about the dynamic linking information in the executable. It's quite extensive. It's connected to ldd's (new) -v option. 1996-10-01 02:16:16 +00:00			`.Pp`
			`The`
			`.Fl v`
			`option displays an verbose listing of the dynamic linking headers`
			`encoded in the executable. See the source code and include`
			`files for the definitive meaning of all the fields.`
Imported NetBSD's ld for shared libs. 1993-11-03 23:41:59 +00:00			`.Sh SEE ALSO`
			`.Xr ld 1 ,`
			`.Xr nm 1`
			`.Sh HISTORY`
			`A`
			`.Nm ldd`
			`utility first appeared in SunOS 4.0, it appeared in its current form`
Changed NetBSD -> FreeBSD 1994-02-11 12:12:51 +00:00			`in FreeBSD 1.1.`
Incorporate John Polstra's sods.c display of the details about the dynamic linking information in the executable. It's quite extensive. It's connected to ldd's (new) -v option. 1996-10-01 02:16:16 +00:00			`.Pp`
			`The`
			`.Fl v`
			`support is based on code written by John Polstra <jdp@polstra.com>`