#include "config.h"
#include "system.h"
#include "coretypes.h"
#include "diagnostic-core.h"
#include "tree.h"
#include "ggc.h"
#include "pointer-set.h"
#include "obstack.h"
#include "debug.h"
#include "gt-godump.h"

Include dependency graph for godump.c:

Data Structures
struct	macro_hash_value
struct	godump_container

Functions
static hashval_t	macro_hash_hashval ()
static int	macro_hash_eq ()
static void	macro_hash_del ()
static int	string_hash_eq ()
static void	go_define ()
static void	go_undef ()
static void	go_decl ()
static void	go_function_decl ()
static void	go_global_decl ()
static void	go_type_decl ()
static void	go_append_string ()
static bool	go_format_type (struct godump_container *container, tree type, bool use_type_name, bool is_func_ok)
static void	go_output_type ()
static void	go_output_fndecl ()
static void	go_output_typedef ()
static void	go_output_var ()
static int	go_print_macro ()
static void	keyword_hash_init ()
static bool	find_dummy_types ()
static void	go_finish ()
struct gcc_debug_hooks *	dump_go_spec_init ()

Variables
static struct gcc_debug_hooks	go_debug_hooks
static struct gcc_debug_hooks *	real_debug_hooks
static FILE *	go_dump_file
static vec< tree, va_gc > *	queue
static htab_t	macro_hash
static const char *const	keywords []

Function Documentation

struct gcc_debug_hooks* dump_go_spec_init ( )

read

Set up our hooks.

static bool find_dummy_types ( )

static

Traversing the pot_dummy_types and seeing which types are present in the global types hash table and creating dummy definitions if not found. This function is invoked by pointer_set_traverse.

static void go_append_string ( )

static

Append an IDENTIFIER_NODE to OB.

References DECL_NAME, IDENTIFIER_POINTER, godump_container::invalid_hash, and gdbhooks::TYPE_DECL.

static void go_decl ( )

static

A function or variable decl.

Referenced by go_undef().

static void go_define ( )

static

A macro definition.

 Skip macro functions.

 For simplicity, we force all names to be hidden by adding an
 initial underscore, and let the user undo this as needed.

           The start of an identifier.  Technically we should also
           worry about UTF-8 identifiers, but they are not a
           problem for practical uses of -fdump-go-spec so we
           don't worry about them.

               This is a reference to a name which was not defined
               as a macro.

         Fall through.

               Go doesn't use any of these trailing type
               modifiers.

           We'll pick up the exponent, if any, as an
           expression.

         Always OK, not part of an operand, presumed to start an
         operand.

         OK if we don't need an operand, and presumed to indicate
         an operand.

         Always OK, but not part of an operand.

         Must be a binary operator.

         Must be a binary operator.

             Must be a binary operator.

             Must be a unary operator.

         Must be a binary operand, may be << or >> or <= or >=.

         Must be a unary operand, must be translated for Go.

                   Go octal characters are always 3
                   digits.

                   Go hex characters are always 2 digits.

static void go_finish ( )

static

Output symbols.

To emit dummy definitions.

References error().

static bool go_format_type	(	struct godump_container *	container,
		tree	type,
		bool	use_type_name,
		bool	is_func_ok
	)

static

Write the Go version of TYPE to CONTAINER->TYPE_OBSTACK. USE_TYPE_NAME is true if we can simply use a type name here without needing to define it. IS_FUNC_OK is true if we can output a func type here; the "func" keyword will already have been added. Return true if the type can be represented in Go, false otherwise.

         The pointer here can be used without the struct or union
         definition.  So this struct or union is a potential dummy
         type.

               Start variable name with an underscore if a keyword.

               Do not expand type if a record or union type or a
               function pointer.

           Only output the first successful field of a union, and
           hope for the best.

       Go has no way to write a type which is a function but not a
       pointer to a function.

Referenced by go_output_typedef().

static void go_function_decl ( )

static

A function decl.

static void go_global_decl ( )

static

A global variable decl.

static void go_output_fndecl ( )

static

Output a function declaration.

static void go_output_type ( )

static

Output the type which was built on the type obstack, and then free it.

Referenced by go_output_typedef().

static void go_output_typedef ( )

static

Output a typedef or something like a struct definition.

 If we have an enum type, output the enum constants
 separately.

         Sometimes a name will be defined as both an enum constant
         and a macro.  Avoid duplicate definition errors by
         treating enum constants as macros.

     If type defined already, skip.

      If type defined already, skip.

References CONST_CAST, DECL_NAME, godump_container::decls_seen, go_dump_file, go_format_type(), go_output_type(), HOST_WIDE_INT_PRINT_DEC, IDENTIFIER_POINTER, int_size_in_bytes(), godump_container::invalid_hash, NULL, pointer_set_insert(), RECORD_OR_UNION_TYPE_P, TREE_TYPE, type(), and godump_container::type_hash.

static void go_output_var ( )

static

Output a variable.

There is already a type with this name, probably from a
struct tag.  Prefer the type to the variable.

Sometimes an extern variable is declared with an unknown struct type.

static int go_print_macro ( )

static

Output the final value of a preprocessor macro or enum constant. This is called via htab_traverse_noresize.

static void go_type_decl ( )

static

A type declaration.

References IDENTIFIER_LENGTH, and IDENTIFIER_POINTER.

static void go_undef ( )

static

A macro undef.

References gcc_debug_hooks::global_decl, and go_decl().

static void keyword_hash_init ( )

static

static void macro_hash_del ( )

static

Free values deleted from the macro hash table.

static int macro_hash_eq ( )

static

Compare values in the macro hash table for equality.

static hashval_t macro_hash_hashval ( )

static

Calculate the hash value for an entry in the macro hash table.

static int string_hash_eq ( )

static

For the string hash tables.

Variable Documentation

struct gcc_debug_hooks go_debug_hooks

static

This file is part of GCC.

GCC 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, or (at your option) any later version.

GCC 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 GCC; see the file COPYING3. If not see http://www.gnu.org/licenses/. This file is used during the build process to emit Go language descriptions of declarations from C header files. It uses the debug info hooks to emit the descriptions. The Go language descriptions then become part of the Go runtime support library.

All global names are output with a leading underscore, so that they are all hidden in Go. We dump this information from the debug hooks. This gives us a stable and maintainable API to hook into. In order to work correctly when -g is used, we build our own hooks structure which wraps the hooks we need to change. Our debug hooks. This is initialized by dump_go_spec_init.

FILE* go_dump_file

static

The file where we should write information.

Referenced by go_output_typedef().

const char* const keywords[]

static

Initial value:

 {
  "__asm__", "break", "case", "chan", "const", "continue", "default",
  "defer", "else", "fallthrough", "for", "func", "go", "goto", "if",
  "import", "interface", "map", "package", "range", "return", "select",
  "struct", "switch", "type", "var"
}

Build a hash table with the Go keywords.

htab_t macro_hash

static

A hash table of macros we have seen.

vec<tree, va_gc>* queue

static

A queue of decls to output.

struct gcc_debug_hooks* real_debug_hooks

static

The real debug hooks.

Data Structures

Functions

Variables

Function Documentation

Variable Documentation