NetBSD Problem Report #33952

From perry@piermont.com  Sat Jul  8 23:23:08 2006
Return-Path: <perry@piermont.com>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id A308063B8C5
	for <gnats-bugs@gnats.NetBSD.org>; Sat,  8 Jul 2006 23:23:08 +0000 (UTC)
Message-Id: <20060708221809.55C2D78B493@hackworth.piermont.com>
Date: Sat,  8 Jul 2006 18:18:09 -0400 (EDT)
From: perry@piermont.com
Reply-To: perry@piermont.com
To: gnats-bugs@NetBSD.org
Subject: There is no documentation for "Wedges"
X-Send-Pr-Version: 3.95

>Number:         33952
>Category:       kern
>Synopsis:       There is no documentation for "Wedges"
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Jul 08 23:25:00 +0000 2006
>Closed-Date:    
>Last-Modified:  Mon Mar 01 00:50:34 +0000 2010
>Originator:     Perry E. Metzger
>Release:        NetBSD 3.99.21
>Organization:
Perry E. Metzger		perry@piermont.com
--
"Ask not what your country can force other people to do for you..."
>Environment:


System: NetBSD hackworth 3.99.21 NetBSD 3.99.21 (HACKWORTH) #0: Tue Jun 13 21:53:06 EDT 2006 perry@hackworth:/usr/src/sys/arch/i386/compile/HACKWORTH i386
Architecture: i386
Machine: i386
>Description:
	Right now, disk labels can't handle really large disks. Some
people say that the way to fix this is to complete the "wedges"
code. However, no documentation exists for "wedges", or it is at least
very incomplete. It would be useful for someone to:

1) Write up a summary of the Wedges design so that people can finish
   the implementation.
2) Write up proper docs so that users can use the parts we have (and
   so that they will be able to use the whole thing once finished.)

>How-To-Repeat:

>Fix:


>Release-Note:

>Audit-Trail:

State-Changed-From-To: open->feedback
State-Changed-By: pgoyette@NetBSD.org
State-Changed-When: Mon, 22 Feb 2010 04:27:03 +0000
State-Changed-Why:
Pointed originator to dk(4) and dkctl(8) documentation in hopes that that
will be enough to let us close this PR.


From: Paul Goyette <paul@whooppee.com>
To: Perry Metzger <perry@piermont.com>, gnats-bugs@netbsd.org
Cc: 
Subject: Re: kern/33952
Date: Sun, 21 Feb 2010 20:26:06 -0800 (PST)

 Perry,

 Now that we have man pages for dk(4) and dkctl(8) (and even one for 
 dkscan_bsdlabel(8)) can we close out your PR?



 -------------------------------------------------------------------------
 |   Paul Goyette   | PGP DSS Key fingerprint: |  E-mail addresses:      |
 | Customer Service | FA29 0E3B 35AF E8AE 6651 |  paul at whooppee.com   |
 | Network Engineer | 0786 F758 55DE 53BA 7731 | pgoyette at juniper.net |
 | Kernel Developer |                          | pgoyette at netbsd.org  |
 -------------------------------------------------------------------------

From: "Perry E. Metzger" <perry@piermont.com>
To: paul@whooppee.com
Cc: gnats-bugs@netbsd.org
Subject: Re: kern/33952
Date: Mon, 22 Feb 2010 13:52:36 -0500

 Paul Goyette <paul@whooppee.com> writes:
 > Now that we have man pages for dk(4) and dkctl(8) (and even one for
 > dkscan_bsdlabel(8)) can we close out your PR?

 I'd say it looks that way. I haven't read everything closely, but if you
 feel that people can now learn about wedges well enough from the docs,
 feel free to close it.

 Perry
 -- 
 Perry E. Metzger		perry@piermont.com

Responsible-Changed-From-To: kern-bug-people->pgoyette
Responsible-Changed-By: pgoyette@NetBSD.org
Responsible-Changed-When: Mon, 22 Feb 2010 19:00:59 +0000
Responsible-Changed-Why:
I followed up on it.


State-Changed-From-To: feedback->closed
State-Changed-By: pgoyette@NetBSD.org
State-Changed-When: Mon, 22 Feb 2010 19:00:59 +0000
State-Changed-Why:
Originator agreed to close based on dk(4) and dkctl(8) man pages.


From: Paul Goyette <paul@whooppee.com>
To: "Perry E. Metzger" <perry@piermont.com>
Cc: gnats-bugs@netbsd.org
Subject: Re: kern/33952
Date: Mon, 22 Feb 2010 10:59:28 -0800 (PST)

 Thanks!

 On Mon, 22 Feb 2010, Perry E. Metzger wrote:

 >
 > Paul Goyette <paul@whooppee.com> writes:
 >> Now that we have man pages for dk(4) and dkctl(8) (and even one for
 >> dkscan_bsdlabel(8)) can we close out your PR?
 >
 > I'd say it looks that way. I haven't read everything closely, but if you
 > feel that people can now learn about wedges well enough from the docs,
 > feel free to close it.
 >
 > Perry
 > -- 
 > Perry E. Metzger		perry@piermont.com
 >

 -------------------------------------------------------------------------
 |   Paul Goyette   | PGP DSS Key fingerprint: |  E-mail addresses:      |
 | Customer Service | FA29 0E3B 35AF E8AE 6651 |  paul at whooppee.com   |
 | Network Engineer | 0786 F758 55DE 53BA 7731 | pgoyette at juniper.net |
 | Kernel Developer |                          | pgoyette at netbsd.org  |
 -------------------------------------------------------------------------

From: David Holland <dholland-bugs@netbsd.org>
To: gnats-bugs@NetBSD.org
Cc: perry@piermont.com, paul@whooppee.com
Subject: Re: kern/33952
Date: Sun, 28 Feb 2010 22:21:20 +0000

 On Mon, Feb 22, 2010 at 06:55:01PM +0000, Perry E. Metzger wrote:
  > Paul Goyette <paul@whooppee.com> writes:
  >> Now that we have man pages for dk(4) and dkctl(8) (and even one for
  >> dkscan_bsdlabel(8)) can we close out your PR?
  >  
  > I'd say it looks that way. I haven't read everything closely, but if you
  > feel that people can now learn about wedges well enough from the docs,
  > feel free to close it.

 I'm not sure. It would be nice to have some introductory information
 in dk(4) that, you know, says what a wedge is and describes a little
 bit about disk partitioning. All the docs tell you right now is that
 there are these things called wedges and they might have something to
 do with partition tables; it doesn't say what behavior to expect or
 how to use wedges effectively.

 My inclination would not have been to close this; in fact, I think
 maybe it should be reopened. Anyone else have an opinion?

 -- 
 David A. Holland
 dholland@netbsd.org

Responsible-Changed-From-To: pgoyette->kern-bug-people
Responsible-Changed-By: pgoyette@NetBSD.org
Responsible-Changed-When: Mon, 01 Mar 2010 00:50:34 +0000
Responsible-Changed-Why:
Reopen and reassign to category owner


State-Changed-From-To: closed->open
State-Changed-By: pgoyette@NetBSD.org
State-Changed-When: Mon, 01 Mar 2010 00:50:34 +0000
State-Changed-Why:
Not everyone concurs that current documentation is adequate.


>Unformatted:

Home	PR Database Search