]>
Commit | Line | Data |
---|---|---|
fea681da MK |
1 | .\" -*- nroff -*- |
2 | .\" Copyright 1999 SuSE GmbH Nuernberg, Germany | |
3 | .\" Author: Thorsten Kukuk <kukuk@suse.de> | |
4 | .\" | |
5 | .\" This program is free software; you can redistribute it and/or | |
6 | .\" modify it under the terms of the GNU General Public License as | |
7 | .\" published by the Free Software Foundation; either version 2 of the | |
8 | .\" License, or (at your option) any later version. | |
9 | .\" | |
10 | .\" This program is distributed in the hope that it will be useful, | |
11 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 | .\" General Public License for more details. | |
14 | .\" | |
15 | .\" You should have received a copy of the GNU General Public | |
16 | .\" License along with this program; see the file COPYING. If not, | |
17 | .\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
18 | .\" Boston, MA 02111-1307, USA. | |
19 | .\" | |
305a0578 | 20 | .\" Modified, 6 May 2002, Michael Kerrisk, <mtk-manpages@gmx.net> |
fea681da MK |
21 | .\" Change listed order of /usr/lib and /lib |
22 | .TH LDCONFIG 8 2002-05-06 "GNU C Library" "Linux Programmer's Manual" | |
23 | .SH NAME | |
24 | /sbin/ldconfig \- configure dynamic linker run time bindings | |
25 | .SH SYNOPSIS | |
26 | .B /sbin/ldconfig | |
27 | [ | |
28 | .B \-nNvXV | |
29 | ] | |
30 | [ | |
31 | .BR \-f\ conf | |
32 | ] | |
33 | [ | |
34 | .BR \-C\ cache | |
35 | ] | |
36 | [ | |
37 | .BR \-r\ root | |
38 | ] | |
39 | .IR directory \ ... | |
40 | .PD 0 | |
41 | .PP | |
42 | .PD | |
43 | .BR /sbin/ldconfig | |
44 | .B \-l | |
45 | [ | |
46 | .B \-v | |
47 | ] | |
48 | .IR library \ ... | |
49 | .PD 0 | |
50 | .PP | |
51 | .PD | |
52 | .B /sbin/ldconfig | |
53 | .B \-p | |
54 | .SH DESCRIPTION | |
55 | .B ldconfig | |
56 | creates the necessary links and cache to the most recent shared | |
57 | libraries found in the directories specified on the command line, | |
58 | in the file | |
59 | .IR /etc/ld.so.conf , | |
60 | and in the trusted directories | |
61 | .RI ( /lib | |
62 | and | |
63 | .IR /usr/lib ). | |
64 | The cache is used by the run-time linker, | |
65 | .IR ld.so | |
66 | or | |
67 | .IR ld-linux.so . | |
68 | .B ldconfig | |
2c5f1089 | 69 | checks the header and filenames of the libraries it encounters when |
fea681da MK |
70 | determining which versions should have their links updated. |
71 | .PP | |
72 | .B ldconfig | |
73 | will attempt to deduce the type of ELF libs (ie. libc5 or libc6/glibc) | |
4d9b6984 | 74 | based on what C libs, if any, the library was linked against. |
218e46f8 | 75 | .\" FIXME The following sentence looks suspect |
92057f4d | 76 | .\" (perhaps historical cruft) -- MTK, Jul 2005 |
4d9b6984 MK |
77 | Therefore, when making dynamic libraries, |
78 | it is wise to explicitly link against libc (use \-lc). | |
fea681da MK |
79 | .PP |
80 | Some existing libs do not contain enough information to allow the deduction of | |
81 | their type. Therefore, the | |
82 | .IR /etc/ld.so.conf | |
83 | file format allows the specification of an expected type. This is | |
8478ee02 | 84 | .I only |
fea681da MK |
85 | used for those ELF libs which we can not work out. The format |
86 | is "dirname=TYPE", where TYPE can be libc4, libc5, or libc6. | |
87 | (This syntax also works on the command line.) Spaces are | |
8478ee02 | 88 | .I not |
fea681da | 89 | allowed. Also see the |
4d9b6984 | 90 | .B \-p |
fea681da MK |
91 | option. |
92 | .B ldconfig | |
2c8d1c7d | 93 | should normally be run by the superuser as it may require write |
fea681da MK |
94 | permission on some root owned directories and files. |
95 | .SH OPTIONS | |
96 | .TP | |
97 | .B \-v | |
98 | Verbose mode. | |
99 | Print current version number, the name of each directory as it | |
100 | is scanned, and any links that are created. | |
101 | Overrides quiet mode. | |
102 | .TP | |
103 | .B \-n | |
104 | Only process directories specified on the command line. | |
105 | Don't process the trusted directories | |
106 | .RI ( /lib | |
107 | and | |
108 | .IR /usr/lib ) | |
109 | nor those specified in | |
110 | .IR /etc/ld.so.conf . | |
111 | Implies | |
112 | .BR \-N . | |
113 | .TP | |
114 | .B \-N | |
115 | Don't rebuild the cache. | |
116 | Unless | |
117 | .B \-X | |
118 | is also specified, links are still updated. | |
119 | .TP | |
120 | .B \-X | |
121 | Don't update links. | |
122 | Unless | |
123 | .B \-N | |
124 | is also specified, the cache is still rebuilt. | |
125 | .TP | |
126 | .B \-f conf | |
127 | Use | |
128 | .B conf | |
129 | instead of | |
130 | .IR /etc/ld.so.conf . | |
131 | .TP | |
132 | .B \-C cache | |
133 | Use | |
134 | .B cache | |
135 | instead of | |
136 | .IR /etc/ld.so.cache . | |
137 | .TP | |
138 | .B \-r root | |
139 | Change to and use | |
8478ee02 | 140 | .I root |
fea681da MK |
141 | as the root directory. |
142 | .TP | |
143 | .B \-l | |
144 | Library mode. Manually link individual libraries. Intended for | |
145 | use by experts only. | |
146 | .TP | |
147 | .B \-p | |
148 | Print the lists of directories and candidate libraries stored in | |
149 | the current cache. | |
fea681da MK |
150 | .SH FILES |
151 | .PD 0 | |
152 | .TP 20 | |
8478ee02 | 153 | .I /lib/ld.so |
fea681da MK |
154 | run-time linker/loader |
155 | .TP 20 | |
8478ee02 | 156 | .I /etc/ld.so.conf |
a898aac5 | 157 | File containing a list of colon, space, tab, newline, or comma-separated |
fea681da MK |
158 | directories in which to search for libraries. |
159 | .TP 20 | |
8478ee02 | 160 | .I /etc/ld.so.cache |
fea681da MK |
161 | File containing an ordered list of libraries found in the directories |
162 | specified in | |
8478ee02 | 163 | .IR /etc/ld.so.conf . |
fea681da | 164 | .PD |