base/mac/call_with_eh_frame.h

   1 // Copyright 2015 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef BASE_MAC_CALL_WITH_EH_FRAME_H_
   6 #define BASE_MAC_CALL_WITH_EH_FRAME_H_
   7
   8 #include "base/base_export.h"
   9
  10 namespace base {
  11 namespace mac {
  12
  13 // Invokes the specified block in a stack frame with a special exception
  14 // handler. This function creates an exception handling stack frame that
  15 // specifies a custom C++ exception personality routine, which terminates the
  16 // search for an exception handler at this frame.
  17 //
  18 // The purpose of this function is to prevent a try/catch statement in system
  19 // libraries, acting as a global exception handler, from handling exceptions
  20 // in such a way that disrupts the generation of useful stack traces.
  21 void BASE_EXPORT CallWithEHFrame(void (^block)(void));
  22
  23 }  // namespace mac
  24 }  // namespace base
  25
  26 #endif  // BASE_MAC_CALL_WITH_EH_FRAME_H_