Hello all,
I've drafted a man page for the pldd command that glibc added
in version 2.15. Comments and suggestions for improvements
welcome. Rendered version of the page is below, followed
by the page source.
Thanks
Michael
PLDD(1) Linux User Manual PLDD(1)
NAME
pldd - display dynamic shared objects linked into a process
SYNOPSIS
pldd PID
pldd OPTION
DESCRIPTION
The pldd command displays a list of the dynamic shared objects
that are linked into the process with the specified process ID.
The list includes the libraries that have been dynamically loaded
using dlopen(3).
OPTIONS
-?, --help
Display program help message.
--usage
Display a short usage message.
-V, --version
Display the program version.
VERSIONS
pldd is available since glibc 2.15.
CONFORMING TO
The pldd command is not specified by POSIX.1. Some other systems
have a similar command.
EXIT STATUS
On success, pldd exits with the status 0. If the specified
process does not exist, the user does not have permission to
access its dynamic shared object list, or no command-line argu‐
ments are supplied, pldd exists with a status of 1. If given an
invalid option, it exits with the status 64.
EXAMPLE
$ echo $$ # Display PID of shell
1143
$ pldd $$ # Display DSOs linked into the shell
1143: /usr/bin/bash
linux-vdso.so.1
/lib64/libtinfo.so.5
/lib64/libdl.so.2
/lib64/libc.so.6
/lib64/ld-linux-x86-64.so.2
/lib64/libnss_files.so.2
NOTES
The command
lsof -p PID
also shows output that includes the dynamic shared objects that
are linked into a process.
SEE ALSO
ldd(1), lsof(1), dlopen(3), ld.so(8)
GNU 2014-09-27 PLDD(1)
====
Page source
.\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@xxxxxxxxx>
.\"
.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
.TH PLDD 1 2014-09-27 "GNU" "Linux User Manual"
.SH NAME
pldd \- display dynamic shared objects linked into a process
.SH SYNOPSIS
.nf
.BI "pldd " "PID"
.BR pldd " OPTION"
.fi
.SH DESCRIPTION
The
.B pldd
command displays a list of the dynamic shared objects that are
linked into the process with the specified process ID.
The list includes the libraries that have been dynamically loaded using
.BR dlopen (3).
.SH OPTIONS
.TP
.BR \-? ", " \-\-help
Display program help message.
.TP
.BR \-\-usage
Display a short usage message.
.TP
.BR \-V ", " \-\-version
Display the program version.
.SH VERSIONS
.B pldd
is available since glibc 2.15.
.SH CONFORMING TO
The
.B pldd
command is not specified by POSIX.1.
Some other systems
.\" There are man pages on Solaris and HP-UX.
have a similar command.
.SH EXIT STATUS
On success,
.B pldd
exits with the status 0.
If the specified process does not exist,
the user does not have permission to access
its dynamic shared object list,
or no command-line arguments are supplied,
.B pldd
exists with a status of 1.
If given an invalid option, it exits with the status 64.
.SH EXAMPLE
.nf
$ \fBecho $$\fP # Display PID of shell
1143
$ \fBpldd $$\fP # Display DSOs linked into the shell
1143: /usr/bin/bash
linux\-vdso.so.1
/lib64/libtinfo.so.5
/lib64/libdl.so.2
/lib64/libc.so.6
/lib64/ld\-linux\-x86\-64.so.2
/lib64/libnss_files.so.2
.fi
.SH NOTES
The command
lsof -p PID
also shows output that includes the dynamic shared objects
that are linked into a process.
.SH SEE ALSO
.BR ldd (1),
.BR lsof (1),
.BR dlopen (3),
.BR ld.so (8)
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
