From kargl@troutmask.apl.washington.edu Mon Aug 23 08:09:43 1999
Return-Path: <kargl@troutmask.apl.washington.edu>
Received: from troutmask.apl.washington.edu (troutmask.apl.washington.edu [128.95.76.54])
	by hub.freebsd.org (Postfix) with ESMTP id 666C3156E9
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 23 Aug 1999 08:09:36 -0700 (PDT)
	(envelope-from kargl@troutmask.apl.washington.edu)
Received: (from root@localhost)
	by troutmask.apl.washington.edu (8.9.3/8.9.1) id IAA16584;
	Mon, 23 Aug 1999 08:13:13 -0700 (PDT)
	(envelope-from kargl)
Message-Id: <199908231513.IAA16584@troutmask.apl.washington.edu>
Date: Mon, 23 Aug 1999 08:13:13 -0700 (PDT)
From: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>
Reply-To: kargl@troutmask.apl.washington.edu
To: FreeBSD-gnats-submit@freebsd.org
Subject: remove rtld(1) XREF in dlopen.3
X-Send-Pr-Version: 3.2

>Number:         13333
>Category:       docs
>Synopsis:       remove rtld(1) XREF in dlopen.3
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    asmodai
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 23 08:10:01 PDT 1999
>Closed-Date:    Mon Jan 31 14:12:14 PST 2000
>Last-Modified:  Tue Feb  1 01:41:52 PST 2000
>Originator:     Steven G. Kargl
>Release:        FreeBSD 4.0-CURRENT i386
>Organization:
APL/UW
>Environment:

FreeBSD-current

>Description:

dlopen(3) contains a cross reference to rtld(1).  rtld(1)
appears to be absence on FreeBSD-current.

>How-To-Repeat:

	

>Fix:

--- dlopen.3.orig	Mon Aug 23 08:08:28 1999
+++ dlopen.3	Mon Aug 23 08:08:46 1999
@@ -241,6 +241,4 @@
 .Fn dlerror .
 .Sh SEE ALSO
 .Xr ld 1 ,
-.Xr rtld 1 ,
 .Xr link 5
-

>Release-Note:
>Audit-Trail:

From: Nik Clayton <nik@freebsd.org>
To: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Sun, 26 Sep 1999 00:09:43 +0100

 On Mon, Aug 23, 1999 at 08:13:13AM -0700, Steven G. Kargl wrote:
 > dlopen(3) contains a cross reference to rtld(1).  rtld(1)
 > appears to be absence on FreeBSD-current.
 
 rtld(1) is in libexec/rtld-aout.  This is only built if OBJFORMAT == 
 aout.
 
 I don't know this chunk of the system.  The proper fix might be to 
 have an aout specific dlopen(3) and an ELF specific dlopen(3).  If
 you enquire on -hackers we can probably work out the best course of
 action.
 
 N
 -- 
  [intentional self-reference] can be easily accommodated using a blessed,
  non-self-referential dummy head-node whose own object destructor severs
  the links.
     -- Tom Christiansen in <375143b5@cs.colorado.edu>
 

From: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>
To: nik@freebsd.org (Nik Clayton)
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Sat, 25 Sep 1999 18:33:31 -0700 (PDT)

 Once upon a time, Nik Clayton said:
 > On Mon, Aug 23, 1999 at 08:13:13AM -0700, Steven G. Kargl wrote:
 > > dlopen(3) contains a cross reference to rtld(1).  rtld(1)
 > > appears to be absence on FreeBSD-current.
 > 
 > rtld(1) is in libexec/rtld-aout.  This is only built if OBJFORMAT == 
 > aout.
 > 
 > I don't know this chunk of the system.  The proper fix might be to 
 > have an aout specific dlopen(3) and an ELF specific dlopen(3).  If
 > you enquire on -hackers we can probably work out the best course of
 > action.
 > 
 
 On a FreeBSD-current with the default ELF format, rtld.1 is not installed.
 Perhaps, rtld.1 should be installed into share/man/man1aout?
 Otherwise, the .Xr in dlopen(3) points to a man page that does not
 exist.
 
 -- 
 Steve
 

