git: e6ab1e365c06 - main - config(8): Correct the mentioned paper in the SEE ALSO section

[Warner Losh]

On Wed, Apr 14, 2021 at 4:38 AM Rodney W. Grimes <freebsd at gndrsh.dnsmgr.net>
wrote:

> > On Tue, Apr 13, 2021 at 03:41:22AM -0700, Rodney W. Grimes wrote:
> > > > The branch main has been updated by gbe (doc committer):
> > > >
> > > > URL:
> https://cgit.FreeBSD.org/src/commit/?id=e6ab1e365c06559e964667d2f5a6de856fa28be6
> > > >
> > > > commit e6ab1e365c06559e964667d2f5a6de856fa28be6
> > > > Author:     Gordon Bergling <gbe at FreeBSD.org>
> > > > AuthorDate: 2021-04-13 04:49:00 +0000
> > > > Commit:     Gordon Bergling <gbe at FreeBSD.org>
> > > > CommitDate: 2021-04-13 04:49:00 +0000
> > > >
> > > >     config(8): Correct the mentioned paper in the SEE ALSO section
> > > >
> > > >     FreeBSD's version of the config(8) utility is based on 4.3BSD not
> > > >     4.4BSD. So correct the mentioned paper in the SEE ALSO section.
> > >
> > > What is this based upon?
> > >
> > > As far as I know, and I am the one that did the imports, we
> > > never had the source code to config(8) for 4.3BSD, the config
> > > sources in the system are imported from the 4.4BSD lite source tape.
> >
> > Warner has sent me a private mail in which he told me that FreeBSD's
> > config(8) is based on 4.3BSD with a lot modifications. The updated
> > paper date and origin I got from a scan of the original documents
> > found at [1].
>
> If this has infact occured that is a violation of the AT&T/USL
> lawsuit agreement.
>
> Further as the person that did the import of 4.4, and did the lifting
> to make that version work with FreeBSD I dispute this claim that
> the config utility is based on 4.3BSD, the history of the files simply
> do not bear that to be true.
>
> Please revert this inaccurate change of history.
>

There were two different config programs in 4.4BSD, which is the base
of this confusion.

Rodney imported "config" from the 4.4-Lite tapes. This is the older
one, based on the 4.3BSD config with i386 added (he did nothing
wrong here: it was config on 4.4BSD). In talking about this with
$OTHERBSD projects this has always been referred to as the
4.3BSD-based config, even if that's a bit inaccurate. It was referred
to this way because they'd adopted config.new from 4.4BSD and
considered that the 4.4BSD-based config....

Chris Torek wrote config.new, which also first appeared on the 4.4BSD
tape, and subsequent 4.4BSD-lite releases. NetBSD adopted this in
its early days, so it's the basis for both NetBSD and OpenBSD. There
was even a port to FreeBSD which lost out to Doug Rabson's newbus
for device configuration in the FreeBSD 3.x timeframe. Atsushi Furuta-san
presented on this port at USENIX-99, the paper can be found here:
https://www.usenix.org/legacy/event/usenix99/full_papers/furuta/furuta.pdf
and Chris Torek's original paper is available from here:
http://www.netbsd.org/Documentation/kernel/config-torek.ps

I'd only ever seen his paper (at least I think it's this paper, since my mac
can't render it for me to confirm). It describes config.new, but bills it as
the configuration for 4.4BSD systems. I read it years ago.

My failure was that I'd neglected to double check what was actually
in the 4.4BSD manual. I'd assumed it was Chris' paper, but a check
now shows that I was wrong.

So Rodney is right, this should have been reverted.

Warner


> Regards,
> Rod
> >
> > --Gordon
> >
> > [1] http://www.bitsavers.org/pdf/mtXinu/MT_XINU_SMM_Apr_1986.pdf
> >
> > > >     Reported by:    imp
> > > >     Reviewed by:    imp
> > > >     X-MFC-with:     2b59392cb0da804e825c63469beb1934ec4267db
> > > >     Differential Revision:  https://reviews.freebsd.org/D29701
> > > > ---
> > > >  usr.sbin/config/config.8 | 7 ++++---
> > > >  1 file changed, 4 insertions(+), 3 deletions(-)
> > > >
> > > > diff --git a/usr.sbin/config/config.8 b/usr.sbin/config/config.8
> > > > index 929607712ef8..1e874c3e8355 100644
> > > > --- a/usr.sbin/config/config.8
> > > > +++ b/usr.sbin/config/config.8
> > > > @@ -28,7 +28,7 @@
> > > >  .\"     @(#)config.8     8.2 (Berkeley) 4/19/94
> > > >  .\" $FreeBSD$
> > > >  .\"
> > > > -.Dd April 9, 2021
> > > > +.Dd April 11, 2021
> > > >  .Dt CONFIG 8
> > > >  .Os
> > > >  .Sh NAME
> > > > @@ -249,11 +249,12 @@ The
> > > >  .Sx SYNOPSIS
> > > >  portion of each device in section 4.
> > > >  .Rs
> > > > -.\" 4.4BSD SMM:2
> > > > +.\" 4.3BSD SMM:2
> > > >  .%A S. J. Leffler
> > > >  .%A M. J. Karels
> > > >  .%T "Building 4.3 BSD UNIX System with Config"
> > > > -.%B 4.4BSD System Manager's Manual (SMM)
> > > > +.%B 4.3BSD System Manager's Manual (SMM)
> > > > +.%D June 3, 1986
> > > >  .Re
> > > >  .Sh HISTORY
> > > >  The
> > > >
> > >
> > > --
> > > Rod Grimes
> rgrimes at freebsd.org
> >
> > --
> >
>
> --
> Rod Grimes
> rgrimes at freebsd.org
>