* 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 VMs?
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 VMs? 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 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 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 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 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 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
* 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
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