From: Alexey Zelkin <phantom@cris.net>
To: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>
Cc: freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Sun, 26 Sep 1999 07:21:13 +0400

 hi,
 
 On Sat, Sep 25, 1999 at 06:40:01PM -0700, Steven G. Kargl wrote:
 
 >  > rtld(1) is in libexec/rtld-aout.  This is only built if OBJFORMAT == 
 >  > aout.
 >  > 
 >  > I don't know this chunk of the system.  The proper fix might be to 
 >  > have an aout specific dlopen(3) and an ELF specific dlopen(3).  If
 >  > you enquire on -hackers we can probably work out the best course of
 >  > action.
 >  > 
 >  
 >  On a FreeBSD-current with the default ELF format, rtld.1 is not installed.
 >  Perhaps, rtld.1 should be installed into share/man/man1aout?
 >  Otherwise, the .Xr in dlopen(3) points to a man page that does not
 >  exist.
 
 You have to install compatXX dist to get this manpage installed. I not sure
 that we will do any specific actions with rtld.1 (like installing to man1aout)
 because we already have such precendents -- "man kerberos" is good one.
 
 May I close PR ?
 
 -- 
 /* Alexey Zelkin                       && phantom@cris.net    */
 /* Tavric National University          && phantom@crimea.edu  */
 /* http://www.ccssu.crimea.ua/~phantom && phantom@FreeBSD.org */
 

From: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>
To: phantom@cris.net (Alexey Zelkin)
Cc: freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Sun, 26 Sep 1999 11:52:21 -0700 (PDT)

 Once upon a time, Alexey Zelkin said:
 > hi,
 > 
 > On Sat, Sep 25, 1999 at 06:40:01PM -0700, Steven G. Kargl wrote:
 > 
 > >  > rtld(1) is in libexec/rtld-aout.  This is only built if OBJFORMAT == 
 > >  > aout.
 > >  > 
 > >  > I don't know this chunk of the system.  The proper fix might be to 
 > >  > have an aout specific dlopen(3) and an ELF specific dlopen(3).  If
 > >  > you enquire on -hackers we can probably work out the best course of
 > >  > action.
 > >  > 
 > >  
 > >  On a FreeBSD-current with the default ELF format, rtld.1 is not installed.
 > >  Perhaps, rtld.1 should be installed into share/man/man1aout?
 > >  Otherwise, the .Xr in dlopen(3) points to a man page that does not
 > >  exist.
 > 
 > You have to install compatXX dist to get this manpage installed. I not sure
 > that we will do any specific actions with rtld.1 (like installing to man1aout)
 > because we already have such precendents -- "man kerberos" is good one.
 > 
 > May I close PR ?
 > 
 
 Sure.  Close the PR.
 
 I update my systems via "make world", and I went from aout to
 elf format via "make update; make world".  I have the equivalent
 of the compatXX installed on my system with respect to the binaries
 and libraries.  I do not have rtld.1 except in /usr/src/whatever.
 The .Xr to rtld(1) in dlopen(3) should be removed on a FreeBSD-current
 system.
 
 -- 
 Steve
 

From: Alexey Zelkin <phantom@cris.net>
To: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>
Cc: Alexey Zelkin <phantom@cris.net>, freebsd-doc@FreeBSD.ORG,
	FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Mon, 27 Sep 1999 08:07:26 +0400

 hi,
 
 On Sun, Sep 26, 1999 at 11:52:21AM -0700, Steven G. Kargl wrote:
 
 > > May I close PR ?
 > > 
 > 
 > Sure.  Close the PR.
 Ok.
 
 > I update my systems via "make world", and I went from aout to
 > elf format via "make update; make world".  I have the equivalent
 > of the compatXX installed on my system with respect to the binaries
 > and libraries.  I do not have rtld.1 except in /usr/src/whatever.
 > The .Xr to rtld(1) in dlopen(3) should be removed on a FreeBSD-current
 > system.
 Just try to "make -DWANT_AOUT world" and you'll get it in /usr/libexec/aout.
 
 -- 
 /* Alexey Zelkin                       && phantom@cris.net    */
 /* Tavric National University          && phantom@crimea.edu  */
 /* http://www.ccssu.crimea.ua/~phantom && phantom@FreeBSD.org */
 

