Debian Codegraph @

upstream/fedora-44/man1/pldd.1

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