Update Crashpad to 32981a3ee9d7c2769fb27afa038fe2e194cfa329

third_party/crashpad/crashpad/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 261 matching lines @@
   //! \brief The system’s operating system type, which distinguishes between
   //!     “desktop” or “workstation” systems and “server” systems. This may be a
   //!     \ref VER_NT_x "VER_NT_*" value, or a member of
   //!     crashpad::MinidumpOSType.
   uint8_t ProductType;
 
   //! \brief The system’s operating system version number’s first (major)
   //!     component.
   //!
   //!  - For Windows 7 (NT 6.1) SP1, version 6.1.7601, this would be `6`.
-  //!  - For Mac OS X 10.9.2, this would be `10`.
+  //!  - For macOS 10.12.1, this would be `10`.
   uint32_t MajorVersion;
 
   //! \brief The system’s operating system version number’s second (minor)
   //!     component.
   //!
   //!  - For Windows 7 (NT 6.1) SP1, version 6.1.7601, this would be `1`.
-  //!  - For Mac OS X 10.9.2, this would be `9`.
+  //!  - For macOS 10.12.1, this would be `12`.
   uint32_t MinorVersion;
 
   //! \brief The system’s operating system version number’s third (build or
   //!     patch) component.
   //!
   //!  - For Windows 7 (NT 6.1) SP1, version 6.1.7601, this would be `7601`.
-  //!  - For Mac OS X 10.9.2, this would be `2`.
+  //!  - For macOS 10.12.1, this would be `1`.
   uint32_t BuildNumber;
 
   //! \brief The system’s operating system family. This may be a \ref
   //!     VER_PLATFORM_x "VER_PLATFORM_*" value, or a member of
   //!     crashpad::MinidumpOS.
   uint32_t PlatformId;
 
   //! \brief ::RVA of a MINIDUMP_STRING containing operating system-specific
   //!     version information.
   //!
   //! This field further identifies an operating system version beyond its
   //! version number fields. Historically, “CSD” stands for “corrective service
   //! diskette.”
   //!
   //!  - On Windows, this is the name of the installed operating system service
   //!    pack, such as “Service Pack 1”. If no service pack is installed, this
   //!    field references an empty string.
-  //!  - On Mac OS X, this is the operating system build number from `sw_vers
-  //!    -buildVersion`. For Mac OS X 10.9.2 on most hardware types, this would
-  //!    be `13C64`.
+  //!  - On macOS, this is the operating system build number from `sw_vers
+  //!    -buildVersion`. For macOS 10.12.1 on most hardware types, this would
+  //!    be `16B2657`.
   //!  - On Linux and other Unix-like systems, this is the kernel version from
   //!    `uname -srvm`, possibly with additional information appended. On
   //!    Android, the `ro.build.fingerprint` system property is appended.
   RVA CSDVersionRva;
 
   //! \brief A bitfield identifying products installed on the system. This is
   //!     composed of \ref VER_SUITE_x "VER_SUITE_*" values.
   //!
   //! This field is Windows-specific, and has no meaning on other operating
   //! systems.
@@ skipping 83 matching lines @@
 
   //! \brief Structures identifying each thread within the process.
   MINIDUMP_THREAD Threads[0];
 };
 
 //! \brief Information about an exception that occurred in the process.
 struct __attribute__((packed, aligned(4))) MINIDUMP_EXCEPTION {
   //! \brief The top-level exception code identifying the exception, in
   //!     operating system-specific values.
   //!
-  //! For Mac OS X minidumps, this will be an \ref EXC_x "EXC_*" exception type,
+  //! For macOS minidumps, this will be an \ref EXC_x "EXC_*" exception type,
   //! such as `EXC_BAD_ACCESS`. `EXC_CRASH` will not appear here for exceptions
   //! processed as `EXC_CRASH` when generated from another preceding exception:
   //! the original exception code will appear instead. The exception type as it
   //! was received will appear at index 0 of #ExceptionInformation.
   //!
-  //! For Windows minidumps, this will be an \ref EXCEPTION_x "EXCEPTION_*"
-  //! exception type, such as `EXCEPTION_ACCESS_VIOLATION`.
+  //! For Windows minidumps, this will be an `EXCEPTION_*` exception type, such
+  //! as `EXCEPTION_ACCESS_VIOLATION`.
   //!
   //! \note This field is named ExceptionCode, but what is known as the
-  //!     “exception code” on Mac OS X/Mach is actually stored in the
+  //!     “exception code” on macOS/Mach is actually stored in the
   //!     #ExceptionFlags field of a minidump file.
   //!
   //! \todo Document the possible values by OS. There may be OS-specific enums
   //!     in minidump_extensions.h.
   uint32_t ExceptionCode;
 
   //! \brief Additional exception flags that further identify the exception, in
   //!     operating system-specific values.
   //!
-  //! For Mac OS X minidumps, this will be the value of the exception code at
-  //! index 0 as received by a Mach exception handler, except:
+  //! For macOS minidumps, this will be the value of the exception code at index
+  //! 0 as received by a Mach exception handler, except:
   //!  * For exception type `EXC_CRASH` generated from another preceding
   //!    exception, the original exception code will appear here, not the code
   //!    as received by the Mach exception handler.
   //!  * For exception types `EXC_RESOURCE` and `EXC_GUARD`, the high 32 bits of
   //!    the code received by the Mach exception handler will appear here.
   //!
-  //! In all cases for Mac OS X minidumps, the code as it was received by the
-  //! Mach exception handler will appear at index 1 of #ExceptionInformation.
+  //! In all cases for macOS minidumps, the code as it was received by the Mach
+  //! exception handler will appear at index 1 of #ExceptionInformation.
   //!
   //! For Windows minidumps, this will either be `0` if the exception is
   //! continuable, or `EXCEPTION_NONCONTINUABLE` to indicate a noncontinuable
   //! exception.
   //!
   //! \todo Document the possible values by OS. There may be OS-specific enums
   //!     in minidump_extensions.h.
   uint32_t ExceptionFlags;
 
   //! \brief An address, in the address space of the process that this minidump
   //!     file contains a snapshot of, of another MINIDUMP_EXCEPTION. This field
   //!     is used for nested exceptions.
   uint64_t ExceptionRecord;
 
   //! \brief The address that caused the exception.
   //!
   //! This may be the address that caused a fault on data access, or it may be
   //! the instruction pointer that contained an offending instruction.
   uint64_t ExceptionAddress;
 
   //! \brief The number of valid elements in #ExceptionInformation.
   uint32_t NumberParameters;
 
   uint32_t __unusedAlignment;
 
   //! \brief Additional information about the exception, specific to the
   //!     operating system and possibly the #ExceptionCode.
   //!
-  //! For Mac OS X minidumps, this will contain the exception type as received
-  //! by a Mach exception handler and the values of the `codes[0]` and
-  //! `codes[1]` (exception code and subcode) parameters supplied to the Mach
-  //! exception handler. Unlike #ExceptionCode and #ExceptionFlags, the values
-  //! received by a Mach exception handler are used directly here even for the
-  //! `EXC_CRASH`, `EXC_RESOURCE`, and `EXC_GUARD` exception types.
+  //! For macOS minidumps, this will contain the exception type as received by a
+  //! Mach exception handler and the values of the `codes[0]` and `codes[1]`
+  //! (exception code and subcode) parameters supplied to the Mach exception
+  //! handler. Unlike #ExceptionCode and #ExceptionFlags, the values received by
+  //! a Mach exception handler are used directly here even for the `EXC_CRASH`,
+  //! `EXC_RESOURCE`, and `EXC_GUARD` exception types.
 
   //! For Windows, these are additional arguments (if any) as provided to
   //! `RaiseException()`.
   uint64_t ExceptionInformation[EXCEPTION_MAXIMUM_PARAMETERS];
 };
 
 //! \brief Information about the exception that triggered a minidump file’s
 //!     generation.
 struct __attribute__((packed, aligned(4))) MINIDUMP_EXCEPTION_STREAM {
   //! \brief The ID of the thread that caused the exception.
@@ skipping 481 matching lines @@
 struct __attribute__((packed, aligned(4))) MINIDUMP_MEMORY_INFO {
   //! \brief The base address of the region of pages.
   uint64_t BaseAddress;
 
   //! \brief The base address of a range of pages in this region. The page is
   //!     contained within this memory region.
   uint64_t AllocationBase;
 
   //! \brief The memory protection when the region was initially allocated. This
   //!     member can be one of the memory protection options (such as
-  //!     \ref PAGE_x PAGE_EXECUTE, \ref PAGE_x PAGE_NOACCESS, etc.), along with
-  //!     \ref PAGE_x PAGE_GUARD or \ref PAGE_x PAGE_NOCACHE, as needed.
+  //!     \ref PAGE_x "PAGE_EXECUTE", \ref PAGE_x "PAGE_NOACCESS", etc.), along
+  //!     with \ref PAGE_x "PAGE_GUARD" or \ref PAGE_x "PAGE_NOCACHE", as
+  //!     needed.
   uint32_t AllocationProtect;
 
   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
-  //!     \ref MEM_x MEM_COMMIT, \ref MEM_x MEM_FREE, or \ref MEM_x MEM_RESERVE.
+  //!     \ref MEM_x "MEM_COMMIT", \ref MEM_x "MEM_FREE", or \ref MEM_x
+  //!     "MEM_RESERVE".
   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 \ref MEM_x
-  //!     MEM_IMAGE, \ref MEM_x MEM_MAPPED, or \ref MEM_x MEM_PRIVATE.
+  //!     "MEM_IMAGE", \ref MEM_x "MEM_MAPPED", or \ref MEM_x "MEM_PRIVATE".
   uint32_t Type;
 
   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;
@@ skipping 23 matching lines @@
   //!  - 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_