close.2: Place discussion of error handling under a subheading in NOTES

[thirdparty/man-pages.git] / man8 / ldconfig.8

diff --git a/man8/ldconfig.8 b/man8/ldconfig.8
index cbd9b33a2d9954499a3dbc7c3f62315ce772a31a..c06212ebc8985fdae1add648942edb7859f85b19 100644 (file)
--- a/man8/ldconfig.8
+++ b/man8/ldconfig.8
@@ -19,7 +19,7 @@
 .\"
 .\" Modified, 6 May 2002, Michael Kerrisk, <mtk.manpages@gmail.com>
 .\"   Change listed order of /usr/lib and /lib
-.TH LDCONFIG 8 2012-05-10 "GNU" "Linux Programmer's Manual"
+.TH LDCONFIG 8 2015-03-29 "GNU" "Linux Programmer's Manual"
 .SH NAME
 ldconfig \- configure dynamic linker run-time bindings
 .SH SYNOPSIS
@@ -57,10 +57,20 @@ 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 in the trusted directories,
+.I /lib
+and
+.IR /usr/lib
+(on some 64-bit architectures such as x86-64,
+.I lib
+and
+.IR /usr/lib
+are the trusted directories for 32-bit libraries, while
+.I /lib64
 and
-.IR /usr/lib ).
+.IR /usr/lib64
+are used for 64-bit libraries).
+
 The cache is used by the run-time linker,
 .I ld.so
 or
@@ -99,18 +109,42 @@ should normally be run by the superuser 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.
+.BR \-c " \fIfmt\fP, " \-\-format=\fIfmt\fP
+(Since glibc 2.2)
+Cache format to use:
+.IR old ,
+.IR new ,
+or
+.IR compat
+(default).
+.TP
+.B \-C cache
+Use
+.B cache
+instead of
+.IR /etc/ld.so.cache .
+.TP
+.B \-f conf
+Use
+.B conf
+instead of
+.IR /etc/ld.so.conf .
+.\" FIXME glibc 2.7 added -i
+.TP
+.BR \-i ", " \-\-ignore\-aux\-cache
+(Since glibc 2.7)
+.\"             commit 27d9ffda17df4d2388687afd12897774fde39bcc
+Ignore auxiliary cache file.
+.TP
+.B \-l
+(Since glibc 2.2)
+Library mode.
+Manually link individual libraries.
+Intended for use by experts only.
 .TP
 .B \-n
-Only process directories specified on the command line.
-Don't process the trusted directories
-.RI ( /lib
-and
-.IR /usr/lib )
+Process only the directories specified on the command line.
+Don't process the trusted directories,
 nor those specified in
 .IR /etc/ld.so.conf .
 Implies
@@ -122,57 +156,47 @@ 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 .
+.BR \-p ", " \-\-print\-cache
+Print the lists of directories and candidate libraries stored in
+the current cache.
 .TP
-.B \-r root
+.BI "\-r  " root
 Change to and use
 .I root
 as the root directory.
 .TP
-.B \-l
-Library mode.
-Manually link individual libraries.
-Intended for use by experts only.
+.BR \-v ", " \-\-verbose
+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 \-p
-Print the lists of directories and candidate libraries stored in
-the current cache.
+.BR \-V ", " \-\-version
+Print program version.
+.TP
+.B \-X
+Don't update links.
+Unless
+.B \-N
+is also specified, the cache is still rebuilt.
 .SH FILES
+.\" FIXME Since glibc-2.3.4, "include" directives are supported in ld.so.conf
+.\"
+.\" FIXME Since glibc-2.4, "hwcap" directives are supported in ld.so.conf
 .PD 0
 .TP 20
 .I /lib/ld.so
-run-time linker/loader
+Run-time linker/loader.
 .TP 20
 .I /etc/ld.so.conf
-File containing a list of colon, space, tab, newline, or comma-separated
-directories in which to search for libraries.
-.\" FIXME Since glibc-2.3.4, "include" directives are supported in ld.so.conf
-.\" FIXME Since glibc-2.4, "hwcap" directives are supported in ld.so.conf
+File containing a list of directories, one per line,
+in which to search for libraries.
 .TP 20
 .I /etc/ld.so.cache
 File containing an ordered list of libraries found in the directories
 specified in
 .IR /etc/ld.so.conf ,
-as well as those found in
-.I /lib
-and
-.IR /usr/lib .
+as well as those found in the trusted directories.
 .PD
 .SH SEE ALSO
 .BR ldd (1),