fs: use kmem_cache_zalloc instead
[pv_ops_mirror.git] / Documentation / i386 / zero-page.txt
blob6c0817c45683fd07f6367c8234d419a4e824ee48
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 ----------------------------------------------------------------------------
11 Summary of boot_params layout (kernel point of view)
12      ( collected by Hans Lermen and Martin Mares )
14 The contents of boot_params are used to pass parameters from the
15 16-bit realmode code of the kernel to the 32-bit part. References/settings
16 to it mainly are in:
18   arch/i386/boot/setup.S
19   arch/i386/boot/video.S
20   arch/i386/kernel/head.S
21   arch/i386/kernel/setup.c
24 Offset  Type            Description
25 ------  ----            -----------
26     0   32 bytes        struct screen_info, SCREEN_INFO
27                         ATTENTION, overlaps the following !!!
28     2   unsigned short  EXT_MEM_K, extended memory size in Kb (from int 0x15)
29  0x20   unsigned short  CL_MAGIC, commandline magic number (=0xA33F)
30  0x22   unsigned short  CL_OFFSET, commandline offset
31                         Address of commandline is calculated:
32                           0x90000 + contents of CL_OFFSET
33                         (only taken, when CL_MAGIC = 0xA33F)
34  0x40   20 bytes        struct apm_bios_info, APM_BIOS_INFO
35  0x60   16 bytes        Intel SpeedStep (IST) BIOS support information
36  0x80   16 bytes        hd0-disk-parameter from intvector 0x41
37  0x90   16 bytes        hd1-disk-parameter from intvector 0x46
39  0xa0   16 bytes        System description table truncated to 16 bytes.
40                         ( struct sys_desc_table_struct )
41  0xb0 - 0x13f           Free. Add more parameters here if you really need them.
42  0x140- 0x1be           EDID_INFO Video mode setup
44 0x1c4   unsigned long   EFI system table pointer
45 0x1c8   unsigned long   EFI memory descriptor size
46 0x1cc   unsigned long   EFI memory descriptor version
47 0x1d0   unsigned long   EFI memory descriptor map pointer
48 0x1d4   unsigned long   EFI memory descriptor map size
49 0x1e0   unsigned long   ALT_MEM_K, alternative mem check, in Kb
50 0x1e4   unsigned long   Scratch field for the kernel setup code
51 0x1e8   char            number of entries in E820MAP (below)
52 0x1e9   unsigned char   number of entries in EDDBUF (below)
53 0x1ea   unsigned char   number of entries in EDD_MBR_SIG_BUFFER (below)
54 0x1f1   char            size of setup.S, number of sectors
55 0x1f2   unsigned short  MOUNT_ROOT_RDONLY (if !=0)
56 0x1f4   unsigned short  size of compressed kernel-part in the
57                         (b)zImage-file (in 16 byte units, rounded up)
58 0x1f6   unsigned short  swap_dev (unused AFAIK)
59 0x1f8   unsigned short  RAMDISK_FLAGS
60 0x1fa   unsigned short  VGA-Mode (old one)
61 0x1fc   unsigned short  ORIG_ROOT_DEV (high=Major, low=minor)
62 0x1ff   char            AUX_DEVICE_INFO
64 0x200   short jump to start of setup code aka "reserved" field.
65 0x202   4 bytes         Signature for SETUP-header, ="HdrS"
66 0x206   unsigned short  Version number of header format
67                         Current version is 0x0201...
68 0x208   8 bytes         (used by setup.S for communication with boot loaders,
69                          look there)
70 0x210   char            LOADER_TYPE, = 0, old one
71                         else it is set by the loader:
72                         0xTV: T=0 for LILO
73                                 1 for Loadlin
74                                 2 for bootsect-loader
75                                 3 for SYSLINUX
76                                 4 for ETHERBOOT
77                                 5 for ELILO
78                                 7 for GRuB
79                                 8 for U-BOOT
80                                 9 for Xen
81                                 V = version
82 0x211   char            loadflags:
83                         bit0 = 1: kernel is loaded high (bzImage)
84                         bit7 = 1: Heap and pointer (see below) set by boot
85                                   loader.
86 0x212   unsigned short  (setup.S)
87 0x214   unsigned long   KERNEL_START, where the loader started the kernel
88 0x218   unsigned long   INITRD_START, address of loaded ramdisk image
89 0x21c   unsigned long   INITRD_SIZE, size in bytes of ramdisk image
90 0x220   4 bytes         (setup.S)
91 0x224   unsigned short  setup.S heap end pointer
92 0x226   unsigned short  zero_pad
93 0x228   unsigned long   cmd_line_ptr
94 0x22c   unsigned long   ramdisk_max
95 0x230   16 bytes        trampoline
96 0x290 - 0x2cf           EDD_MBR_SIG_BUFFER (edd.S)
97 0x2d0 - 0xd00           E820MAP
98 0xd00 - 0xeff           EDDBUF (edd.S) for disk signature read sector
99 0xd00 - 0xeeb           EDDBUF (edd.S) for edd data