1 .\" Copyright 1999 SuSE GmbH Nuernberg, Germany
2 .\" Author: Thorsten Kukuk <kukuk@suse.de>
4 .\" SPDX-License-Identifier: GPL-2.0-or-later
6 .\" Modified, 6 May 2002, Michael Kerrisk, <mtk.manpages@gmail.com>
7 .\" Change listed order of /usr/lib and /lib
8 .TH ldconfig 8 (date) "Linux man-pages (unreleased)"
10 ldconfig \- configure dynamic linker run-time bindings
13 .\" TODO?: -c, --format, -i, --ignore-aux-cache, --print-cache,
14 .\" --verbose, -V, --version, -?, --help, --usage
22 .IR directory \~.\|.\|.
34 creates the necessary links and cache to the most recent shared
35 libraries found in the directories specified on the command line,
38 and in the trusted directories,
42 On some 64-bit architectures such as x86-64,
46 are the trusted directories for 32-bit libraries,
51 are used for 64-bit libraries.
53 The cache is used by the run-time linker,
58 checks the header and filenames of the libraries it encounters when
59 determining which versions should have their links updated.
60 .\" Support for libc4 and libc5 dropped in
61 .\" 8ee878592c4a642937152c8308b8faef86bcfc40 (2022-07-14) as "obsolete
62 .\" for over twenty years".
64 should normally be run by the superuser as it may require write
65 permission on some root owned directories and files.
68 will look only at files that are named
70 (for regular shared objects) or
72 (for the dynamic loader itself).
73 Other files will be ignored.
76 expects a certain pattern to how the symbolic links are set up,
80 here) is the SONAME for the library:
84 libfoo.so \-> libfoo.so.1 \-> libfoo.so.1.12
88 Failure to follow this pattern may result in compatibility issues
96 .\" commit 45eca4d141c047950db48c69c8941163d0a61fcd
107 .\" commit cad64f778aced84efdaa04ae64f8737b86f063ab
116 .IR /etc/ld.so.cache .
122 .IR /etc/ld.so.conf .
126 .B \-\-ignore\-aux\-cache
128 .\" commit 27d9ffda17df4d2388687afd12897774fde39bcc
129 Ignore auxiliary cache file.
133 Interpret each operand as a library name and configure its links.
134 Intended for use only by experts.
137 Process only the directories specified on the command line;
138 don't process the trusted directories,
139 nor those specified in
140 .IR /etc/ld.so.conf .
145 Don't rebuild the cache.
149 links are still updated.
154 Print the lists of directories and candidate libraries stored in
160 as the root directory.
166 Print current version number,
167 the name of each directory as it is scanned,
168 and any links that are created.
169 Overrides quiet mode.
174 Print program version.
181 the cache is still rebuilt.
183 .\" FIXME Since glibc-2.3.4, "include" directives are supported in ld.so.conf
185 .\" FIXME Since glibc-2.4, "hwcap" directives are supported in ld.so.conf
189 is the run-time linker/loader.
192 contains a list of directories,
194 in which to search for libraries.
197 contains an ordered list of libraries found in the directories
199 .IR /etc/ld.so.conf ,
200 as well as those found in the trusted directories.