OLD | NEW |
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
12 // See the License for the specific language governing permissions and | 12 // See the License for the specific language governing permissions and |
13 // limitations under the License. | 13 // limitations under the License. |
14 | 14 |
15 #ifndef CRASHPAD_CLIENT_CAPTURE_CONTEXT_MAC_H_ | 15 #ifndef CRASHPAD_CLIENT_CAPTURE_CONTEXT_MAC_H_ |
16 #define CRASHPAD_CLIENT_CAPTURE_CONTEXT_MAC_H_ | 16 #define CRASHPAD_CLIENT_CAPTURE_CONTEXT_MAC_H_ |
17 | 17 |
18 #include <mach/mach.h> | 18 #include <mach/mach.h> |
19 | 19 |
20 #include "build/build_config.h" | 20 #include "build/build_config.h" |
21 | 21 |
22 namespace crashpad { | 22 namespace crashpad { |
23 | 23 |
24 #if defined(ARCH_CPU_X86_FAMILY) | 24 #if defined(ARCH_CPU_X86_FAMILY) |
25 typedef x86_thread_state NativeCPUContext; | 25 using NativeCPUContext = x86_thread_state; |
26 #endif | 26 #endif |
27 | 27 |
28 //! \brief Saves the CPU context. | 28 //! \brief Saves the CPU context. |
29 //! | 29 //! |
30 //! The CPU context will be captured as accurately and completely as possible, | 30 //! The CPU context will be captured as accurately and completely as possible, |
31 //! containing an atomic snapshot at the point of this function’s return. This | 31 //! containing an atomic snapshot at the point of this function’s return. This |
32 //! function does not modify any registers. | 32 //! function does not modify any registers. |
33 //! | 33 //! |
34 //! \param[out] cpu_context The structure to store the context in. | 34 //! \param[out] cpu_context The structure to store the context in. |
35 //! | 35 //! |
36 //! \note On x86_64, the value for `%%rdi` will be populated with the address of | 36 //! \note On x86_64, the value for `%%rdi` will be populated with the address of |
37 //! this function’s argument, as mandated by the ABI. If the value of | 37 //! this function’s argument, as mandated by the ABI. If the value of |
38 //! `%%rdi` prior to calling this function is needed, it must be obtained | 38 //! `%%rdi` prior to calling this function is needed, it must be obtained |
39 //! separately prior to calling this function. For example: | 39 //! separately prior to calling this function. For example: |
40 //! \code | 40 //! \code |
41 //! uint64_t rdi; | 41 //! uint64_t rdi; |
42 //! asm("movq %%rdi, %0" : "=m"(rdi)); | 42 //! asm("movq %%rdi, %0" : "=m"(rdi)); |
43 //! \endcode | 43 //! \endcode |
44 void CaptureContext(NativeCPUContext* cpu_context); | 44 void CaptureContext(NativeCPUContext* cpu_context); |
45 | 45 |
46 } // namespace crashpad | 46 } // namespace crashpad |
47 | 47 |
48 #endif // CRASHPAD_CLIENT_CAPTURE_CONTEXT_MAC_H_ | 48 #endif // CRASHPAD_CLIENT_CAPTURE_CONTEXT_MAC_H_ |
OLD | NEW |