xref: /netbsd-src/external/gpl3/gdb/dist/sim/common/sim-syscall.h (revision 0d3e0572e40d81edb4fdbff937458d47b685c34c)
1 /* Simulator system call support.
2 
3    Copyright 2002-2024 Free Software Foundation, Inc.
4 
5    This file is part of simulators.
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 SIM_SYSCALL_H
21 #define SIM_SYSCALL_H
22 
23 struct cb_syscall;
24 
25 /* Perform a syscall on the behalf of the target program.  The error/result are
26    normalized into a single value (like a lot of operating systems do).  If you
27    want the split values, see the other function below.
28 
29    Note: While cb_syscall requires you handle the exit syscall yourself, that is
30    not the case with these helpers.
31 
32    Note: Types here match the gdb callback interface.  */
33 long sim_syscall (SIM_CPU *, int func, long arg1, long arg2, long arg3,
34 		  long arg4);
35 
36 /* Same as sim_syscall, but return the split values by referenced.  */
37 void sim_syscall_multi (SIM_CPU *, int func, long arg1, long arg2, long arg3,
38 			long arg4, long *result, long *result2, int *errcode);
39 
40 /* Simple memory callbacks for cb_syscall's read_mem/write_mem that assume
41    cb_syscall's p1 and p2 are set to the SIM_DESC and SIM_CPU respectively.  */
42 int sim_syscall_read_mem (host_callback *, struct cb_syscall *, unsigned long,
43 			  char *, int);
44 int sim_syscall_write_mem (host_callback *, struct cb_syscall *, unsigned long,
45 			   const char *, int);
46 
47 #endif
48