From patchwork Mon Dec 2 20:32:10 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: DJ Delorie X-Patchwork-Id: 1203314 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=sourceware.org (client-ip=209.132.180.131; helo=sourceware.org; envelope-from=libc-alpha-return-107635-incoming=patchwork.ozlabs.org@sourceware.org; receiver=) Authentication-Results: ozlabs.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.b="QNmrGfeO"; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.b="WCHTO2I0"; dkim-atps=neutral Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 47RcHC3WySz9sPJ for ; Tue, 3 Dec 2019 07:32:23 +1100 (AEDT) DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:date:message-id:from:to:cc:subject :content-type:content-transfer-encoding; q=dns; s=default; b=hvG xT1ye1lKNB5wPhwPWt88CoD4ZWyfPnnIa0yYHxnrhf7gztXr6+QDTGXIEoOi72at i022F7RE30lJqMm/BriUQ/8YFgMdee6pUx7+R8Jq8UgQmCiKl0pIbKAWdzyBnCDP heMNL+K5y6qi6j6ZaqLXRJL/KRAb6q2K+bNINdLs= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:date:message-id:from:to:cc:subject :content-type:content-transfer-encoding; s=default; bh=SulxhFFDJ JH1zE5TrN6lWKu4rjw=; b=QNmrGfeOmJ5aYH6FQxfypwYHue8VFLF0ouM3ou9pf F441Bezg/KyU4eUcIYtC7enXxL/G2dMUDxXN7BSSj6KK4DUSFCAAflEjAbYVMD+e Z+NWb65SsdOadyzYlNhaDySbcwZZdQBOKZ1D44wlFnj9rEn+A4jZiajiuTybFBNb SM= Received: (qmail 81400 invoked by alias); 2 Dec 2019 20:32:17 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Delivered-To: mailing list libc-alpha@sourceware.org Received: (qmail 81388 invoked by uid 89); 2 Dec 2019 20:32:17 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-18.2 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3 autolearn=ham version=3.3.1 spammy= X-HELO: us-smtp-delivery-1.mimecast.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1575318734; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=vUrGE/y2GAVUMdC3HFrIyK0p1d4PcznkA8dtEjUo1Dc=; b=WCHTO2I07hhKHYPaw3EXENmAYkrsy/13g5D8khpGZOMW33D1zmEefrPjDqtbu+0gOVFzsD pxV/IelCXwFbp+PvHTc5OQYfz7Dgs1Rdsqz6H5W1sFcUTdWmJSfm3Af2vH2l8ftHYYUoWw 9R9xOlMKAHOO03L7olKGNlxqWYqrrZc= Date: Mon, 02 Dec 2019 15:32:10 -0500 Message-Id: From: DJ Delorie To: mtk.manpages@gmail.com CC: linux-man@vger.kernel.org, libc-alpha@sourceware.org Subject: [patch] ldconfig.8: Document file filter and symlink pattern expectations X-Mimecast-Spam-Score: 0 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. +.PP +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 ( libfoo.so.1 +here) is the SONAME for the library: +.PP +.in +4n +.EX +libfoo.so -> libfoo.so.1 -> libfoo.so.1.12 +.EE +.in +.PP +Failure to follow this pattern may result in compatibility issues +after an upgrade. .SH OPTIONS .TP .BR \-c " \fIfmt\fP, " \-\-format=\fIfmt\fP