diff options
Diffstat (limited to 'gcc/streamer-hooks.h')
-rw-r--r-- | gcc/streamer-hooks.h | 84 |
1 files changed, 18 insertions, 66 deletions
diff --git a/gcc/streamer-hooks.h b/gcc/streamer-hooks.h index 29a6591ccc0..6c45102376a 100644 --- a/gcc/streamer-hooks.h +++ b/gcc/streamer-hooks.h @@ -39,76 +39,28 @@ struct lto_streamer_cache_d; Hooks marked [REQ] are required to be set. Those marked [OPT] may be NULL, if the streamer does not need to implement them. */ struct streamer_hooks { - /* [REQ] A string identifying this streamer. */ - const char *name; - - /* [REQ] Called by lto_streamer_cache_create to instantiate a cache of - well-known nodes. These are tree nodes that are always - instantiated by the compiler on startup. Additionally, these - nodes need to be shared. This function should call - lto_streamer_cache_append on every tree node that it wishes to - preload in the streamer cache. This way, the writer will only - write out a reference to the tree and the reader will instantiate - the tree out of this pre-populated cache. */ - void (*preload_common_nodes) (struct lto_streamer_cache_d *); - - /* [REQ] Return true if the given tree is supported by this streamer. */ - bool (*is_streamable) (tree); - - /* [OPT] Called by lto_write_tree after writing all the common parts of - a tree. If defined, the callback is in charge of writing all - the fields that lto_write_tree did not write out. Arguments - are as in lto_write_tree. - - The following tree fields are not handled by common code: - - DECL_ABSTRACT_ORIGIN - DECL_INITIAL - DECL_SAVED_TREE - - Callbacks may choose to ignore or handle them. If handled, - the reader should read them in the exact same sequence written - by the writer. */ + /* [REQ] Called by every tree streaming routine that needs to write + a tree node. The arguments are: output_block where to write the + node, the tree node to write and a boolean flag that should be true + if the caller wants to write a reference to the tree, instead of the + tree itself. The referencing mechanism is up to each streamer to + implement. */ void (*write_tree) (struct output_block *, tree, bool); - /* [OPT] Called by lto_read_tree after reading all the common parts of - a tree. If defined, the callback is in charge of reading all - the fields that lto_read_tree did not read in. Arguments - are as in lto_read_tree. */ - void (*read_tree) (struct lto_input_block *, struct data_in *, tree); - - /* [OPT] Called by lto_output_tree_ref to determine if the given tree node - should be emitted as a reference to the table of declarations - (the same table that holds global declarations). */ - bool (*indexable_with_decls_p) (tree); - - /* [OPT] Called by pack_value_fields to store any non-pointer fields - in the tree structure. The arguments are as in pack_value_fields. */ - void (*pack_value_fields) (struct bitpack_d *, tree); - - /* [OPT] Called by unpack_value_fields to retrieve any non-pointer fields - in the tree structure. The arguments are as in unpack_value_fields. */ - void (*unpack_value_fields) (struct bitpack_d *, tree); - - /* [OPT] Called by lto_materialize_tree for tree nodes that it does not - know how to allocate memory for. If defined, this hook should - return a new tree node of the given code. The data_in and - input_block arguments are passed in case the hook needs to - read more data from the stream to allocate the node. - If this hook returns NULL, then lto_materialize_tree will attempt - to allocate the tree by calling make_node directly. */ - tree (*alloc_tree) (enum tree_code, struct lto_input_block *, - struct data_in *); - - /* [OPT] Called by lto_output_tree_header to write any streamer-specific - information needed to allocate the tree. This hook may assume - that the basic header data (tree code, etc) has already been - written. It should only write any extra data needed to allocate - the node (e.g., in the case of CALL_EXPR, this hook would write - the number of arguments to the CALL_EXPR). */ - void (*output_tree_header) (struct output_block *, tree); + /* [REQ] Called by every tree streaming routine that needs to read + a tree node. It takes two arguments: an lto_input_block pointing + to the buffer where to read from and a data_in instance with tables + and descriptors needed by the unpickling routines. It returns the + tree instantiated from the stream. */ + tree (*read_tree) (struct lto_input_block *, struct data_in *); }; +#define stream_write_tree(OB, EXPR, REF_P) \ + streamer_hooks.write_tree(OB, EXPR, REF_P) + +#define stream_read_tree(IB, DATA_IN) \ + streamer_hooks.read_tree(IB, DATA_IN) + /* Streamer hooks. */ extern struct streamer_hooks streamer_hooks; |