Source-Changes archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

Re: CVS commit: src/share/man/man9



On Thu, Oct 27, 2005 at 01:36:13PM +0900, YAMAMOTO Takashi wrote:
> > Module Name:        src
> > Committed By:       wrstuden
> > Date:               Thu Oct 27 00:05:03 UTC 2005
> > 
> > Modified Files:
> >     src/share/man/man9: buffercache.9
> > 
> > Log Message:
> > Adjust discussion of blkno's units to describe the units for
> > blkno for non-special files. Per comments from yamt at.
> 
> the "For other files," part is an internal detail of each filesystems.
> i don't think it's appropriate to document it here.

I disagree. The call is here, so we should say something. As best I can 
tell, we don't document it anywhere else, so we can't do cross-references. 

I agree each file system gets to make up its own mind, but that's why I
said, "File system blocks." My experience has been that each file system
gets to choose its own idea of what a block is (and they often all choose
differently), thus we have a kilometer of wiggle room in even this
definition.

As others may not realize "file system blocks" is such an overloaded term, 
I'll soften the text a bit more.

> there is no filesystem independent way to use bread() anyway.

I'm not saying there is. We however use bread() in a number of file 
systems, and for the most part we use it in similar ways. I think it's 
perfectly reasonable to document that similarity.

Take care,

Bill

Attachment: pgpUrdRVzSES7.pgp
Description: PGP signature



Home | Main Index | Thread Index | Old Index