diff options
Diffstat (limited to 'usr/src/man/man1/ldd.1')
| -rw-r--r-- | usr/src/man/man1/ldd.1 | 48 |
1 files changed, 8 insertions, 40 deletions
diff --git a/usr/src/man/man1/ldd.1 b/usr/src/man/man1/ldd.1 index bfdd18db7c..ff612c494f 100644 --- a/usr/src/man/man1/ldd.1 +++ b/usr/src/man/man1/ldd.1 @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH ldd 1 "3 Jun 2008" "SunOS 5.11" "User Commands" +.TH LDD 1 "Jun 3, 2008" .SH NAME ldd \- list dynamic dependencies of executable files or shared objects .SH SYNOPSIS @@ -65,23 +65,19 @@ warnings for any unresolved symbol references that would occur when \fIfilename\fR is loaded. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Check \fBimmediate\fR references. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Check both \fBimmediate\fR references and \fBlazy\fR references. .RE @@ -107,24 +103,20 @@ references can be reported with the following options. These options are only useful when combined with either the \fB-d\fR or the \fB-r\fR options. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Expose any unresolved symbol errors to explicit \fBparent\fR and \fBexternal\fR references. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 6n -.rt Expose any unresolved \fBweak\fR symbol references. .RE @@ -171,12 +163,10 @@ Search paths that are not used to satisfy any dependencies cause unnecessary file system processing. .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad .RS 6n -.rt Displays any unreferenced, or unused dependencies. If an unreferenced dependency is not bound to by other objects loaded with \fIfilename\fR, the dependency is also flagged as unused. Cyclic dependencies that are not bound to @@ -187,12 +177,10 @@ This option also displays any unused search paths. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Displays any unused objects. .RE @@ -227,12 +215,10 @@ obtain the dependencies of this object, and hence will look unused to The following additional options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 12n -.rt Disables any configuration file use. Configuration files can be employed to alter default search paths, and provide alternative object dependencies. See \fBcrle\fR(1). @@ -240,12 +226,10 @@ alter default search paths, and provide alternative object dependencies. See .sp .ne 2 -.mk .na \fB\fB-e\fR \fIenvar\fR\fR .ad .RS 12n -.rt Sets the environment variable \fIenvar\fR. .sp This option is useful for experimenting with environment variables that are @@ -259,12 +243,10 @@ and \fBlari\fR(1). .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 12n -.rt Forces \fBldd\fR to check for an executable file that is not secure. When \fBldd\fR is invoked by a superuser, by default \fBldd\fR does not process any executable that is not secure. An executable is not considered secure if the @@ -275,12 +257,10 @@ if the interpreter cannot be determined. See \fBSecurity\fR under USAGE. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 12n -.rt Displays the order of execution of initialization sections. The order that is discovered can be affected by use of the \fB-d\fR or \fB-r\fR options. See \fBInitialization Order\fR under USAGE. @@ -288,12 +268,10 @@ discovered can be affected by use of the \fB-d\fR or \fB-r\fR options. See .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 12n -.rt Enables lazy loading. Lazy loading is the default mode of operation when the object under inspection is loaded as part of a process. In this case, any lazy dependencies, or filters, are only loaded into the process when reference is @@ -304,12 +282,10 @@ dependencies, and their order of loading as would occur in a running process. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 12n -.rt Forces the immediate processing of any filters so that all filtees, and their dependencies, are listed. The immediate processing of filters is now the default mode of operation for \fBldd\fR. However, under this default any @@ -319,23 +295,19 @@ option, missing auxiliary filtees generate an error message. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 12n -.rt Displays the search path used to locate shared object dependencies. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 12n -.rt Displays all dependency relationships incurred when processing \fIfilename\fR. This option also displays any dependency version requirements. See \fBpvs\fR(1). @@ -372,7 +344,7 @@ object: .sp .in +2 .nf -example% \fBldd main\fR +example% \fBldd main\fR libelf.so.1 => /lib/libelf.so.1 libnsl.so.1 => /lib/libnsl.so.1 libc.so.1 => /lib/libc.so.1 @@ -391,10 +363,10 @@ immediate, and lazy references respectively: .sp .in +2 .nf -example% \fBldd\fR \fB-L\fR \fBmain\fR -example% \fBldd\fR \fB-d\fR \fBmain\fR - libc.so.1 => /lib/libc.so.1 -example% \fBldd\fR \fB-r\fR \fBmain\fR +example% \fBldd\fR \fB-L\fR \fBmain\fR +example% \fBldd\fR \fB-d\fR \fBmain\fR + libc.so.1 => /lib/libc.so.1 +example% \fBldd\fR \fB-r\fR \fBmain\fR libc.so.1 => /lib/libc.so.1 libelf.so.1 => /lib/libelf.so.1 .fi @@ -422,7 +394,7 @@ the options used. For example, a simple application might reveal: .sp .in +2 .nf -example% \fBldd -i main\fR +example% \fBldd -i main\fR libA.so.1 => ./libA.so.1 libc.so.1 => /lib/libc.so.1 libB.so.1 => ./libB.so.1 @@ -440,7 +412,7 @@ whereas, when relocations are applied, the initialization section order is: .sp .in +2 .nf -example% \fBldd -ir main\fR +example% \fBldd -ir main\fR ......... init object=/lib/libc.so.1 @@ -475,23 +447,19 @@ dependencies using tools such as \fBdump\fR(1) and \fBelfdump\fR(1). .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/lddstub\fR\fR .ad .RS 23n -.rt Fake 32-bit executable loaded to check the dependencies of shared objects. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/64/lddstub\fR\fR .ad .RS 23n -.rt Fake 64-bit executable loaded to check the dependencies of shared objects. .RE |