sim/common/sim-syscall.h

   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