| Index: util/mach/mach_extensions.h
|
| diff --git a/util/mach/mach_extensions.h b/util/mach/mach_extensions.h
|
| index d1e392ad7a55f90682f8bed1bc1618816eb7aa1a..4f2861bf6446e2be186e3c6bc31956e970aa1c3b 100644
|
| --- a/util/mach/mach_extensions.h
|
| +++ b/util/mach/mach_extensions.h
|
| @@ -94,11 +94,27 @@ mach_port_t NewMachPort(mach_port_right_t right);
|
| //! recognize. Calling this function will return a value for `EXC_MASK_ALL`
|
| //! appropriate for the system at run time.
|
| //!
|
| -//! \note `EXC_MASK_ALL` does not include the value of `EXC_MASK_CRASH`.
|
| -//! Consumers that want `EXC_MASK_ALL` along with `EXC_MASK_CRASH` must use
|
| -//! ExcMaskAll() | `EXC_MASK_CRASH` explicitly.
|
| +//! \note `EXC_MASK_ALL` does not include the value of `EXC_MASK_CRASH` or
|
| +//! `EXC_MASK_CORPSE_NOTIFY`. Consumers that want `EXC_MASK_ALL` along with
|
| +//! `EXC_MASK_CRASH` may use ExcMaskAll() `| EXC_MASK_CRASH`. Consumers may
|
| +//! use ExcMaskValid() for `EXC_MASK_ALL` along with `EXC_MASK_CRASH`,
|
| +//! `EXC_MASK_CORPSE_NOTIFY`, and any values that come into existence in the
|
| +//! future.
|
| exception_mask_t ExcMaskAll();
|
|
|
| +//! \brief An exception mask containing every possible exception understood by
|
| +//! the operating system at run time.
|
| +//!
|
| +//! `EXC_MASK_ALL`, and thus ExcMaskAll(), never includes the value of
|
| +//! `EXC_MASK_CRASH` or `EXC_MASK_CORPSE_NOTIFY`. For situations where an
|
| +//! exception mask corresponding to every possible exception understood by the
|
| +//! running kernel is desired, use this function instead.
|
| +//!
|
| +//! Should new exception types be introduced in the future, this function will
|
| +//! be updated to include their bits in the returned mask value when run time
|
| +//! support is present.
|
| +exception_mask_t ExcMaskValid();
|
| +
|
| } // namespace crashpad
|
|
|
| #endif // CRASHPAD_UTIL_MACH_MACH_EXTENSIONS_H_
|
|
|