Linux Kernel Tester’s Guide v0.3-rc1
Hi,
We are pleased to announce the availability of "Linux Kernel Tester's Guide" v0.3-rc1.
This short guide describes the basics of kernel testing. The handbook is divided into six chapters:
1 The kernel, patches, trees and compilation
1.1 The kernel
1.2 Patches
1.3 Ketchup
1.4 Trees
1.5 The -mm tree
1.6 Compilation and installation
1.6.1 Kernel compilation
1.6.2 Useful make options
1.6.3 Kernel modules
1.6.4 Kernel hacking options
1.6.5 Magic SysRq
1.6.6 Installation
1.6.7 Automated configuration and installation
2 Testing
2.1 Phase One
2.2 Phase Two (AutoTest)
2.3 Phase Three
2.4 Measuring performance
2.5 Hello world! or What exactly are we looking for? 2.6 Binary drivers and distribution kernels
3 Collecting kernel messages
3.1 Syslog, console and dmesg
3.2 Serial console
3.3 Network console
4 Git, quilt and binary searching
4.1 Git 4.2 Quilt 4.3 General idea of binary searching 4.4 Binary searching with the help of quilt 4.5 Binary searching with the help of git-bisect 4.6 Caveats
5 Reporting bugs
6 Testing of hardware
A Related topics
A.1 Test system
A.2 KLive
A.3 Sending patches
A.4 How to become the kernel developer?
B License
PDF version
http://www.stardust.webpages.pl/files/handbook/handbook-en-0.3-rc1.pdf
LaTeX source
http://www.stardust.webpages.pl/files/handbook/handbook-current.tar.bz2
Any comments, suggestions and patches are welcome.
Huge thanks goes to Rafael J. Wysocki who translated the entire guide into English. This is one of those rare cases when translation is better than original version :).
Regards,
Michal
Signature · 2 lines
LOG http://www.stardust.webpages.pl/log/
Hello, Michal, Rafael!
Good work!
Some (minor) comments below.
Quoted 8 lines · Michal Piotrowski
Hi,
We are pleased to announce the availability of "Linux Kernel Tester's Guide" v0.3-rc1.
This short guide describes the basics of kernel testing. The handbook is divided into six chapters:
1 The kernel, patches, trees and compilation
1.1 The kernel
I would prefer to use a -rc in the examples and not one of the stable 2.6.x.y kernels.
Quoted 2 lines
1.2 Patches
1.3 Ketchup
I would prefer using git in the examples. There is no such thing as "apt-get" in generic linux.
Quoted 1 line
Any comments, suggestions and patches are welcome.
There is just too less time to test the kernel much in detail. It would be fine to have the whole book as ./test-my-system-now-but-dont-ask-me.sh ;-)
Good luck,
Signature · 10 lines
Clemens Koller __________________________________ R&D Imaging Devices Anagramm GmbH Rupert-Mayer-Straße 45/1 Linhof Werksgelände D-81379 München Tel.089-741518-50 Fax 089-741518-19 http://www.anagramm-technology.com
Hi Clemens,
Quoted 3 lines · Clemens Koller
Hello, Michal, Rafael!
Good work!
Thanks :)
Quoted 20 lines
Some (minor) comments below.
Quoted 10 lines · Michal Piotrowski
Hi,
We are pleased to announce the availability of "Linux Kernel Tester's Guide" v0.3-rc1.
This short guide describes the basics of kernel testing. The handbook is divided into six chapters:
1 The kernel, patches, trees and compilation
1.1 The kernelI would prefer to use a -rc in the examples and not one of the stable 2.6.x.y kernels.
Quoted 2 lines
1.2 Patches
1.3 Ketchup
Quoted 8 lines
I would prefer using git in the examples. There is no such thing as "apt-get" in generic linux.
Quoted 1 line
Any comments, suggestions and patches are welcome.
There is just too less time to test the kernel much in detail. It would be fine to have the whole book as ./test-my-system-now-but-dont-ask-me.sh ;-)
How about "bin/autotest samples/all_tests"?
Regards,
Michal
Signature · 2 lines
LOG http://www.stardust.webpages.pl/log/
Quoted 3 lines · Michal Piotrowski
1 The kernel, patches, trees and compilation
1.1 The kernel
Please do not advocate old-style tar option syntax.
Quoted 7 lines
1.2 Patches
1.3 Ketchup
1.4 Trees
1.5 The -mm tree
1.6 Compilation and installation
1.6.1 Kernel compilation
1.6.2 Useful make options
make O=/katalog seems out of place.
Quoted 7 lines
1.6.3 Kernel modules
1.6.4 Kernel hacking options
1.6.5 Magic SysRq
1.6.6 Installation
1.6.7 Automated configuration and installation
2 Testing
2.1 Phase One
Quoted 8 lines
2.2 Phase Two (AutoTest)
2.3 Phase Three
2.4 Measuring performance
2.5 Hello world! or What exactly are we looking for? 2.6 Binary drivers and distribution kernels 3 Collecting kernel messages
3.1 Syslog, console and dmesg
3.2 Serial console
Or set up minicom first... minicom -s ttyS0 (and then go to Serial port setup)
Quoted 2 lines
PDF version
http://www.stardust.webpages.pl/files/handbook/handbook-en-0.3-rc1.pdf
No HTML version?
Quoted 11 lines
LaTeX source
http://www.stardust.webpages.pl/files/handbook/handbook-current.tar.bz2Any comments, suggestions and patches are welcome.
Huge thanks goes to Rafael J. Wysocki who translated the entire guide into English.
This is one of those rare cases when translation is better than original version :).
Jan
Hi Balbir,
Quoted 2 lines · Balbir Singh
Wonderful! Are there any plans to start using the fault injection framework to catch more defects?
There are plans for the second part called "debugging techniques", but I really don't know when I'll start writing this.
In fact I don't even know if it will be useful for testers. IMHO it is for developers not for testers.
Regards,
Michal
Signature · 2 lines
LOG http://www.stardust.webpages.pl/log/
Quoted 7 lines · Michal Piotrowski
Hi Balbir,
Quoted 3 lines · Balbir Singh
Wonderful! Are there any plans to start using the fault injection framework
to catch more defects?
Quoted 9 lines
There are plans for the second part called "debugging techniques", but I really don't know when I'll start writing this.
In fact I don't even know if it will be useful for testers. IMHO it is for developers not for testers.
Regards,
Michal
I thought so too, but being able to randomly fail allocations on a system might expose the system error handling and recovery capabilities.
It'll also be interesting to see if testing is catching bugs, that tools (such as sparse) could have caught.
Signature · 4 lines
Warm Regards, Balbir Singh Linux Technology Center IBM, ISTL
Hello, Michal!
Quoted 5 lines · Michal Piotrowski
Quoted 3 lines
There is just too less time to test the kernel much in detail. It would be fine to have the whole book as ./test-my-system-now-but-dont-ask-me.sh ;-)
How about "bin/autotest
samples/all_tests"?
Ah, I really should read all of it:
There is "Chapter 2.2 Phase Two (AutoTest)".
I will give it a try...
Thanks,
Signature · 10 lines
Clemens Koller __________________________________ R&D Imaging Devices Anagramm GmbH Rupert-Mayer-Straße 45/1 Linhof Werksgelände D-81379 München Tel.089-741518-50 Fax 089-741518-19 http://www.anagramm-technology.com
Re: [ANNOUNCE] Linux Kernel Tester???s Guide v0.3-rc1
In reply to Jan EngelhardtQuoted 2 lines · Jan Engelhardt
<On Jun 18 2007 22:11, Michal Piotrowski wrote:
...
Quoted 4 lines
Quoted 2 lines
PDF version
http://www.stardust.webpages.pl/files/handbook/handbook-en-0.3-rc1.pdfNo HTML version?
I see I'm not the last of a kind... Or? So:
No txt version?
Quoted 4 lines
Quoted 4 lines
Any comments, suggestions and patches are welcome.
Huge thanks goes to Rafael J. Wysocki who translated the entire guide into English.
I join you in this thanking! (Sorry for delay.)
Quoted 2 lines
Quoted 2 lines
This is one of those rare cases when translation is better than original version :).
It's probably mainly because my contribution (i.e. some comas) is untranslatable!
Cheers,
Jarek P.
Re: [ANNOUNCE] Linux Kernel Tester???s Guide v0.3-rc1
On Fri, Jun 22, 2007 at 10:30:04AM +0200, Jarek Poplawski wrote:
...
Quoted 2 lines
It's probably mainly because my contribution (i.e. some comas) is untranslatable!
After full awakening I've recalled there were a few very nice commas as well!
Jarek P.
Quoted 4 lines · Michal Piotrowski
Hi,
We are pleased to announce the availability of "Linux Kernel Tester's Guide" v0.3-rc1.
It would be cool if we can get a clickable table of contents. Normally it's enough to include \usepackage{hyperref} before running pdflatex.
Eike