mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-11-23 18:14:13 +08:00
1d506c26d9
This commit is the result of the following actions:
- Running gdb/copyright.py to update all of the copyright headers to
include 2024,
- Manually updating a few files the copyright.py script told me to
update, these files had copyright headers embedded within the
file,
- Regenerating gdbsupport/Makefile.in to refresh it's copyright
date,
- Using grep to find other files that still mentioned 2023. If
these files were updated last year from 2022 to 2023 then I've
updated them this year to 2024.
I'm sure I've probably missed some dates. Feel free to fix them up as
you spot them.
85 lines
3.1 KiB
C
85 lines
3.1 KiB
C
/* Miscellaneous simulator utilities.
|
|
Copyright (C) 1997-2024 Free Software Foundation, Inc.
|
|
Contributed by Cygnus Support.
|
|
|
|
This file is part of GDB, the GNU debugger.
|
|
|
|
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 3 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, see <http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef SIM_UTILS_H
|
|
#define SIM_UTILS_H
|
|
|
|
#include "ansidecl.h"
|
|
|
|
/* Memory management with an allocator that clears memory before use. */
|
|
|
|
void *zalloc (unsigned long size);
|
|
|
|
#define ZALLOC(TYPE) (TYPE*)zalloc(sizeof (TYPE))
|
|
#define NZALLOC(TYPE,N) (TYPE*)zalloc(sizeof (TYPE) * (N))
|
|
|
|
/* Turn VALUE into a string with commas. */
|
|
char *sim_add_commas (char *, int, unsigned long);
|
|
|
|
/* Utilities for elapsed time reporting. */
|
|
|
|
/* Opaque type, known only inside sim_elapsed_time_foo fns. Externally
|
|
it is known to never have the value zero. */
|
|
typedef unsigned long SIM_ELAPSED_TIME;
|
|
|
|
|
|
/* Get reference point for future call to sim_time_elapsed. */
|
|
SIM_ELAPSED_TIME sim_elapsed_time_get (void);
|
|
|
|
/* Elapsed time in milliseconds since START. */
|
|
unsigned long sim_elapsed_time_since (SIM_ELAPSED_TIME start);
|
|
|
|
/* Utilities for manipulating the load image. */
|
|
|
|
SIM_RC sim_analyze_program (SIM_DESC sd, const char *prog_name,
|
|
struct bfd *prog_bfd);
|
|
|
|
/* Load program PROG into the simulator using the function DO_LOAD.
|
|
If PROG_BFD is non-NULL, the file has already been opened.
|
|
If VERBOSE_P is non-zero statistics are printed of each loaded section
|
|
and the transfer rate (for consistency with gdb).
|
|
If LMA_P is non-zero the program sections are loaded at the LMA
|
|
rather than the VMA
|
|
If this fails an error message is printed and NULL is returned.
|
|
If it succeeds the bfd is returned.
|
|
NOTE: For historical reasons, older hardware simulators incorrectly
|
|
write the program sections at LMA interpreted as a virtual address.
|
|
This is still accommodated for backward compatibility reasons. */
|
|
|
|
typedef struct host_callback_struct host_callback;
|
|
typedef uint64_t sim_write_fn (SIM_DESC sd, uint64_t mem,
|
|
const void *buf, uint64_t length);
|
|
struct bfd *sim_load_file (SIM_DESC sd, const char *myname,
|
|
host_callback *callback, const char *prog,
|
|
struct bfd *prog_bfd, int verbose_p,
|
|
int lma_p, sim_write_fn do_load);
|
|
|
|
/* Internal version of sim_do_command, include formatting */
|
|
void sim_do_commandf (SIM_DESC sd, const char *fmt, ...)
|
|
ATTRIBUTE_PRINTF (2, 3);
|
|
|
|
|
|
/* sim-basics.h defines a number of enumerations, convert each of them
|
|
to a string representation */
|
|
const char *map_to_str (unsigned map);
|
|
const char *access_to_str (unsigned access);
|
|
const char *transfer_to_str (unsigned transfer);
|
|
|
|
#endif
|