1LDCONFIG(8)                Linux Programmer's Manual               LDCONFIG(8)
2
3
4

NAME

6       ldconfig - configure dynamic linker run-time bindings
7

SYNOPSIS

9       /sbin/ldconfig  [  -nNvXV ] [ -f conf ] [ -C cache ] [ -r root ] direc‐
10       tory ...
11       /sbin/ldconfig -l [ -v ] library ...
12       /sbin/ldconfig -p
13

DESCRIPTION

15       ldconfig creates the necessary links  and  cache  to  the  most  recent
16       shared  libraries  found  in  the  directories specified on the command
17       line, in the file /etc/ld.so.conf, and in the trusted directories (/lib
18       and  /usr/lib).  The cache is used by the run-time linker, ld.so or ld-
19       linux.so.  ldconfig checks the header and filenames of the libraries it
20       encounters  when  determining  which  versions  should have their links
21       updated.
22
23       ldconfig will attempt to deduce the type of ELF libs  (i.e.,  libc5  or
24       libc6/glibc)  based  on  what  C  libs,  if any, the library was linked
25       against.
26
27       Some existing libs do not  contain  enough  information  to  allow  the
28       deduction  of  their  type.  Therefore, the /etc/ld.so.conf file format
29       allows the specification of an expected type.  This is  used  only  for
30       those   ELF   libs   which   we  can  not  work  out.   The  format  is
31       "dirname=TYPE", where TYPE can be libc4, libc5, or libc6.  (This syntax
32       also works on the command line.)  Spaces are not allowed.  Also see the
33       -p option.  ldconfig should normally be run by the superuser as it  may
34       require write permission on some root owned directories and files.
35

OPTIONS

37       -v     Verbose  mode.   Print  current version number, the name of each
38              directory as it is scanned, and  any  links  that  are  created.
39              Overrides quiet mode.
40
41       -n     Only  process  directories specified on the command line.  Don't
42              process the trusted directories (/lib and  /usr/lib)  nor  those
43              specified in /etc/ld.so.conf.  Implies -N.
44
45       -N     Don't rebuild the cache.  Unless -X is also specified, links are
46              still updated.
47
48       -X     Don't update links.  Unless -N is also specified, the  cache  is
49              still rebuilt.
50
51       -f conf
52              Use conf instead of /etc/ld.so.conf.
53
54       -C cache
55              Use cache instead of /etc/ld.so.cache.
56
57       -r root
58              Change to and use root as the root directory.
59
60       -l     Library mode.  Manually link individual libraries.  Intended for
61              use by experts only.
62
63       -p     Print the lists of directories and candidate libraries stored in
64              the current cache.
65

FILES

67       /lib/ld.so          run-time linker/loader
68       /etc/ld.so.conf     File  containing  a list of colon, space, tab, new‐
69                           line, or comma-separated directories  in  which  to
70                           search for libraries.
71       /etc/ld.so.cache    File  containing an ordered list of libraries found
72                           in the directories specified in /etc/ld.so.conf, as
73                           well as those found in /lib and /usr/lib.
74

SEE ALSO

76       ldd(1), ld.so(8)
77

COLOPHON

79       This  page  is  part of release 3.53 of the Linux man-pages project.  A
80       description of the project, and information about reporting  bugs,  can
81       be found at http://www.kernel.org/doc/man-pages/.
82
83
84
85GNU                               2012-05-10                       LDCONFIG(8)