1 | /* Copyright (c) 2006, Google Inc. |
2 | * All rights reserved. |
3 | * |
4 | * Redistribution and use in source and binary forms, with or without |
5 | * modification, are permitted provided that the following conditions are |
6 | * met: |
7 | * |
8 | * * Redistributions of source code must retain the above copyright |
9 | * notice, this list of conditions and the following disclaimer. |
10 | * * Redistributions in binary form must reproduce the above |
11 | * copyright notice, this list of conditions and the following disclaimer |
12 | * in the documentation and/or other materials provided with the |
13 | * distribution. |
14 | * * Neither the name of Google Inc. nor the names of its |
15 | * contributors may be used to endorse or promote products derived from |
16 | * this software without specific prior written permission. |
17 | * |
18 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
19 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
20 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
21 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
22 | * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
23 | * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
24 | * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
25 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
26 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
27 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
28 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ |
29 | |
30 | /* minidump_format.h: A cross-platform reimplementation of minidump-related |
31 | * portions of DbgHelp.h from the Windows Platform SDK. |
32 | * |
33 | * (This is C99 source, please don't corrupt it with C++.) |
34 | * |
35 | * This file contains the necessary definitions to read minidump files |
36 | * produced on amd64. These files may be read on any platform provided |
37 | * that the alignments of these structures on the processing system are |
38 | * identical to the alignments of these structures on the producing system. |
39 | * For this reason, precise-sized types are used. The structures defined |
40 | * by this file have been laid out to minimize alignment problems by ensuring |
41 | * ensuring that all members are aligned on their natural boundaries. In |
42 | * In some cases, tail-padding may be significant when different ABIs specify |
43 | * different tail-padding behaviors. To avoid problems when reading or |
44 | * writing affected structures, MD_*_SIZE macros are provided where needed, |
45 | * containing the useful size of the structures without padding. |
46 | * |
47 | * Structures that are defined by Microsoft to contain a zero-length array |
48 | * are instead defined here to contain an array with one element, as |
49 | * zero-length arrays are forbidden by standard C and C++. In these cases, |
50 | * *_minsize constants are provided to be used in place of sizeof. For a |
51 | * cleaner interface to these sizes when using C++, see minidump_size.h. |
52 | * |
53 | * These structures are also sufficient to populate minidump files. |
54 | * |
55 | * These definitions may be extended to support handling minidump files |
56 | * for other CPUs and other operating systems. |
57 | * |
58 | * Because precise data type sizes are crucial for this implementation to |
59 | * function properly and portably in terms of interoperability with minidumps |
60 | * produced by DbgHelp on Windows, a set of primitive types with known sizes |
61 | * are used as the basis of each structure defined by this file. DbgHelp |
62 | * on Windows is assumed to be the reference implementation; this file |
63 | * seeks to provide a cross-platform compatible implementation. To avoid |
64 | * collisions with the types and values defined and used by DbgHelp in the |
65 | * event that this implementation is used on Windows, each type and value |
66 | * defined here is given a new name, beginning with "MD". Names of the |
67 | * equivalent types and values in the Windows Platform SDK are given in |
68 | * comments. |
69 | * |
70 | * Author: Mark Mentovai |
71 | * Change to split into its own file: Neal Sidhwaney */ |
72 | |
73 | #ifndef GOOGLE_BREAKPAD_COMMON_MINIDUMP_CPU_AMD64_H__ |
74 | #define GOOGLE_BREAKPAD_COMMON_MINIDUMP_CPU_AMD64_H__ |
75 | |
76 | |
77 | /* |
78 | * AMD64 support, see WINNT.H |
79 | */ |
80 | |
81 | typedef struct { |
82 | uint16_t control_word; |
83 | uint16_t status_word; |
84 | uint8_t tag_word; |
85 | uint8_t reserved1; |
86 | uint16_t error_opcode; |
87 | uint32_t error_offset; |
88 | uint16_t error_selector; |
89 | uint16_t reserved2; |
90 | uint32_t data_offset; |
91 | uint16_t data_selector; |
92 | uint16_t reserved3; |
93 | uint32_t mx_csr; |
94 | uint32_t mx_csr_mask; |
95 | uint128_struct float_registers[8]; |
96 | uint128_struct xmm_registers[16]; |
97 | uint8_t reserved4[96]; |
98 | } MDXmmSaveArea32AMD64; /* XMM_SAVE_AREA32 */ |
99 | |
100 | #define MD_CONTEXT_AMD64_VR_COUNT 26 |
101 | |
102 | typedef struct { |
103 | /* |
104 | * Register parameter home addresses. |
105 | */ |
106 | uint64_t p1_home; |
107 | uint64_t p2_home; |
108 | uint64_t p3_home; |
109 | uint64_t p4_home; |
110 | uint64_t p5_home; |
111 | uint64_t p6_home; |
112 | |
113 | /* The next field determines the layout of the structure, and which parts |
114 | * of it are populated */ |
115 | uint32_t context_flags; |
116 | uint32_t mx_csr; |
117 | |
118 | /* The next register is included with MD_CONTEXT_AMD64_CONTROL */ |
119 | uint16_t cs; |
120 | |
121 | /* The next 4 registers are included with MD_CONTEXT_AMD64_SEGMENTS */ |
122 | uint16_t ds; |
123 | uint16_t es; |
124 | uint16_t fs; |
125 | uint16_t gs; |
126 | |
127 | /* The next 2 registers are included with MD_CONTEXT_AMD64_CONTROL */ |
128 | uint16_t ss; |
129 | uint32_t eflags; |
130 | |
131 | /* The next 6 registers are included with MD_CONTEXT_AMD64_DEBUG_REGISTERS */ |
132 | uint64_t dr0; |
133 | uint64_t dr1; |
134 | uint64_t dr2; |
135 | uint64_t dr3; |
136 | uint64_t dr6; |
137 | uint64_t dr7; |
138 | |
139 | /* The next 4 registers are included with MD_CONTEXT_AMD64_INTEGER */ |
140 | uint64_t rax; |
141 | uint64_t rcx; |
142 | uint64_t rdx; |
143 | uint64_t rbx; |
144 | |
145 | /* The next register is included with MD_CONTEXT_AMD64_CONTROL */ |
146 | uint64_t rsp; |
147 | |
148 | /* The next 11 registers are included with MD_CONTEXT_AMD64_INTEGER */ |
149 | uint64_t rbp; |
150 | uint64_t rsi; |
151 | uint64_t rdi; |
152 | uint64_t r8; |
153 | uint64_t r9; |
154 | uint64_t r10; |
155 | uint64_t r11; |
156 | uint64_t r12; |
157 | uint64_t r13; |
158 | uint64_t r14; |
159 | uint64_t r15; |
160 | |
161 | /* The next register is included with MD_CONTEXT_AMD64_CONTROL */ |
162 | uint64_t rip; |
163 | |
164 | /* The next set of registers are included with |
165 | * MD_CONTEXT_AMD64_FLOATING_POINT |
166 | */ |
167 | union { |
168 | MDXmmSaveArea32AMD64 flt_save; |
169 | struct { |
170 | uint128_struct [2]; |
171 | uint128_struct legacy[8]; |
172 | uint128_struct xmm0; |
173 | uint128_struct xmm1; |
174 | uint128_struct xmm2; |
175 | uint128_struct xmm3; |
176 | uint128_struct xmm4; |
177 | uint128_struct xmm5; |
178 | uint128_struct xmm6; |
179 | uint128_struct xmm7; |
180 | uint128_struct xmm8; |
181 | uint128_struct xmm9; |
182 | uint128_struct xmm10; |
183 | uint128_struct xmm11; |
184 | uint128_struct xmm12; |
185 | uint128_struct xmm13; |
186 | uint128_struct xmm14; |
187 | uint128_struct xmm15; |
188 | } sse_registers; |
189 | }; |
190 | |
191 | uint128_struct vector_register[MD_CONTEXT_AMD64_VR_COUNT]; |
192 | uint64_t vector_control; |
193 | |
194 | /* The next 5 registers are included with MD_CONTEXT_AMD64_DEBUG_REGISTERS */ |
195 | uint64_t debug_control; |
196 | uint64_t last_branch_to_rip; |
197 | uint64_t last_branch_from_rip; |
198 | uint64_t last_exception_to_rip; |
199 | uint64_t last_exception_from_rip; |
200 | |
201 | } MDRawContextAMD64; /* CONTEXT */ |
202 | |
203 | /* For (MDRawContextAMD64).context_flags. These values indicate the type of |
204 | * context stored in the structure. The high 24 bits identify the CPU, the |
205 | * low 8 bits identify the type of context saved. */ |
206 | #define MD_CONTEXT_AMD64 0x00100000 /* CONTEXT_AMD64 */ |
207 | #define MD_CONTEXT_AMD64_CONTROL (MD_CONTEXT_AMD64 | 0x00000001) |
208 | /* CONTEXT_CONTROL */ |
209 | #define MD_CONTEXT_AMD64_INTEGER (MD_CONTEXT_AMD64 | 0x00000002) |
210 | /* CONTEXT_INTEGER */ |
211 | #define MD_CONTEXT_AMD64_SEGMENTS (MD_CONTEXT_AMD64 | 0x00000004) |
212 | /* CONTEXT_SEGMENTS */ |
213 | #define MD_CONTEXT_AMD64_FLOATING_POINT (MD_CONTEXT_AMD64 | 0x00000008) |
214 | /* CONTEXT_FLOATING_POINT */ |
215 | #define MD_CONTEXT_AMD64_DEBUG_REGISTERS (MD_CONTEXT_AMD64 | 0x00000010) |
216 | /* CONTEXT_DEBUG_REGISTERS */ |
217 | #define MD_CONTEXT_AMD64_XSTATE (MD_CONTEXT_AMD64 | 0x00000040) |
218 | /* CONTEXT_XSTATE */ |
219 | |
220 | /* WinNT.h refers to CONTEXT_MMX_REGISTERS but doesn't appear to define it |
221 | * I think it really means CONTEXT_FLOATING_POINT. |
222 | */ |
223 | |
224 | #define MD_CONTEXT_AMD64_FULL (MD_CONTEXT_AMD64_CONTROL | \ |
225 | MD_CONTEXT_AMD64_INTEGER | \ |
226 | MD_CONTEXT_AMD64_FLOATING_POINT) |
227 | /* CONTEXT_FULL */ |
228 | |
229 | #define MD_CONTEXT_AMD64_ALL (MD_CONTEXT_AMD64_FULL | \ |
230 | MD_CONTEXT_AMD64_SEGMENTS | \ |
231 | MD_CONTEXT_X86_DEBUG_REGISTERS) |
232 | /* CONTEXT_ALL */ |
233 | |
234 | |
235 | #endif /* GOOGLE_BREAKPAD_COMMON_MINIDUMP_CPU_AMD64_H__ */ |
236 | |