xref: /netbsd-src/external/gpl3/gdb.old/dist/gdb/nat/amd64-linux-siginfo.h (revision bdc22b2e01993381dcefeff2bc9b56ca75a4235c)
1 /* Low-level siginfo manipulation for amd64.
2 
3    Copyright (C) 2016 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 AMD64_LINUX_SIGINFO_H
21 #define AMD64_LINUX_SIGINFO_H 1
22 
23 /* When GDB is built as a 64-bit application on Linux, the
24    PTRACE_GETSIGINFO data is always presented in 64-bit layout.  Since
25    debugging a 32-bit inferior with a 64-bit GDB should look the same
26    as debugging it with a 32-bit GDB, we do the 32-bit <-> 64-bit
27    conversion in-place ourselves.
28    In other to make this conversion independent of the system where gdb
29    is compiled the most complete version of the siginfo, named as native
30    siginfo, is used internally as an intermediate step.
31 
32    Conversion using nat_siginfo is exemplified below:
33    compat_siginfo_from_siginfo or compat_x32_siginfo_from_siginfo
34 
35       buffer (from the kernel) -> nat_siginfo -> 32 / X32 siginfo
36 
37    siginfo_from_compat_x32_siginfo or siginfo_from_compat_siginfo
38 
39      32 / X32 siginfo -> nat_siginfo -> buffer (to the kernel)  */
40 
41 
42 /* Kind of siginfo fixup to be performed.  */
43 
44 enum amd64_siginfo_fixup_mode
45 {
46   FIXUP_32 = 1,   /* Fixup for 32bit.  */
47   FIXUP_X32 = 2   /* Fixup for x32.  */
48 };
49 
50 /* Common code for performing the fixup of the siginfo.  */
51 
52 int amd64_linux_siginfo_fixup_common (siginfo_t *native, gdb_byte *inf,
53 				      int direction,
54 				      enum amd64_siginfo_fixup_mode mode);
55 
56 #endif
57