From: Mike Pritchard <mpp@FreeBSD.org>
To: phantom@cris.net (Alexey Zelkin)
Cc: kargl@troutmask.apl.washington.edu (Steven G. Kargl),
	freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Mon, 27 Sep 1999 05:38:00 -0500 (CDT)

 > hi,
 > 
 > On Sun, Sep 26, 1999 at 11:52:21AM -0700, Steven G. Kargl wrote:
 > 
 > > > May I close PR ?
 > > > 
 > > 
 > > Sure.  Close the PR.
 > Ok.
 
 Only after removing the refernce to rtld(1) :-).
 
 rtld(1) isn't installed by default anymore, so it shouldn't be xrefed.
 I've done *many* "make world"'s in the last 5 months or so, and the last time
 rtld(1) was installed was last May (about when I upgraded my main machine
 from 2.2.8 - 4.0-current).  My "virgin" 3.2 machine, and my 3.3-RC 
 machine do not have rtld.1 at all.
 
 Yes, rtld(1) can be installed under some configurations, but since
 you have to jump through some hoops to do that, we shouldn't xref rtld(1).
 
 (This reminds me, I should probably blow away my current /usr/share/man
 just so I can catch these kinds of things with 'manck')
 
 -Mike
   
 > > I update my systems via "make world", and I went from aout to
 > > elf format via "make update; make world".  I have the equivalent
 > > of the compatXX installed on my system with respect to the binaries
 > > and libraries.  I do not have rtld.1 except in /usr/src/whatever.
 > > The .Xr to rtld(1) in dlopen(3) should be removed on a FreeBSD-current
 > > system.
 > Just try to "make -DWANT_AOUT world" and you'll get it in /usr/libexec/aout.
 > -- 
 > /* Alexey Zelkin                       && phantom@cris.net    */
 -- 
 Mike Pritchard
 mpp@FreeBSD.org or mpp@mpp.pro-ns.net
 

