# HG changeset patch
# User yamahata@xxxxxxxxxxxxx
# Date 1188385920 -32400
# Node ID ed74e810c3cc669fc236ffdc4eb6114d610f35c4
# Parent  6642cba9eb6631f40071cdb39f518ef4bf270387
update dump-core-foramt.txt documentation.
PATCHNAME: dump_core_documentation_update

Signed-off-by: Isaku Yamahata <yamahata@xxxxxxxxxxxxx>

diff -r 6642cba9eb66 -r ed74e810c3cc docs/misc/dump-core-format.txt
--- a/docs/misc/dump-core-format.txt	Wed Aug 29 19:43:22 2007 +0900
+++ b/docs/misc/dump-core-format.txt	Wed Aug 29 20:12:00 2007 +0900
@@ -80,7 +80,10 @@ Currently the following sections are def
                         gmfn:   machine physical frame number
                 The size of arrays is stored in xch_nr_pages member of header
                 note descriptor in .note.Xen note section.
-                The entryies are stored in pfn-ascending order.
+                The entries are stored in pfn-ascending order.
+                The value, {~(uint64_t)0, ~(uint64_t)0}, means invalid
+                (pfn, gmfn) and the corresponding page has zero. There might
+                exist invalid (pfn, gmfn)'s at the end part of this array.
                 This section must exist when the domain is non auto
                 translated physmap mode. Currently x86 paravirtualized domain.
 
@@ -94,6 +97,9 @@ Currently the following sections are def
                 The size of arrays is stored in xch_nr_pages member of header
                 note descriptor in .note.Xen note section.
                 The entries are stored in ascending order.
+                The value, ~(uint64_t)0, means invalid pfn and the
+                corresponding page has zero. There might exist invalid
+                pfn's at the end part of this array.
                 This section must exist when the domain is auto translated
                 physmap mode. Currently x86 full virtualized domain and
                 ia64 domain.
@@ -225,6 +231,8 @@ Currently only (major, minor) = (0, 1) i
 
 (0, 1) update
 - .xen_p2m, .xen_pfn section
+  Invalid pfn/gmfn.
+- .xen_p2m, .xen_pfn section
   Arrays must be in pfn ascending order for efficient looking up.
 - EI_CLASS member of elf header was changed to ELFCLASS64 independent of
   architecture. This is mainly for x86_32pae.