-.\" -*- nroff -*-
.\" Copyright 1999 SuSE GmbH Nuernberg, Germany
.\" Author: Thorsten Kukuk <kukuk@suse.de>
.\"
+.\" %%%LICENSE_START(GPLv2+_SW_3_PARA)
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of the
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
-.\" License along with this program; see the file COPYING. If not,
-.\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-.\" Boston, MA 02111-1307, USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
.\"
-.\" Modified, 6 May 2002, Michael Kerrisk, <mtk-manpages@gmx.net>
+.\" Modified, 6 May 2002, Michael Kerrisk, <mtk.manpages@gmail.com>
.\" Change listed order of /usr/lib and /lib
-.TH LDCONFIG 8 2002-05-06 "GNU" "Linux Programmer's Manual"
+.TH LDCONFIG 8 2015-03-29 "GNU" "Linux Programmer's Manual"
.SH NAME
-/sbin/ldconfig \- configure dynamic linker run time bindings
+ldconfig \- configure dynamic linker run-time bindings
.SH SYNOPSIS
.B /sbin/ldconfig
[
.PD 0
.PP
.PD
-.BR /sbin/ldconfig
+.B /sbin/ldconfig
.B \-l
[
.B \-v
libraries found in the directories specified on the command line,
in the file
.IR /etc/ld.so.conf ,
-and in the trusted directories
-.RI ( /lib
+and in the trusted directories,
+.I /lib
+and
+.IR /usr/lib
+(on some 64-bit architectures such as x86-64,
+.I lib
+and
+.IR /usr/lib
+are the trusted directories for 32-bit libraries, while
+.I /lib64
and
-.IR /usr/lib ).
+.IR /usr/lib64
+are used for 64-bit libraries).
+
The cache is used by the run-time linker,
-.IR ld.so
+.I ld.so
or
.IR ld-linux.so .
.B ldconfig
determining which versions should have their links updated.
.PP
.B ldconfig
-will attempt to deduce the type of ELF libs (ie. libc5 or libc6/glibc)
+will attempt to deduce the type of ELF libs (i.e., libc5 or libc6/glibc)
based on what C libs, if any, the library was linked against.
-.\" FIXME The following sentence looks suspect
+.\" The following sentence looks suspect
.\" (perhaps historical cruft) -- MTK, Jul 2005
-Therefore, when making dynamic libraries,
-it is wise to explicitly link against libc (use \-lc).
+.\" Therefore, when making dynamic libraries,
+.\" it is wise to explicitly link against libc (use \-lc).
.PP
Some existing libs do not contain enough information to allow the deduction of
their type.
Therefore, the
-.IR /etc/ld.so.conf
+.I /etc/ld.so.conf
file format allows the specification of an expected type.
-This is
+This is used
.I only
-used for those ELF libs which we can not work out.
+for those ELF libs which we can not work out.
The format
is "dirname=TYPE", where TYPE can be libc4, libc5, or libc6.
(This syntax also works on the command line.)
permission on some root owned directories and files.
.SH OPTIONS
.TP
-.B \-v
-Verbose mode.
-Print current version number, the name of each directory as it
-is scanned, and any links that are created.
-Overrides quiet mode.
+.BR \-c " \fIfmt\fP, " \-\-format=\fIfmt\fP
+(Since glibc 2.2)
+Cache format to use:
+.IR old ,
+.IR new ,
+or
+.IR compat
+(default).
+.TP
+.B \-C cache
+Use
+.B cache
+instead of
+.IR /etc/ld.so.cache .
+.TP
+.B \-f conf
+Use
+.B conf
+instead of
+.IR /etc/ld.so.conf .
+.\" FIXME glibc 2.7 added -i
+.TP
+.BR \-i ", " \-\-ignore\-aux\-cache
+(Since glibc 2.7)
+.\" commit 27d9ffda17df4d2388687afd12897774fde39bcc
+Ignore auxiliary cache file.
+.TP
+.B \-l
+(Since glibc 2.2)
+Library mode.
+Manually link individual libraries.
+Intended for use by experts only.
.TP
.B \-n
-Only process directories specified on the command line.
-Don't process the trusted directories
-.RI ( /lib
-and
-.IR /usr/lib )
+Process only the directories specified on the command line.
+Don't process the trusted directories,
nor those specified in
.IR /etc/ld.so.conf .
Implies
.B \-X
is also specified, links are still updated.
.TP
-.B \-X
-Don't update links.
-Unless
-.B \-N
-is also specified, the cache is still rebuilt.
-.TP
-.B \-f conf
-Use
-.B conf
-instead of
-.IR /etc/ld.so.conf .
-.TP
-.B \-C cache
-Use
-.B cache
-instead of
-.IR /etc/ld.so.cache .
+.BR \-p ", " \-\-print\-cache
+Print the lists of directories and candidate libraries stored in
+the current cache.
.TP
-.B \-r root
+.BI "\-r " root
Change to and use
.I root
as the root directory.
.TP
-.B \-l
-Library mode.
-Manually link individual libraries.
-Intended for use by experts only.
+.BR \-v ", " \-\-verbose
+Verbose mode.
+Print current version number, the name of each directory as it
+is scanned, and any links that are created.
+Overrides quiet mode.
.TP
-.B \-p
-Print the lists of directories and candidate libraries stored in
-the current cache.
+.BR \-V ", " \-\-version
+Print program version.
+.TP
+.B \-X
+Don't update links.
+Unless
+.B \-N
+is also specified, the cache is still rebuilt.
.SH FILES
+.\" FIXME Since glibc-2.3.4, "include" directives are supported in ld.so.conf
+.\"
+.\" FIXME Since glibc-2.4, "hwcap" directives are supported in ld.so.conf
.PD 0
.TP 20
.I /lib/ld.so
-run-time linker/loader
+Run-time linker/loader.
.TP 20
.I /etc/ld.so.conf
-File containing a list of colon, space, tab, newline, or comma-separated
-directories in which to search for libraries.
+File containing a list of directories, one per line,
+in which to search for libraries.
.TP 20
.I /etc/ld.so.cache
File containing an ordered list of libraries found in the directories
specified in
-.IR /etc/ld.so.conf .
+.IR /etc/ld.so.conf ,
+as well as those found in the trusted directories.
.PD
+.SH SEE ALSO
+.BR ldd (1),
+.BR ld.so (8)