Linux-man Archive on
 help / color / Atom feed
From: DJ Delorie <>
Subject: [patch] ldconfig.8: Document file filter and symlink pattern expectations
Date: Mon, 02 Dec 2019 15:32:10 -0500
Message-ID: <> (raw)

Information gleaned from comments in glibc's elf/ldconfig.c

diff --git a/man8/ldconfig.8 b/man8/ldconfig.8
index 4f799962c..15585243c 100644
--- a/man8/ldconfig.8
+++ b/man8/ldconfig.8
@@ -93,6 +93,28 @@ option.
 .B ldconfig
 should normally be run by the superuser as it may require write
 permission on some root owned directories and files.
+Note that
+.B ldconfig
+will only look at files that are named
+.I lib*.so*
+(for regular shared objects) or
+.I ld-*.so*
+(for the dynamic loader itsef).  Other files will be ignored.  Also,
+.B ldconfig
+expects a certain pattern to how the symlinks are set up, like this
+example, where the middle file
+.RB (
+here) is the SONAME for the library:
+.PP +4n
+.EX -> ->
+Failure to follow this pattern may result in compatibility issues
+after an upgrade.
 .BR \-c " \fIfmt\fP, " \-\-format=\fIfmt\fP

             reply index

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-12-02 20:32 DJ Delorie [this message]
2019-12-02 21:41 ` Carlos O'Donell

Reply instructions:

You may reply publically to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \ \ \ \ \ \

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Linux-man Archive on

Archives are clonable:
	git clone --mirror linux-man/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-man linux-man/ \
	public-inbox-index linux-man

Example config snippet for mirrors

Newsgroup available over NNTP:

AGPL code for this site: git clone