/thirdparty/breakpad/google_breakpad/common/minidump_cpu_ppc.h

  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 ppc.  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/*
 74 * Breakpad minidump extension for PowerPC support.  Based on Darwin/Mac OS X'
 75 * mach/ppc/_types.h
 76 */
 77
 78#ifndef GOOGLE_BREAKPAD_COMMON_MINIDUMP_CPU_PPC_H__
 79#define GOOGLE_BREAKPAD_COMMON_MINIDUMP_CPU_PPC_H__
 80
 81#define MD_FLOATINGSAVEAREA_PPC_FPR_COUNT 32
 82
 83typedef struct {
 84  /* fpregs is a double[32] in mach/ppc/_types.h, but a u_int64_t is used
 85   * here for precise sizing. */
 86  u_int64_t fpregs[MD_FLOATINGSAVEAREA_PPC_FPR_COUNT];
 87  u_int32_t fpscr_pad;
 88  u_int32_t fpscr;      /* Status/control */
 89} MDFloatingSaveAreaPPC;  /* Based on ppc_float_state */
 90
 91
 92#define MD_VECTORSAVEAREA_PPC_VR_COUNT 32
 93
 94typedef struct {
 95  /* Vector registers (including vscr) are 128 bits, but mach/ppc/_types.h
 96   * exposes them as four 32-bit quantities. */
 97  u_int128_t save_vr[MD_VECTORSAVEAREA_PPC_VR_COUNT];
 98  u_int128_t save_vscr;  /* Status/control */
 99  u_int32_t  save_pad5[4];
100  u_int32_t  save_vrvalid;  /* Identifies which vector registers are saved */
101  u_int32_t  save_pad6[7];
102} MDVectorSaveAreaPPC;  /* ppc_vector_state */
103
104
105#define MD_CONTEXT_PPC_GPR_COUNT 32
106
107/* Use the same 32-bit alignment when accessing this structure from 64-bit code
108 * as is used natively in 32-bit code.  #pragma pack is a MSVC extension
109 * supported by gcc. */
110#if defined(__SUNPRO_C) || defined(__SUNPRO_CC)
111#pragma pack(4)
112#else
113#pragma pack(push, 4)
114#endif
115
116typedef struct {
117  /* context_flags is not present in ppc_thread_state, but it aids
118   * identification of MDRawContextPPC among other raw context types,
119   * and it guarantees alignment when we get to float_save. */
120  u_int32_t             context_flags;
121
122  u_int32_t             srr0;    /* Machine status save/restore: stores pc
123                                  * (instruction) */
124  u_int32_t             srr1;    /* Machine status save/restore: stores msr
125                                  * (ps, program/machine state) */
126  /* ppc_thread_state contains 32 fields, r0 .. r31.  Here, an array is
127   * used for brevity. */
128  u_int32_t             gpr[MD_CONTEXT_PPC_GPR_COUNT];
129  u_int32_t             cr;      /* Condition */
130  u_int32_t             xer;     /* Integer (fiXed-point) exception */
131  u_int32_t             lr;      /* Link */
132  u_int32_t             ctr;     /* Count */
133  u_int32_t             mq;      /* Multiply/Quotient (PPC 601, POWER only) */
134  u_int32_t             vrsave;  /* Vector save */
135
136  /* float_save and vector_save aren't present in ppc_thread_state, but
137   * are represented in separate structures that still define a thread's
138   * context. */
139  MDFloatingSaveAreaPPC float_save;
140  MDVectorSaveAreaPPC   vector_save;
141} MDRawContextPPC;  /* Based on ppc_thread_state */
142
143#if defined(__SUNPRO_C) || defined(__SUNPRO_CC)
144#pragma pack(0)
145#else
146#pragma pack(pop)
147#endif
148
149/* For (MDRawContextPPC).context_flags.  These values indicate the type of
150 * context stored in the structure.  MD_CONTEXT_PPC is Breakpad-defined.  Its
151 * value was chosen to avoid likely conflicts with MD_CONTEXT_* for other
152 * CPUs. */
153#define MD_CONTEXT_PPC                0x20000000
154#define MD_CONTEXT_PPC_BASE           (MD_CONTEXT_PPC | 0x00000001)
155#define MD_CONTEXT_PPC_FLOATING_POINT (MD_CONTEXT_PPC | 0x00000008)
156#define MD_CONTEXT_PPC_VECTOR         (MD_CONTEXT_PPC | 0x00000020)
157
158#define MD_CONTEXT_PPC_FULL           MD_CONTEXT_PPC_BASE
159#define MD_CONTEXT_PPC_ALL            (MD_CONTEXT_PPC_FULL | \
160                                       MD_CONTEXT_PPC_FLOATING_POINT | \
161                                       MD_CONTEXT_PPC_VECTOR)
162
163#endif /* GOOGLE_BREAKPAD_COMMON_MINIDUMP_CPU_PPC_H__ */