From: Alexey Zelkin <phantom@cris.net>
To: Mike Pritchard <mpp@FreeBSD.org>
Cc: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>,
	freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Mon, 27 Sep 1999 14:11:56 +0400

 hi,
 
 On Mon, Sep 27, 1999 at 05:38:00AM -0500, Mike Pritchard wrote:
 
 > > > > May I close PR ?
 
 > > > Sure.  Close the PR.
 > > Ok.
 > 
 > Only after removing the refernce to rtld(1) :-).
 Maybe we just should replace rtld(1) reference with ld.so(1) reference ?
 I not sure that dinamic linker routine dlopen(3) not referencing dinamic
 loader (ld.so(1)). Just for note: we still have no elf(5) manpage (but as I
 know it's in progress) and we still have no ELF dinamic loader (ld-elf.so(1)).
 
 It means that we will not remove rtld(1) refernce, but create rtld(1)
 manpage (which by default will describe ELF format). And current rtld(1)
 manpage (a.out) will be installed under share/man/man1aout.
 
 Any correction for MHO ?
  
 > rtld(1) isn't installed by default anymore, so it shouldn't be xrefed.
 > I've done *many* "make world"'s in the last 5 months or so, and the last time
 > rtld(1) was installed was last May (about when I upgraded my main machine
 Yes. About this time AOUT world building was tunred off by default.
 
 -- 
 /* Alexey Zelkin                       && phantom@cris.net    */
 /* Tavric National University          && phantom@crimea.edu  */
 /* http://www.ccssu.crimea.ua/~phantom && phantom@FreeBSD.org */
 

From: Mike Pritchard <mpp@FreeBSD.org>
To: phantom@cris.net (Alexey Zelkin)
Cc: kargl@troutmask.apl.washington.edu (Steven G. Kargl),
	freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Mon, 27 Sep 1999 07:12:09 -0500 (CDT)

 > On Mon, Sep 27, 1999 at 05:38:00AM -0500, Mike Pritchard wrote:
 > > > > > May I close PR ?
 > > > > Sure.  Close the PR.
 > > > Ok.
 > > 
 > > Only after removing the refernce to rtld(1) :-).
 > Maybe we just should replace rtld(1) reference with ld.so(1) reference ?
 > I not sure that dinamic linker routine dlopen(3) not referencing dinamic
 > loader (ld.so(1)). Just for note: we still have no elf(5) manpage (but as I
 > know it's in progress) and we still have no ELF dinamic loader (ld-elf.so(1)).
 
 I'm no loader expert, so I'll leave that to someone else.  But,
 ld.so(1) also isn't on my 3.2, or 3.3 systems, much less the actual
 ld.so binary.  It is on my 4.0 system, but I suspect that is left over 
 from when this machine used to be 2.2.8 before I upgraded it to 3.2 then
 4.0.  I should really do a fresh 4.0 install on this machine :-(.
 
 Someone is slowly working on an elf(5) man page.
 
 As a side note, link(5) could probably use a "SEE ALSO" section.
   
 > It means that we will not remove rtld(1) refernce, but create rtld(1)
 > manpage (which by default will describe ELF format). And current rtld(1)
 > manpage (a.out) will be installed under share/man/man1aout.
 
 I don't have an rtld command installed on any of my 3.2, 3.3, or 4.0 systems,
 so I don't think we need to create a man page for it.
 -- 
 Mike Pritchard
 mpp@FreeBSD.org or mpp@mpp.pro-ns.net
 

From: Alexey Zelkin <phantom@cris.net>
To: Mike Pritchard <mpp@FreeBSD.ORG>
Cc: "Steven G. Kargl" <kargl@troutmask.apl.washington.edu>,
	FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/13333: remove rtld(1) XREF in dlopen.3
Date: Mon, 27 Sep 1999 16:13:27 +0400

 hi,
 
 On Mon, Sep 27, 1999 at 07:12:09AM -0500, Mike Pritchard wrote:
 
 > > > Only after removing the refernce to rtld(1) :-).
 > > Maybe we just should replace rtld(1) reference with ld.so(1) reference ?
 > > I not sure that dinamic linker routine dlopen(3) not referencing dinamic
 > > loader (ld.so(1)). Just for note: we still have no elf(5) manpage (but as I
 > > know it's in progress) and we still have no ELF dinamic loader (ld-elf.so(1)).
 > 
 > I'm no loader expert, so I'll leave that to someone else.  But,
 Let's ask about this specific question loader maintainer.
 
 [I added Cc: to jdp@FreeBSD.ORG (ld-elf.so maintainer) and hope that he'll
 clarify this question]
 
 > ld.so(1) also isn't on my 3.2, or 3.3 systems, much less the actual
 > ld.so binary.  It is on my 4.0 system, but I suspect that is left over 
 > from when this machine used to be 2.2.8 before I upgraded it to 3.2 then
 > 4.0.  I should really do a fresh 4.0 install on this machine :-(.
 :-)
 
 > Someone is slowly working on an elf(5) man page.
 >
 > As a side note, link(5) could probably use a "SEE ALSO" section.
 Agreed.
 
 > > It means that we will not remove rtld(1) refernce, but create rtld(1)
 > > manpage (which by default will describe ELF format). And current rtld(1)
 > > manpage (a.out) will be installed under share/man/man1aout.
 > 
 > I don't have an rtld command installed on any of my 3.2, 3.3, or 4.0 systems,
 > so I don't think we need to create a man page for it.
 Why not ? Please take a look on src/libexec/rtld-aout/rtld.1. Pay special
 attention to first ".Nm" directive. It says that rtld(1) and ld.so(1) are same
 utils and, depends on my output "locate ld-elf.so", I sure that ELF variant of
 rtld.1 manpage (ld-elf.so.1) will be added into FreeBSD source tree.
 
 2John Polstra: Am I right ?
 
 -- 
 /* Alexey Zelkin                       && phantom@cris.net    */
 /* Tavric National University          && phantom@crimea.edu  */
 /* http://www.ccssu.crimea.ua/~phantom && phantom@FreeBSD.org */
 
Responsible-Changed-From-To: freebsd-doc->jdp 
Responsible-Changed-By: billf 
Responsible-Changed-When: Mon Jan 31 11:20:00 PST 2000 
Responsible-Changed-Why:  
John recently shuffled around the man pages and such for this. 
He's also the resident linker maintainer. 
State-Changed-From-To: open->closed 
State-Changed-By: jdp 
State-Changed-When: Mon Jan 31 14:12:14 PST 2000 
State-Changed-Why:  
I have added an ELF version of rtld(1) to FreeBSD. 
. 
Responsible-Changed-From-To: jdp->asmodai 
Responsible-Changed-By: asmodai 
Responsible-Changed-When: Tue Feb 1 01:41:26 PST 2000 
Responsible-Changed-Why:  
I would take care of these pr's about rtld for John. 
>Unformatted:
