Update Crashpad to 32981a3ee9d7c2769fb27afa038fe2e194cfa329

third_party/crashpad/crashpad/snapshot/system_snapshot.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 18 matching lines @@
 //!     other characteristics.
 class SystemSnapshot {
  public:
   virtual ~SystemSnapshot() {}
 
   //! \brief A system’s operating system family.
   enum OperatingSystem {
     //! \brief The snapshot system’s operating system is unknown.
     kOperatingSystemUnknown = 0,
 
-    //! \brief Mac OS X.
+    //! \brief macOS.
     kOperatingSystemMacOSX,
 
     //! \brief Windows.
     kOperatingSystemWindows,
   };
 
   //! \brief A system’s daylight saving time status.
   //!
   //! The daylight saving time status is taken partially from the system’s
   //! locale configuration. This determines whether daylight saving time is
@@ skipping 47 matching lines @@
   //! \brief Returns the vendor of the snapshot system’s CPUs.
   //!
   //! For x86-family CPUs (including x86_64 and 32-bit x86), this is the CPU
   //! vendor identification string as encoded in `cpuid 0` `ebx`, `edx`, and
   //! `ecx`.
   //!
   //! \return A string identifying the vendor of the snapshot system’s CPUs.
   virtual std::string CPUVendor() const = 0;
 
   //! \brief Returns frequency information about the snapshot system’s CPUs in
-  //!     \current_hz and \a max_hz.
+  //!     \a current_hz and \a max_hz.
   //!
   //! \param[out] current_hz The snapshot system’s CPU clock frequency in Hz at
   //!     the time of the snapshot.
   //! \param[out] max_hz The snapshot system’s maximum possible CPU clock
   //!     frequency.
   virtual void CPUFrequency(uint64_t* current_hz, uint64_t* max_hz) const = 0;
 
   //! \brief Returns an x86-family snapshot system’s CPU signature.
   //!
   //! This is the family, model, and stepping ID values as encoded in `cpuid 1`
@@ skipping 73 matching lines @@
   virtual OperatingSystem GetOperatingSystem() const = 0;
 
   //! \brief Returns whether the snapshot system runs a server variant of its
   //!     operating system.
   virtual bool OSServer() const = 0;
 
   //! \brief Returns the snapshot system’s operating system version information
   //!     in \a major, \a minor, \a bugfix, and \a build.
   //!
   //! \param[out] major The snapshot system’s operating system’s first (major)
-  //!     version number component. This would be `10` for Mac OS X 10.9.5, and
+  //!     version number component. This would be `10` for macOS 10.12.1, and
   //!     `6` for Windows 7 (NT 6.1) SP1 version 6.1.7601.
   //! \param[out] minor The snapshot system’s operating system’s second (minor)
-  //!     version number component. This would be `9` for Mac OS X 10.9.5, and
+  //!     version number component. This would be `12` for macOS 10.12.1, and
   //!     `1` for Windows 7 (NT 6.1) SP1 version 6.1.7601.
   //! \param[out] bugfix The snapshot system’s operating system’s third (bugfix)
-  //!     version number component. This would be `5` for Mac OS X 10.9.5, and
+  //!     version number component. This would be `1` for macOS 10.12.1, and
   //!     `7601` for Windows 7 (NT 6.1) SP1 version 6.1.7601.
   //! \param[out] build A string further identifying an operating system
-  //!     version. For Mac OS X 10.9.5, this would be `"13F34"`. For Windows,
+  //!     version. For macOS 10.12.1, this would be `"16B2657"`. For Windows,
   //!     this would be `"Service Pack 1"` if that service pack was installed.
-  //!     For Linux and other Unix-like systems, this would be the kernel
-  //!     version from `uname -srvm`, possibly with additional information
-  //!     appended. On Android, the `ro.build.fingerprint` system property would
-  //!     be appended.
+  //!     On Android, the `ro.build.fingerprint` system property would be
+  //!     appended. For Linux and other Unix-like systems, this would be the
+  //!     kernel version from `uname -srvm`, possibly with additional
+  //!     information appended.
   virtual void OSVersion(int* major,
                          int* minor,
                          int* bugfix,
                          std::string* build) const = 0;
 
   //! \brief Returns the snapshot system’s full operating system version
   //!     information in string format.
   //!
-  //! For Mac OS X, the string contains values from the operating system and
-  //! kernel. A Mac OS X 10.9.5 snapshot system would be identified as `"Mac OS
-  //! X 10.9.5 (13F34); Darwin 13.4.0 Darwin Kernel Version 13.4.0: Sun Aug 17
-  //! 19:50:11 PDT 2014; root:xnu-2422.115.4~1/RELEASE_X86_64 x86_64"`.
+  //! For macOS, the string contains values from the operating system and
+  //! kernel. A macOS 10.12.1 system snapshot would be identified as `"Mac OS
+  //! X 10.12.1 (16B2657); Darwin 16.1.0 Darwin Kernel Version 16.1.0: Wed Oct
+  //! 19 20:31:56 PDT 2016; root:xnu-3789.21.4~4/RELEASE_X86_64 x86_64"`.
   virtual std::string OSVersionFull() const = 0;
 
   //! \brief Returns a description of the snapshot system’s hardware in string
   //!     format.
   //!
-  //! For Mac OS X, the string contains the Mac model and board ID. A mid-2014
-  //! 15" MacBook Pro would be identified as `"MacBookPro11,3
+  //! For macOS, the string contains the Mac model and board ID. A mid-2014 15"
+  //! MacBook Pro would be identified as `"MacBookPro11,3
   //! (Mac-2BD1B31983FE1663)"`.
   virtual std::string MachineDescription() const = 0;
 
   //! \brief Returns the status of the NX (no-execute, or XD, execute-disable)
   //!     feature on the snapshot system.
   //!
   //! This refers to a feature that allows mapped readable pages to be marked
   //! as non-executable.
   //!
   //! \return `true` if the snapshot system supports NX and it is enabled.
   virtual bool NXEnabled() const = 0;
 
   //! \brief Returns time zone information from the snapshot system, based on
   //!     its locale configuration and real-time clock.
   //!
   //! \param[out] dst_status Whether the location observes daylight saving time,
   //!     and if so, whether it or standard time is currently being observed.
   //! \param[out] standard_offset_seconds The number of seconds that the
   //!     location’s time zone is east (ahead) of UTC during standard time.
   //! \param[out] daylight_offset_seconds The number of seconds that the
   //!     location’s time zone is east (ahead) of UTC during daylight saving.
   //!     time.
   //! \param[out] standard_name The name of the time zone while standard time is
   //!     being observed.
   //! \param[out] daylight_name The name of the time zone while daylight saving
   //!     time is being observed.
-  virtual void TimeZone(DaylightSavingTimeStatus* observes_daylight,
+  virtual void TimeZone(DaylightSavingTimeStatus* dst_status,
                         int* standard_offset_seconds,
                         int* daylight_offset_seconds,
                         std::string* standard_name,
                         std::string* daylight_name) const = 0;
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_SNAPSHOT_SYSTEM_SNAPSHOT_H_