| /* This file is part of the program psim. |
| |
| Copyright (C) 1994-1995,1998, Andrew Cagney <cagney@highland.com.au> |
| |
| This program is free software; you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 2 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program; if not, write to the Free Software |
| Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
| |
| */ |
| |
| |
| #ifndef _SIM_CALLBACKS_H_ |
| #define _SIM_CALLBACKS_H_ |
| |
| /* Simulator output: |
| |
| Functions to report diagnostic information to the user. */ |
| |
| #define printf_filtered sim_io_printf_filtered |
| void sim_io_printf_filtered |
| (const char *msg, ...) __attribute__ ((format (printf, 1, 2))); |
| |
| void NORETURN error |
| (const char *msg, ...); |
| |
| |
| /* External environment: |
| |
| Some HOST OS's require regular polling so that external events such |
| as GUI io can be handled. */ |
| |
| void sim_io_poll_quit |
| (void); |
| |
| |
| |
| /* Model I/O: |
| |
| These functions provide the interface between the modeled targets |
| standard input and output streams and the hosts external |
| environment. |
| |
| The underlying model is responsible for co-ordinating I/O |
| interactions such as: |
| |
| main() |
| { |
| const char mess[] = "Hello World\r\n"; |
| int out; |
| out = dup(1); |
| close(1); |
| write(out, mess, sizeof(mess)) |
| } |
| |
| That is to say, the underlying model would, in implementing dup() |
| recorded the fact that any output directed at fid-OUT should be |
| displayed using sim_io_write_stdout(). While for the code stub: |
| |
| main() |
| { |
| const char mess[] = "Hello World\r\n"; |
| int out; |
| close(1); |
| out = open("output", 0x0001|0x0200, 0); // write+create |
| out = dup(1); |
| write(out, mess, sizeof(mess)) |
| } |
| |
| would result in output to fid-1 being directed towards the file |
| "output". */ |
| |
| |
| int |
| sim_io_write_stdout |
| (const char *buf, |
| int sizeof_buf); |
| |
| int |
| sim_io_write_stderr |
| (const char *buf, |
| int sizeof_buf); |
| |
| /* read results */ |
| enum { sim_io_eof = -1, sim_io_not_ready = -2, }; /* See: IEEE 1275 */ |
| |
| int |
| sim_io_read_stdin |
| (char *buf, |
| int sizeof_buf); |
| |
| #define flush_stdoutput sim_io_flush_stdoutput |
| void sim_io_flush_stdoutput |
| (void); |
| |
| |
| /* Simulator instance. */ |
| extern psim *simulator; |
| |
| |
| /* Memory management with an allocator that clears memory before use. */ |
| |
| void *zalloc |
| (long size); |
| |
| #define ZALLOC(TYPE) (TYPE*)zalloc(sizeof (TYPE)) |
| |
| void zfree(void*); |
| |
| #endif |