Allow exception forwarding to the system’s native crash reporter to be disabled

snapshot/mac/mach_o_image_annotations_reader.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,
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
 #ifndef CRASHPAD_SNAPSHOT_MAC_MACH_O_IMAGE_ANNOTATIONS_READER_H_
 #define CRASHPAD_SNAPSHOT_MAC_MACH_O_IMAGE_ANNOTATIONS_READER_H_
 
 #include <map>
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
+#include "snapshot/mac/process_types.h"
 
 namespace crashpad {
 
 class MachOImageReader;
 class ProcessReader;
 
 //! \brief A reader for annotations stored in a Mach-O image mapped into another
 //!     process.
 //!
 //! These annotations are stored for the benefit of crash reporters, and provide
@@ skipping 26 matching lines @@
   ~MachOImageAnnotationsReader() {}
 
   //! \brief Returns the module’s annotations that are organized as a vector of
   //!     strings.
   std::vector<std::string> Vector() const;
 
   //! \brief Returns the module’s annotations that are organized as key-value
   //!     pairs, where all keys and values are strings.
   std::map<std::string, std::string> SimpleMap() const;
 
+  //! \brief Obtains the module’s CrashpadInfo structure.
+  //!
+  //! \return `true` on success, `false` on failure. If the module does not have
+  //!     a `__crashpad_info` section, this will return `false` without logging
+  //!     any messages. Other failures will result in messages being logged.
+  bool GetCrashpadInfo(process_types::CrashpadInfo* crashpad_info) const;
+
  private:
   // Reades crashreporter_annotations_t::message and
   // crashreporter_annotations_t::message2 on behalf of Vector().
   void ReadCrashReporterClientAnnotations(
       std::vector<std::string>* vector_annotations) const;
 
   // Reads dyld_error_string on behalf of Vector().
   void ReadDyldErrorStringAnnotation(
       std::vector<std::string>* vector_annotations) const;
 
   // Reads CrashpadInfo::simple_annotations_ on behalf of SimpleMap().
   void ReadCrashpadSimpleAnnotations(
       std::map<std::string, std::string>* simple_map_annotations) const;
 
   std::string name_;
   ProcessReader* process_reader_;  // weak
   const MachOImageReader* image_reader_;  // weak
 
   DISALLOW_COPY_AND_ASSIGN(MachOImageAnnotationsReader);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_SNAPSHOT_MAC_MACH_O_IMAGE_ANNOTATIONS_READER_H_