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, |
(...skipping 27 matching lines...) Expand all Loading... |
38 //! \a x86_float_state32, and \a x86_debug_state32 will be honored. | 38 //! \a x86_float_state32, and \a x86_debug_state32 will be honored. |
39 //! | 39 //! |
40 //! If \a flavor, \a state, and \a state_count are provided but do not contain | 40 //! If \a flavor, \a state, and \a state_count are provided but do not contain |
41 //! valid values, a message will be logged and their values will be ignored as | 41 //! valid values, a message will be logged and their values will be ignored as |
42 //! though \a flavor were specified as `THREAD_STATE_NONE`. | 42 //! though \a flavor were specified as `THREAD_STATE_NONE`. |
43 //! | 43 //! |
44 //! \param[out] context The CPUContextX86 structure to initialize. | 44 //! \param[out] context The CPUContextX86 structure to initialize. |
45 //! \param[in] flavor The native thread state flavor of \a state. This may be | 45 //! \param[in] flavor The native thread state flavor of \a state. This may be |
46 //! `x86_THREAD_STATE32`, `x86_FLOAT_STATE32`, `x86_DEBUG_STATE32`, | 46 //! `x86_THREAD_STATE32`, `x86_FLOAT_STATE32`, `x86_DEBUG_STATE32`, |
47 //! `x86_THREAD_STATE`, `x86_FLOAT_STATE`, or `x86_DEBUG_STATE`. It may also | 47 //! `x86_THREAD_STATE`, `x86_FLOAT_STATE`, or `x86_DEBUG_STATE`. It may also |
48 //! be `THREAD_STATE_NONE` if \a state is not supplied (and is `NULL`). | 48 //! be `THREAD_STATE_NONE` if \a state is not supplied (and is `nullptr`). |
49 //! \param[in] state The native thread state, which may be a casted pointer to | 49 //! \param[in] state The native thread state, which may be a casted pointer to |
50 //! `x86_thread_state32_t`, `x86_float_state32_t`, `x86_debug_state32_t`, | 50 //! `x86_thread_state32_t`, `x86_float_state32_t`, `x86_debug_state32_t`, |
51 //! `x86_thread_state`, `x86_float_state`, or `x86_debug_state`. This | 51 //! `x86_thread_state`, `x86_float_state`, or `x86_debug_state`. This |
52 //! parameter may be `NULL` to not supply this data, in which case \a flavor | 52 //! parameter may be `nullptr` to not supply this data, in which case \a |
53 //! must be `THREAD_STATE_NONE`. If a “universal” structure is used, it must | 53 //! flavor must be `THREAD_STATE_NONE`. If a “universal” structure is used, |
54 //! carry 32-bit state data of the correct type. | 54 //! it must carry 32-bit state data of the correct type. |
55 //! \param[in] state_count The number of `natural_t`-sized (`int`-sized) units | 55 //! \param[in] state_count The number of `natural_t`-sized (`int`-sized) units |
56 //! in \a state. This may be 0 if \a state is `NULL`. | 56 //! in \a state. This may be 0 if \a state is `nullptr`. |
57 //! \param[in] x86_thread_state32 The state of the thread’s integer registers. | 57 //! \param[in] x86_thread_state32 The state of the thread’s integer registers. |
58 //! \param[in] x86_float_state32 The state of the thread’s floating-point | 58 //! \param[in] x86_float_state32 The state of the thread’s floating-point |
59 //! registers. | 59 //! registers. |
60 //! \param[in] x86_debug_state32 The state of the thread’s debug registers. | 60 //! \param[in] x86_debug_state32 The state of the thread’s debug registers. |
61 void InitializeCPUContextX86(CPUContextX86* context, | 61 void InitializeCPUContextX86(CPUContextX86* context, |
62 thread_state_flavor_t flavor, | 62 thread_state_flavor_t flavor, |
63 const natural_t* state, | 63 const natural_t* state, |
64 mach_msg_type_number_t state_count, | 64 mach_msg_type_number_t state_count, |
65 const x86_thread_state32_t* x86_thread_state32, | 65 const x86_thread_state32_t* x86_thread_state32, |
66 const x86_float_state32_t* x86_float_state32, | 66 const x86_float_state32_t* x86_float_state32, |
(...skipping 12 matching lines...) Expand all Loading... |
79 //! \a x86_float_state64, and \a x86_debug_state64 will be honored. | 79 //! \a x86_float_state64, and \a x86_debug_state64 will be honored. |
80 //! | 80 //! |
81 //! If \a flavor, \a state, and \a state_count are provided but do not contain | 81 //! If \a flavor, \a state, and \a state_count are provided but do not contain |
82 //! valid values, a message will be logged and their values will be ignored as | 82 //! valid values, a message will be logged and their values will be ignored as |
83 //! though \a flavor were specified as `THREAD_STATE_NONE`. | 83 //! though \a flavor were specified as `THREAD_STATE_NONE`. |
84 //! | 84 //! |
85 //! \param[out] context The CPUContextX86_64 structure to initialize. | 85 //! \param[out] context The CPUContextX86_64 structure to initialize. |
86 //! \param[in] flavor The native thread state flavor of \a state. This may be | 86 //! \param[in] flavor The native thread state flavor of \a state. This may be |
87 //! `x86_THREAD_STATE64`, `x86_FLOAT_STATE64`, `x86_DEBUG_STATE64`, | 87 //! `x86_THREAD_STATE64`, `x86_FLOAT_STATE64`, `x86_DEBUG_STATE64`, |
88 //! `x86_THREAD_STATE`, `x86_FLOAT_STATE`, or `x86_DEBUG_STATE`. It may also | 88 //! `x86_THREAD_STATE`, `x86_FLOAT_STATE`, or `x86_DEBUG_STATE`. It may also |
89 //! be `THREAD_STATE_NONE` if \a state is not supplied (and is `NULL`). | 89 //! be `THREAD_STATE_NONE` if \a state is not supplied (and is `nullptr`). |
90 //! \param[in] state The native thread state, which may be a casted pointer to | 90 //! \param[in] state The native thread state, which may be a casted pointer to |
91 //! `x86_thread_state64_t`, `x86_float_state64_t`, `x86_debug_state64_t`, | 91 //! `x86_thread_state64_t`, `x86_float_state64_t`, `x86_debug_state64_t`, |
92 //! `x86_thread_state`, `x86_float_state`, or `x86_debug_state`. This | 92 //! `x86_thread_state`, `x86_float_state`, or `x86_debug_state`. This |
93 //! parameter may be `NULL` to not supply this data, in which case \a flavor | 93 //! parameter may be `nullptr` to not supply this data, in which case \a |
94 //! must be `THREAD_STATE_NONE`. If a “universal” structure is used, it must | 94 //! flavor must be `THREAD_STATE_NONE`. If a “universal” structure is used, |
95 //! carry 64-bit state data of the correct type. | 95 //! it must carry 64-bit state data of the correct type. |
96 //! \param[in] state_count The number of `int`-sized units in \a state. This may | 96 //! \param[in] state_count The number of `int`-sized units in \a state. This may |
97 //! be 0 if \a state is `NULL`. | 97 //! be 0 if \a state is `nullptr`. |
98 //! \param[in] x86_thread_state64 The state of the thread’s integer registers. | 98 //! \param[in] x86_thread_state64 The state of the thread’s integer registers. |
99 //! \param[in] x86_float_state64 The state of the thread’s floating-point | 99 //! \param[in] x86_float_state64 The state of the thread’s floating-point |
100 //! registers. | 100 //! registers. |
101 //! \param[in] x86_debug_state64 The state of the thread’s debug registers. | 101 //! \param[in] x86_debug_state64 The state of the thread’s debug registers. |
102 void InitializeCPUContextX86_64(CPUContextX86_64* context, | 102 void InitializeCPUContextX86_64(CPUContextX86_64* context, |
103 thread_state_flavor_t flavor, | 103 thread_state_flavor_t flavor, |
104 const natural_t* state, | 104 const natural_t* state, |
105 mach_msg_type_number_t state_count, | 105 mach_msg_type_number_t state_count, |
106 const x86_thread_state64_t* x86_thread_state64, | 106 const x86_thread_state64_t* x86_thread_state64, |
107 const x86_float_state64_t* x86_float_state64, | 107 const x86_float_state64_t* x86_float_state64, |
108 const x86_debug_state64_t* x86_debug_state64); | 108 const x86_debug_state64_t* x86_debug_state64); |
109 | 109 |
110 #endif | 110 #endif |
111 | 111 |
112 } // namespace internal | 112 } // namespace internal |
113 } // namespace crashpad | 113 } // namespace crashpad |
114 | 114 |
115 #endif // CRASHPAD_SNAPSHOT_SNAPSHOT_CPU_CONTEXT_MAC_H_ | 115 #endif // CRASHPAD_SNAPSHOT_SNAPSHOT_CPU_CONTEXT_MAC_H_ |
OLD | NEW |