Home | History | Annotate | Line # | Download | only in nat 
      1 /* Low-level siginfo manipulation for amd64.
      2 
      3    Copyright (C) 2016-2024 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>
     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 */
     59