mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-25 18:30:06 +00:00
![Rusty Russell](/assets/img/avatar_default.png)
The netfilter code had very good documentation: the Netfilter Hacking HOWTO. Noone ever read it. So this time I'm trying something different, using a bit of Knuthiness. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
47 lines
1.7 KiB
Text
47 lines
1.7 KiB
Text
Welcome, friend reader, to lguest.
|
|
|
|
Lguest is an adventure, with you, the reader, as Hero. I can't think of many
|
|
5000-line projects which offer both such capability and glimpses of future
|
|
potential; it is an exciting time to be delving into the source!
|
|
|
|
But be warned; this is an arduous journey of several hours or more! And as we
|
|
know, all true Heroes are driven by a Noble Goal. Thus I offer a Beer (or
|
|
equivalent) to anyone I meet who has completed this documentation.
|
|
|
|
So get comfortable and keep your wits about you (both quick and humorous).
|
|
Along your way to the Noble Goal, you will also gain masterly insight into
|
|
lguest, and hypervisors and x86 virtualization in general.
|
|
|
|
Our Quest is in seven parts: (best read with C highlighting turned on)
|
|
|
|
I) Preparation
|
|
- In which our potential hero is flown quickly over the landscape for a
|
|
taste of its scope. Suitable for the armchair coders and other such
|
|
persons of faint constitution.
|
|
|
|
II) Guest
|
|
- Where we encounter the first tantalising wisps of code, and come to
|
|
understand the details of the life of a Guest kernel.
|
|
|
|
III) Drivers
|
|
- Whereby the Guest finds its voice and become useful, and our
|
|
understanding of the Guest is completed.
|
|
|
|
IV) Launcher
|
|
- Where we trace back to the creation of the Guest, and thus begin our
|
|
understanding of the Host.
|
|
|
|
V) Host
|
|
- Where we master the Host code, through a long and tortuous journey.
|
|
Indeed, it is here that our hero is tested in the Bit of Despair.
|
|
|
|
VI) Switcher
|
|
- Where our understanding of the intertwined nature of Guests and Hosts
|
|
is completed.
|
|
|
|
VII) Mastery
|
|
- Where our fully fledged hero grapples with the Great Question:
|
|
"What next?"
|
|
|
|
make Preparation!
|
|
Rusty Russell.
|