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 173 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
184 //! This method performs red zone calculation for CalculateStackRegion(). Its | 184 //! This method performs red zone calculation for CalculateStackRegion(). Its |
185 //! parameters are local variables used within that method, and may be | 185 //! parameters are local variables used within that method, and may be |
186 //! modified as needed. | 186 //! modified as needed. |
187 //! | 187 //! |
188 //! Where a red zone is required, the region of memory captured for a thread’s | 188 //! Where a red zone is required, the region of memory captured for a thread’s |
189 //! stack will be extended to include the red zone below the stack pointer, | 189 //! stack will be extended to include the red zone below the stack pointer, |
190 //! provided that such memory is mapped, readable, and has the correct user | 190 //! provided that such memory is mapped, readable, and has the correct user |
191 //! tag value. If these conditions cannot be met fully, as much of the red | 191 //! tag value. If these conditions cannot be met fully, as much of the red |
192 //! zone will be captured as is possible while meeting these conditions. | 192 //! zone will be captured as is possible while meeting these conditions. |
193 //! | 193 //! |
194 //! \param[inout] start_address The base address of the region to begin | 194 //! \param[in,out] start_address The base address of the region to begin |
195 //! capturing stack memory from. On entry, \a start_address is the stack | 195 //! capturing stack memory from. On entry, \a start_address is the stack |
196 //! pointer. On return, \a start_address may be decreased to encompass a | 196 //! pointer. On return, \a start_address may be decreased to encompass a |
197 //! red zone. | 197 //! red zone. |
198 //! \param[inout] region_base The base address of the region that contains | 198 //! \param[in,out] region_base The base address of the region that contains |
199 //! stack memory. This is distinct from \a start_address in that \a | 199 //! stack memory. This is distinct from \a start_address in that \a |
200 //! region_base will be page-aligned. On entry, \a region_base is the | 200 //! region_base will be page-aligned. On entry, \a region_base is the |
201 //! base address of a region that contains \a start_address. On return, | 201 //! base address of a region that contains \a start_address. On return, |
202 //! if \a start_address is decremented and is outside of the region | 202 //! if \a start_address is decremented and is outside of the region |
203 //! originally described by \a region_base, \a region_base will also be | 203 //! originally described by \a region_base, \a region_base will also be |
204 //! decremented appropriately. | 204 //! decremented appropriately. |
205 //! \param[inout] region_size The size of the region that contains stack | 205 //! \param[in,out] region_size The size of the region that contains stack |
206 //! memory. This region begins at \a region_base. On return, if \a | 206 //! memory. This region begins at \a region_base. On return, if \a |
207 //! region_base is decremented, \a region_size will be incremented | 207 //! region_base is decremented, \a region_size will be incremented |
208 //! appropriately. | 208 //! appropriately. |
209 //! \param[in] user_tag The Mach VM system’s user tag for the region described | 209 //! \param[in] user_tag The Mach VM system’s user tag for the region described |
210 //! by the initial values of \a region_base and \a region_size. The red | 210 //! by the initial values of \a region_base and \a region_size. The red |
211 //! zone will only be allowed to extend out of the region described by | 211 //! zone will only be allowed to extend out of the region described by |
212 //! these initial values if the user tag is appropriate for stack memory | 212 //! these initial values if the user tag is appropriate for stack memory |
213 //! and the expanded region has the same user tag value. | 213 //! and the expanded region has the same user tag value. |
214 void LocateRedZone(mach_vm_address_t* start_address, | 214 void LocateRedZone(mach_vm_address_t* start_address, |
215 mach_vm_address_t* region_base, | 215 mach_vm_address_t* region_base, |
(...skipping 15 matching lines...) Expand all Loading... |
231 | 231 |
232 bool initialized_threads_; | 232 bool initialized_threads_; |
233 bool initialized_modules_; | 233 bool initialized_modules_; |
234 | 234 |
235 DISALLOW_COPY_AND_ASSIGN(ProcessReader); | 235 DISALLOW_COPY_AND_ASSIGN(ProcessReader); |
236 }; | 236 }; |
237 | 237 |
238 } // namespace crashpad | 238 } // namespace crashpad |
239 | 239 |
240 #endif // CRASHPAD_SNAPSHOT_MAC_PROCESS_READER_H_ | 240 #endif // CRASHPAD_SNAPSHOT_MAC_PROCESS_READER_H_ |
OLD | NEW |