diff options
| author | Andi Kleen <ak@suse.de> | 2007-08-10 16:31:08 -0400 |
|---|---|---|
| committer | Linus Torvalds <torvalds@woody.linux-foundation.org> | 2007-08-11 18:58:14 -0400 |
| commit | 43fb2387d0774a36f450b50d538cee84cf83858e (patch) | |
| tree | 2a7c894bb93aac523cc2228b5249e659a7df3a9b /Documentation | |
| parent | d3f7eae182b04997be19343a23f7009170f4f7a5 (diff) | |
i386: Add warning in Documentation that zero-page is not a stable ABI
Some people writing boot loaders seem to falsely belief the 32bit zero page is a
stable interface for out of tree code like the real mode boot protocol. Add a comment
clarifying that is not true.
Signed-off-by: Andi Kleen <ak@suse.de>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/i386/zero-page.txt | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/Documentation/i386/zero-page.txt b/Documentation/i386/zero-page.txt index 75b3680c41eb..6c0817c45683 100644 --- a/Documentation/i386/zero-page.txt +++ b/Documentation/i386/zero-page.txt | |||
| @@ -1,3 +1,13 @@ | |||
| 1 | --------------------------------------------------------------------------- | ||
| 2 | !!!!!!!!!!!!!!!WARNING!!!!!!!! | ||
| 3 | The zero page is a kernel internal data structure, not a stable ABI. It might change | ||
| 4 | without warning and the kernel has no way to detect old version of it. | ||
| 5 | If you're writing some external code like a boot loader you should only use | ||
| 6 | the stable versioned real mode boot protocol described in boot.txt. Otherwise the kernel | ||
| 7 | might break you at any time. | ||
| 8 | !!!!!!!!!!!!!WARNING!!!!!!!!!!! | ||
| 9 | ---------------------------------------------------------------------------- | ||
| 10 | |||
| 1 | Summary of boot_params layout (kernel point of view) | 11 | Summary of boot_params layout (kernel point of view) |
| 2 | ( collected by Hans Lermen and Martin Mares ) | 12 | ( collected by Hans Lermen and Martin Mares ) |
| 3 | 13 | ||