From owner-freebsd-doc@FreeBSD.ORG Tue May 4 11:10:24 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 36D9816A4D6 for ; Tue, 4 May 2004 11:10:24 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EFE2243D5A for ; Tue, 4 May 2004 11:10:17 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i44IAHRe081530 for ; Tue, 4 May 2004 11:10:17 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i44IAHhq081529; Tue, 4 May 2004 11:10:17 -0700 (PDT) (envelope-from gnats) Resent-Date: Tue, 4 May 2004 11:10:17 -0700 (PDT) Resent-Message-Id: <200405041810.i44IAHhq081529@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Michel Lavondes Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F321716A4CE for ; Tue, 4 May 2004 11:02:55 -0700 (PDT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id BEB1D43D48 for ; Tue, 4 May 2004 11:02:55 -0700 (PDT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i44I2toY090640 for ; Tue, 4 May 2004 11:02:55 -0700 (PDT) (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i44I2tA5090639; Tue, 4 May 2004 11:02:55 -0700 (PDT) (envelope-from nobody) Message-Id: <200405041802.i44I2tA5090639@www.freebsd.org> Date: Tue, 4 May 2004 11:02:55 -0700 (PDT) From: Michel Lavondes To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/66265: [patch] Document what -f and LD_TRACE_LOADED_OBJECTS_FMT[12] are for in ldd/rtld X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 04 May 2004 18:10:24 -0000 >Number: 66265 >Category: docs >Synopsis: [patch] Document what -f and LD_TRACE_LOADED_OBJECTS_FMT[12] are for in ldd/rtld >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue May 04 11:10:17 PDT 2004 >Closed-Date: >Last-Modified: >Originator: Michel Lavondes >Release: 4.8-RELEASE-p18 >Organization: Ah! I wish! >Environment: >Description: ldd(1) and rtld(1) are vague about the effect of repeated -f options, or the difference between LD_TRACE_LOADED_OBJECTS_FMT1 and LD_TRACE_LOADED_OBJECTS_FMT2. This makes clear that one is for libraries, the other for shared objects. >How-To-Repeat: man ldd man rtld (not tested on -current, but I looked at the CVS repo and didn't see anything along those lines.) >Fix: --- usr.bin/ldd/ldd.1.orig Sun May 2 14:34:19 2004 +++ usr.bin/ldd/ldd.1 Sun May 2 23:57:54 2004 @@ -26,6 +26,13 @@ Zero, one or two .Fl f options may be given. +If one is given, it sets +.Ev LD_TRACE_LOADED_OBJECTS_FMT1 . +If two are given, they set +.Ev LD_TRACE_LOADED_OBJECTS_FMT1 +and +.Ev LD_TRACE_LOADED_OBJECTS_FMT2 , +respectively. The argument is a format string passed to .Xr rtld 1 and allows customization of @@ -33,7 +40,7 @@ output. See .Xr rtld 1 -for a list of recognized conversion characters. +for details, including a list of recognized conversion characters. .Pp The .Fl v --- libexec/rtld-elf/rtld.1.orig Sun May 2 23:23:40 2004 +++ libexec/rtld-elf/rtld.1 Sun May 2 23:29:57 2004 @@ -117,6 +117,10 @@ option and allows .Xr ldd 1 to be operated as a filter more conveniently. +.Ev LD_TRACE_LOADED_OBJECTS_FMT1 +is used for tracing shared libraries, and +.Ev LD_TRACE_LOADED_OBJECTS_FMT2 +is used for tracing shared objects (but see BUGS below). The following conversions can be used: .Bl -tag -width 4n .It Li %a @@ -153,3 +157,6 @@ .Xr ldd 1 , .Xr elf 5 , .Xr ldconfig 8 +.Sh BUGS +Libraries with a name that doesn't start with lib may be mistaken for +objects, and conversely. >Release-Note: >Audit-Trail: >Unformatted: