| 1 |
684 |
jeremybenn |
/* Streamer hooks. Support for adding streamer-specific callbacks to
|
| 2 |
|
|
generic streaming routines.
|
| 3 |
|
|
|
| 4 |
|
|
Copyright 2011 Free Software Foundation, Inc.
|
| 5 |
|
|
Contributed by Diego Novillo <dnovillo@google.com>
|
| 6 |
|
|
|
| 7 |
|
|
This file is part of GCC.
|
| 8 |
|
|
|
| 9 |
|
|
GCC is free software; you can redistribute it and/or modify it under
|
| 10 |
|
|
the terms of the GNU General Public License as published by the Free
|
| 11 |
|
|
Software Foundation; either version 3, or (at your option) any later
|
| 12 |
|
|
version.
|
| 13 |
|
|
|
| 14 |
|
|
GCC is distributed in the hope that it will be useful, but WITHOUT ANY
|
| 15 |
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
| 16 |
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
| 17 |
|
|
for more details.
|
| 18 |
|
|
|
| 19 |
|
|
You should have received a copy of the GNU General Public License
|
| 20 |
|
|
along with GCC; see the file COPYING3. If not see
|
| 21 |
|
|
<http://www.gnu.org/licenses/>. */
|
| 22 |
|
|
|
| 23 |
|
|
#ifndef GCC_STREAMER_HOOKS_H
|
| 24 |
|
|
#define GCC_STREAMER_HOOKS_H
|
| 25 |
|
|
|
| 26 |
|
|
#include "tree.h"
|
| 27 |
|
|
|
| 28 |
|
|
/* Forward declarations to avoid including unnecessary headers. */
|
| 29 |
|
|
struct output_block;
|
| 30 |
|
|
struct lto_input_block;
|
| 31 |
|
|
struct data_in;
|
| 32 |
|
|
|
| 33 |
|
|
/* Streamer hooks. These functions do additional processing as
|
| 34 |
|
|
needed by the module. There are two types of callbacks, those that
|
| 35 |
|
|
replace the default behavior and those that supplement it.
|
| 36 |
|
|
|
| 37 |
|
|
Hooks marked [REQ] are required to be set. Those marked [OPT] may
|
| 38 |
|
|
be NULL, if the streamer does not need to implement them. */
|
| 39 |
|
|
struct streamer_hooks {
|
| 40 |
|
|
/* [REQ] Called by every tree streaming routine that needs to write
|
| 41 |
|
|
a tree node. The arguments are: output_block where to write the
|
| 42 |
|
|
node, the tree node to write and a boolean flag that should be true
|
| 43 |
|
|
if the caller wants to write a reference to the tree, instead of the
|
| 44 |
|
|
tree itself. The second boolean parameter specifies this for
|
| 45 |
|
|
the tree itself, the first for all siblings that are streamed.
|
| 46 |
|
|
The referencing mechanism is up to each streamer to implement. */
|
| 47 |
|
|
void (*write_tree) (struct output_block *, tree, bool, bool);
|
| 48 |
|
|
|
| 49 |
|
|
/* [REQ] Called by every tree streaming routine that needs to read
|
| 50 |
|
|
a tree node. It takes two arguments: an lto_input_block pointing
|
| 51 |
|
|
to the buffer where to read from and a data_in instance with tables
|
| 52 |
|
|
and descriptors needed by the unpickling routines. It returns the
|
| 53 |
|
|
tree instantiated from the stream. */
|
| 54 |
|
|
tree (*read_tree) (struct lto_input_block *, struct data_in *);
|
| 55 |
|
|
|
| 56 |
|
|
/* [OPT] Called by lto_input_location to retrieve the source location of the
|
| 57 |
|
|
tree currently being read. If this hook returns NULL, lto_input_location
|
| 58 |
|
|
defaults to calling lto_input_location_bitpack. */
|
| 59 |
|
|
location_t (*input_location) (struct lto_input_block *, struct data_in *);
|
| 60 |
|
|
|
| 61 |
|
|
/* [OPT] Called by lto_output_location to write the source_location of the
|
| 62 |
|
|
tree currently being written. If this hook returns NULL,
|
| 63 |
|
|
lto_output_location defaults to calling lto_output_location_bitpack. */
|
| 64 |
|
|
void (*output_location) (struct output_block *, location_t);
|
| 65 |
|
|
};
|
| 66 |
|
|
|
| 67 |
|
|
#define stream_write_tree(OB, EXPR, REF_P) \
|
| 68 |
|
|
streamer_hooks.write_tree(OB, EXPR, REF_P, REF_P)
|
| 69 |
|
|
|
| 70 |
|
|
#define stream_write_tree_shallow_non_ref(OB, EXPR, REF_P) \
|
| 71 |
|
|
streamer_hooks.write_tree(OB, EXPR, REF_P, false)
|
| 72 |
|
|
|
| 73 |
|
|
#define stream_read_tree(IB, DATA_IN) \
|
| 74 |
|
|
streamer_hooks.read_tree(IB, DATA_IN)
|
| 75 |
|
|
|
| 76 |
|
|
/* Streamer hooks. */
|
| 77 |
|
|
extern struct streamer_hooks streamer_hooks;
|
| 78 |
|
|
|
| 79 |
|
|
/* In streamer-hooks.c. */
|
| 80 |
|
|
void streamer_hooks_init (void);
|
| 81 |
|
|
|
| 82 |
|
|
#endif /* GCC_STREAMER_HOOKS_H */
|