Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/ldd/ldd.1
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd October 23, 2018 | .Dd August 28, 2021 | ||||
.Dt LDD 1 | .Dt LDD 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ldd | .Nm ldd | ||||
.Nd list dynamic object dependencies | .Nd list dynamic object dependencies | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl a | .Op Fl a | ||||
.Op Fl v | |||||
.Op Fl f Ar format | .Op Fl f Ar format | ||||
.Ar program ... | .Ar program ... | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
utility displays all shared objects that are needed to run the given program or | utility displays all shared objects that are needed to run the given program or | ||||
to load the given shared object. | to load the given shared object. | ||||
Contrary to | Contrary to | ||||
Show All 21 Lines | |||||
See | See | ||||
.Xr rtld 1 | .Xr rtld 1 | ||||
for details, including a list of recognized conversion characters. | for details, including a list of recognized conversion characters. | ||||
.Pp | .Pp | ||||
The | The | ||||
.Fl a | .Fl a | ||||
option displays the list of all objects that are needed by each loaded | option displays the list of all objects that are needed by each loaded | ||||
object. | object. | ||||
This option does not work with | |||||
.Xr a.out 5 | |||||
binaries. | |||||
.Pp | |||||
The | |||||
.Fl v | |||||
option displays a 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 IMPLEMENTATION NOTES | .Sh IMPLEMENTATION NOTES | ||||
.Nm | .Nm | ||||
lists the dependencies of an executable by setting | lists the dependencies of an executable by setting | ||||
.Xr rtld 1 | .Xr rtld 1 | ||||
environment variables and running the executable in a child process. | environment variables and running the executable in a child process. | ||||
If the executable is corrupt or invalid, | If the executable is corrupt or invalid, | ||||
.Nm | .Nm | ||||
may therefore fail without providing any diagnostic error messages. | may therefore fail without providing any diagnostic error messages. | ||||
Show All 9 Lines | |||||
.Xr nm 1 , | .Xr nm 1 , | ||||
.Xr readelf 1 , | .Xr readelf 1 , | ||||
.Xr rtld 1 | .Xr rtld 1 | ||||
.Sh HISTORY | .Sh HISTORY | ||||
A | A | ||||
.Nm | .Nm | ||||
utility first appeared in SunOS 4.0, it appeared in its current form in | utility first appeared in SunOS 4.0, it appeared in its current form in | ||||
.Fx 1.1 . | .Fx 1.1 . | ||||
.Pp | |||||
The | |||||
.Fl v | |||||
support is based on code written by | |||||
.An John Polstra Aq Mt jdp@polstra.com |