Debian Codegraph @

upstream/debian-unstable/man1/pldd.1

raw
1 .\" Copyright 2014, Michael Kerrisk <[email protected]>
2 .\" Copyright, the authors of the Linux man-pages project
3 .\"
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\"
6 .TH pldd 1 2026-02-08 "Linux man-pages 6.18"
7 .SH NAME
8 pldd \- display dynamic shared objects linked into a process
9 .SH SYNOPSIS
10 .SY pldd
11 .I pid
12 .YS
13 .SY pldd
14 .I option
15 .YS
16 .SH DESCRIPTION
17 The
18 .B pldd
19 command displays a list of the dynamic shared objects (DSOs) that are
20 linked into the process with the specified process ID (PID).
21 The list includes the libraries that have been dynamically loaded using
22 .BR dlopen (3).
23 .SH OPTIONS
24 .TP
25 .B \-\-help
26 .TQ
27 .B \-?
28 Display a help message and exit.
29 .TP
30 .B \-\-usage
31 Display a short usage message and exit.
32 .TP
33 .B \-\-version
34 .TQ
35 .B \-V
36 Display program version information and exit.
37 .SH EXIT STATUS
38 On success,
39 .B pldd
40 exits with the status 0.
41 If the specified process does not exist,
42 the user does not have permission to access
43 its dynamic shared object list,
44 or no command-line arguments are supplied,
45 .B pldd
46 exists with a status of 1.
47 If given an invalid option, it exits with the status 64.
48 .SH VERSIONS
49 Some other systems
50 .\" There are man pages on Solaris and HP-UX.
51 have a similar command.
52 .SH STANDARDS
53 None.
54 .SH HISTORY
55 glibc 2.15.
56 .SH NOTES
57 The command
58 .P
59 .in +4n
60 .EX
61 lsof \-p PID
62 .EE
63 .in
64 .P
65 also shows output that includes the dynamic shared objects
66 that are linked into a process.
67 .P
68 The
69 .BR gdb (1)
70 .I "info shared"
71 command also shows the shared libraries being used by a process,
72 so that one can obtain similar output to
73 .B pldd
74 using a command such as the following
75 (to monitor the process with the specified
76 .IR pid ):
77 .P
78 .in +4n
79 .EX
80 .RB $ " gdb \-ex \[dq]set confirm off\[dq] \[rs]"
81 .B " \-ex \[dq]set height 0\[dq] \[rs]"
82 .B " \-ex \[dq]info shared\[dq] \[rs]"
83 .B " \-ex \[dq]quit\[dq] \[rs]"
84 .B " \-p $pid \[rs]"
85 .BR "| grep \[aq]\[ha]0x.*0x\[aq]" ;
86 .EE
87 .in
88 .SH BUGS
89 From glibc 2.19 to glibc 2.29,
90 .B pldd
91 was broken: it just hung when executed.
92 .\" glibc commit 1a4c27355e146b6d8cc6487b998462c7fdd1048f
93 This problem was fixed in glibc 2.30, and the fix has been backported
94 to earlier glibc versions in some distributions.
95 .SH EXAMPLES
96 .EX
97 .RB $ " echo $$" "; # Display PID of shell"
98 1143
99 .RB $ " pldd $$" "; # Display DSOs linked into the shell"
100 1143: /usr/bin/bash
101 linux\-vdso.so.1
102 /lib64/libtinfo.so.5
103 /lib64/libdl.so.2
104 /lib64/libc.so.6
105 /lib64/ld\-linux\-x86\-64.so.2
106 /lib64/libnss_files.so.2
107 .EE
108 .SH SEE ALSO
109 .BR ldd (1),
110 .BR lsof (1),
111 .BR dlopen (3),
112 .BR ld.so (8)