X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=ir%2Fir%2Firflag.h;h=63ccef2f13a8cdabb0ecc2d3d91eb40af9da3ca0;hb=23ea16875f38dc0c067cce24f64b5c70f3acc496;hp=295c82cfe5782397c7719758d75b1e74bf491369;hpb=8bbdf5627f63f6580f4b9cc3ec9d03a004bcb36d;p=libfirm diff --git a/ir/ir/irflag.h b/ir/ir/irflag.h index 295c82cfe..63ccef2f1 100644 --- a/ir/ir/irflag.h +++ b/ir/ir/irflag.h @@ -24,15 +24,17 @@ * transformations in several algorithms on/off. * 2. Normalization flags. * These flags steer transformations of the ir that improve it, as removing - * dump Phi nodes (one predecessor, all preds are equal ...), Ids, Tuples ... + * dump Phi nodes (one predecessor, all predecessors are equal ...), Ids, Tuples ... * 3. Verbosity flags. * a) Flags to steer the level of the information. * b) Flags to steer in which phase information should be dumped. - * + * 4. Verification flag + * This one controls the behavior of node and type verifications */ +#ifndef _FIRM_IR_IRFLAG_H_ +#define _FIRM_IR_IRFLAG_H_ -#ifndef _IRFLAG_H_ -#define _IRFLAG_H_ +#include "firm_types.h" /** * A container type to load/restore all optimizations @@ -64,8 +66,6 @@ int get_firm_verbosity (void); * - constant expression evaluation (2 + 5 ==> 7, 3 < 2 ==> false) * - algebraic simplification (a * 0 ==> 0, a or a ==> a) * - simplification of tests ( !(a < b) ==> (a >= b)) - * - refining the memory representation - * - remove store after load * Default: opt_constant_folding == 1. */ void set_opt_constant_folding (int value); @@ -93,9 +93,9 @@ void set_opt_loop_unrolling_verbose (int value); */ void set_opt_redundant_loadstore(int value); -/** Enables/Disables constant subexpression elimination. +/** Enables/Disables common subexpression elimination. * - * If opt_cse == 1 perform constant subexpression elimination. + * If opt_cse == 1 perform common subexpression elimination. * Default: opt_cse == 1. */ void set_opt_cse (int value); @@ -155,9 +155,6 @@ void set_opt_control_flow_weak_simplification(int value); /** Enables/Disables strong if and loop simplification (in optimize_cf). */ void set_opt_control_flow_strong_simplification(int value); -/** Enables/Disables removal of critical control flow edges. */ -void set_opt_critical_edges(int value); - /** Enables/Disables reassociation. * * If opt_reassociation == 1 reassociation is performed. @@ -176,11 +173,12 @@ void set_opt_dead_node_elimination (int value); * * If opt_dead_method_elimination == 1 methods never called are * removed. - * Default: opt_dead_method_elimination == 1. */ + * Default: opt_dead_method_elimination == 1. + */ void set_opt_dead_method_elimination (int value); void set_opt_dead_method_elimination_verbose (int value); -/** Enable/Disables inlining. +/** Enable/Disables method inlining. * * If opt_inline == 1 the inlining transformation is performed. */ @@ -240,7 +238,9 @@ void set_opt_if_conversion(int value); * Enable/Disable real function call optimization. * * Real function call optimization detects "real functions" and - * allows the floating of Call nodes. + * allows the floating of Call nodes. A "real function" is one that + * do only evaluate it's parameters and did not read or write memory + * to compute its results. */ void set_opt_real_function_call(int value); @@ -255,24 +255,88 @@ void set_opt_remove_confirm(int value); void set_opt_scalar_replacement(int value); void set_opt_scalar_replacement_verbose(int value); +/** + * Enable/Disable Null exception in Load and Store nodes only. + * + * If enabled, only Null pointer exception can occur at Load and + * store nodes. If it can be proved that the address input of these + * nodes is non-null, the exception edge can safely be removed. + * If disabled, other exceptions (like unaligned access, read-only memory, + * etc.) can occur. + * + * This flag is enabled by default. + */ +void set_opt_ldst_only_null_ptr_exceptions(int value); + +/** + * Enable/Disable Selection based Null pointer check elimination. + * + * In languages, where all addresses are always Sel nodes, Null + * pointers can only occur as input to Sel nodes. + * If Null pointers are the only source for exceptions in Load and + * Store nodes (as typical in high level languages), we can eliminate + * exception edges from Load and Store when can prove that the Sel + * nodes representing the Load/Store address have non-null inputs. + * Enabling this flag enables this elimination. + * + * Enabling this flag is meaningless if ldst_non_null_exceptions is + * enabled. + * + * This flags should be set for Java style languages. + */ +void set_opt_sel_based_null_check_elim(int value); + +/** + * Enable/Disable Automatic construction of Sync nodes during + * Firm construction. + * + * If this flags is set, sequential non-volatile Loads are automatically + * rearranged so that they can be executed in parallel by creating Sync nodes. + * + * This flags should be set for Java style languages. + */ +void set_opt_auto_create_sync(int value); + /** Enable/Disable normalizations of the firm representation. * - * This flag guards transformations that normalize the firm representation + * This flag guards transformations that normalize the Firm representation * as removing Ids and Tuples, useless Phis, replacing SymConst(id) by * Const(entity) and others. * The transformations guarded by this flag are not guarded by flag * "optimize". - * Many algorithms operating on firm can not deal with constructs in + * Many algorithms operating on Firm can not deal with constructs in * the non-normalized representation. - * default: 1 - * @@@ ATTENTION: not all such transformations are guarded by a flag. + * default: ON + * + * @note ATTENTION: not all such transformations are guarded by a flag. */ void set_opt_normalize (int value); - -/** Enable/Disable precise exception context. */ +/** Enable/Disable precise exception context. + * + * If enabled, all exceptions form a barrier for values, as in the + * following example: + * + * @code + * a = 1; + * b = 3 / 0; + * a = 2; + * @endcode + * + * If precise exception handling is enabled, an exception handler see a == 1, + * else it might see a == 2. + * Enable this for languages with strict exception order like Java. + */ void set_opt_precise_exc_context(int value); +/** Enable/Disable closed world assumption. + * + * If enabled, optimizations expect to know the "whole world", i.e. no + * external types or callers exist. + * This enables some powerful optimizations. + */ +void set_opt_closed_world(int value); + /** * Save the current optimization state. */ @@ -283,4 +347,26 @@ void save_optimization_state(optimization_state_t *state); */ void restore_optimization_state(const optimization_state_t *state); -#endif /* _IRFLAG_H_ */ +/** + * Switches ALL optimizations off. + */ +void all_optimizations_off(void); + +/** + * Possible verification modes. + */ +typedef enum _firm_verification_t { + FIRM_VERIFICATION_OFF = 0, /**< do not verify nodes at all */ + FIRM_VERIFICATION_ON = 1, /**< do node verification and assert on error in debug version */ + FIRM_VERIFICATION_REPORT = 2, /**< do node verification, but report to stderr only */ + FIRM_VERIFICATION_ERROR_ONLY = 3 /**< do node verification, but NEVER do assert nor report */ +} firm_verification_t; + +/** Select verification of IR nodes and types. + * + * Per default the verification is in mode NODE_VERIFICATION_ASSERT. + * Turn the verification off during development to check partial implementations. + */ +void do_node_verification(firm_verification_t mode); + +#endif /* _FIRM_IR_IRFLAG_H_ */