win: Write memory map info as MINIDUMP_MEMORY_INFO[_LIST]

compat/non_win/dbghelp.h

 // Copyright 2014 The Crashpad Authors. All rights reserved.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ skipping 149 matching lines @@
   //! \brief The stream type for MINIDUMP_MISC_INFO, MINIDUMP_MISC_INFO_2,
   //!     MINIDUMP_MISC_INFO_3, and MINIDUMP_MISC_INFO_4.
   //!
   //! More recent versions of this stream are supersets of earlier versions.
   //!
   //! The exact version of the stream that is present is implied by the stream’s
   //! size. Furthermore, this stream contains a field,
   //! MINIDUMP_MISC_INFO::Flags1, that indicates which data is present and
   //! valid.
   MiscInfoStream = 15,
+
+  //! \brief The stream type for MINIDUMP_MEMORY_INFO_LIST.
+  MemoryInfoListStream = 16,
 };
 
 //! \brief Information about the CPU (or CPUs) that ran the process that the
 //!     minidump file contains a snapshot of.
 //!
 //! This union only appears as MINIDUMP_SYSTEM_INFO::Cpu. Its interpretation is
 //! controlled by MINIDUMP_SYSTEM_INFO::ProcessorArchitecture.
 union __attribute__((packed, aligned(4))) CPU_INFORMATION {
   //! \brief Information about 32-bit x86 CPUs, or x86_64 CPUs when running
   //!     32-bit x86 processes.
@@ skipping 672 matching lines @@
   uint32_t AllocationProtect;
 
   //! \brief To align the next field.
   uint32_t __alignment1;
 
   //! \brief The size of the region beginning at the base address in which all
   //!     pages have identical attributes, in bytes.
   uint64_t RegionSize;
 
   //! \brief The state of the pages in the region. This can be one of
   //! `MEM_COMMIT`, `MEM_FREE`, or `MEM_RESERVE`.

[Mark Mentovai, 2015/10/12 14:34:46]

Since we have our own versions of these now, this should become the ugly

\ref MEM_x MEM_COMMIT, \ref MEM_x MEM_FREE, or \ref MEM_x MEM_RESERVE.

Similar in the comments for the Type field below and the AllocationProtect field
above.

[scottmg, 2015/10/13 19:51:29]

Done.

   uint32_t State;
 
   //! \brief The access protection of the pages in the region. This member is
   //!     one of the values listed for the #AllocationProtect member.
   uint32_t Protect;
 
   //! \brief The type of pages in the region. This can be one of `MEM_IMAGE`,
   //!     `MEM_MAPPED`, or `MEM_PRIVATE`.
   uint32_t Type;
 
   //! \brief To align the next MINIDUMP_MEMORY_INFO in an array.
   uint32_t __alignment2;
 };
 
+//! \brief Contains a list of memory regions.
+struct __attribute__((packed, aligned(4))) MINIDUMP_MEMORY_INFO_LIST {
+  //! \brief The size of the header data for the stream, in bytes. This is
+  //!     generally sizeof(MINIDUMP_MEMORY_INFO_LIST).
+  uint32_t SizeOfHeader;
+
+  //! \brief The size of each entry following the header, in bytes. This is
+  //!     generally sizeof(MINIDUMP_MEMORY_INFO).
+  uint32_t SizeOfEntry;
+
+  //! \brief The number of entries in the stream. These are generally
+  //!     MINIDUMP_MEMORY_INFO structures. The entries follow the header.
+  uint64_t NumberOfEntries;
+};
+
 //! \brief Minidump file type values for MINIDUMP_HEADER::Flags. These bits
 //!     describe the types of data carried within a minidump file.
 enum MINIDUMP_TYPE {
   //! \brief A minidump file without any additional data.
   //!
   //! This type of minidump file contains:
   //!  - A MINIDUMP_SYSTEM_INFO stream.
   //!  - A MINIDUMP_MISC_INFO, MINIDUMP_MISC_INFO_2, MINIDUMP_MISC_INFO_3, or
   //!    MINIDUMP_MISC_INFO_4 stream, depending on which fields are present.
   //!  - A MINIDUMP_THREAD_LIST stream. All threads are present, along with a
   //!    snapshot of each thread’s stack memory sufficient to obtain backtraces.
   //!  - If the minidump file was generated as a result of an exception, a
   //!    MINIDUMP_EXCEPTION_STREAM describing the exception.
   //!  - A MINIDUMP_MODULE_LIST stream. All loaded modules are present.
   //!  - Typically, a MINIDUMP_MEMORY_LIST stream containing duplicate pointers
   //!    to the stack memory regions also referenced by the MINIDUMP_THREAD_LIST
   //!    stream. This type of minidump file also includes a
   //!    MINIDUMP_MEMORY_DESCRIPTOR containing the 256 bytes centered around
   //!    the exception address or the instruction pointer.
   MiniDumpNormal = 0x00000000,
 };
 
 #endif  // CRASHPAD_COMPAT_NON_WIN_DBGHELP_H_