Penguin
Recent Changes
Annotated edit history of ldconfig(8) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 ldconfig
2 !!!ldconfig
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 EXAMPLES
8 FILES
9 SEE ALSO
10 BUGS
11 AUTHORS
12 ----
13 !!NAME
14
15
16 ldconfig - determine run-time link bindings
17 !!SYNOPSIS
18
19
20 ldconfig [[OPTION...]
21 !!DESCRIPTION
22
23
24 __ldconfig__ creates the necessary links and cache (for
25 use by the run-time linker, ''ld.so'') to the most recent
26 shared libraries found in the directories specified on the
27 command line, in the file ''/etc/ld.so.conf'', and in the
28 trusted directories (''/usr/lib'' and ''/lib'').
29 __ldconfig__ checks the header and file names of the
30 libraries it encounters when determining which versions
31 should have their links updated. __ldconfig__ ignores
32 symbolic links when scanning for libraries.
33
34
35 __ldconfig__ will attempt to deduce the type of ELF libs
36 (ie. libc5 or libc6/glibc) based on what C libs if any the
37 library was linked against, therefore when making dynamic
38 libraries, it is wise to explicitly link against libc (use
39 -lc).
40
41
42 Some existing libs do not contain enough information to
43 allow the deduction of their type, therefore the
44 ''/etc/ld.so.conf'' file format allows the specification
45 of an expected type. This is __only__ used for those ELF
46 libs which we can not work out. The format is like this
47 __not__ allowed. Also see the __-p__
48 option.
49
50
51 Directory names containing an __=__ are no longer legal
52 unless they also have an expected type
53 specifier.
54
55
56 __ldconfig__ should normally be run by the super-user as
57 it may require write permission on some root owned
58 directories and files. It is normally run automatically at
59 bootup, from /etc/rc, or manually whenever new DLL's are
60 installed.
61 !!OPTIONS
62
63
64 __-v --verbose__
65
66
67 Verbose mode. Print current version number, the name of each
68 directory as it is scanned and any links that are
69 created.
70
71
72 __-n__
73
74
75 Only process directories specified on the command line.
76 Don't process the trusted directories (''/usr/lib'' and
77 ''/lib'') nor those specified in ''/etc/ld.so.conf''.
78 Implies __-N__.
79
80
81 __-N__
82
83
84 Don't rebuild the cache. Unless __-X__ is also specified,
85 links are still updated.
86
87
88 __-X__
89
90
91 Don't update links. Unless __-N__ is also specified, the
92 cache is still rebuilt.
93
94
95 __-f conf__
96
97
98 Use __conf__ instead of
99 ''/etc/ld.so.conf''.
100
101
102 __-C cache__
103
104
105 Use __cache__ instead of
106 ''/etc/ld.so.cache''.
107
108
109 __-r root__
110
111
112 Change to and use __root__ as the root
113 directory.
114
115
116 __-l__
117
118
119 Library mode. Manually link individual libraries. Intended
120 for use by experts only.
121
122
123 __-p --print-cache__
124
125
126 Print the lists of directories and candidate libraries
127 stored in the current cache.
128
129
130 __-c --format=FORMAT__
131
132
133 Use __FORMAT__ for the cache file. Choices are old, new
134 and compat (the default).
135
136
137 __-? --help --usage__
138
139
140 Print usage information.
141
142
143 __-V --version__
144
145
146 Print version and exit.
147 !!EXAMPLES
148
149
150 In the bootup file ''/etc/rc'' having the
151 line
152
153
154 /sbin/ldconfig -v
155
156
157 will set up the correct links for the shared binaries and
158 rebuild the cache.
159
160
161 On the command line
162
163
164 # /sbin/ldconfig -n /lib
165
166
167 as root after the installation of a new DLL, will properly
168 update the shared library symbolic links in
169 /lib.
170 !!FILES
171
172
173 __/lib/ld.so, /lib/ld-linux.so.*__
174
175
176 execution time linker/loader
177
178
179 __/etc/ld.so.conf__
180
181
182 File containing a list of colon, space, tab, newline, or
183 comma spearated directories in which to search for
184 libraries.
185
186
187 __/etc/ld.so.cache__
188
189
190 File containing an ordered list of libraries found in the
191 directories specified in __/etc/ld.so.conf__. This file
192 is not in human readable format, and is not intended to be
193 edited.
194
195
196 __lib*.so.version__
197
198
199 shared libraries
200 !!SEE ALSO
201
202
2 perry 203 ldd(1), ld.so(8).
1 perry 204 !!BUGS
205
206
207 __ldconfig__'s functionality, in conjunction with
208 __ld.so__, is only available for executables compiled
209 using libc version 4.4.3 or greater.
210
211
212 __ldconfig__, being a user process, must be run manually
213 and has no means of dynamically determining and relinking
214 shared libraries for use by __ld.so__ when a new DLL is
215 installed.
216 !!AUTHORS
217
218
219 David Engel and Mitch D'Souza.
220 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.