]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - sim/common/sim-utils.h
* config/sh/tm-sh.h (BELIEVE_PCC_PROMOTION): Define, so that
[thirdparty/binutils-gdb.git] / sim / common / sim-utils.h
CommitLineData
fafce69a
AC
1/* Miscellaneous simulator utilities.
2 Copyright (C) 1997 Free Software Foundation, Inc.
3 Contributed by Cygnus Support.
4
5This file is part of GDB, the GNU debugger.
6
7This program is free software; you can redistribute it and/or modify
8it under the terms of the GNU General Public License as published by
9the Free Software Foundation; either version 2, or (at your option)
10any later version.
11
12This program is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License along
18with this program; if not, write to the Free Software Foundation, Inc.,
1959 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
20
21#ifndef SIM_UTILS_H
22#define SIM_UTILS_H
23
24/* Memory management with an allocator that clears memory before use. */
25
26void *zalloc (unsigned long size);
27
28#define ZALLOC(TYPE) (TYPE*)zalloc(sizeof (TYPE))
6dbaff8f 29#define NZALLOC(TYPE,N) (TYPE*)zalloc(sizeof (TYPE) * (N))
fafce69a
AC
30
31void zfree(void*);
32
33/* Turn VALUE into a string with commas. */
34char *sim_add_commas (char *, int, unsigned long);
35
36/* Utilities for elapsed time reporting. */
37
fdd64f95
AC
38/* Opaque type, known only inside sim_elapsed_time_foo fns. Externally
39 it is known to never have the value zero. */
fafce69a
AC
40typedef unsigned long SIM_ELAPSED_TIME;
41
fdd64f95 42
fafce69a
AC
43/* Get reference point for future call to sim_time_elapsed. */
44SIM_ELAPSED_TIME sim_elapsed_time_get (void);
45
46/* Elapsed time in milliseconds since START. */
47unsigned long sim_elapsed_time_since (SIM_ELAPSED_TIME start);
48
49/* Utilities for manipulating the load image. */
50
51SIM_RC sim_analyze_program (SIM_DESC sd, char *prog_name,
52 struct _bfd *prog_bfd);
53
fafce69a
AC
54/* Load program PROG into the simulator.
55 If PROG_BFD is non-NULL, the file has already been opened.
56 If VERBOSE_P is non-zero statistics are printed of each loaded section
57 and the transfer rate (for consistency with gdb).
58 If this fails an error message is printed and NULL is returned.
59 If it succeeds the bfd is returned. */
60
61struct _bfd *sim_load_file (SIM_DESC sd, const char *myname,
62 host_callback *callback, char *prog,
63 struct _bfd *prog_bfd, int verbose_p);
64
65/* These are defined in callback.c as cover functions to the vprintf
66 callbacks. */
67
68void sim_cb_printf (host_callback *, const char *, ...);
69void sim_cb_eprintf (host_callback *, const char *, ...);
70
71#endif