public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
* White Paper on the Linux kernel VM?
@ 2002-01-24  3:36 info
  2002-01-24  6:54 ` David Beckett
                   ` (2 more replies)
  0 siblings, 3 replies; 12+ messages in thread
From: info @ 2002-01-24  3:36 UTC (permalink / raw)
  To: linux-kernel

I am interested in reviewing the technical specifications on the Linux kernel VM.
As there has been much controversy of late on this subject, it would be relevant to compare the concepts behind both the former VM and the new VM in order to obtain a better understanding of the issues. 
Is there a “white paper” available on both the old and the new VM’s? 
Understandably, the VM is a work in progress; however, there should be a basic set of design goals and concepts from which future development will proceed.  It would definitely be helpful to present them both as an aid to further analysis.

Sincerely,
D. L. Beaman


   -- D. L. Beaman -- 
  Software development 
     Global Digicom 
----------------------------
 info@global-digicom.com



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24  3:36 White Paper on the Linux kernel VM? info
@ 2002-01-24  6:54 ` David Beckett
  2002-01-24 12:05 ` Rik van Riel
  2002-01-24 16:06 ` Denis Vlasenko
  2 siblings, 0 replies; 12+ messages in thread
From: David Beckett @ 2002-01-24  6:54 UTC (permalink / raw)
  To: linux-kernel

I found this: http://www.nks.net/linux-vm.html
I hope it helps. 
Sincerly,
David Beckett

__________________________________________________
Do You Yahoo!?
Great stuff seeking new owners in Yahoo! Auctions! 
http://auctions.yahoo.com

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24  3:36 White Paper on the Linux kernel VM? info
  2002-01-24  6:54 ` David Beckett
@ 2002-01-24 12:05 ` Rik van Riel
  2002-01-24 12:59   ` Dave Jones
  2002-01-24 16:06 ` Denis Vlasenko
  2 siblings, 1 reply; 12+ messages in thread
From: Rik van Riel @ 2002-01-24 12:05 UTC (permalink / raw)
  To: info; +Cc: linux-kernel

On 23 Jan 2002 info@global-digicom.com wrote:

> I am interested in reviewing the technical specifications on the Linux
> kernel VM. As there has been much controversy of late on this subject,
> it would be relevant to compare the concepts behind both the former VM
> and the new VM in order to obtain a better understanding of the
> issues.  Is there a “white paper” available on both the old and the
> new VM’s?  Understandably, the VM is a work in progress; however,
> there should be a basic set of design goals and concepts from which
> future development will proceed.  It would definitely be helpful to
> present them both as an aid to further analysis.

I made a paper about the old VM in the 2.4 kernels, with some
overview of its shortcomings and what needs to be fixed.

This paper was made for last year's USENIX in Boston, you can
get it from my home page:

	http://surriel.com/lectures/

regards,

Rik
-- 
"Linux holds advantages over the single-vendor commercial OS"
    -- Microsoft's "Competing with Linux" document

http://www.surriel.com/		http://distro.conectiva.com/


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 16:06 ` Denis Vlasenko
@ 2002-01-24 12:21   ` Rik van Riel
  2002-01-24 15:06   ` Olaf Dietsche
  2002-01-24 18:21   ` Daniel Phillips
  2 siblings, 0 replies; 12+ messages in thread
From: Rik van Riel @ 2002-01-24 12:21 UTC (permalink / raw)
  To: Denis Vlasenko; +Cc: info, linux-kernel

On Thu, 24 Jan 2002, Denis Vlasenko wrote:
> On 24 January 2002 01:36, info@global-digicom.com wrote:
> > I am interested in reviewing the technical specifications on the Linux
> > kernel VM. As there has been much controversy of late on this subject, it

> It was said that code is sufficient, you can read it and ask questions
> on lkml if you will find difficult to swallow parts. You may spot some
> bugs also, that will be very good! Linux kernel needs peer review!

I don't agree with this.  If you don't have documentation, you
only know what the code does, not what it's supposed to do.

This means not only does it become harder to understand things,
it also becomes much harder to verify that the code is doing
the right thing.

> Writing docs wastes developer's time: they will write how they want VM to
> operate or how they think it operates (while some bug can make actual VM
> operate differently) instead of improving/debugging current VM code.

On the contrary.  I have found that updating the documentation
of a function before fixing the code helps to keep me focussed
on letting this function do the exact right thing.

Working the other way around often leads to the "wait a moment,
shouldn't I catch this special case ??" thing and at times to
spagetti code.

Writing the documentation first makes it easier to realise that
some functionality doesn't belong in a function and needs to be
abstracted out, which I'm doing at a nice rate in the -rmap VM.

> Yes, it is not an easy path to VM doc. :-)

Just download the -rmap patch and start reading.
It's not _that_ hard ;)

cheers,

Rik
-- 
"Linux holds advantages over the single-vendor commercial OS"
    -- Microsoft's "Competing with Linux" document

http://www.surriel.com/		http://distro.conectiva.com/


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 12:05 ` Rik van Riel
@ 2002-01-24 12:59   ` Dave Jones
  0 siblings, 0 replies; 12+ messages in thread
From: Dave Jones @ 2002-01-24 12:59 UTC (permalink / raw)
  To: Rik van Riel; +Cc: info, linux-kernel

On Thu, Jan 24, 2002 at 10:05:43AM -0200, Rik van Riel wrote:
 
 > I made a paper about the old VM in the 2.4 kernels, with some
 > overview of its shortcomings and what needs to be fixed.

 And probably the closest thing to documentation for
 the newer 2.4 VM is in some slides from Andrea..
 ftp://ftp.suse.com/pub/people/andrea/talks/2001/pluto-dec-pub-0.tar.gz

 Some bits may have changed a little since those slides were done,
 (especially in -aa VM) but for the most part they make interesting
 reading.

-- 
| Dave Jones.        http://www.codemonkey.org.uk
| SuSE Labs

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 16:06 ` Denis Vlasenko
  2002-01-24 12:21   ` Rik van Riel
@ 2002-01-24 15:06   ` Olaf Dietsche
  2002-01-24 15:13     ` Rik van Riel
  2002-01-24 18:21   ` Daniel Phillips
  2 siblings, 1 reply; 12+ messages in thread
