2 Dokumentation in ir_dump
3 Habe Routinen fuer einzelne Knoten/Kanten aus header entfernt:
4 Benutzen globale Variable die nicht oeffentlich zugaenglich ist.
7 We need an entity for the array elements for the Sel nodes. This
8 entity should be stored in the array type. Changed constructor
9 parameters: include array element type. Entity for elements is built
14 Faulty use of va_arg, became visible with new, stricter gcc 2.96.
17 Added list of member entites to union. unioned_types and delimiters
18 are superfluous now -- removed.
19 Rationale: we want to express selection of a union member as a Sel
20 node. for this we need to have entities. The entities contain the
21 unioned type and have as name the delimiters...
24 Changed Makefile/MakeTargets to install headers and libraries
28 Changed Makefile and Configure scripts to produce a proper tar file
29 for distribution (libfirm-VERSION.tar)
30 Use 'make distrib' instead of 'make dist'
33 Changed implementation of tr module. With this I also changed the
34 interface!! Type casts are unnecessary now, but some access funcions
38 ======================================================================
39 ==================== New version: 0.3.0 ==============================
40 ======================================================================
46 added creation of a tar archive for distribution
47 replaced ir/.dummy.in by ir/Makefile.in
50 Changed equivalent_node() and copy_preds() so that the end block
51 is not optimized away if it has no real predecessors. This fixes
52 the problem with the while examples.
53 Added while_example in Makefile
56 Fooled around with if_while_example: Why does cse make it abort?
57 Cse removes path to End node, Bad remains as pred of Endblock.
58 The block walker can't deal with this.
59 Made new example with only loop: while_example.
62 added auto documentation in Makefiles, configure, etc
63 example in ir/ir/ircons.c - much must be added
64 creation of documentation by 'make autodoc' in architecture directory
67 added lots of #ifdef HAVE_CONFIG_G #include "config.h" #endif
68 replaced some C++ style comments (//) by standard C comments /**/
71 - configure (with some features, see --help for more)
72 - make [depend | tags | install]
73 - make [run] in testprograms
75 - compilation on SunOS
77 - automatic call of autoconf if required
80 More colours in vcg output.
81 Fixed bug: cse found that start block equals it's
82 first successor as both have the Start block as predecessor.
83 This only happens for local_optimize_graph() as during construction
84 the Start block is not entered in the value table.
85 Changed implementation: irgmod: local_optimize_graph() did not
86 empty the hash table with the irnodes for cse. This might cause that
87 cse turns up with a node that seems better but was removed from the
88 graph in an earlier optimization phase.
89 Removed old #if 1 from ircons.c
90 Commented in call of optimization for Block nodes in irgopt.c, copy_preds():
91 Optimizes blocks that had bad predecessors.
96 Moved struct from irprog.h to irprog_t.h, same for irmode.h.
97 Added a module deb_info in debug.h. Adapted makefile. Added example
99 Removed use of debug.h in ident.c. Now debug.c|h can be moved to
101 Removed inabled code for dead node elimination in irgopt.h.
102 Renamed some missnamed access routines (_of_). Macros with old names
103 are in old_fctnames.h.
104 Edited makefiles to remove #* and *.flc.
107 Some minor bugfixes...
110 After compacting of in arrays in dead_node_elimination
111 merge blocks and remove Phis with one pred.
114 Freeing of obstack in dead_node_elimination commented in.
115 Compacting in arrays of Block and Phi nodes in dead_node_
120 added set/get_SymConst_type_or_id in irnode.h
121 added field offset to entity in entity.h
122 added field size to type_class in type.h
123 include "gmp.h" in tv.h with "" instead <>
126 Some changes to make the lib better portable
129 Initialize max_node_nr in irprog.
132 Now outputs warning if faulty type in irdump, dump_type_info.
133 Explicit string termination in irdump, vcg_open.
136 Added external to declaration of irp.
137 Added typedef before pns and pnc_number.
138 irmode.c, init_mode(): We need to memset all new modes as
139 tarval_vrfy reads fields before they are initialized: It
140 compares to min/max when tarvals for min/max are allocated!
143 Changed parameter of Methods in type.h and type.c from
144 class to clss. Class is a C++ keyword.
147 Changed some testprograms to accomodate Uebprakt.
150 Finished implementation of dump_all_types.
151 Added new testprogram inheritance_example.
154 Added seven access routines in type.[hc]:
155 get_class_n_member, get_class_n_subtype, get_class_n_supertype,
156 get_strct_n_member, add_strct_member, get_strct_member and set_strct_member.
157 Fixed the type_walk_2 for those seven routines.
160 Added irdump routine dump_all_types.
161 Did changes to irprog, type, typewalk to achieve this.
162 typewalk needs to walk along members, sub and supertypes, this
163 is still missing! irdump then needs to output these edges.
165 ======================================================================
166 ==================== New version: 0.2.5 ==============================
167 ======================================================================
170 Made new Version: 0.2.5
172 15.8.2000 Goetz until 3.9.00
173 Separated irnode.h and many others into two files: one public
175 Added funcionality to extract headers for lib.
178 type_dump also dumps irg->ent
179 if_example: corrected nr of locals
182 irgopt: Correct copy of self pointer in start block.
183 irgopt: Correct treatment of loops: pre function in walker
184 breaks all possible loops in Phi and Block nodes.
185 irr_loop_example: wrong Return statement
186 Now I fixed all but one error: in memory_example.
187 This error showed a conceptual problem, so I wrote
188 a slightly different algorithm. This now runs for
190 dead_node_example: cse is buggy!! merges start and the
194 looking at bug in dead_node_elimination.
196 irnode: all get_..._arr functions changed
197 ircons: new_r_Block: set matured flag.
198 ircons: new_r_SymConst: needs mode_p for linkage_ptr_info.
199 adapted call_str_example to new concepts.
202 Implemented simpler Phi construction algorithm that constructs
203 correct code for three_cfpred_example in ircons. This algorithm
204 generates more Id nodes than the original algorithm and therefore
206 Also made some changes to optimizations of Not.
209 Fixed a bug, caused by the recursive use in type.h and entity.h.
210 Deleted the _TYPE_TYPEDEF_ and inserted the _ENTITY_TYPEDEF_ instead.
211 Fixed a problem in if_while testprogram, so it now works.
214 Fixed bug in optimize(). Returned Null instead n if
215 get_optimize() == false.
218 Added some access routines in type.[hc]. Solved a recursive definition
219 of type_class struct, entity struct and type union.
222 Separated entity header into pure functional header and header
226 ... a bunch small changes not documented
229 Changed output of oo_prog_example: now uses the internal list
230 of all irgs. Had to implement some of the access routines for
231 that. Also fixed a bug in irdump. Main routines did not use
232 current_ir_graph properly.
235 Implemented some missing parts in irgopt.
236 Added field irg to entity. Only valid if entity is a method.
237 Had to resove a cyclic de[endency between irgraph.h and entity.h
239 Added fields sub and super to type_class for inheritance.
240 Added field main_irg to irprog.
243 Fixed some bugs in irgopt.c
244 Added some missing 'get_new_node' methods, so the new obstack contains
248 Renamed ir_vrfy to irn_vrfy and vrfy_graphg to irg_vrfy.
249 Solved some copy'n'paste problems. Deleted most debug-code!
250 Added comments to several files.
253 Fixed bug in _r_ constructors for all four Div operations.
254 Fixed bug in turn_into_tuple: didn't remember the block.
255 Tested transform_node.
258 Fixed some testprograms to new semantics of firm.
259 Added testprogram global_var_example.
260 Fixed a bug in irop: Size of Sel node was (entity *) instead of
261 sel_attr. Therefor array_heap_example aborted.
262 Also found a missing break in typewalk, case iro_Alloc.
263 Added a construct that unifies all things constructed by the lib
264 and needed to represent a program: irprog.ch
265 This contains a list of all types as well as a list of all ir graphs.
266 I added calls to initialization and constructors so that this is constructed
267 automatically. I changed firm.c, type.c, irgraph.c and ev. more.
268 Removed strange block struct and constructor from ircons.c.
269 Moved routines for automatic Phi construction from irgmod to ircons.
270 Sorted functions in ircons to reflect the different interfaces.
271 Renamed dataseg to globals to be conformant with documentation.
272 Added conservation of current_ir_graph to irgopt.c.
273 Corrected bug in Makefiles: wrong path to directory ./inlude.
276 Commented a whole bunch of stuff, e.g. in ircons.h (Procedure to construct)
277 We should change the naming of the Block constructor.
278 Removed acces routines to attr. "closed" of Block.
279 Removed second implementation of new_ir_node from ircons and some comments
280 concerned with the now resolved cyclic dependency.
281 Fixed some bugs in irgopt so that the compilation goes through.
284 Changed the irnode attribut 'visit' into 'visited'.
285 Added some access functions, like get/set_irn_visit etc.
288 Renamed some access funtion in irgraph.*.
289 Deleted two global flags (ir_visited and block_visited) from irgraph.*.
290 Added two attributes to the irgraph struct. The visited flags belongs
291 to a ir graph, not to a whole program.
294 A new optimization has been finished. The dead-node-elimination copies
295 the existing ir graph from one opstack to another. While walking the
296 graph, only the reachable nodes will be copied, so the "dead-nodes"
297 (unreachable in the controlflow) are removed.
300 Solved some problems in the 'copy_node' function. The in array was not
301 as easy as it seamed.
304 Wrote a new 'post' funtion, for future use in 'dead-node-elimination'
305 optimization, which is needed in the paramter list of 'irg_walk'.
308 Moved 'optimze_in_place_wrapper' from iropt.* tothe new files irgopt.*.
309 New functions 'local_optimze_graph' and 'dead_node_elimination' are added,
313 Removed some files from the archive, after dependencies and usage are
315 - 'ir/common/strerror.c'
317 - 'ir/ident/xx_ident.h'
318 an empty file, only included by 'ident.c', but never used;
319 - 'ir/tv/label.c' and
321 contained a numeric counter;
322 The files were included in 'tv.h' and implemented in 'tarval.c'. The two
323 functions 'tarval_label' and 'tarval_forall_labeled' were also never used.
324 In the old fiasco compiler, the label thing is used in the backend.
325 Search for 'babil' to see the usage.
326 Also removed the two attributes 'lab' and 'used' in the tarval struct.
329 Moved the 'new_ir_node' constructor from ircons.* to irnode.* and fixed
330 afterwards some recursive includes, so libfirm works again.
333 Did a lot of changes, which I never commented until now (4.7.00).
335 * Added new result to Start node: Pointer to global data segment.
336 * Extended Semantics of SymConst node to represent information for the
338 * Added arithmeitc nodes (Shrs, Minus ...)
340 Rearranged the directory structure and adjusted the makefiles.
341 The directories contain:
342 ir: everything for the intermediate representation (better: src?)
343 /ir: the ir itself, and standard optimizations.
344 /tv: the target value module
345 /tr: the type and entity representation
346 /adt: abstract data types
347 /common: stuff needed by all other dirs
348 /debug: debugging Unterstuetzung
350 include: external files needen as includes
351 testprograms: examples to test the lib.
353 The makefiles generate files with extension .d that contain the dependencies
357 Added access routine to attribute link of irnode in irnode.ch.
358 Added get_negated_pnc to irnode.ch.
361 Added an iterator in iropt that calls the optimization for all nodes.
362 Copied optimize's code to optimize_in_place and removed deallocations.
363 Made set_irn_n in irnode.c public.
364 Added Bad as possible cfg predecessor in is_cfg_node in irnode. Bads
365 are allowded as cfgpredecessors to represent dead "incoming" control
367 Added call to optimize_in_place in mature_block. Is this useful?
370 Changed tests from comparing enums to comparing pointers. This is more
371 efficient (is it?) and reads better. e.g., instead get_irn_opcode == irm_And
372 now get_irn_op == op_And
375 Compared equivalent_value to the one in the original fiasco.
376 Added a test in case iro_And.
377 Changed implementation of iro_Div. Added routines turn_into_tuple
378 and set_irn_op() in irgmod/irnode.
379 Changed implementation of irn_Minus (although commented out).
380 Now all features are ported or documented for this function.
383 Compared computed_value to the one in the original fiasco.
384 Added one further optimization in case iro_Proj.
385 Now all features are ported for this function.
388 Updated comments in ircons.h.
391 Changed possible attribute of SymConst from type_class to type.
392 SymConst size could be the size of a union, array, ...
395 Implemented two dumpers that dump type information and a graph with
399 Implemented a walker that walks over the type informatin that can
400 be reached from an ir node.
401 Added routine get_kind(firm_thing) in common.h, Added file common.c.
402 Added files typewalk.ch and routines to irdump.
403 Added visited flags and initialization to entity and all types.
404 Implemented some of the missing access routines in type.c, entity.c
407 Implemented constructor for ShrA.
409 Added routine that iterates the graph and verifies all nodes.
410 Added Phi_in stack to irgraph. This allows to build several
411 graphs at once with respect to the Phi building algorithm.
414 Implemented dumper for control flow graphs. Changed irr_* and dead_*
415 examples to dump cfg.
418 Implemeted explicit stack for the Phi node generation. See ircons.c.
421 added include string.h in xoprintf.c to get rid of warning:
422 implicit declaration of function `bcopy'
426 Added more cases to equivalent_node.
427 Portet gigo, identify, identify_remember.
428 The set/pset library can not handle several hash tables. At least,
429 compiling several procedures causes a segmentation fault during access
430 to the tables (oo_program_example). Need to work on this.
431 transform_node still needs to be ported.
432 some cases in equivalent_node are still missing.
434 To get it running I had to remove the call to optimize in the
435 new_Block constructor. It can only be called when the Block is
439 Introduced a walker that walks only over blocks. The asserts
440 might be too strict for general graphs, but so far it works.
441 For the walker I introduced an additional flag in the attribute
442 of Blocks, an a global block_visited variable (in irgraph.h).
443 Furhter I modularized dump_ir_node, implemented dump_ir_graph
444 with the existing walker, and added new routines to output a
446 Changed the examples to call the new dump routine.
449 Added auxiliary routines to ir_node:
450 skip_Proj, skip_Nop, is_Bad ...
451 Changed access routines to use get_irn_n instead of explicit array
452 accesses. Changed get_irn_n to call skip_Id, so that the access routines
453 never will return Id nodes.
456 Repaired Phi computation, changed new_r_Phi_in. Added test program to
457 test irregular controlflow.
460 Updated optimizations computed_value and equivalent_node to new
461 Syntax of FIRM nodes and to use access routines.
462 Added routine skip_Proj in irnode.
464 2.2.2000 Boris Boesler
465 Added files irgwalk.c and irgwalk.h. They include a simple function to
466 traverse an ir graph and execute pre and post functions to current node.
469 Added arrays with parameters and result types to the type informtion
470 of a procedure. This is needed for the code generation. Also added
471 the corresponding access routines.
472 Adapted the testprograms.
475 Found a bug / complication: the call order
476 get_value (makes Phi0, put's it into graph_arr)
477 set_value (overwrites Phi0 in graph_arr)
478 mature_block (upgrades Phi0, puts it again into graph_arr, overwriting
480 fails. Added test wether graph_arr is already set in phi_merge.
482 Added tons of comments to explain Phi generation -- the stack hack.
486 irdump now outputs the pnc_number for projs of Cmp nodes.
487 Added routine to access the pnc_string.
490 Added result "dataseg" to Start node, with all it's consequences.
491 We need this for the compiler lab to translate global variables.
492 Now they can be selected from the data segment, and the start
493 node supplies the pointer to this segment.
494 These changes are guarded by preprocessor variable UEBPRAKT in
496 Changed files: common.h, irgraph.ch, irnode.h
500 removed array_example, added array-heap_example and
501 array-stack_example and adapted makefile.
503 Entity now also allows type_method as owner. This is to model
504 the stack, Sel nodes that select a variable (array) from the
505 stack need an entity that describes what they select. This
506 entity gets the type of the enclosing procedure as owner.
509 Added future access routines in `irmode.[ch]' as comments,
510 that all attributes in the ir_mode struct can be user-defined.
511 Added access routines in `irgraph.[ch]', for all attributes.
514 Moved verify routines from `irgraph.[ch]' to own files `irvrfy.[ch]'.
515 Added `irvrfy.[ch]' to MAKEFILE
516 Added "inline" before access routines in `irnode.h', that no warnings
517 will appear furthermore.
518 Added three more access routines in `irmode.[ch]':
519 struct tarval *get_min_of_mode (ir_mode *mode);
520 struct tarval *get_max_of_mode (ir_mode *mode);
521 struct tarval *get_null_of_mode (ir_mode *mode);
524 Adaption of Alloc, Sel and Entity to new types:
525 Changed array_example to use type instead of type_class.
526 Changed entity to allow all types as owner instead of
527 only type_class. Added routine "assert_legal_owner_of_ent(type* type)".
528 Changed alloc to allow allocating variables of any type instead of
530 Adapted all testprograms to avoid warnings.
532 removed dtest ... from Makefile, replaced by test.
535 Added "run" to makefile, added array_example to makefile of testprograms.
536 Corrected testprogram array
537 Changed assert in irvrfy -- Conv.