123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283 |
- // Copyright 2014 The Crashpad Authors. All rights reserved.
- //
- // Licensed under the Apache License, Version 2.0 (the "License");
- // you may not use this file except in compliance with the License.
- // You may obtain a copy of the License at
- //
- // http://www.apache.org/licenses/LICENSE-2.0
- //
- // Unless required by applicable law or agreed to in writing, software
- // distributed under the License is distributed on an "AS IS" BASIS,
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- // See the License for the specific language governing permissions and
- // limitations under the License.
- #ifndef CRASHPAD_SNAPSHOT_SNAPSHOT_CPU_CONTEXT_H_
- #define CRASHPAD_SNAPSHOT_SNAPSHOT_CPU_CONTEXT_H_
- #include <stdint.h>
- #include "snapshot/cpu_architecture.h"
- namespace crashpad {
- //! \brief A context structure carrying 32-bit x86 CPU state.
- struct CPUContextX86 {
- using X87Register = uint8_t[10];
- struct Fsave {
- uint16_t fcw; // FPU control word
- uint16_t reserved_1;
- uint16_t fsw; // FPU status word
- uint16_t reserved_2;
- uint16_t ftw; // full FPU tag word
- uint16_t reserved_3;
- uint32_t fpu_ip; // FPU instruction pointer offset
- uint16_t fpu_cs; // FPU instruction pointer segment selector
- uint16_t fop; // FPU opcode
- uint32_t fpu_dp; // FPU data pointer offset
- uint16_t fpu_ds; // FPU data pointer segment selector
- uint16_t reserved_4;
- X87Register st[8];
- };
- union X87OrMMXRegister {
- struct {
- X87Register st;
- uint8_t st_reserved[6];
- };
- struct {
- uint8_t mm_value[8];
- uint8_t mm_reserved[8];
- };
- };
- using XMMRegister = uint8_t[16];
- struct Fxsave {
- uint16_t fcw; // FPU control word
- uint16_t fsw; // FPU status word
- uint8_t ftw; // abridged FPU tag word
- uint8_t reserved_1;
- uint16_t fop; // FPU opcode
- uint32_t fpu_ip; // FPU instruction pointer offset
- uint16_t fpu_cs; // FPU instruction pointer segment selector
- uint16_t reserved_2;
- uint32_t fpu_dp; // FPU data pointer offset
- uint16_t fpu_ds; // FPU data pointer segment selector
- uint16_t reserved_3;
- uint32_t mxcsr; // multimedia extensions status and control register
- uint32_t mxcsr_mask; // valid bits in mxcsr
- X87OrMMXRegister st_mm[8];
- XMMRegister xmm[8];
- uint8_t reserved_4[176];
- uint8_t available[48];
- };
- //! \brief Converts an `fxsave` area to an `fsave` area.
- //!
- //! `fsave` state is restricted to the x87 FPU, while `fxsave` state includes
- //! state related to the x87 FPU as well as state specific to SSE.
- //!
- //! As the `fxsave` format is a superset of the `fsave` format, this operation
- //! fully populates the `fsave` area. `fsave` uses the full 16-bit form for
- //! the x87 floating-point tag word, so FxsaveToFsaveTagWord() is used to
- //! derive Fsave::ftw from the abridged 8-bit form used by `fxsave`. Reserved
- //! fields in \a fsave are set to `0`.
- //!
- //! \param[in] fxsave The `fxsave` area to convert.
- //! \param[out] fsave The `fsave` area to populate.
- //!
- //! \sa FsaveToFxsave()
- static void FxsaveToFsave(const Fxsave& fxsave, Fsave* fsave);
- //! \brief Converts an `fsave` area to an `fxsave` area.
- //!
- //! `fsave` state is restricted to the x87 FPU, while `fxsave` state includes
- //! state related to the x87 FPU as well as state specific to SSE.
- //!
- //! As the `fsave` format is a subset of the `fxsave` format, this operation
- //! cannot fully populate the `fxsave` area. Fields in \a fxsave that have no
- //! equivalent in \a fsave are set to `0`, including Fxsave::mxcsr,
- //! Fxsave::mxcsr_mask, Fxsave::xmm, and Fxsave::available.
- //! FsaveToFxsaveTagWord() is used to derive Fxsave::ftw from the full 16-bit
- //! form used by `fsave`. Reserved fields in \a fxsave are set to `0`.
- //!
- //! \param[in] fsave The `fsave` area to convert.
- //! \param[out] fxsave The `fxsave` area to populate.
- //!
- //! \sa FxsaveToFsave()
- static void FsaveToFxsave(const Fsave& fsave, Fxsave* fxsave);
- //! \brief Converts x87 floating-point tag words from `fxsave` (abridged,
- //! 8-bit) to `fsave` (full, 16-bit) form.
- //!
- //! `fxsave` stores the x87 floating-point tag word in abridged 8-bit form,
- //! and `fsave` stores it in full 16-bit form. Some users, notably
- //! CPUContextX86::Fsave::ftw, require the full 16-bit form, where most other
- //! contemporary code uses `fxsave` and thus the abridged 8-bit form found in
- //! CPUContextX86::Fxsave::ftw.
- //!
- //! This function converts an abridged tag word to the full version by using
- //! the abridged tag word and the contents of the registers it describes. See
- //! Intel Software Developer’s Manual, Volume 2A: Instruction Set Reference
- //! A-M (253666-052), 3.2 “FXSAVE”, specifically, the notes on the abridged
- //! FTW and recreating the FSAVE format, and AMD Architecture Programmer’s
- //! Manual, Volume 2: System Programming (24593-3.24), “FXSAVE Format for x87
- //! Tag Word”.
- //!
- //! \sa FsaveToFxsaveTagWord()
- //!
- //! \param[in] fsw The FPU status word, used to map logical \a st_mm registers
- //! to their physical counterparts. This can be taken from
- //! CPUContextX86::Fxsave::fsw.
- //! \param[in] fxsave_tag The abridged FPU tag word. This can be taken from
- //! CPUContextX86::Fxsave::ftw.
- //! \param[in] st_mm The floating-point registers in logical order. This can
- //! be taken from CPUContextX86::Fxsave::st_mm.
- //!
- //! \return The full FPU tag word.
- static uint16_t FxsaveToFsaveTagWord(
- uint16_t fsw, uint8_t fxsave_tag, const X87OrMMXRegister st_mm[8]);
- //! \brief Converts x87 floating-point tag words from `fsave` (full, 16-bit)
- //! to `fxsave` (abridged, 8-bit) form.
- //!
- //! This function performs the inverse operation of FxsaveToFsaveTagWord().
- //!
- //! \param[in] fsave_tag The full FPU tag word.
- //!
- //! \return The abridged FPU tag word.
- static uint8_t FsaveToFxsaveTagWord(uint16_t fsave_tag);
- // Integer registers.
- uint32_t eax;
- uint32_t ebx;
- uint32_t ecx;
- uint32_t edx;
- uint32_t edi; // destination index
- uint32_t esi; // source index
- uint32_t ebp; // base pointer
- uint32_t esp; // stack pointer
- uint32_t eip; // instruction pointer
- uint32_t eflags;
- uint16_t cs; // code segment selector
- uint16_t ds; // data segment selector
- uint16_t es; // extra segment selector
- uint16_t fs;
- uint16_t gs;
- uint16_t ss; // stack segment selector
- // Floating-point and vector registers.
- Fxsave fxsave;
- // Debug registers.
- uint32_t dr0;
- uint32_t dr1;
- uint32_t dr2;
- uint32_t dr3;
- uint32_t dr4; // obsolete, normally an alias for dr6
- uint32_t dr5; // obsolete, normally an alias for dr7
- uint32_t dr6;
- uint32_t dr7;
- };
- //! \brief A context structure carrying x86_64 CPU state.
- struct CPUContextX86_64 {
- using X87Register = CPUContextX86::X87Register;
- using X87OrMMXRegister = CPUContextX86::X87OrMMXRegister;
- using XMMRegister = CPUContextX86::XMMRegister;
- struct Fxsave {
- uint16_t fcw; // FPU control word
- uint16_t fsw; // FPU status word
- uint8_t ftw; // abridged FPU tag word
- uint8_t reserved_1;
- uint16_t fop; // FPU opcode
- union {
- // The expression of these union members is determined by the use of
- // fxsave/fxrstor or fxsave64/fxrstor64 (fxsaveq/fxrstorq). macOS and
- // Windows systems use the traditional fxsave/fxrstor structure.
- struct {
- // fxsave/fxrstor
- uint32_t fpu_ip; // FPU instruction pointer offset
- uint16_t fpu_cs; // FPU instruction pointer segment selector
- uint16_t reserved_2;
- uint32_t fpu_dp; // FPU data pointer offset
- uint16_t fpu_ds; // FPU data pointer segment selector
- uint16_t reserved_3;
- };
- struct {
- // fxsave64/fxrstor64 (fxsaveq/fxrstorq)
- uint64_t fpu_ip_64; // FPU instruction pointer
- uint64_t fpu_dp_64; // FPU data pointer
- };
- };
- uint32_t mxcsr; // multimedia extensions status and control register
- uint32_t mxcsr_mask; // valid bits in mxcsr
- X87OrMMXRegister st_mm[8];
- XMMRegister xmm[16];
- uint8_t reserved_4[48];
- uint8_t available[48];
- };
- // Integer registers.
- uint64_t rax;
- uint64_t rbx;
- uint64_t rcx;
- uint64_t rdx;
- uint64_t rdi; // destination index
- uint64_t rsi; // source index
- uint64_t rbp; // base pointer
- uint64_t rsp; // stack pointer
- uint64_t r8;
- uint64_t r9;
- uint64_t r10;
- uint64_t r11;
- uint64_t r12;
- uint64_t r13;
- uint64_t r14;
- uint64_t r15;
- uint64_t rip; // instruction pointer
- uint64_t rflags;
- uint16_t cs; // code segment selector
- uint16_t fs;
- uint16_t gs;
- // Floating-point and vector registers.
- Fxsave fxsave;
- // Debug registers.
- uint64_t dr0;
- uint64_t dr1;
- uint64_t dr2;
- uint64_t dr3;
- uint64_t dr4; // obsolete, normally an alias for dr6
- uint64_t dr5; // obsolete, normally an alias for dr7
- uint64_t dr6;
- uint64_t dr7;
- };
- //! \brief A context structure capable of carrying the context of any supported
- //! CPU architecture.
- struct CPUContext {
- //! \brief Returns the instruction pointer value from the context structure.
- //!
- //! This is a CPU architecture-independent method that is capable of
- //! recovering the instruction pointer from any supported CPU architecture’s
- //! context structure.
- uint64_t InstructionPointer() const;
- //! \brief The CPU architecture of a context structure. This field controls
- //! the expression of the union.
- CPUArchitecture architecture;
- union {
- CPUContextX86* x86;
- CPUContextX86_64* x86_64;
- };
- };
- } // namespace crashpad
- #endif // CRASHPAD_SNAPSHOT_SNAPSHOT_CPU_CONTEXT_H_
|