gdb/nat/amd64-linux-siginfo.h

   1 /* Low-level siginfo manipulation for amd64.
   2
   3    Copyright (C) 2016-2023 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef NAT_AMD64_LINUX_SIGINFO_H
  21 #define NAT_AMD64_LINUX_SIGINFO_H
  22
  23 #include <signal.h>  /* For siginfo_t.  */
  24
  25 /* When GDB is built as a 64-bit application on Linux, the
  26    PTRACE_GETSIGINFO data is always presented in 64-bit layout.  Since
  27    debugging a 32-bit inferior with a 64-bit GDB should look the same
  28    as debugging it with a 32-bit GDB, we do the 32-bit <-> 64-bit
  29    conversion in-place ourselves.
  30    In other to make this conversion independent of the system where gdb
  31    is compiled the most complete version of the siginfo, named as native
  32    siginfo, is used internally as an intermediate step.
  33
  34    Conversion using nat_siginfo is exemplified below:
  35    compat_siginfo_from_siginfo or compat_x32_siginfo_from_siginfo
  36
  37       buffer (from the kernel) -> nat_siginfo -> 32 / X32 siginfo
  38
  39    siginfo_from_compat_x32_siginfo or siginfo_from_compat_siginfo
  40
  41      32 / X32 siginfo -> nat_siginfo -> buffer (to the kernel)  */
  42
  43
  44 /* Kind of siginfo fixup to be performed.  */
  45
  46 enum amd64_siginfo_fixup_mode
  47 {
  48   FIXUP_32 = 1,   /* Fixup for 32bit.  */
  49   FIXUP_X32 = 2   /* Fixup for x32.  */
  50 };
  51
  52 /* Common code for performing the fixup of the siginfo.  */
  53
  54 int amd64_linux_siginfo_fixup_common (siginfo_t *native, gdb_byte *inf,
  55                                       int direction,
  56                                       enum amd64_siginfo_fixup_mode mode);
  57
  58 #endif /* NAT_AMD64_LINUX_SIGINFO_H */