| 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 |