]>
Commit | Line | Data |
---|---|---|
f1ed8a80 MK |
1 | .\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com> |
2 | .\" | |
3 | .\" %%%LICENSE_START(VERBATIM) | |
4 | .\" Permission is granted to make and distribute verbatim copies of this | |
5 | .\" manual provided the copyright notice and this permission notice are | |
6 | .\" preserved on all copies. | |
7 | .\" | |
8 | .\" Permission is granted to copy and distribute modified versions of this | |
9 | .\" manual under the conditions for verbatim copying, provided that the | |
10 | .\" entire resulting derived work is distributed under the terms of a | |
11 | .\" permission notice identical to this one. | |
12 | .\" | |
13 | .\" Since the Linux kernel and libraries are constantly changing, this | |
14 | .\" manual page may be incorrect or out-of-date. The author(s) assume no | |
15 | .\" responsibility for errors or omissions, or for damages resulting from | |
16 | .\" the use of the information contained herein. The author(s) may not | |
17 | .\" have taken the same level of care in the production of this manual, | |
18 | .\" which is licensed free of charge, as they might when working | |
19 | .\" professionally. | |
20 | .\" | |
21 | .\" Formatted or processed versions of this manual, if unaccompanied by | |
22 | .\" the source, must acknowledge the copyright and authors of this work. | |
23 | .\" %%%LICENSE_END | |
24 | .\" | |
b8efb414 | 25 | .TH PLDD 1 2016-10-08 "GNU" "Linux User Manual" |
f1ed8a80 MK |
26 | .SH NAME |
27 | pldd \- display dynamic shared objects linked into a process | |
28 | .SH SYNOPSIS | |
29 | .nf | |
dcab219a MK |
30 | .BI "pldd " "pid" |
31 | .BI pldd " option" | |
f1ed8a80 MK |
32 | .fi |
33 | .SH DESCRIPTION | |
34 | The | |
35 | .B pldd | |
6f9e0e57 | 36 | command displays a list of the dynamic shared objects that are |
f1ed8a80 MK |
37 | linked into the process with the specified process ID. |
38 | The list includes the libraries that have been dynamically loaded using | |
39 | .BR dlopen (3). | |
40 | .SH OPTIONS | |
41 | .TP | |
42 | .BR \-? ", " \-\-help | |
43 | Display program help message. | |
44 | .TP | |
45 | .BR \-\-usage | |
46 | Display a short usage message. | |
47 | .TP | |
48 | .BR \-V ", " \-\-version | |
49 | Display the program version. | |
f1ed8a80 MK |
50 | .SH EXIT STATUS |
51 | On success, | |
52 | .B pldd | |
53 | exits with the status 0. | |
54 | If the specified process does not exist, | |
55 | the user does not have permission to access | |
56 | its dynamic shared object list, | |
57 | or no command-line arguments are supplied, | |
58 | .B pldd | |
59 | exists with a status of 1. | |
60 | If given an invalid option, it exits with the status 64. | |
7e57f0e6 MK |
61 | .SH VERSIONS |
62 | .B pldd | |
63 | is available since glibc 2.15. | |
64 | .SH CONFORMING TO | |
65 | The | |
66 | .B pldd | |
67 | command is not specified by POSIX.1. | |
68 | Some other systems | |
69 | .\" There are man pages on Solaris and HP-UX. | |
70 | have a similar command. | |
f1ed8a80 MK |
71 | .SH NOTES |
72 | The command | |
e6154a82 MK |
73 | .PP |
74 | .in +4n | |
75 | .EX | |
76 | lsof \-p PID | |
77 | .EE | |
78 | .in | |
79 | .PP | |
f1ed8a80 MK |
80 | also shows output that includes the dynamic shared objects |
81 | that are linked into a process. | |
2a86152e | 82 | .PP |
760fc1e8 MK |
83 | The |
84 | .BR gdb (1) | |
85 | .I "info shared" | |
86 | command also shows the shared libraries being used by a process, | |
87 | so that one can obtain similar output to | |
88 | .BR pldd | |
89 | using a command such as the following | |
90 | (to monitor the process with the specified | |
91 | .IR pid ): | |
e6154a82 | 92 | .PP |
760fc1e8 | 93 | .in +4n |
e6154a82 | 94 | .EX |
760fc1e8 MK |
95 | $ \fBgdb \-ex "set confirm off" \-ex "set height 0" \-ex "info shared" \\\fP |
96 | \fB-ex "quit" \-p $pid | grep '^0x.*0x'\fP | |
97 | .fi | |
e6154a82 | 98 | .EE |
bc911928 MK |
99 | .SH BUGS |
100 | Since glibc 2.19, | |
101 | .B pldd | |
102 | is broken: it just hangs when executed. | |
c47c4f8a | 103 | .\" FIXME . https://sourceware.org/bugzilla/show_bug.cgi?id=18035 |
bc911928 | 104 | It is unclear if it will ever be fixed. |
7e57f0e6 MK |
105 | .SH EXAMPLE |
106 | .nf | |
107 | $ \fBecho $$\fP # Display PID of shell | |
108 | 1143 | |
109 | $ \fBpldd $$\fP # Display DSOs linked into the shell | |
110 | 1143: /usr/bin/bash | |
111 | linux\-vdso.so.1 | |
112 | /lib64/libtinfo.so.5 | |
113 | /lib64/libdl.so.2 | |
114 | /lib64/libc.so.6 | |
115 | /lib64/ld\-linux\-x86\-64.so.2 | |
116 | /lib64/libnss_files.so.2 | |
117 | .fi | |
f1ed8a80 MK |
118 | .SH SEE ALSO |
119 | .BR ldd (1), | |
120 | .BR lsof (1), | |
121 | .BR dlopen (3), | |
122 | .BR ld.so (8) |