From: Olaf Dietsche @ 2002-01-24 15:06 UTC (permalink / raw)
  To: vda; +Cc: linux-kernel

Denis Vlasenko <vda@port.imtp.ilyichevsk.odessa.ua> writes:

> Writing docs wastes developer's time: they will write how they want VM to 
> operate or how they think it operates (while some bug can make actual VM 
> operate differently) instead of improving/debugging current VM code.

I don't want to judge, wether writing docs wastes developer's
time. But, when I first tried understanding file systems, it was of
tremendous help having docs like Documentation/filesystems/vfs.txt and
the like. I couldn't have done it without.

> After you got to understand how Linux VM works from source, feel free to 
> write docs.

When you're that far, you are a developer and it will waste your time
writing docs ;-).

Regards, Olaf.

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 15:06   ` Olaf Dietsche
@ 2002-01-24 15:13     ` Rik van Riel
  2002-01-24 16:40       ` Richard Gooch
  2002-01-24 21:54       ` Mika Liljeberg
  0 siblings, 2 replies; 12+ messages in thread
From: Rik van Riel @ 2002-01-24 15:13 UTC (permalink / raw)
  To: Olaf Dietsche; +Cc: vda, linux-kernel

On 24 Jan 2002, Olaf Dietsche wrote:
> Denis Vlasenko <vda@port.imtp.ilyichevsk.odessa.ua> writes:
>
> > Writing docs wastes developer's time: they will write how they want VM to
> > operate or how they think it operates (while some bug can make actual VM
> > operate differently) instead of improving/debugging current VM code.
>
> I don't want to judge, wether writing docs wastes developer's
> time.

Not writing docs wastes other developers' time.

Rik
-- 
"Linux holds advantages over the single-vendor commercial OS"
    -- Microsoft's "Competing with Linux" document

http://www.surriel.com/		http://distro.conectiva.com/


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24  3:36 White Paper on the Linux kernel VM? info
  2002-01-24  6:54 ` David Beckett
  2002-01-24 12:05 ` Rik van Riel
@ 2002-01-24 16:06 ` Denis Vlasenko
  2002-01-24 12:21   ` Rik van Riel
                     ` (2 more replies)
  2 siblings, 3 replies; 12+ messages in thread
From: Denis Vlasenko @ 2002-01-24 16:06 UTC (permalink / raw)
  To: info; +Cc: linux-kernel

On 24 January 2002 01:36, info@global-digicom.com wrote:
> I am interested in reviewing the technical specifications on the Linux
> kernel VM. As there has been much controversy of late on this subject, it
> would be relevant to compare the concepts behind both the former VM and the
> new VM in order to obtain a better understanding of the issues. Is there a
> ⌠white paper■ available on both the old and the new VM▓s? Understandably,
> the VM is a work in progress; however, there should be a basic set of
> design goals and concepts from which future development will proceed.  It
> would definitely be helpful to present them both as an aid to further
> analysis.

It was said that code is sufficient, you can read it and ask questions on 
lkml if you will find difficult to swallow parts. You may spot some bugs 
also, that will be very good! Linux kernel needs peer review!

Writing docs wastes developer's time: they will write how they want VM to 
operate or how they think it operates (while some bug can make actual VM 
operate differently) instead of improving/debugging current VM code.

After you got to understand how Linux VM works from source, feel free to 
write docs.

Yes, it is not an easy path to VM doc. :-)
I must say I did not do it (yet?).
--
vda

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 15:13     ` Rik van Riel
@ 2002-01-24 16:40       ` Richard Gooch
  2002-01-24 21:54       ` Mika Liljeberg
  1 sibling, 0 replies; 12+ messages in thread
