|
Packit Service |
72eb06 |
/* Generic interface between GCC and GDB
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
Copyright (C) 2014-2018 Free Software Foundation, Inc.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This file is part of GCC.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This program is free software; you can redistribute it and/or modify
|
|
Packit Service |
72eb06 |
it under the terms of the GNU General Public License as published by
|
|
Packit Service |
72eb06 |
the Free Software Foundation; either version 3 of the License, or
|
|
Packit Service |
72eb06 |
(at your option) any later version.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This program is distributed in the hope that it will be useful,
|
|
Packit Service |
72eb06 |
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
Packit Service |
72eb06 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
Packit Service |
72eb06 |
GNU General Public License for more details.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
You should have received a copy of the GNU General Public License
|
|
Packit Service |
72eb06 |
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
#ifndef GCC_INTERFACE_H
|
|
Packit Service |
72eb06 |
#define GCC_INTERFACE_H
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* This header defines the interface to the GCC API. It must be both
|
|
Packit Service |
72eb06 |
valid C and valid C++, because it is included by both programs. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
#ifdef __cplusplus
|
|
Packit Service |
72eb06 |
extern "C" {
|
|
Packit Service |
72eb06 |
#endif
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Opaque typedefs for objects passed through the interface. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
typedef unsigned long long gcc_type;
|
|
Packit Service |
72eb06 |
typedef unsigned long long gcc_decl;
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* An address in the inferior. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
typedef unsigned long long gcc_address;
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Forward declaration. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
struct gcc_base_context;
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Defined versions of the generic API. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
enum gcc_base_api_version
|
|
Packit Service |
72eb06 |
{
|
|
Packit Service |
72eb06 |
GCC_FE_VERSION_0 = 0,
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Deprecated methods set_arguments_v0 and compile_v0. Added methods
|
|
Packit Service |
72eb06 |
set_arguments, set_triplet_regexp, set_driver_filename, set_verbose and
|
|
Packit Service |
72eb06 |
compile. */
|
|
Packit Service |
72eb06 |
GCC_FE_VERSION_1 = 1,
|
|
Packit Service |
72eb06 |
};
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* The operations defined by the GCC base API. This is the vtable for
|
|
Packit Service |
72eb06 |
the real context structure which is passed around.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
The "base" API is concerned with basics shared by all compiler
|
|
Packit Service |
72eb06 |
front ends: setting command-line arguments, the file names, etc.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
Front-end-specific interfaces inherit from this one. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
struct gcc_base_vtable
|
|
Packit Service |
72eb06 |
{
|
|
Packit Service |
72eb06 |
/* The actual version implemented in this interface. This field can
|
|
Packit Service |
72eb06 |
be relied on not to move, so users can always check it if they
|
|
Packit Service |
72eb06 |
desire. The value is one of the gcc_base_api_version constants.
|
|
Packit Service |
72eb06 |
*/
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
unsigned int version;
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Deprecated GCC_FE_VERSION_0 variant of the GCC_FE_VERSION_1
|
|
Packit Service |
72eb06 |
methods set_triplet_regexp and set_arguments. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
char *(*set_arguments_v0) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
const char *triplet_regexp,
|
|
Packit Service |
72eb06 |
int argc, char **argv);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Set the file name of the program to compile. The string is
|
|
Packit Service |
72eb06 |
copied by the method implementation, but the caller must
|
|
Packit Service |
72eb06 |
guarantee that the file exists through the compilation. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
void (*set_source_file) (struct gcc_base_context *self, const char *file);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Set a callback to use for printing error messages. DATUM is
|
|
Packit Service |
72eb06 |
passed through to the callback unchanged. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
void (*set_print_callback) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
void (*print_function) (void *datum,
|
|
Packit Service |
72eb06 |
const char *message),
|
|
Packit Service |
72eb06 |
void *datum);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Deprecated GCC_FE_VERSION_0 variant of the GCC_FE_VERSION_1
|
|
Packit Service |
72eb06 |
compile method. GCC_FE_VERSION_0 version verbose parameter has
|
|
Packit Service |
72eb06 |
been replaced by the set_verbose method. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
int /* bool */ (*compile_v0) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
const char *filename,
|
|
Packit Service |
72eb06 |
int /* bool */ verbose);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Destroy this object. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
void (*destroy) (struct gcc_base_context *self);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* VERBOSE can be set to non-zero to cause GCC to print some
|
|
Packit Service |
72eb06 |
information as it works. Calling this method overrides its
|
|
Packit Service |
72eb06 |
possible previous calls.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This method is only available since GCC_FE_VERSION_1. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
void (*set_verbose) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
int /* bool */ verbose);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Perform the compilation. FILENAME is the name of the resulting
|
|
Packit Service |
72eb06 |
object file. Either set_triplet_regexp or set_driver_filename must
|
|
Packit Service |
72eb06 |
be called before. Returns true on success, false on error.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This method is only available since GCC_FE_VERSION_1. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
int /* bool */ (*compile) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
const char *filename);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Set the compiler's command-line options for the next compilation.
|
|
Packit Service |
72eb06 |
The arguments are copied by GCC. ARGV need not be
|
|
Packit Service |
72eb06 |
NULL-terminated. The arguments must be set separately for each
|
|
Packit Service |
72eb06 |
compilation; that is, after a compile is requested, the
|
|
Packit Service |
72eb06 |
previously-set arguments cannot be reused.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This returns NULL on success. On failure, returns a malloc()d
|
|
Packit Service |
72eb06 |
error message. The caller is responsible for freeing it.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This method is only available since GCC_FE_VERSION_1. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
char *(*set_arguments) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
int argc, char **argv);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* Set TRIPLET_REGEXP as a regular expression that is used to match
|
|
Packit Service |
72eb06 |
the configury triplet prefix to the compiler. Calling this method
|
|
Packit Service |
72eb06 |
overrides possible previous call of itself or set_driver_filename.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This returns NULL on success. On failure, returns a malloc()d
|
|
Packit Service |
72eb06 |
error message. The caller is responsible for freeing it.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This method is only available since GCC_FE_VERSION_1. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
char *(*set_triplet_regexp) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
const char *triplet_regexp);
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* DRIVER_FILENAME should be filename of the gcc compiler driver
|
|
Packit Service |
72eb06 |
program. It will be searched in PATH components like
|
|
Packit Service |
72eb06 |
TRIPLET_REGEXP. Calling this method overrides possible previous
|
|
Packit Service |
72eb06 |
call of itself or set_triplet_regexp.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This returns NULL on success. On failure, returns a malloc()d
|
|
Packit Service |
72eb06 |
error message. The caller is responsible for freeing it.
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
This method is only available since GCC_FE_VERSION_1. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
char *(*set_driver_filename) (struct gcc_base_context *self,
|
|
Packit Service |
72eb06 |
const char *driver_filename);
|
|
Packit Service |
72eb06 |
};
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* The GCC object. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
struct gcc_base_context
|
|
Packit Service |
72eb06 |
{
|
|
Packit Service |
72eb06 |
/* The virtual table. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
const struct gcc_base_vtable *ops;
|
|
Packit Service |
72eb06 |
};
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* An array of types used for creating function types in multiple
|
|
Packit Service |
72eb06 |
languages. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
struct gcc_type_array
|
|
Packit Service |
72eb06 |
{
|
|
Packit Service |
72eb06 |
/* Number of elements. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
int n_elements;
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* The elements. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
gcc_type *elements;
|
|
Packit Service |
72eb06 |
};
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
/* The name of the dummy wrapper function generated by gdb. */
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
#define GCC_FE_WRAPPER_FUNCTION "_gdb_expr"
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
#ifdef __cplusplus
|
|
Packit Service |
72eb06 |
}
|
|
Packit Service |
72eb06 |
#endif
|
|
Packit Service |
72eb06 |
|
|
Packit Service |
72eb06 |
#endif /* GCC_INTERFACE_H */
|