From nobody@FreeBSD.org  Tue May  4 11:02:56 2004
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id F321716A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <fox@vader.aacc.cc.md.us>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] Document what -f and LD_TRACE_LOADED_OBJECTS_FMT[12] are for in ldd/rtld
X-Send-Pr-Version: www-2.3

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue May 04 11:10:17 PDT 2004
>Closed-Date:    Sat May 12 12:26:45 GMT 2007
>Last-Modified:  Sat May 12 12:30:17 GMT 2007
>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:
State-Changed-From-To: open->closed 
State-Changed-By: pav 
State-Changed-When: Sat May 12 11:29:44 UTC 2007 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=66265 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/66265: commit references a PR
Date: Sat, 12 May 2007 12:23:49 +0000 (UTC)

 pav         2007-05-12 12:23:41 UTC
 
   FreeBSD src repository (doc,ports committer)
 
   Modified files:
     usr.bin/ldd          ldd.1 
   Log:
   Expand documentation of -f option
   
   PR:             docs/66265
   Submitted by:   Michel Lavondes <fox@vader.aacc.cc.md.us>
   MFC after:      1 week
   
   Revision  Changes    Path
   1.24      +8 -1      src/usr.bin/ldd/ldd.1
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/66265: commit references a PR
Date: Sat, 12 May 2007 12:24:54 +0000 (UTC)

 pav         2007-05-12 12:24:49 UTC
 
   FreeBSD src repository (doc,ports committer)
 
   Modified files:
     libexec/rtld-elf     rtld.1 
   Log:
   Expand documentation for LD_TRACE_LOADED_OBJECTS_FMT? variables
   
   PR:             docs/66265 (inspired by)
   Submitted by:   Michel Lavondes <fox@vader.aacc.cc.md.us>
   MFC after:      1 week
   
   Revision  Changes    Path
   1.44      +6 -0      src/libexec/rtld-elf/rtld.1
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