From: Richard Gooch @ 2002-01-24 16:40 UTC (permalink / raw)
  To: Rik van Riel; +Cc: Olaf Dietsche, vda, linux-kernel

Rik van Riel writes:
> On 24 Jan 2002, Olaf Dietsche wrote:
> > Denis Vlasenko <vda@port.imtp.ilyichevsk.odessa.ua> writes:
> >
> > > Writing docs wastes developer's time: they will write how they want VM to
> > > operate or how they think it operates (while some bug can make actual VM
> > > operate differently) instead of improving/debugging current VM code.
> >
> > I don't want to judge, wether writing docs wastes developer's
> > time.
> 
> Not writing docs wastes other developers' time.

Aka. being selfish and lazy.

				Regards,

					Richard....
Permanent: rgooch@atnf.csiro.au
Current:   rgooch@ras.ucalgary.ca

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 16:06 ` Denis Vlasenko
  2002-01-24 12:21   ` Rik van Riel
  2002-01-24 15:06   ` Olaf Dietsche
@ 2002-01-24 18:21   ` Daniel Phillips
  2 siblings, 0 replies; 12+ messages in thread
From: Daniel Phillips @ 2002-01-24 18:21 UTC (permalink / raw)
  To: vda, info; +Cc: linux-kernel

On January 24, 2002 05:06 pm, Denis Vlasenko wrote:
> Writing docs wastes developer's time: they will write how they want VM to 
> operate or how they think it operates (while some bug can make actual VM 
> operate differently) instead of improving/debugging current VM code.

No you're wrong.  Not writing docs wastes the time of other developers.  It 
sends the message 'my time is more important than yours'.  In the case of 
Linus, that may be true, but it's very definitely not true for any other core 
developer.

It is the responsibility of each developer to prepare at least minimal - but 
sufficient - documentation for the work they do.  Others who specialize in 
preparing documentation can then use that material as a starting point for 
preparing clearer, more extensive documentation.  But if core developers shirk 
their responsibility in this area, we will continue to suffer from a chronic 
shortage of good, current kernel documentation.

--
Daniel


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 15:13     ` Rik van Riel
  2002-01-24 16:40       ` Richard Gooch
@ 2002-01-24 21:54       ` Mika Liljeberg
  2002-01-25 16:51         ` Mika Liljeberg
  1 sibling, 1 reply; 12+ messages in thread
From: Mika Liljeberg @ 2002-01-24 21:54 UTC (permalink / raw)
  To: Rik van Riel; +Cc: Olaf Dietsche, vda, linux-kernel

> > I don't want to judge, wether writing docs wastes developer's
> > time.
> 
> Not writing docs wastes other developers' time.

Writing about not writing docs wastes everybody's time.

Please excuse my lack of restraint. :-)

	MikaL

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: White Paper on the Linux kernel VM?
  2002-01-24 21:54       ` Mika Liljeberg
@ 2002-01-25 16:51         ` Mika Liljeberg
  0 siblings, 0 replies; 12+ messages in thread
From: Mika Liljeberg @ 2002-01-25 16:51 UTC (permalink / raw)
  To: linux-kernel

> Writing about not writing docs wastes everybody's time.

For the record, I would love to see some proper documentation on the
current VM. While the code is indeed the ultimate reference, it does not
yield readily to peer review.

That said, I don't think much of the waterfall model. It tends to kill
the enthusiasm and slow projects down to a crawl. The thing is to write
the code, hone it until you're happy with it, and then document it. If
the code isn't ready to document, it's not ready for peer review. Prior
to that degree of readiness, too many brains plucking at the code just
slows things down. On the other hand, if you leave out the documentation
altogether you end up with developers arguing about who can't read whose
code, instead of doing something useful.

I seemed to touch the hearts of a surprising number of people with my
thoughtless little remark. No permanent heart ache, I hope. :)

	MikaL

^ permalink raw reply	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2002-01-25 16:52 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2002-01-24  3:36 White Paper on the Linux kernel VM? info
2002-01-24  6:54 ` David Beckett
2002-01-24 12:05 ` Rik van Riel
2002-01-24 12:59   ` Dave Jones
2002-01-24 16:06 ` Denis Vlasenko
2002-01-24 12:21   ` Rik van Riel
2002-01-24 15:06   ` Olaf Dietsche
2002-01-24 15:13     ` Rik van Riel
2002-01-24 16:40       ` Richard Gooch
2002-01-24 21:54       ` Mika Liljeberg
2002-01-25 16:51         ` Mika Liljeberg
2002-01-24 18:21   ` Daniel Phillips

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox