Skip to content

Commit

Permalink
i386: Add warning in Documentation that zero-page is not a stable ABI
Browse files Browse the repository at this point in the history
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>
  • Loading branch information
Andi Kleen authored and Linus Torvalds committed Aug 11, 2007
1 parent d3f7eae commit 43fb238
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions Documentation/i386/zero-page.txt
Original file line number Diff line number Diff line change
@@ -1,3 +1,13 @@
---------------------------------------------------------------------------
!!!!!!!!!!!!!!!WARNING!!!!!!!!
The zero page is a kernel internal data structure, not a stable ABI. It might change
without warning and the kernel has no way to detect old version of it.
If you're writing some external code like a boot loader you should only use
the stable versioned real mode boot protocol described in boot.txt. Otherwise the kernel
might break you at any time.
!!!!!!!!!!!!!WARNING!!!!!!!!!!!
----------------------------------------------------------------------------

Summary of boot_params layout (kernel point of view)
( collected by Hans Lermen and Martin Mares )

Expand Down

0 comments on commit 43fb238

Please sign in to comment.