summaryrefslogtreecommitdiffstats
path: root/man8/ldconfig.8
diff options
context:
space:
mode:
Diffstat (limited to 'man8/ldconfig.8')
-rw-r--r--man8/ldconfig.8162
1 files changed, 162 insertions, 0 deletions
diff --git a/man8/ldconfig.8 b/man8/ldconfig.8
new file mode 100644
index 000000000..57a146ded
--- /dev/null
+++ b/man8/ldconfig.8
@@ -0,0 +1,162 @@
+.\" -*- nroff -*-
+.\" Copyright 1999 SuSE GmbH Nuernberg, Germany
+.\" Author: Thorsten Kukuk <kukuk@suse.de>
+.\"
+.\" This program is free software; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of the
+.\" License, or (at your option) any later version.
+.\"
+.\" This program is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+.\" General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public
+.\" License along with this program; see the file COPYING. If not,
+.\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+.\" Boston, MA 02111-1307, USA.
+.\"
+.\" Modified, 6 May 2002, Michael Kerrisk, mtk16@ext.canterbury.ac.nz
+.\" Change listed order of /usr/lib and /lib
+.TH LDCONFIG 8 2002-05-06 "GNU C Library" "Linux Programmer's Manual"
+.SH NAME
+/sbin/ldconfig \- configure dynamic linker run time bindings
+.SH SYNOPSIS
+.B /sbin/ldconfig
+[
+.B \-nNvXV
+]
+[
+.BR \-f\ conf
+]
+[
+.BR \-C\ cache
+]
+[
+.BR \-r\ root
+]
+.IR directory \ ...
+.PD 0
+.PP
+.PD
+.BR /sbin/ldconfig
+.B \-l
+[
+.B \-v
+]
+.IR library \ ...
+.PD 0
+.PP
+.PD
+.B /sbin/ldconfig
+.B \-p
+.SH DESCRIPTION
+.B ldconfig
+creates the necessary links and cache to the most recent shared
+libraries found in the directories specified on the command line,
+in the file
+.IR /etc/ld.so.conf ,
+and in the trusted directories
+.RI ( /lib
+and
+.IR /usr/lib ).
+The cache is used by the run-time linker,
+.IR ld.so
+or
+.IR ld-linux.so .
+.B ldconfig
+checks the header and file names of the libraries it encounters when
+determining which versions should have their links updated.
+.PP
+.B 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).
+.PP
+Some existing libs do not contain enough information to allow the deduction of
+their type. Therefore, the
+.IR /etc/ld.so.conf
+file format allows the specification of an expected type. This is
+.B only
+used for those ELF libs which we can not work out. The format
+is "dirname=TYPE", where TYPE can be libc4, libc5, or libc6.
+(This syntax also works on the command line.) Spaces are
+.B not
+allowed. Also see the
+.B -p
+option.
+.B ldconfig
+should normally be run by the super-user as it may require write
+permission on some root owned directories and files.
+.SH OPTIONS
+.TP
+.B \-v
+Verbose mode.
+Print current version number, the name of each directory as it
+is scanned, and any links that are created.
+Overrides quiet mode.
+.TP
+.B \-n
+Only process directories specified on the command line.
+Don't process the trusted directories
+.RI ( /lib
+and
+.IR /usr/lib )
+nor those specified in
+.IR /etc/ld.so.conf .
+Implies
+.BR \-N .
+.TP
+.B \-N
+Don't rebuild the cache.
+Unless
+.B \-X
+is also specified, links are still updated.
+.TP
+.B \-X
+Don't update links.
+Unless
+.B \-N
+is also specified, the cache is still rebuilt.
+.TP
+.B \-f conf
+Use
+.B conf
+instead of
+.IR /etc/ld.so.conf .
+.TP
+.B \-C cache
+Use
+.B cache
+instead of
+.IR /etc/ld.so.cache .
+.TP
+.B \-r root
+Change to and use
+.B root
+as the root directory.
+.TP
+.B \-l
+Library mode. Manually link individual libraries. Intended for
+use by experts only.
+.TP
+.B \-p
+Print the lists of directories and candidate libraries stored in
+the current cache.
+
+.SH FILES
+.PD 0
+.TP 20
+.B /lib/ld.so
+run-time linker/loader
+.TP 20
+.B /etc/ld.so.conf
+File containing a list of colon, space, tab, newline, or comma spearated
+directories in which to search for libraries.
+.TP 20
+.B /etc/ld.so.cache
+File containing an ordered list of libraries found in the directories
+specified in
+.BR /etc/ld.so.conf .
+.PD