View Source: ldconfig(8) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
ldconfig
!!!ldconfig
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
FILES
SEE ALSO
BUGS
AUTHORS
----
!!NAME


ldconfig - determine run-time link bindings
!!SYNOPSIS


ldconfig [[OPTION...]
!!DESCRIPTION


__ldconfig__ creates the necessary links and cache (for
use by the run-time linker, ''ld.so'') to the most recent
shared libraries found in the directories specified on the
command line, in the file ''/etc/ld.so.conf'', and in the
trusted directories (''/usr/lib'' and ''/lib'').
__ldconfig__ checks the header and file names of the
libraries it encounters when determining which versions
should have their links updated. __ldconfig__ ignores
symbolic links when scanning for libraries.


__ldconfig__ will attempt to deduce the type of ELF libs
(ie. libc5 or libc6/glibc) based on what C libs if any the
library was linked against, therefore when making dynamic
libraries, it is wise to explicitly link against libc (use
-lc).


Some existing libs do not contain enough information to
allow the deduction of their type, therefore the
''/etc/ld.so.conf'' file format allows the specification
of an expected type. This is __only__ used for those ELF
libs which we can not work out. The format is like this
__not__ allowed. Also see the __-p__
option.


Directory names containing an __=__ are no longer legal
unless they also have an expected type
specifier.


__ldconfig__ should normally be run by the super-user as
it may require write permission on some root owned
directories and files. It is normally run automatically at
bootup, from /etc/rc, or manually whenever new DLL's are
installed.
!!OPTIONS


__-v --verbose__


Verbose mode. Print current version number, the name of each
directory as it is scanned and any links that are
created.


__-n__


Only process directories specified on the command line.
Don't process the trusted directories (''/usr/lib'' and
''/lib'') nor those specified in ''/etc/ld.so.conf''.
Implies __-N__.


__-N__


Don't rebuild the cache. Unless __-X__ is also specified,
links are still updated.


__-X__


Don't update links. Unless __-N__ is also specified, the
cache is still rebuilt.


__-f conf__


Use __conf__ instead of
''/etc/ld.so.conf''.


__-C cache__


Use __cache__ instead of
''/etc/ld.so.cache''.


__-r root__


Change to and use __root__ as the root
directory.


__-l__


Library mode. Manually link individual libraries. Intended
for use by experts only.


__-p --print-cache__


Print the lists of directories and candidate libraries
stored in the current cache.


__-c --format=FORMAT__


Use __FORMAT__ for the cache file. Choices are old, new
and compat (the default).


__-? --help --usage__


Print usage information.


__-V --version__


Print version and exit.
!!EXAMPLES


In the bootup file ''/etc/rc'' having the
line


/sbin/ldconfig -v


will set up the correct links for the shared binaries and
rebuild the cache.


On the command line


# /sbin/ldconfig -n /lib


as root after the installation of a new DLL, will properly
update the shared library symbolic links in
/lib.
!!FILES


__/lib/ld.so, /lib/ld-linux.so.*__


execution time linker/loader


__/etc/ld.so.conf__


File containing a list of colon, space, tab, newline, or
comma spearated directories in which to search for
libraries.


__/etc/ld.so.cache__


File containing an ordered list of libraries found in the
directories specified in __/etc/ld.so.conf__. This file
is not in human readable format, and is not intended to be
edited.


__lib*.so.version__


shared libraries
!!SEE ALSO


ldd(1), ld.so(8).
!!BUGS


__ldconfig__'s functionality, in conjunction with
__ld.so__, is only available for executables compiled
using libc version 4.4.3 or greater.


__ldconfig__, being a user process, must be run manually
and has no means of dynamically determining and relinking
shared libraries for use by __ld.so__ when a new DLL is
installed.
!!AUTHORS


David Engel and Mitch D'Souza.
----
10 pages link to ldconfig(8):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Tuesday, June 4, 2002 12:31:14 am by "perry"
Edit PageHistory Diff Info LikePages