GCC Middle and Back End API Reference
combine.c File Reference
#include "config.h"
#include "system.h"
#include "coretypes.h"
#include "tm.h"
#include "rtl.h"
#include "tree.h"
#include "tm_p.h"
#include "flags.h"
#include "regs.h"
#include "hard-reg-set.h"
#include "basic-block.h"
#include "insn-config.h"
#include "function.h"
#include "expr.h"
#include "insn-attr.h"
#include "recog.h"
#include "diagnostic-core.h"
#include "target.h"
#include "optabs.h"
#include "insn-codes.h"
#include "rtlhooks-def.h"
#include "params.h"
#include "tree-pass.h"
#include "df.h"
#include "valtrack.h"
#include "cgraph.h"
#include "obstack.h"
Include dependency graph for combine.c:

Data Structures

struct  reg_stat_struct
struct  insn_link
struct  undo
struct  undobuf
struct  likely_spilled_retval_info

Macros

#define INSN_COST(INSN)   (uid_insn_cost[INSN_UID (INSN)])
#define LOG_LINKS(INSN)   (uid_log_links[INSN_UID (INSN)])
#define FOR_EACH_LOG_LINK(L, INSN)   for ((L) = LOG_LINKS (INSN); (L); (L) = (L)->next)
#define RTL_HOOKS_GEN_LOWPART   gen_lowpart_for_combine
#define RTL_HOOKS_GEN_LOWPART_NO_EMIT   gen_lowpart_for_combine
#define RTL_HOOKS_REG_NONZERO_REG_BITS   reg_nonzero_bits_for_combine
#define RTL_HOOKS_REG_NUM_SIGN_BIT_COPIES   reg_num_sign_bit_copies_for_combine
#define RTL_HOOKS_REG_TRUNCATED_TO_MODE   reg_truncated_to_mode
#define SUBST(INTO, NEWVAL)   do_SUBST (&(INTO), (NEWVAL))
#define SUBST_INT(INTO, NEWVAL)   do_SUBST_INT (&(INTO), (NEWVAL))
#define SUBST_MODE(INTO, NEWVAL)   do_SUBST_MODE (&(INTO), (NEWVAL))
#define SUBST_LINK(oldval, newval)   do_SUBST_LINK (&oldval, newval)
#define COMBINE_RTX_EQUAL_P(X, Y)

Typedefs

typedef struct reg_stat_struct reg_stat_type

Enumerations

enum  undo_kind { UNDO_RTX, UNDO_INT, UNDO_MODE, UNDO_LINKS }

Functions

static struct insn_linkalloc_insn_link ()
static rtx reg_nonzero_bits_for_combine (const_rtx, enum machine_mode, const_rtx, enum machine_mode, unsigned HOST_WIDE_INT, unsigned HOST_WIDE_INT *)
static rtx reg_num_sign_bit_copies_for_combine (const_rtx, enum machine_mode, const_rtx, enum machine_mode, unsigned int, unsigned int *)
static void do_SUBST (rtx *, rtx)
static void do_SUBST_INT (int *, int)
static void init_reg_last (void)
static void setup_incoming_promotions (rtx)
static void set_nonzero_bits_and_sign_copies (rtx, const_rtx, void *)
static int cant_combine_insn_p (rtx)
static int can_combine_p (rtx, rtx, rtx, rtx, rtx, rtx, rtx *, rtx *)
static int combinable_i3pat (rtx, rtx *, rtx, rtx, rtx, int, int, rtx *)
static int contains_muldiv (rtx)
static rtx try_combine (rtx, rtx, rtx, rtx, int *, rtx)
static void undo_all (void)
static void undo_commit (void)
static rtxfind_split_point (rtx *, rtx, bool)
static rtx subst (rtx, rtx, rtx, int, int, int)
static rtx combine_simplify_rtx (rtx, enum machine_mode, int, int)
static rtx simplify_if_then_else (rtx)
static rtx simplify_set (rtx)
static rtx simplify_logical (rtx)
static rtx expand_compound_operation (rtx)
static const_rtx expand_field_assignment (const_rtx)
static rtx make_extraction (enum machine_mode, rtx, HOST_WIDE_INT, rtx, unsigned HOST_WIDE_INT, int, int, int)
static rtx extract_left_shift (rtx, int)
static int get_pos_from_mask (unsigned HOST_WIDE_INT, unsigned HOST_WIDE_INT *)
static rtx canon_reg_for_combine (rtx, rtx)
static rtx force_to_mode (rtx, enum machine_mode, unsigned HOST_WIDE_INT, int)
static rtx if_then_else_cond (rtx, rtx *, rtx *)
static rtx known_cond (rtx, enum rtx_code, rtx, rtx)
static int rtx_equal_for_field_assignment_p (rtx, rtx)
static rtx make_field_assignment (rtx)
static rtx apply_distributive_law (rtx)
static rtx distribute_and_simplify_rtx (rtx, int)
static rtx simplify_and_const_int_1 (enum machine_mode, rtx, unsigned HOST_WIDE_INT)
static rtx simplify_and_const_int (rtx, enum machine_mode, rtx, unsigned HOST_WIDE_INT)
static int merge_outer_ops (enum rtx_code *, HOST_WIDE_INT *, enum rtx_code, HOST_WIDE_INT, enum machine_mode, int *)
static rtx simplify_shift_const_1 (enum rtx_code, enum machine_mode, rtx, int)
static rtx simplify_shift_const (rtx, enum rtx_code, enum machine_mode, rtx, int)
static int recog_for_combine (rtx *, rtx, rtx *)
static rtx gen_lowpart_for_combine (enum machine_mode, rtx)
static enum rtx_code simplify_compare_const (enum rtx_code, rtx, rtx *)
static enum rtx_code simplify_comparison (enum rtx_code, rtx *, rtx *)
static void update_table_tick (rtx)
static void record_value_for_reg (rtx, rtx, rtx)
static void check_promoted_subreg (rtx, rtx)
static void record_dead_and_set_regs_1 (rtx, const_rtx, void *)
static void record_dead_and_set_regs (rtx)
static int get_last_value_validate (rtx *, rtx, int, int)
static rtx get_last_value (const_rtx)
static int use_crosses_set_p (const_rtx, int)
static void reg_dead_at_p_1 (rtx, const_rtx, void *)
static int reg_dead_at_p (rtx, rtx)
static void move_deaths (rtx, rtx, int, rtx, rtx *)
static int reg_bitfield_target_p (rtx, rtx)
static void distribute_notes (rtx, rtx, rtx, rtx, rtx, rtx, rtx)
static void distribute_links (struct insn_link *)
static void mark_used_regs_combine (rtx)
static void record_promoted_value (rtx, rtx)
static int unmentioned_reg_p_1 (rtx *, void *)
static bool unmentioned_reg_p (rtx, rtx)
static int record_truncated_value (rtx *, void *)
static void record_truncated_values (rtx *, void *)
static bool reg_truncated_to_mode (enum machine_mode, const_rtx)
static rtx gen_lowpart_or_truncate (enum machine_mode, rtx)
static void target_canonicalize_comparison (enum rtx_code *code, rtx *op0, rtx *op1, bool op0_preserve_value)
static rtx combine_split_insns ()
static rtxfind_single_use_1 ()
static rtxfind_single_use ()
static void do_SUBST ()
static void do_SUBST_INT ()
static void do_SUBST_MODE ()
static void do_SUBST_LINK ()
static bool combine_validate_cost (rtx i0, rtx i1, rtx i2, rtx i3, rtx newpat, rtx newi2pat, rtx newotherpat)
static void delete_noop_moves ()
static void create_log_links ()
static bool insn_a_feeds_b ()
static int combine_instructions ()
static void setup_incoming_promotions ()
static void set_nonzero_bits_and_sign_copies ()
static int contains_muldiv ()
static int cant_combine_insn_p ()
static void likely_spilled_retval_1 ()
static int likely_spilled_retval_p ()
static void adjust_for_new_dest ()
static bool can_change_dest_mode ()
static bool reg_subword_p ()
static void update_cfg_for_uncondjump ()
static rtxfind_split_point ()
static rtx subst ()
static rtx simplify_if_then_else ()
static rtx simplify_set ()
static rtx simplify_logical ()
static rtx expand_compound_operation ()
static const_rtx expand_field_assignment ()
static rtx extract_left_shift ()
rtx make_compound_operation ()
static int get_pos_from_mask ()
static rtx canon_reg_for_combine ()
static rtx gen_lowpart_or_truncate ()
static rtx if_then_else_cond ()
static rtx known_cond ()
static int rtx_equal_for_field_assignment_p ()
static rtx make_field_assignment ()
static rtx apply_distributive_law ()
static rtx distribute_and_simplify_rtx ()
unsigned int extended_count ()
static int merge_outer_ops ()
static enum machine_mode try_widen_shift_mode (enum rtx_code code, rtx op, int count, enum machine_mode orig_mode, enum machine_mode mode, enum rtx_code outer_code, HOST_WIDE_INT outer_const)
static int recog_for_combine ()
static rtx gen_lowpart_for_combine ()
static enum rtx_code simplify_compare_const ()
static enum rtx_code simplify_comparison ()
static int count_rtxs ()
static void update_table_tick ()
static void record_value_for_reg ()
static void record_dead_and_set_regs_1 ()
static void record_dead_and_set_regs ()
static void record_promoted_value ()
static bool reg_truncated_to_mode ()
static int record_truncated_value ()
static void record_truncated_values ()
static void check_promoted_subreg ()
static int get_last_value_validate ()
static rtx get_last_value ()
static int use_crosses_set_p ()
static void reg_dead_at_p_1 ()
static int reg_dead_at_p ()
static void mark_used_regs_combine ()
rtx remove_death ()
static int reg_bitfield_target_p ()
static void distribute_links ()
static int unmentioned_reg_p_1 ()
static bool unmentioned_reg_p ()
DEBUG_FUNCTION void dump_combine_stats ()
void dump_combine_total_stats ()
static bool gate_handle_combine ()
static unsigned int rest_of_handle_combine ()
rtl_opt_passmake_pass_combine ()

Variables

static int combine_attempts
static int combine_merges
static int combine_extras
static int combine_successes
static int total_attempts
static int total_merges
static int total_extras
static int total_successes
static rtx i2mod
static rtx i2mod_old_rhs
static rtx i2mod_new_rhs
static vec< reg_stat_typereg_stat
static int mem_last_set
static int last_call_luid
static rtx subst_insn
static int subst_low_luid
static HARD_REG_SET newpat_used_regs
static rtx added_links_insn
static basic_block this_basic_block
static bool optimize_this_for_speed_p
static int max_uid_known
static int * uid_insn_cost
static struct insn_link ** uid_log_links
static struct obstack insn_link_obstack
static int label_tick
static int label_tick_ebb_start
static enum machine_mode nonzero_bits_mode
static int nonzero_sign_valid
static struct undobuf undobuf
static int n_occurrences
static struct rtl_hooks combine_rtl_hooks = RTL_HOOKS_INITIALIZER
static unsigned int reg_dead_regno
static unsigned int reg_dead_endregno
static int reg_dead_flag

Macro Definition Documentation

#define COMBINE_RTX_EQUAL_P (   X,
  Y 
)
Value:
((X) == (Y) \
|| (REG_P (X) && REG_P (Y) \
&& REGNO (X) == REGNO (Y) && GET_MODE (X) == GET_MODE (Y)))
#define FOR_EACH_LOG_LINK (   L,
  INSN 
)    for ((L) = LOG_LINKS (INSN); (L); (L) = (L)->next)

Referenced by create_log_links().

#define INSN_COST (   INSN)    (uid_insn_cost[INSN_UID (INSN)])

Referenced by do_SUBST_MODE().

#define LOG_LINKS (   INSN)    (uid_log_links[INSN_UID (INSN)])

Referenced by create_log_links().

#define RTL_HOOKS_GEN_LOWPART   gen_lowpart_for_combine

It is not safe to use ordinary gen_lowpart in combine. See comments in gen_lowpart_for_combine.

#define RTL_HOOKS_GEN_LOWPART_NO_EMIT   gen_lowpart_for_combine

Our implementation of gen_lowpart never emits a new pseudo.

#define RTL_HOOKS_REG_NONZERO_REG_BITS   reg_nonzero_bits_for_combine
#define RTL_HOOKS_REG_NUM_SIGN_BIT_COPIES   reg_num_sign_bit_copies_for_combine
#define RTL_HOOKS_REG_TRUNCATED_TO_MODE   reg_truncated_to_mode
#define SUBST (   INTO,
  NEWVAL 
)    do_SUBST (&(INTO), (NEWVAL))
#define SUBST_INT (   INTO,
  NEWVAL 
)    do_SUBST_INT (&(INTO), (NEWVAL))
#define SUBST_LINK (   oldval,
  newval 
)    do_SUBST_LINK (&oldval, newval)
#define SUBST_MODE (   INTO,
  NEWVAL 
)    do_SUBST_MODE (&(INTO), (NEWVAL))

Typedef Documentation


Enumeration Type Documentation

enum undo_kind

Record one modification to rtl structure to be undone by storing old_contents into *where.

Enumerator:
UNDO_RTX 
UNDO_INT 
UNDO_MODE 
UNDO_LINKS 

Function Documentation

static void adjust_for_new_dest ( )
static

Adjust INSN after we made a change to its destination.

Changing the destination can invalidate notes that say something about the results of the insn and a LOG_LINK pointing to the insn.

For notes, be conservative and simply remove them.

 The new insn will have a destination that was previously the destination
 of an insn just above it.  Call distribute_links to make a LOG_LINK from
 the next use of that destination.   

References CONSTANT_P, SET_SRC, and single_set.

static struct insn_link* alloc_insn_link ( )
staticread

Allocate a link.

References UNDO_INT, UNDO_LINKS, UNDO_MODE, and UNDO_RTX.

Referenced by create_log_links().

static rtx apply_distributive_law ( rtx  )
static
static rtx apply_distributive_law ( )
static

See if X is of the form (+ (* a c) (* b c)) and convert to (* (+ a b) c) if so.

 Distributivity is not true for floating point as it can change the
 value.  So we don't do it unless -funsafe-math-optimizations.   
 The outer operation can only be one of the following:   
 If either operand is a primitive we can't do anything, so get out
 fast.   
 See if the inner and outer operations distribute.   
     These all distribute except over PLUS.   
     This is also a multiply, so it distributes over everything.   
   This used to handle SUBREG, but this turned out to be counter-
   productive, since (subreg (op ...)) usually is not handled by
   insn patterns, and this "optimization" therefore transformed
   recognizable patterns into unrecognizable ones.  Therefore the
   SUBREG case was removed from here.

   It is possible that distributing SUBREG over arithmetic operations
   leads to an intermediate result than can then be optimized further,
   e.g. by moving the outer SUBREG to the other side of a SET as done
   in simplify_set.  This seems to have been the original intent of
   handling SUBREGs here.

   However, with current GCC this does not appear to actually happen,
   at least on major platforms.  If some case is found where removing
   the SUBREG case here prevents follow-on optimizations, distributing
   SUBREGs ought to be re-added at that place, e.g. in simplify_set.   
 Set LHS and RHS to the inner operands (A and B in the example
 above) and set OTHER to the common operand (C in the example).
 There is only one way to do this unless the inner operation is
 commutative.   
 Form the new inner operation, seeing if it simplifies first.   
 There is one exception to the general way of distributing:
 (a | c) ^ (b | c) -> (a ^ b) & ~c   
 We may be able to continuing distributing the result, so call
 ourselves recursively on the inner operation before forming the
 outer operation, which we return.   
static bool can_change_dest_mode ( )
static

Return TRUE if combine can reuse reg X in mode MODE. ADDED_SETS is nonzero if the original set is still required.

Allow hard registers if the new mode is legal, and occupies no more registers than the old mode.

 Or a pseudo that is only used once.   
static int can_combine_p ( rtx  insn,
rtx  i3,
rtx  pred,
rtx  pred2,
rtx  succ,
rtx  succ2,
rtx pdest,
rtx psrc 
)
static

See if INSN can be combined into I3. PRED, PRED2, SUCC and SUCC2 are optionally insns that were previously combined into I3 or that will be combined into the merger of INSN and I3. The order is PRED, PRED2, INSN, SUCC, SUCC2, I3.

Return 0 if the combination is not allowed for any reason.

If the combination is allowed, *PDEST will be set to the single destination of INSN and *PSRC to the single source, and this function will return 1.

 Can combine only if previous insn is a SET of a REG, a SUBREG or CC0.
 or a PARALLEL consisting of such a SET and CLOBBERs.

 If INSN has CLOBBER parallel parts, ignore them for our processing.
 By definition, these happen during the execution of the insn.  When it
 is merged with another insn, all bets are off.  If they are, in fact,
 needed and aren't also supplied in I3, they may be added by
 recog_for_combine.  Otherwise, it won't match.

 We can also ignore a SET whose SET_DEST is mentioned in a REG_UNUSED
 note.

 Get the source and destination of INSN.  If more than one, can't
 combine.   
           This is important to combine floating point insns
           for the SH4 port.   
             Combining an isolated USE doesn't make sense.
             We depend here on combinable_i3pat to reject them.   
             The code below this loop only verifies that the inputs of
             the SET in INSN do not change.  We call reg_set_between_p
             to verify that the REG in the USE does not change between
             I3 and INSN.
             If the USE in INSN was for a pseudo register, the matching
             insn pattern will likely match any register; combining this
             with any other USE would only be safe if we knew that the
             used registers have identical values, or if there was
             something to tell them apart, e.g. different modes.  For
             now, we forgo such complicated tests and simply disallow
             combining of USES of pseudo registers with any other USE.   
             We can ignore CLOBBERs.   
             Ignore SETs whose result isn't used but not those that
             have side-effects.   
             If we have already found a SET, this is a second one and
             so we cannot combine with this insn.   
             Anything else means we can't combine.   
         If SET_SRC is an ASM_OPERANDS we can't throw away these CLOBBERs,
         so don't do anything with it.   
 The simplification in expand_field_assignment may call back to
 get_last_value, so set safe guard here.   
 Don't eliminate a store in the stack pointer.   
     Don't combine with an insn that sets a register to itself if it has
     a REG_EQUAL note.  This may be part of a LIBCALL sequence.   
     Can't merge an ASM_OPERANDS.   
     Can't merge a function call.   
     Don't eliminate a function call argument.   
     Don't substitute into an incremented register.   
     Don't substitute into a non-local goto, this confuses CFG.   
     Make sure that DEST is not used after SUCC but before I3.   
     Make sure that the value that is to be substituted for the register
     does not use any registers whose values alter in between.  However,
     If the insns are adjacent, a use can't cross a set even though we
     think it might (this can happen for a sequence of insns each setting
     the same destination; last_set of that register might point to
     a NOTE).  If INSN has a REG_EQUIV note, the register is always
     equivalent to the memory so the substitution is valid even if there
     are intervening stores.  Also, don't move a volatile asm or
     UNSPEC_VOLATILE across any other insns.   
     Don't combine across a CALL_INSN, because that would possibly
     change whether the life span of some REGs crosses calls or not,
     and it is a pain to update that information.
     Exception: if source is a constant, moving it later can't hurt.
     Accept that as a special case.   
 DEST must either be a REG or CC0.   
     If register alignment is being enforced for multi-word items in all
     cases except for parameters, it is possible to have a register copy
     insn referencing a hard register that is not allowed to contain the
     mode being copied and which would not be valid as an operand of most
     insns.  Eliminate this problem by not combining with such an insn.

     Also, on some machines we don't want to extend the life of a hard
     register.   
             Don't extend the life of a hard register unless it is
             user variable (if we have few registers) or it can't
             fit into the desired register (meaning something special
             is going on).
             Also avoid substituting a return register into I3, because
             reload can't handle a conflict with constraints of other
             inputs.   
         Don't substitute for a register intended as a clobberable
         operand.   
         If the clobber represents an earlyclobber operand, we must not
         substitute an expression containing the clobbered register.
         As we do not analyze the constraint strings here, we have to
         make the conservative assumption.  However, if the register is
         a fixed hard reg, the clobber cannot represent any operand;
         we leave it up to the machine description to either accept or
         reject use-and-clobber patterns.   
 If INSN contains anything volatile, or is an `asm' (whether volatile
 or not), reject, unless nothing volatile comes between it and I3  
     Make sure neither succ nor succ2 contains a volatile reference.   
     We'll check insns between INSN and I3 below.   
 If INSN is an asm, and DEST is a hard register, reject, since it has
 to be an explicit register variable, and was chosen for a reason.   
 If INSN contains volatile references (specifically volatile MEMs),
 we cannot combine across any other volatile references.
 Even if INSN doesn't contain volatile references, any intervening
 volatile insn might affect machine state.   
 If INSN contains an autoincrement or autodecrement, make sure that
 register is not used between there and I3, and not already used in
 I3 either.  Neither must it be used in PRED or SUCC, if they exist.
 Also insist that I3 not be a jump; if it were one
 and the incremented register were spilled, we would lose.   
 If we get here, we have passed all the tests and the combination is
 to be allowed.   
static rtx canon_reg_for_combine ( rtx  ,
rtx   
)
static
static rtx canon_reg_for_combine ( )
static

If X refers to a register that equals REG in value, replace these references with REG.

fall through

static int cant_combine_insn_p ( rtx  )
static
static int cant_combine_insn_p ( )
static

Determine whether INSN can be used in a combination. Return nonzero if not. This is used in try_combine to detect early some cases where we can't perform combinations.

If this isn't really an insn, we can't do anything. This can occur when flow deletes an insn that it has merged into an auto-increment address.

 Never combine loads and stores involving hard regs that are likely
 to be spilled.  The register allocator can usually handle such
 reg-reg moves by tying.  If we allow the combiner to make
 substitutions of likely-spilled regs, reload might die.
 As an exception, we allow combinations involving fixed regs; these are
 not available to the register allocator so there's no risk involved.   
static void check_promoted_subreg ( rtx  ,
rtx   
)
static
static void check_promoted_subreg ( )
static

Scan X for promoted SUBREGs. For each one found, note what it implies to the registers used in it.

static int combinable_i3pat ( rtx  i3,
rtx loc,
rtx  i2dest,
rtx  i1dest,
rtx  i0dest,
int  i1_not_in_src,
int  i0_not_in_src,
rtx pi3dest_killed 
)
static

LOC is the location within I3 that contains its pattern or the component of a PARALLEL of the pattern. We validate that it is valid for combining.

One problem is if I3 modifies its output, as opposed to replacing it entirely, we can't allow the output to contain I2DEST, I1DEST or I0DEST as doing so would produce an insn that is not equivalent to the original insns.

Consider:

  (set (reg:DI 101) (reg:DI 100))
  (set (subreg:SI (reg:DI 101) 0) <foo>)

This is NOT equivalent to:

  (parallel [(set (subreg:SI (reg:DI 100) 0) <foo>)
             (set (reg:DI 101) (reg:DI 100))])

Not only does this modify 100 (in which case it might still be valid if 100 were dead in I2), it sets 101 to the ORIGINAL value of 100.

We can also run into a problem if I2 sets a register that I1 uses and I1 gets directly substituted into I3 (not via I2). In that case, we would be getting the wrong value of I2DEST into I3, so we must reject the combination. This case occurs when I2 and I1 both feed into I3, rather than when I1 feeds into I2, which feeds into I3. If I1_NOT_IN_SRC is nonzero, it means that finding I1 in the source of a SET must prevent combination from occurring. The same situation can occur for I0, in which case I0_NOT_IN_SRC is set.

Before doing the above check, we first try to expand a field assignment into a set of logical operations.

If PI3_DEST_KILLED is nonzero, it is a pointer to a location in which we place a register that is both set and used within I3. If more than one such register is detected, we fail.

Return 1 if the combination is valid, zero otherwise.

     Check for the case where I3 modifies its output, as discussed
     above.  We don't want to prevent pseudos from being combined
     into the address of a MEM, so only prevent the combination if
     i1 or i2 set the same MEM.   
         This is the same test done in can_combine_p except we can't test
         all_adjacent; we don't have to, since this instruction will stay
         in place, thus we are not considering increasing the lifetime of
         INNER_DEST.

         Also, if this insn sets a function argument, combining it with
         something that might need a spill could clobber a previous
         function argument; the all_adjacent test in can_combine_p also
         checks this; here, we do a more specific test for this case.   
     If DEST is used in I3, it is being killed in this insn, so
     record that for later.  We have to consider paradoxical
     subregs here, since they kill the whole register, but we
     ignore partial subregs, STRICT_LOW_PART, etc.
     Never add REG_DEAD notes for the FRAME_POINTER_REGNUM or the
     STACK_POINTER_REGNUM, since these are always considered to be
     live.  Similarly for ARG_POINTER_REGNUM if it is fixed.   

References targetm.

static int combine_instructions ( )
static

Main entry point for combiner. F is the first insn of the function. NREGS is the first unused pseudo-reg number.

Return nonzero if the combiner has turned an indirect jump instruction into a direct jump.

 Allocate array for insn info.   
 Don't use reg_stat[].nonzero_bits when computing it.  This can cause
 problems when, for example, we have j <<= 1 in a loop.   
 Scan all SETs and see if we can deduce anything about what
 bits are known to be zero for some registers and how many copies
 of the sign bit are known to exist for those registers.

 Also set any known values so that we can use it while searching
 for what bits are known to be set.   
 Allow the entry block and the first block to fall into the same EBB.
 Conceptually the incoming promotions are assigned to the entry block.   
           Record the current insn_rtx_cost of this instruction.   
 Now scan all the insns in forward order.   
             See if we know about function return values before this
             insn based upon SUBREG flags.   
             See if we can find hardregs and subreg of pseudos in
             narrower modes.  This could help turning TRUNCATEs
             into SUBREGs.   
             Try this insn with each insn it links back to.   
             Try each sequence of three linked insns ending with this one.   
                 If the linked insn has been replaced by a note, then there
                 is no point in pursuing this chain any further.   
             Try combining an insn with two different insns whose results it
             uses.   
             Try four-instruction combinations.   
                 If the linked insn has been replaced by a note, then there
                 is no point in pursuing this chain any further.   
                     I0 -> I1 -> I2 -> I3.   
                     I0, I1 -> I2, I2 -> I3.   
                     I0 -> I2; I1, I2 -> I3.   
                     I0 -> I1; I1, I2 -> I3.   
             Try this insn with each REG_EQUAL note it links back to.   
                     Avoid using a register that may already been marked
                     dead by an earlier instruction.   
                     Temporarily replace the set's source with the
                     contents of the REG_EQUAL note.  The insn will
                     be deleted or recognized by try_combine.   
 Clean up.   
 Make recognizer allow volatile MEMs again.   
static rtx combine_simplify_rtx ( rtx  x,
enum machine_mode  op0_mode,
int  in_dest,
int  in_cond 
)
static

Simplify X, a piece of RTL. We just operate on the expression at the outer level; call `subst' to simplify recursively. Return the new expression.

OP0_MODE is the original mode of XEXP (x, 0). IN_DEST is nonzero if we are inside a SET_DEST. IN_COND is nonzero if we are at the top level of a condition.

 If this is a commutative operation, put a constant last and a complex
 expression first.  We don't need to do this for comparisons here.   
 If this is a simple operation applied to an IF_THEN_ELSE, try
 applying it to the arms of the IF_THEN_ELSE.  This often simplifies
 things.  Check for cases where both arms are testing the same
 condition.

 Don't do anything if all operands are very simple.   
         If everything is a comparison, what we have is highly unlikely
         to be simpler, so don't use it.   
         Simplify the alternative arms; this may collapse the true and
         false arms to store-flag values.  Be careful to use copy_rtx
         here since true_rtx or false_rtx might share RTL with x as a
         result of the if_then_else_cond call above.   
         If true_rtx and false_rtx are not general_operands, an if_then_else
         is unlikely to be simpler.   
             Restarting if we generate a store-flag expression will cause
             us to loop.  Just drop through in this case.   
             If the result values are STORE_FLAG_VALUE and zero, we can
             just make the comparison operation.   
             Likewise, we can make the negate of a comparison operation
             if the result values are - STORE_FLAG_VALUE and zero.   
 Try to fold this expression in case we have constants that weren't
 present before.   
 First see if we can apply the inverse distributive law.   
 If CODE is an associative operation not otherwise handled, see if we
 can associate some operands.  This can win if they are constants or
 if they are logically related (i.e. (a & b) & a).   
         Make sure we pass the constant operand if any as the second
         one if this is a commutative operation.   
         For commutative operations, try the other pair if that one
         didn't simplify.   
 A little bit of algebraic simplification here.   
     Ensure that our address has any ASHIFTs converted to MULT in case
     address-recognizing predicates are called later.   
     See if this can be moved to simplify_subreg.   
            Don't call gen_lowpart if the inner mode
            is VOIDmode and we cannot simplify it, as SUBREG without
            inner mode is invalid.   
       If op is known to have all lower bits zero, the result is zero.   
     Don't change the mode of the MEM if that would change the meaning
     of the address.   
     Note that we cannot do any narrowing for non-constants since
     we might have been counting on using the fact that some bits were
     zero.  We now do this in the SET.   
     For C equal to the width of MODE minus 1, (neg (ashiftrt X C)) can be
     replaced by (lshiftrt X C).  This will convert
     (neg (sign_extract X 1 Y)) to (zero_extract X 1 Y).   
     If X has only a single bit that might be nonzero, say, bit I, convert
     (neg X) to (ashiftrt (ashift X C-I) C-I) where C is the bitsize of
     MODE minus 1.  This will convert (neg (zero_extract X 1 Y)) to
     (sign_extract X 1 Y).  But only do this if TEMP isn't a register
     or a SUBREG of one since we'd be making the expression more
     complex if it was just a register.   
         If all we did was surround TEMP with the two shifts, we
         haven't improved anything, so don't use it.  Otherwise,
         we are better off with TEMP1.   
     We can't handle truncation to a partial integer mode here
     because we don't know the real bitsize of the partial
     integer mode.   
     We can truncate a constant value and return it.   
     Similarly to what we do in simplify-rtx.c, a truncate of a register
     whose value is a comparison can be replaced with a subreg if
     STORE_FLAG_VALUE permits.   
     (const (const X)) can become (const X).  Do it this way rather than
     returning the inner CONST since CONST can be shared with a
     REG_EQUAL note.   
     (plus (xor (and <foo> (const_int pow2 - 1)) <c>) <-c>)
     when c is (const_int (pow2 + 1) / 2) is a sign extension of a
     bit-field and can be replaced by either a sign_extend or a
     sign_extract.  The `and' may be a zero_extend and the two
     <c>, -<c> constants may be reversed.   
     If only the low-order bit of X is possibly nonzero, (plus x -1)
     can become (ashiftrt (ashift (xor x 1) C) C) where C is
     the bitsize of the mode - 1.  This allows simplification of
     "a = (b & 8) == 0;"   
     If we are adding two things that have no bits in common, convert
     the addition into an IOR.  This will often be further simplified,
     for example in cases like ((a & 1) + (a & 2)), which can
     become a & 3.   
         Try to simplify the expression further.   
         If we could, great.  If not, do not go ahead with the IOR
         replacement, since PLUS appears in many special purpose
         address arithmetic instructions.   
     (minus <foo> (and <foo> (const_int -pow2))) becomes
     (and <foo> (const_int pow2-1))   
     If we have (mult (plus A B) C), apply the distributive law and then
     the inverse distributive law to see if things simplify.  This
     occurs mostly in addresses, often when unrolling loops.   
     Try simplify a*(b/c) as (a*b)/c.   
     If this is a divide by a power of two, treat it as a shift if
     its first operand is a shift.   
     If the first operand is a condition code, we can't do anything
     with it.   
         Simplify our comparison, if possible.   
         If STORE_FLAG_VALUE is 1, we can convert (ne x 0) to simply X
         if only the low-order bit is possibly nonzero in X (such as when
         X is a ZERO_EXTRACT of one bit).  Similarly, we can convert EQ to
         (xor X 1) or (minus 1 X); we use the former.  Finally, if X is
         known to be either 0 or -1, NE becomes a NEG and EQ becomes
         (plus X 1).

         Remove any ZERO_EXTRACT we made when thinking this was a
         comparison.  It may now be simpler to use, e.g., an AND.  If a
         ZERO_EXTRACT is indeed appropriate, it will be placed back by
         the call to make_compound_operation in the SET case.

         Don't apply these optimizations if the caller would
         prefer a comparison rather than a value.
         E.g., for the condition in an IF_THEN_ELSE most targets need
         an explicit comparison.   
         If STORE_FLAG_VALUE is -1, we have cases similar to
         those above.   
         If X is 0/1, (eq X 0) is X-1.   
         If STORE_FLAG_VALUE says to just test the sign bit and X has just
         one bit that might be nonzero, we can convert (ne x 0) to
         (ashift x c) where C puts the bit in the sign bit.  Remove any
         AND with STORE_FLAG_VALUE when we are done, since we are only
         going to test the sign bit.   
         If the code changed, return a whole new comparison.
         We also need to avoid using SUBST in cases where
         simplify_comparison has widened a comparison with a CONST_INT,
         since in that case the wider CONST_INT may fail the sanity
         checks in do_SUBST.   
         Otherwise, keep this operation, but maybe change its operands.
         This also converts (ne (compare FOO BAR) 0) to (ne FOO BAR).   
     If we are processing SET_DEST, we are done.   
     If this is a shift by a constant amount, simplify it.   
static rtx combine_split_insns ( )
static

Try to split PATTERN found in INSN. This returns NULL_RTX if PATTERN can not be split. Otherwise, it returns an insn sequence. This is a wrapper around split_insns which ensures that the reg_stat vector is made larger if the splitter creates a new register.

static bool combine_validate_cost ( rtx  i0,
rtx  i1,
rtx  i2,
rtx  i3,
rtx  newpat,
rtx  newi2pat,
rtx  newotherpat 
)
static

Subroutine of try_combine. Determine whether the replacement patterns NEWPAT, NEWI2PAT and NEWOTHERPAT are cheaper according to insn_rtx_cost than the original sequence I0, I1, I2, I3 and undobuf.other_insn. Note that I0, I1 and/or NEWI2PAT may be NULL_RTX. Similarly, NEWOTHERPAT and undobuf.other_insn may also both be NULL_RTX. Return false if the cost of all the instructions can be estimated and the replacements are more expensive than the original sequence.

 Lookup the original insn_rtx_costs.   
 Calculate the replacement insn_rtx_costs.   
 Disallow this combination if both new_cost and old_cost are greater than
 zero, and new_cost is greater than old cost.   
 Update the uid_insn_cost array with the replacement costs.   
static int contains_muldiv ( rtx  )
static
static int contains_muldiv ( )
static

Return 1 if X is an arithmetic expression that contains a multiplication and division. We don't count multiplications by powers of two here.

static int count_rtxs ( )
static

Utility function for record_value_for_reg. Count number of rtxs in X.

static void create_log_links ( )
static

Fill in log links field for all insns.

 Pass through each block from the end, recording the uses of each
 register and establishing log links when def is encountered.
 Note that we do not clear next_use array in order to save time,
 so we have to test whether the use is in the same basic block as def.

 There are a few cases below when we do not consider the definition or
 usage &ndash; these are taken from original flow.c did. Don't ask me why it is
 done this way; I don't know and if it works, I don't want to know.   
         Log links are created only once.   
             Do not consider if it is pre/post modification in MEM.   
             Do not make the log link for frame pointer.   
                 flow.c claimed:

                 We don't build a LOG_LINK for hard registers contained
                 in ASM_OPERANDs.  If these registers get replaced,
                 we might wind up changing the semantics of the insn,
                 even if reload can make what appear to be valid
                 assignments later.   
                     Don't add duplicate links between instructions.   
             Do not consider the usage of the stack pointer
             by function call.   

References alloc_insn_link(), FOR_EACH_LOG_LINK, insn_link::insn, and LOG_LINKS.

static void delete_noop_moves ( )
static

Delete any insns that copy a register to itself.

static rtx distribute_and_simplify_rtx ( rtx  ,
int   
)
static
static rtx distribute_and_simplify_rtx ( )
static

See if X is of the form (* (+ A B) C), and if so convert to (+ (* A C) (* B C)) and try to simplify.

Most of the time, this results in no change. However, if some of the operands are the same or inverses of each other, simplifications will result.

For example, (and (ior A B) (not B)) can occur as the result of expanding a bit field assignment. When we apply the distributive law to this, we get (ior (and (A (not B))) (and (B (not B)))), which then simplifies to (and (A (not B))).

Note that no checks happen on the validity of applying the inverse distributive law. This is pointless since we can do it in the few places where this routine is called.

N is the index of the term that is decomposed (the arithmetic operation, i.e. (+ A B) in the first example above). !N is the index of the term that is distributed, i.e. of C in the first example above.

 Distributivity is not true for floating point as it can change the
 value.  So we don't do it unless -funsafe-math-optimizations.   
 Special case (and (xor B C) (not A)), which is equivalent to
 (xor (ior A B) (ior A C))   
     Distribute the second term.   
     Distribute the first term.   

References adjust_address_nv, expand_compound_operation(), GET_MODE, GET_MODE_BITSIZE, GET_MODE_CLASS, GET_MODE_SIZE, MEM_ADDR_SPACE, MEM_VOLATILE_P, mode_dependent_address_p(), mode_for_size(), subreg_lowpart_p(), and SUBREG_REG.

static void distribute_links ( struct insn_link )
static
static void distribute_links ( )
static

Similarly to above, distribute the LOG_LINKS that used to be present on I3, I2, and I1 to new locations. This is also called to add a link pointing at I3 when I3's destination is changed.

     If the insn that this link points to is a NOTE or isn't a single
     set, ignore it.  In the latter case, it isn't clear what we
     can do other than ignore the link, since we can't tell which
     register it was for.  Such links wouldn't be used by combine
     anyway.

     It is not possible for the destination of the target of the link to
     have been changed by combine.  The only potential of this is if we
     replace I3, I2, and I1 by I3 and I2.  But in that case the
     destination of I2 also remains unchanged.   
     A LOG_LINK is defined as being placed on the first insn that uses
     a register and points to the insn that sets the register.  Start
     searching at the next insn after the target of the link and stop
     when we reach a set of the register or the end of the basic block.

     Note that this correctly handles the link that used to point from
     I3 to I2.  Also note that not much searching is typically done here
     since most links don't point very far away.   
     If we found a place to put the link, place it there unless there
     is already a link to the same insn as LINK at that point.   
             Set added_links_insn to the earliest insn we added a
             link to.   
static void distribute_notes ( rtx  notes,
rtx  from_insn,
rtx  i3,
rtx  i2,
rtx  elim_i2,
rtx  elim_i1,
rtx  elim_i0 
)
static

Given a chain of REG_NOTES originally from FROM_INSN, try to place them as appropriate. I3 and I2 are the insns resulting from the combination insns including FROM (I2 may be zero).

ELIM_I2 and ELIM_I1 are either zero or registers that we know will not need REG_DEAD notes because they are being substituted for. This saves searching in the most common cases.

Each note in the list is either ignored or placed on some insns, depending on the type of note.

         Doesn't matter much where we put this, as long as it's somewhere.
         It is preferable to keep these notes on branches, which is most
         likely to be i3.   
         These notes must remain with the call or trapping instruction.   
             ??? Otherwise assume we've combined things such that we
             can now prove that the instructions can't trap.  Drop the
             note in this case.   
         ??? How to distribute between i3-i1.  Assume i3 contains the
         entire adjustment.  Assert i3 contains at least some adjust.   
             fixup_args_size_notes looks at REG_NORETURN note,
             so ensure the note is placed there first.   
             emit_call_1 adds for !ACCUMULATE_OUTGOING_ARGS
             REG_ARGS_SIZE note to all noreturn calls, allow that here.   
         These notes must remain with the call.  It should not be
         possible for both I2 and I3 to be a call.   
         Any clobbers for i3 may still exist, and so we must process
         REG_UNUSED notes from that insn.

         Any clobbers from i2 or i1 can only exist if they were added by
         recog_for_combine.  In that case, recog_for_combine created the
         necessary REG_UNUSED notes.  Trying to keep any original
         REG_UNUSED notes from these insns can cause incorrect output
         if it is for the same register as the original i3 dest.
         In that case, we will notice that the register is set in i3,
         and then add a REG_UNUSED note for the destination of i3, which
         is wrong.  However, it is possible to have REG_UNUSED notes from
         i2 or i1 for register which were both used and clobbered, so
         we keep notes from i2 or i1 if they will turn into REG_DEAD
         notes.   
         If this register is set or clobbered in I3, put the note there
         unless there is one already.   
         Otherwise, if this register is used by I3, then this register
         now dies here, so we must put a REG_DEAD note here unless there
         is one already.   
         These notes say something about results of an insn.  We can
         only support them if they used to be on I3 in which case they
         remain on I3.  Otherwise they are ignored.

         If the note refers to an expression that is not a constant, we
         must also ignore the note since we cannot tell whether the
         equivalence is still true.  It might be possible to do
         slightly better than this (we only have a problem if I2DEST
         or I1DEST is present in the expression), but it doesn't
         seem worth the trouble.   
         These notes say something about how a register is used.  They must
         be present on any use of the register in I2 or I3.   
         This can show up in several ways &ndash; either directly in the
         pattern, or hidden off in the constant pool with (or without?)
         a REG_EQUAL note.   
         ??? Ignore the without-reg_equal-note problem for now.   
         For REG_LABEL_TARGET on a JUMP_P, we prefer to put the note
         as a JUMP_LABEL or decrement LABEL_NUSES if it's already
         there.   
         This note says something about the value of a register prior
         to the execution of an insn.  It is too much trouble to see
         if the note is still correct in all situations.  It is better
         to simply delete it.   
         If we replaced the right hand side of FROM_INSN with a
         REG_EQUAL note, the original use of the dying register
         will not have been combined into I3 and I2.  In such cases,
         FROM_INSN is guaranteed to be the first of the combined
         instructions, so we simply need to search back before
         FROM_INSN for the previous use or set of this register,
         then alter the notes there appropriately.

         If the register is used as an input in I3, it dies there.
         Similarly for I2, if it is nonzero and adjacent to I3.

         If the register is not used as an input in either I3 or I2
         and it is not one of the registers we were supposed to eliminate,
         there are two possibilities.  We might have a non-adjacent I2
         or we might have somehow eliminated an additional register
         from a computation.  For example, we might have had A & B where
         we discover that B will always be zero.  In this case we will
         eliminate the reference to A.

         In both cases, we must search to see if we can find a previous
         use of A and put the death note there.   
                 If the register is being set at TEM, see if that is all
                 TEM is doing.  If so, delete TEM.  Otherwise, make this
                 into a REG_UNUSED note instead. Don't delete sets to
                 global register vars.   
                     Verify that it was the set, and not a clobber that
                     modified the register.

                     CC0 targets must be careful to maintain setter/user
                     pairs.  If we cannot delete the setter due to side
                     effects, mark the user with an UNUSED note instead
                     of deleting it.   
                         Move the notes and links of TEM elsewhere.
                         This might delete other dead insns recursively.
                         First set the pattern to something that won't use
                         any register.   
                          If there isn't already a REG_UNUSED note, put one
                          here.  Do not place a REG_DEAD note, even if
                          the register is also used here; that would not
                          match the algorithm used in lifetime analysis
                          and can cause the consistency check in the
                          scheduler to fail.   
                     If we are doing a 3->2 combination, and we have a
                     register which formerly died in i3 and was not used
                     by i2, which now no longer dies in i3 and is used in
                     i2 but does not die in i2, and place is between i2
                     and i3, then we may need to move a link from place to
                     i2.   
         If the register is set or already dead at PLACE, we needn't do
         anything with this note if it is still a REG_DEAD note.
         We check here if it is set at all, not if is it totally replaced,
         which is what `dead_or_set_p' checks, so also check for it being
         set partially.   
                 Unless the register previously died in PLACE, clear
                 last_death.  [I no longer understand why this is
                 being done.]  
             If this is a death note for a hard reg that is occupying
             multiple registers, ensure that we are still using all
             parts of the object.  If we find a piece of the object
             that is unused, we must arrange for an appropriate REG_DEAD
             note to be added for it.  However, we can't just emit a USE
             and tag the note to it, since the register might actually
             be dead; so we recourse, and the recursive call then finds
             the previous insn that used this register.   
                     Put only REG_DEAD notes for pieces that are
                     not already dead or set.   
         Any other notes should not be present at this point in the
         compilation.   

Referenced by use_crosses_set_p().

static void do_SUBST ( rtx ,
rtx   
)
static
static void do_SUBST ( )
static

Substitute NEWVAL, an rtx expression, into INTO, a place in some insn. The substitution can be undone by undo_all. If INTO is already set to NEWVAL, do not record this change. Because computing NEWVAL might also call SUBST, we have to compute it before we put anything into the undo table.

 We'd like to catch as many invalid transformations here as
 possible.  Unfortunately, there are way too many mode changes
 that are perfectly valid, so we'd waste too much effort for
 little gain doing the checks here.  Focus on catching invalid
 transformations involving integer constants.   
     Sanity check that we're replacing oldval with a CONST_INT
     that is a valid sign-extension for the original mode.   
     Replacing the operand of a SUBREG or a ZERO_EXTEND with a
     CONST_INT is not valid, because after the replacement, the
     original mode would be gone.  Unfortunately, we can't tell
     when do_SUBST is called to replace the operand thereof, so we
     perform this test on oldval instead, checking whether an
     invalid replacement took place before we got here.   

References undobuf::frees, undo::i, undo::kind, undo::next, undo::old_contents, UNDO_INT, undobuf::undos, and undo::where.

static void do_SUBST_INT ( int *  ,
int   
)
static
static void do_SUBST_INT ( )
static

Similar to SUBST, but NEWVAL is an int expression. Note that substitution for the value of a HOST_WIDE_INT value (including CONST_INT) is not safe.

References undobuf::frees, undo::kind, undo::l, undo::next, undo::old_contents, UNDO_LINKS, undobuf::undos, and undo::where.

static void do_SUBST_LINK ( )
static

Similar to SUBST, but NEWVAL is a LOG_LINKS expression.

static void do_SUBST_MODE ( )
static

Similar to SUBST, but just substitute the mode. This is used when changing the mode of a pseudo-register, so that any other references to the entry in the regno_reg_rtx array will change as well.

References INSN_COST, and new_cost().

DEBUG_FUNCTION void dump_combine_stats ( )
void dump_combine_total_stats ( )

Referenced by opt_info_switch_p().

static rtx expand_compound_operation ( rtx  )
static
static rtx expand_compound_operation ( )
static

We consider ZERO_EXTRACT, SIGN_EXTRACT, and SIGN_EXTEND as "compound operations" because they can be replaced with two more basic operations. ZERO_EXTEND is also considered "compound" because it can be replaced with an AND operation, which is simpler, though only one operation.

The function expand_compound_operation is called with an rtx expression and will convert it to the appropriate shifts and AND operations, simplifying at each stage.

The function make_compound_operation is called to convert an expression consisting of shifts and ANDs into the equivalent compound expression. It is the inverse of this function, loosely speaking.

     We can't necessarily use a const_int for a multiword mode;
     it depends on implicitly extending the value.
     Since we don't know the right way to extend it,
     we can't tell whether the implicit way is right.

     Even for a mode that is no wider than a const_int,
     we can't win, because we need to sign extend one of its bits through
     the rest of it, and we don't know which bit.   
     Return if (subreg:MODE FROM 0) is not a safe replacement for
     (zero_extend:MODE FROM) or (sign_extend:MODE FROM).  It is for any MEM
     because (SUBREG (MEM...)) is guaranteed to cause the MEM to be
     reloaded. If not for that, MEM's would very rarely be safe.

     Reject MODEs bigger than a word, because we might not be able
     to reference a two-register group starting with an arbitrary register
     (and currently gen_lowpart might crash for a SUBREG).   
     Reject MODEs that aren't scalar integers because turning vector
     or complex modes into shifts causes problems.   
     If the inner object has VOIDmode (the only way this can happen
     is if it is an ASM_OPERANDS), we can't do anything since we don't
     know how much masking to do.   
     ... fall through ...   
     If the operand is a CLOBBER, just return it.   
     Reject MODEs that aren't scalar integers because turning vector
     or complex modes into shifts causes problems.   
     This should stay within the object being extracted, fail otherwise.   
 Convert sign extension to zero extension, if we know that the high
 bit is not set, as this is easier to optimize.  It will be converted
 back to cheaper alternative in make_extraction.   
     Make sure this is a profitable operation.   
 We can optimize some special cases of ZERO_EXTEND.   
     (zero_extend:DI (truncate:SI foo:DI)) is just foo:DI if we
     know that the last value didn't have any inappropriate bits
     set.   
     Likewise for (zero_extend:DI (subreg:SI foo:DI 0)).   
     (zero_extend:DI (truncate:SI foo:DI)) is just foo:DI when foo
     is a comparison and STORE_FLAG_VALUE permits.  This is like
     the first case, but it works even when GET_MODE (x) is larger
     than HOST_WIDE_INT.   
     Likewise for (zero_extend:DI (subreg:SI foo:DI 0)).   
 If we reach here, we want to return a pair of shifts.  The inner
 shift is a left shift of BITSIZE - POS - LEN bits.  The outer
 shift is a right shift of BITSIZE - LEN bits.  It is arithmetic or
 logical depending on the value of UNSIGNEDP.

 If this was a ZERO_EXTEND or ZERO_EXTRACT, this pair of shifts will be
 converted into an AND of a shift.

 We must check for the case where the left shift would have a negative
 count.  This can happen in a case like (x >> 31) & 255 on machines
 that can't shift by a constant.  On those machines, we would first
 combine the shift with the AND to produce a variable-position
 extraction.  Then the constant of 31 would be substituted in
 to produce such a position.   
   Any other cases we can't handle.   
 If we couldn't do this for some reason, return the original
 expression.   
static const_rtx expand_field_assignment ( const_rtx  )
static
static const_rtx expand_field_assignment ( )
static

X is a SET which contains an assignment of one object into a part of another (such as a bit-field assignment, STRICT_LOW_PART, or certain SUBREGS). If possible, convert it into a series of logical operations.

We half-heartedly support variable positions, but do not at all support variable lengths.

 Loop until we find something we can't simplify.   
         A constant position should stay within the width of INNER.   
               If position is ADJUST - X, new position is X.   
     A SUBREG between two modes that occupy the same numbers of words
     can be done by moving the SUBREG to the source.   
              We need SUBREGs to compute nonzero_bits properly.   
     Don't attempt bitwise arithmetic on non scalar integer modes.   
         Don't do anything for vector or complex integral types.   
         Try to find an integral mode to pun with.   
     Compute a mask of LEN bits, if we can do this on the host machine.   
     Now compute the equivalent expression.  Make a copy of INNER
     for the SET_DEST in case it is a MEM into which we will substitute;
     we don't want shared RTL in that case.   
unsigned int extended_count ( )

Return the number of "extended" bits there are in X, when interpreted as a quantity in MODE whose signedness is indicated by UNSIGNEDP. For unsigned quantities, this is the number of high-order zero bits. For signed quantities, this is the number of copies of the sign bit minus 1. In both case, this function returns the number of "spare" bits. For example, if two quantities for which this function returns at least 1 are added, the addition is known not to overflow.

This function will always return 0 unless called during combine, which implies that it must be called from a define_split.

static rtx extract_left_shift ( rtx  ,
int   
)
static

Referenced by make_extraction().

static rtx extract_left_shift ( )
static

See if X contains an ASHIFT of COUNT or more bits that can be commuted with any other operations in X. Return X without that shift if so.

This is the shift itself. If it is wide enough, we will return either the value being shifted if the shift count is equal to COUNT or a shift for the difference.

     If we can safely shift this constant and we find the inner shift,
     make a new operation.   
static rtx* find_single_use ( )
static

See if DEST, produced in INSN, is used only a single time in the sequel. If so, return a pointer to the innermost rtx expression in which it is used.

If PLOC is nonzero, *PLOC is set to the insn containing the single use.

If DEST is cc0_rtx, we look only at the next insn. In that case, we don't care about REG_DEAD notes or LOG_LINKS.

Otherwise, we find the single use by finding an insn that has a LOG_LINKS pointing at INSN and has a REG_DEAD note for DEST. If DEST is only referenced once in that insn, we know that it must be the first and last insn referencing DEST.

References CONST_INT_P, undobuf::frees, gcc_assert, GET_CODE, GET_MODE, GET_MODE_CLASS, INTVAL, undo::kind, undo::next, undo::old_contents, undo::r, SUBREG_REG, trunc_int_for_mode(), UNDO_RTX, undobuf::undos, undo::where, and XEXP.

static rtx* find_single_use_1 ( )
static

This is used by find_single_use to locate an rtx in LOC that contains exactly one use of DEST, which is typically either a REG or CC0. It returns a pointer to the innermost rtx expression containing DEST. Appearances of DEST that are being used to totally replace it are not counted.

If the destination is anything other than CC0, PC, a REG or a SUBREG
of a REG that occupies all of the REG, the insn uses DEST if
it is mentioned in the destination or the source.  Otherwise, we
need just check the source.   
 If it wasn't one of the common cases above, check each expression and
 vector of this code.  Look for a unique usage of DEST.   


           Duplicate usage.   
static rtx* find_split_point ( rtx ,
rtx  ,
bool   
)
static

Referenced by undo_commit().

static rtx* find_split_point ( )
static

Find the innermost point within the rtx at LOC, possibly LOC itself, where we have an arithmetic expression and return that point. LOC will be inside INSN.

try_combine will call this function to see if an insn can be split into two insns.

 First special-case some codes.   
     If we have a PLUS whose second operand is a constant and the
     address is not valid, perhaps will can split it up using
     the machine-specific way to split large constants.  We use
     the first pseudo-reg (one of the virtual regs) as a placeholder;
     it will not remain in the result.   
         This should have produced two insns, each of which sets our
         placeholder.  If the source of the second is a valid address,
         we can make put both sources together and make a split point
         in the middle.   
             Replace the placeholder in SRC2 with SRC1.  If we can
             find where in SRC2 it was placed, that can become our
             split point and we can replace this address with SRC2.
             Just try two obvious places.   
         If that didn't work, perhaps the first operand is complex and
         needs to be computed separately, so make a split point there.
         This will occur on machines that just support REG + CONST
         and have a constant moved through some previous computation.   
     If we have a PLUS whose first operand is complex, try computing it
     separately by making a split there.   
     See if we can split SET_SRC as it stands.   
     See if we can split SET_DEST as it stands.   
     See if this is a bitfield assignment with everything constant.  If
     so, this is an IOR of an AND, so split it into that.   
     Otherwise, see if this is an operation that we can split into two.
     If so, try to split that.   
         If we are AND'ing with a large constant that is only a single
         bit and the result is only being used in a context where we
         need to know if it is zero or nonzero, replace it with a bit
         extraction.  This will avoid the large constant, which might
         have taken more than one insn to make.  If the constant were
         not a valid argument to the AND but took only one insn to make,
         this is no worse, but if it took more than one insn, it will
         be better.   
         If STORE_FLAG_VALUE is -1, this is (NE X 0) and only one bit of X
         is known to be on, this can be converted into a NEG of a shift.   
         We can't optimize if either mode is a partial integer
         mode as we don't know how many bits are significant
         in those modes.   
         For unsigned, we have a choice of a shift followed by an
         AND or two shifts.  Use two shifts for field sizes where the
         constant might be too large.  We assume here that we can
         always at least get 8-bit constants in an AND insn, which is
         true for every current RISC.   
     See if this is a simple operation with a constant as the second
     operand.  It might be that this constant is out of range and hence
     could be used as a split point.   
     Finally, see if this is a simple operation with its first operand
     not in a register.  The operation might require this operand in a
     register, so return it as a split point.  We can always do this
     because if the first operand were another operation, we would have
     already found it as a split point.   
     We write NOR as (and (not A) (not B)), but if we don't have a NOR,
     it is better to write this as (not (ior A B)) so we can split it.
     Similarly for IOR.   
     Many RISC machines have a large set of logical insns.  If the
     second operand is a NOT, put it first so we will try to split the
     other operand first.   
     Canonicalization can produce (minus A (mult B C)), where C is a
     constant.  It may be better to try splitting (plus (mult B -C) A)
     instead if this isn't a multiply by a power of two.   
     Split at a multiply-accumulate instruction.  However if this is
     the SET_SRC, we likely do not have such an instruction and it's
     worthless to try this split.   
 Otherwise, select our actions depending on our rtx class.   
     ... fall through ...   
     ... fall through ...   
     Some machines have (and (shift ...) ...) insns.  If X is not
     an AND, but XEXP (X, 0) is, use it as our split point.   
     Otherwise, we don't have a split point.   
static rtx force_to_mode ( rtx  x,
enum machine_mode  mode,
unsigned HOST_WIDE_INT  mask,
int  just_select 
)
static

See if X can be simplified knowing that we will only refer to it in MODE and will only refer to those bits that are nonzero in MASK. If other bits are being computed or if masking operations are done that select a superset of the bits in MASK, they can sometimes be ignored.

Return a possibly simplified expression, but always convert X to MODE. If X is a CONST_INT, AND the CONST_INT with MASK.

If JUST_SELECT is nonzero, don't optimize by noticing that bits in MASK are all off in X. This is used when X will be complemented, by either NOT, NEG, or XOR.

 If this is a CALL or ASM_OPERANDS, don't do anything.  Some of the
 code below will do the wrong thing since the mode of such an
 expression is VOIDmode.

 Also do nothing if X is a CLOBBER; this can happen if X was
 the return value from a call to gen_lowpart.   
 We want to perform the operation is its present mode unless we know
 that the operation is valid in MODE, in which case we do the operation
 in MODE.   
 It is not valid to do a right-shift in a narrower mode
 than the one it came in with.   
 Truncate MASK to fit OP_MODE.   
 When we have an arithmetic operation, or a shift whose count we
 do not know, we need to assume that all bits up to the highest-order
 bit in MASK will be needed.  This is how we form such a mask.   
 Determine what bits of X are guaranteed to be (non)zero.   
 If none of the bits in X are needed, return a zero.   
 If X is a CONST_INT, return a new one.  Do this here since the
 test below will fail.   
 If X is narrower than MODE and we want all the bits in X's mode, just
 get X in the proper mode.   
 We can ignore the effect of a SUBREG if it narrows the mode or
 if the constant masks to zero all the bits the mode doesn't have.   
 The arithmetic simplifications here only work for scalar integer modes.   
     If X is a (clobber (const_int)), return it since we know we are
     generating something that won't match.   
     Similarly for a truncate.   
     If this is an AND with a constant, convert it into an AND
     whose constant is the AND of that constant with MASK.  If it
     remains an AND of MASK, delete it since it is redundant.   
         If X is still an AND, see if it is an AND with a mask that
         is just some low-order bits.  If so, and it is MASK, we don't
         need it.   
         If it remains an AND, try making another AND with the bits
         in the mode mask that aren't in MASK turned on.  If the
         constant in the AND is wide enough, this might make a
         cheaper constant.   
     In (and (plus FOO C1) M), if M is a mask that just turns off
     low-order bits (as in an alignment operation) and FOO is already
     aligned to that boundary, mask C1 to that boundary as well.
     This may eliminate that PLUS and, later, the AND.   
       If MODE is narrower than HOST_WIDE_INT and mask is a negative
       number, sign extend it.   
     ... fall through ...   
     For PLUS, MINUS and MULT, we need any bits less significant than the
     most significant bit in MASK since carries from those bits will
     affect the bits we are interested in.   
     If X is (minus C Y) where C's least set bit is larger than any bit
     in the mask, then we may replace with (neg Y).   
     Similarly, if C contains every bit in the fuller_mask, then we may
     replace with (not Y).   
     If X is (ior (lshiftrt FOO C1) C2), try to commute the IOR and
     LSHIFTRT so we end up with an (and (lshiftrt (ior ...) ...) ...)
     operation which may be a bitfield extraction.  Ensure that the
     constant we form is not wider than the mode of X.   
     For most binary operations, just propagate into the operation and
     change the mode if we have an operation of that mode.   
     If we ended up truncating both operands, truncate the result of the
     operation instead.   
     For left shifts, do the same, but just for the first operand.
     However, we cannot do anything with shifts where we cannot
     guarantee that the counts are smaller than the size of the mode
     because such a count will have a different meaning in a
     wider mode.   
     If the shift count is a constant and we can do arithmetic in
     the mode of the shift, refine which bits we need.  Otherwise, use the
     conservative form of the mask.   
     Here we can only do something if the shift count is a constant,
     this shift constant is valid for the host, and we can do arithmetic
     in OP_MODE.   
         Select the mask of the bits we need for the shift operand.   
         We can only change the mode of the shift if we can do arithmetic
         in the mode of the shift and INNER_MASK is no wider than the
         width of X's mode.   
     If we have (and (lshiftrt FOO C1) C2) where the combination of the
     shift and AND produces only copies of the sign bit (C2 is one less
     than a power of two), we can do this with just a shift.   
         The shift puts one of the sign bit copies in the least significant
         bit.   
         Number of bits left after the shift must be more than the mask
         needs.   
         Must be more sign bit copies than the mask needs.   
     If we are just looking for the sign bit, we don't need this shift at
     all, even if it has a variable count.   
     If this is a shift by a constant, get a mask that contains those bits
     that are not copies of the sign bit.  We then have two cases:  If
     MASK only includes those bits, this can be a logical shift, which may
     allow simplifications.  If MASK is a single-bit field not within
     those bits, we are requesting a copy of the sign bit and hence can
     shift the sign bit to the appropriate location.   
         If the considered data is wider than HOST_WIDE_INT, we can't
         represent a mask for all its bits in a single scalar.
         But we only care about the lower bits, so calculate these.   
             GET_MODE_PRECISION (GET_MODE (x)) - INTVAL (XEXP (x, 1))
             is the number of bits a full-width mask would have set.
             We need only shift if these are fewer than nonzero can
             hold.  If not, we must keep all bits set in nonzero.   
     If MASK is 1, convert this to an LSHIFTRT.  This can be done
     even if the shift count isn't a constant.   
     If this is a zero- or sign-extension operation that just affects bits
     we don't care about, remove it.  Be sure the call above returned
     something that is still a shift.   
     If the shift count is constant and we can do computations
     in the mode of X, compute where the bits we care about are.
     Otherwise, we can't do anything.  Don't change the mode of
     the shift or propagate MODE into the shift, though.   
     If we just want the low-order bit, the NEG isn't needed since it
     won't change the low-order bit.   
     We need any bits less significant than the most significant bit in
     MASK since carries from those bits will affect the bits we are
     interested in.   
     (not FOO) is (xor FOO CONST), so if FOO is an LSHIFTRT, we can do the
     same as the XOR case above.  Ensure that the constant we form is not
     wider than the mode of X.   
     (and (not FOO) CONST) is (not (or FOO (not CONST))), so we must
     use the full mask inside the NOT.   
     (and (ne FOO 0) CONST) can be (and FOO CONST) if CONST is included
     in STORE_FLAG_VALUE and FOO has a single bit that might be nonzero,
     which is equal to STORE_FLAG_VALUE.   
     We have no way of knowing if the IF_THEN_ELSE can itself be
     written in a narrower mode.  We play it safe and do not do so.   
 Ensure we return a value of the proper mode.   

Referenced by make_extraction().

static bool gate_handle_combine ( )
static

Referenced by move_deaths().

static rtx gen_lowpart_for_combine ( enum  machine_mode,
rtx   
)
static
static rtx gen_lowpart_for_combine ( )
static

Like gen_lowpart_general but for use by combine. In combine it is not possible to create any new pseudoregs. However, it is safe to create invalid memory addresses, because combine will try to recognize them and all they will do is make the combine attempt fail.

If for some reason this cannot do its job, an rtx (clobber (const_int 0)) is returned. An insn containing that will not be recognized.

 We can only support MODE being wider than a word if X is a
 constant integer or has a mode the same size.   
 X might be a paradoxical (subreg (mem)).  In that case, gen_lowpart
 won't know what to do.  So we will strip off the SUBREG here and
 process normally.   
     For use in case we fall down into the address adjustments
     further below, we need to adjust the known mode and size of
     x; imode and isize, since we just adjusted x.   
     Refuse to work on a volatile memory ref or one with a mode-dependent
     address.   
     If we want to refer to something bigger than the original memref,
     generate a paradoxical subreg instead.  That will force a reload
     of the original memref X.   
     Adjust the address so that the address-after-the-data is
     unchanged.   
 If X is a comparison operator, rewrite it in a new mode.  This
 probably won't match, but may allow further simplifications.   
 If we couldn't simplify X any other way, just enclose it in a
 SUBREG.  Normally, this SUBREG won't match, but some patterns may
 include an explicit SUBREG or we may simplify it further in combine.   

References XEXP.

static rtx gen_lowpart_or_truncate ( enum  machine_mode,
rtx   
)
static
static rtx gen_lowpart_or_truncate ( )
static

Return X converted to MODE. If the value is already truncated to MODE we can just return a subreg even though in the general case we would need an explicit truncation.

Bit-cast X into an integer mode.

static rtx get_last_value ( const_rtx  )
static
static rtx get_last_value ( )
static

Get the last value assigned to X, if known. Some registers in the value may be replaced with (clobber (const_int 0)) if their value is known longer known reliably.

 If this is a non-paradoxical SUBREG, get the value of its operand and
 then convert it to the desired mode.  If this is a paradoxical SUBREG,
 we cannot predict what values the "extra" bits might have.   
 If we don't have a value, or if it isn't for this basic block and
 it's either a hard register, set more than once, or it's a live
 at the beginning of the function, return 0.

 Because if it's not live at the beginning of the function then the reg
 is always set before being used (is never used without being set).
 And, if it's set only once, and it's always set before use, then all
 uses must have the same last value, even if it's not from this basic
 block.   
 If the value was set in a later insn than the ones we are processing,
 we can't use it even if the register was only set once.   
 If the value has all its registers valid, return it.   
 Otherwise, make a copy and replace any invalid register with
 (clobber (const_int 0)).  If that fails for some reason, return 0.   

References find_regno_note(), PUT_REG_NOTE_KIND, and REGNO.

static int get_last_value_validate ( rtx ,
rtx  ,
int  ,
int   
)
static
static int get_last_value_validate ( )
static

Verify that all the registers and memory references mentioned in *LOC are still valid. *LOC was part of a value set in INSN when label_tick was equal to TICK. Return 0 if some are not. If REPLACE is nonzero, replace the invalid references with (clobber (const_int 0)) and return 1. This replacement is useful because we often can get useful information about the form of a value (e.g., if it was produced by a shift that always produces -1 or 0) even though we don't know exactly what registers it was produced from.

        If this is a pseudo-register that was only set once and not
        live at the beginning of the function, it is always valid.   
 If this is a memory reference, make sure that there were no stores after
 it that might have clobbered the value.  We don't have alias info, so we
 assume any store invalidates it.  Moreover, we only have local UIDs, so
 we also assume that there were stores in the intervening basic blocks.   


         Check for identical subexpressions.  If x contains
         identical subexpression we only have to traverse one of
         them.   
             Note that at this point x0 has already been checked
             and found valid.   
             If x0 and x1 are identical then x is also valid.   
             If x1 is identical to a subexpression of x0 then
             while checking x0, x1 has already been checked.  Thus
             it is valid and so as x.   
             If x0 is identical to a subexpression of x1 then x is
             valid iff the rest of x1 is valid.   
 If we haven't found a reason for it to be invalid, it is valid.   

References CALL_P, find_reg_fusage(), i2, next_nonnote_nondebug_insn(), PATTERN, reg_overlap_mentioned_p(), reg_referenced_p(), and rtx_equal_p().

static int get_pos_from_mask ( unsigned  HOST_WIDE_INT,
unsigned HOST_WIDE_INT  
)
static
static int get_pos_from_mask ( )
static

Given M see if it is a value that would select a field of bits within an item, but not the entire word. Return -1 if not. Otherwise, return the starting position of the field, where 0 is the low-order bit.

*PLEN is set to the length of the field.

Get the bit number of the first 1 bit from the right, -1 if none.

   Now shift off the low-order zero bits and see if we have a
   power of two minus 1.   

References GET_MODE_MASK, and INTVAL.

static rtx if_then_else_cond ( rtx  ,
rtx ,
rtx  
)
static
static rtx if_then_else_cond ( )
static

Return nonzero if X is an expression that has one of two values depending on whether some other value is zero or nonzero. In that case, we return the value that is being tested, *PTRUE is set to the value if the rtx being returned has a nonzero value, and *PFALSE is set to the other alternative.

If we return zero, we set *PTRUE and *PFALSE to X.

 If we are comparing a value against zero, we are done.   
 If this is a unary operation whose operand has one of two values, apply
 our opcode to compute those values.   
 If this is a COMPARE, do nothing, since the IF_THEN_ELSE we would
 make can't possibly match and would suppress other optimizations.   
 If this is a binary operation, see if either side has only one of two
 values.  If either one does or if both do and they are conditional on
 the same value, compute the new true and false values.   
         If if_then_else_cond returned zero, then true/false are the
         same rtl.  We must copy one of them to prevent invalid rtl
         sharing.   
     See if we have PLUS, IOR, XOR, MINUS or UMAX, where one of the
     operands is zero when the other is nonzero, and vice-versa,
     and STORE_FLAG_VALUE is 1 or -1.   
     Similarly for MULT, AND and UMIN, except that for these the result
     is always zero.   
     If we have IF_THEN_ELSE already, extract the condition and
     canonicalize it if it is NE or EQ.   
 If X is a SUBREG, we can narrow both the true and false values
 if the inner expression, if there is a condition.   
 If X is a constant, this isn't special and will cause confusions
 if we treat it as such.  Likewise if it is equivalent to a constant.   
 If we're in BImode, canonicalize on 0 and STORE_FLAG_VALUE, as that
 will be least confusing to the rest of the compiler.   
 If X is known to be either 0 or -1, those are the true and
 false values when testing X.   
 Likewise for 0 or a single bit.   
 Otherwise fail; show no condition with true and false values the same.   
static void init_reg_last ( )
static

Wipe the last_xxx fields of reg_stat in preparation for another pass.

References DF_LR_IN, ENTRY_BLOCK_PTR, GET_MODE, HWI_COMPUTABLE_MODE_P, REG_P, reg_stat, REGNO, and REGNO_REG_SET_P.

static bool insn_a_feeds_b ( )
static

Walk the LOG_LINKS of insn B to see if we find a reference to A. Return true if we found a LOG_LINK that proves that A feeds B. This only works if there are no instructions between A and B which could have a link depending on A, since in that case we would not record a link for B. We also check the implicit dependency created by a cc0 setter/user pair.

static rtx known_cond ( rtx  ,
enum  rtx_code,
rtx  ,
rtx   
)
static
static rtx known_cond ( )
static

Return the value of expression X given the fact that condition COND is known to be true when applied to REG as its first operand and VAL as its second. X is known to not be shared and so can be modified in place.

We only handle the simplest cases, and specifically those cases that arise with IF_THEN_ELSE expressions.

 If either operand of the condition is a floating point value,
 then we have to avoid collapsing an EQ comparison.   
 If X is (abs REG) and we know something about REG's relationship
 with zero, we may be able to simplify this.   
 The only other cases we handle are MIN, MAX, and comparisons if the
 operands are the same as REG and VAL.   
             Do not reverse the condition when it is NE or EQ.
             This is because we cannot conclude anything about
             the value of 'SMAX (x, y)' when x is not equal to y,
             but we can when x equals y.   
         We must simplify subreg here, before we lose track of the
         original inner_mode.   
 We don't have to handle SIGN_EXTEND here, because even in the
 case of replacing something with a modeless CONST_INT, a
 CONST_INT is already (supposed to be) a valid sign extension for
 its narrower mode, which implies it's already properly
 sign-extended for the wider mode.  Now, for ZERO_EXTEND, the
 story is different.   
         We must simplify the zero_extend here, before we lose
         track of the original inner_mode.   
static void likely_spilled_retval_1 ( )
static

Called via note_stores by likely_spilled_retval_p. Remove from info->mask hard registers that are known to be written to / clobbered in full.

static int likely_spilled_retval_p ( )
static

Return nonzero iff part of the return value is live during INSN, and it is likely spilled. This can happen when more than one insn is needed to copy the return value, e.g. when we consider to combine into the second copy insn for a complex value.

 We assume here that no machine mode needs more than
 32 hard registers when the value overlaps with a register
 for which TARGET_FUNCTION_VALUE_REGNO_P is true.   
 Disregard parts of the return value that are set later.   
 Check if any of the (probably) live return value registers is
 likely spilled.   

References insn_code_number.

rtx make_compound_operation ( )

Look at the expression rooted at X. Look for expressions equivalent to ZERO_EXTRACT, SIGN_EXTRACT, ZERO_EXTEND, SIGN_EXTEND. Form these expressions.

Return the new rtx, usually just X.

Also, for machines like the VAX that don't have logical shift insns, try to convert logical to arithmetic shift operations in cases where they are equivalent. This undoes the canonicalizations to logical shifts done elsewhere.

We try, as much as possible, to re-use rtl expressions to save memory.

IN_CODE says what kind of expression we are processing. Normally, it is SET. In a memory address (inside a MEM, PLUS or minus, the latter two being kludges), it is MEM. When processing the arguments of a comparison or a COMPARE against zero, it is COMPARE.

 Select the code to be used in recursive calls.  Once we are inside an
 address, we stay there.  If we have a comparison, set to COMPARE,
 but once inside, go back to our default of SET.   
 Process depending on the code of this operation.  If NEW is set
 nonzero, it will be returned.   
     Convert shifts by constants into multiplications if inside
     an address.   
     If the second operand is not a constant, we can't do anything
     with it.   
     If the constant is a power of two minus one and the first operand
     is a logical right shift, make an extraction.   
     Same as previous, but for (subreg (lshiftrt ...)) in first op.   
     Same as previous, but for (xor/ior (lshiftrt...) (lshiftrt...)).   
         Apply the distributive law, and then try to make extractions.   
     If we are have (and (rotate X C) M) and C is larger than the number
     of bits in M, this is an extraction.   
     On machines without logical shifts, if the operand of the AND is
     a logical shift and our mask turns off all the propagated sign
     bits, we can replace the logical shift with an arithmetic shift.   
     If the constant is one less than a power of two, this might be
     representable by an extraction even if no shift is present.
     If it doesn't end up being a ZERO_EXTEND, we will ignore it unless
     we are in a COMPARE.   
     If we are in a comparison and this is an AND with a power of two,
     convert this into the appropriate bit extract.   
     If the sign bit is known to be zero, replace this with an
     arithmetic shift.   
     ... fall through ...   
     If we have (ashiftrt (ashift foo C1) C2) with C2 >= C1,
     this is a SIGN_EXTRACT.   
     See if we have operations between an ASHIFTRT and an ASHIFT.
     If so, try to merge the shifts into a SIGN_EXTEND.  We could
     also do this for some cases of SIGN_EXTRACT, but it doesn't
     seem worth the effort; the case checked for occurs on Alpha.   
     Call ourselves recursively on the inner expression.  If we are
     narrowing the object and it has a different RTL code from
     what it originally did, do this SUBREG as a force_to_mode.   
       If in_code is COMPARE, it isn't always safe to pass it through
       to the recursive make_compound_operation call.   
               (subreg:SI (and:DI (reg:DI) (const_int 0x800000000)) 0)
               is (const_int 0), rather than
               (subreg:SI (lshiftrt:DI (reg:DI) (const_int 35)) 0).   
           If we have something other than a SUBREG, we might have
           done an expansion, so rerun ourselves.   
           force_to_mode can expand compounds.  If it just re-expanded the
           compound, use gen_lowpart to convert to the desired mode.   
               Likewise if it re-expanded the compound only partially.
               This happens for SUBREG of ZERO_EXTRACT if they extract
               the same number of bits.   
 Now recursively process each operand of this operation.  We need to
 handle ZERO_EXTEND specially so that we don't lose track of the
 inner mode.   
 If this is a commutative operation, the changes to the operands
 may have made it noncanonical.   

References gen_lowpart, int_mode_for_mode(), SCALAR_INT_MODE_P, and simplify_gen_unary().

Referenced by make_extraction().

static rtx make_extraction ( enum machine_mode  mode,
rtx  inner,
HOST_WIDE_INT  pos,
rtx  pos_rtx,
unsigned HOST_WIDE_INT  len,
int  unsignedp,
int  in_dest,
int  in_compare 
)
static

Return an RTX for a reference to LEN bits of INNER. If POS_RTX is nonzero, it is an RTX that represents the (variable) starting position; otherwise, POS is the (constant) starting bit position. Both are counted from the LSB.

UNSIGNEDP is nonzero for an unsigned reference and zero for a signed one.

IN_DEST is nonzero if this is a reference in the destination of a SET. This is used when a ZERO_ or SIGN_EXTRACT isn't needed. If nonzero, a STRICT_LOW_PART will be used, if zero, ZERO_EXTEND or SIGN_EXTEND will be used.

IN_COMPARE is nonzero if we are in a COMPARE. This means that a ZERO_EXTRACT should be built even for bits starting at bit 0.

MODE is the desired mode of the result (if IN_DEST == 0).

The result is an RTX for the extraction or NULL_RTX if the target can't handle it.

 This mode describes the size of the storage area
 to fetch the overall value from.  Within that, we
 ignore the POS lowest bits, etc.   
     If going from (subreg:SI (mem:QI ...)) to (mem:QI ...),
     consider just the QI as the memory to extract from.
     The subreg adds or removes high bits; its mode is
     irrelevant to the meaning of this extraction,
     since POS and LEN count from the lsb.   
     We're extracting the least significant bits of an rtx
     (ashift X (const_int C)), where LEN > C.  Extract the
     least significant (LEN - C) bits of X, giving an rtx
     whose mode is MODE, then shift it left C times.   
 See if this can be done without an extraction.  We never can if the
 width of the field is not the same as that of some integer mode. For
 registers, we can only avoid the extraction if the position is at the
 low-order bit and this is either not in the destination or we have the
 appropriate STRICT_LOW_PART operation available.

 For MEM, we can avoid an extract if the field starts on an appropriate
 boundary and we can change the mode of the memory reference.   
             We can't do this if we are widening INNER_MODE (it
             may not be aligned, for one thing).   
     If INNER is a MEM, make a new MEM that encompasses just the desired
     field.  If the original and current mode are the same, we need not
     adjust the offset.  Otherwise, we do if bytes big endian.

     If INNER is not a MEM, get a piece consisting of just the field
     of interest (in this case POS % BITS_PER_WORD must be 0).   
         POS counts from lsb, but make OFFSET count in memory order.   
             We can't call gen_lowpart in a DEST since we
             always want a SUBREG (see below) and it would sometimes
             return a new hard register.   
                 Avoid creating invalid subregs, for example when
                 simplifying (x>>32)&255.   
     If this extraction is going into the destination of a SET,
     make a STRICT_LOW_PART unless we made a MEM.   
     If we know that no extraneous bits are set, and that the high
     bit is not set, convert the extraction to the cheaper of
     sign and zero extension, that are equivalent in these cases.   
         Prefer ZERO_EXTENSION, since it gives more information to
         backends.   
     Otherwise, sign- or zero-extend unless we already are in the
     proper mode.   
 Unless this is a COMPARE or we have a funny memory reference,
 don't do anything with zero-extending field extracts starting at
 the low-order bit since they are simple AND operations.   
 Unless INNER is not MEM, reject this if we would be spanning bytes or
 if the position is not a constant and the length is not 1.  In all
 other cases, we would only be going outside our object in cases when
 an original shift would have been undefined.   
 If INNER is not from memory, we want it to have the mode of a register
 extraction pattern's structure operand, or word_mode if there is no
 such pattern.  The same applies to extraction_mode and pos_mode
 and their respective operands.

 For memory, assume that the desired extraction_mode and pos_mode
 are the same as for a register operation, since at present we don't
 have named patterns for aligned memory structures.   
 Never narrow an object, since that might not be safe.   
     Be careful not to go beyond the extracted object and maintain the
     natural alignment of the memory.   
     POS is passed as if BITS_BIG_ENDIAN == 0, so we need to convert it to
     BITS_BIG_ENDIAN style.  If position is constant, compute new
     position.  Otherwise, build subtraction.
     Note that POS is relative to the mode of the original argument.
     If it's a MEM we need to recompute POS relative to that.
     However, if we're extracting from (or inserting into) a register,
     we want to recompute POS relative to wanted_inner_mode.   
     POS may be less than 0 now, but we check for that below.
     Note that it can only be less than 0 if !MEM_P (inner).   
 If INNER has a wider mode, and this is a constant extraction, try to
 make it smaller and adjust the byte to point to the byte containing
 the value.   
     The computations below will be correct if the machine is big
     endian in both bits and bytes or little endian in bits and bytes.
     If it is mixed, we must adjust.   
     If bytes are big endian and we had a paradoxical SUBREG, we must
     adjust OFFSET to compensate.   
     We can now move to the desired byte.   
 If INNER is not memory, get it into the proper mode.  If we are changing
 its mode, POS must be a constant and smaller than the size of the new
 mode.   
     On the LHS, don't create paradoxical subregs implicitely truncating
     the register unless TRULY_NOOP_TRUNCATION.   
 Adjust mode of POS_RTX, if needed.  If we want a wider mode, we
 have to zero extend.  Otherwise, we can just use a SUBREG.   
     If we know that no extraneous bits are set, and that the high
     bit is not set, convert extraction to cheaper one - either
     SIGN_EXTENSION or ZERO_EXTENSION, that are equivalent in these
     cases.   
         Prefer ZERO_EXTENSION, since it gives more information to
         backends.   
 Make POS_RTX unless we already have it and it is correct.  If we don't
 have a POS_RTX but we do have an ORIG_POS_RTX, the latter must
 be a CONST_INT.   
 Make the required operation.  See if we can use existing rtx.   

References CONST_INT_P, exact_log2(), extract_left_shift(), force_to_mode(), gen_int_mode(), gen_lowpart, GET_CODE, GET_MODE_BITSIZE, GET_MODE_MASK, GET_MODE_PRECISION, GET_MODE_SIZE, have_insn_for(), HOST_BITS_PER_WIDE_INT, HOST_WIDE_INT, INTVAL, make_compound_operation(), nonzero_bits(), OBJECT_P, rtx_equal_p(), SCALAR_INT_MODE_P, SET, simplify_gen_binary(), simplify_gen_unary(), simplify_subreg(), SUBREG_BYTE, subreg_lowpart_p(), SUBREG_REG, SUBST, trunc_int_for_mode(), UINTVAL, and XEXP.

static rtx make_field_assignment ( rtx  )
static
static rtx make_field_assignment ( )
static

See if X, a SET operation, can be rewritten as a bit-field assignment. Return that assignment if so.

We only handle the most common cases.

 If SRC was (and (not (ashift (const_int 1) POS)) DEST), this is
 a clear of a one-bit field.  We will have changed it to
 (and (rotate (const_int -2) POS) DEST), so check for that.  Also check
 for a SUBREG.   
 If SRC is (ior (ashift (const_int 1) POS) DEST), this is a set of a
 one-bit field.   
 If DEST is already a field assignment, i.e. ZERO_EXTRACT, and the
 SRC is an AND with all bits of that field set, then we can discard
 the AND.   
     Complete overlap.  We can remove the source AND.   
     Partial overlap.  We can reduce the source AND.   
 The other case we handle is assignments into a constant-position
 field.  They look like (ior/xor (and DEST C1) OTHER).  If C1 represents
 a mask that has all one bits except for a group of zero bits and
 OTHER is known to have zeros where C1 has ones, this is such an
 assignment.  Compute the position and length from C1.  Shift OTHER
 to the appropriate position, force it to the required mode, and
 make the extraction.  Check for the AND in both operands.   
 The mode to use for the source is the mode of the assignment, or of
 what is inside a possible STRICT_LOW_PART.   
 Shift OTHER right POS places and make it the source, restricting it
 to the proper length and mode.   
 If SRC is masked by an AND that does not make a difference in
 the value being stored, strip it.   

References GET_MODE_MASK, SET, and trunc_int_for_mode().

rtl_opt_pass* make_pass_combine ( )
static void mark_used_regs_combine ( rtx  )
static
static void mark_used_regs_combine ( )
static

Note hard registers in X that are used.

     If we are clobbering a MEM, mark any hard registers inside the
     address as used.   
     A hard reg in a wide mode may really be multiple registers.
     If so, mark all of them just like the first.   
         None of this applies to the stack, frame or arg pointers.   
       If setting a MEM, or a SUBREG of a MEM, then note any hard regs in
       the address.   
 Recursively scan the operands of this expression.   

References insn_link::insn, PATTERN, and reg_referenced_p().

static int merge_outer_ops ( enum rtx_code ,
HOST_WIDE_INT ,
enum  rtx_code,
HOST_WIDE_INT  ,
enum  machine_mode,
int *   
)
static
static int merge_outer_ops ( )
static

This function is called from `simplify_shift_const' to merge two outer operations. Specifically, we have already found that we need to perform operation *POP0 with constant *PCONST0 at the outermost position. We would now like to also perform OP1 with constant CONST1 (with *POP0 being done last).

Return 1 if we can do the operation and update *POP0 and *PCONST0 with the resulting operation. *PCOMP_P is set to 1 if we would need to complement the innermost operand, otherwise it is unchanged.

MODE is the mode in which the operation will be done. No bits outside the width of this mode matter. It is assumed that the width of this mode is smaller than or equal to HOST_BITS_PER_WIDE_INT.

If *POP0 or OP1 are UNKNOWN, it means no operation is required. Only NEG, PLUS, IOR, XOR, and AND are supported. We may set *POP0 to SET if the proper result is simply *PCONST0.

If the resulting operation cannot be expressed as one operation, we return 0 and do not change *POP0, *PCONST0, and *PCOMP_P.

 If OP0 is an AND, clear unimportant bits in CONST1.   
 If OP0 or OP1 is UNKNOWN, this is easy.  Similarly if they are the same or
 if OP0 is SET.   
 Otherwise, if either is a PLUS or NEG, we can't do anything.   
 If the two constants aren't the same, we can't do anything.  The
 remaining six cases can all be done.   
         (a & b) | b == b  
         (a ^ b) | b == a | b  
         (a & b) ^ b == (~a) & b  
         (a | b) ^ b == a & ~b  
         (a | b) & b == b  
         (a ^ b) & b) == (~a) & b  
 Check for NO-OP cases.   
 ??? Slightly redundant with the above mask, but not entirely.
 Moving this above means we'd have to sign-extend the mode mask
 for the final test.   

References XEXP.

static void move_deaths ( rtx  x,
rtx  maybe_kill_insn,
int  from_luid,
rtx  to_insn,
rtx pnotes 
)
static

For each register (hardware or pseudo) used within expression X, if its death is in an instruction with luid between FROM_LUID (inclusive) and TO_INSN (exclusive), put a REG_DEAD note for that register in the list headed by PNOTES.

That said, don't move registers killed by maybe_kill_insn.

This is done when X is being merged by combination into TO_INSN. These notes will then be distributed as needed.

     Don't move the register if it gets killed in between from and to.   
         It is possible for the call above to return 0.  This can occur
         when last_death points to I2 or I1 that we combined with.
         In that case make a new note.

         We must also check for the case where X is a hard register
         and NOTE is a death note for a range of hard registers
         including X.  In that case, we must put REG_DEAD notes for
         the remaining registers in place of NOTE.   
         If we didn't find any note, or if we found a REG_DEAD note that
         covers only part of the given reg, and we have a multi-reg hard
         register, then to be safe we must check for REG_DEAD notes
         for each register other than the first.  They could have
         their own REG_DEAD notes lying around.   
     In the case of a ZERO_EXTRACT, a STRICT_LOW_PART, or a SUBREG
     that accesses one word of a multi-word item, some
     piece of everything register in the expression is used by
     this insn, so remove any old death.   
     ??? So why do we test for equality of the sizes?   
     If this is some other SUBREG, we know it replaces the entire
     value, so use that as the destination.   
     If this is a MEM, adjust deaths of anything used in the address.
     For a REG (the only other possibility), the entire value is
     being replaced so the old value is not used in this insn.   

References execute(), gate_handle_combine(), and rest_of_handle_combine().

Referenced by record_value_for_reg().

static int recog_for_combine ( rtx ,
rtx  ,
rtx  
)
static
static int recog_for_combine ( )
static

Like recog, but we receive the address of a pointer to a new pattern. We try to match the rtx that the pointer points to. If that fails, we may try to modify or replace the pattern, storing the replacement into the same pointer object.

Modifications include deletion or addition of CLOBBERs.

PNOTES is a pointer to a location where any REG_UNUSED notes added for the CLOBBERs are placed.

The value is the final insn code from the pattern ultimately matched, or -1.

 If PAT is a PARALLEL, check to see if it contains the CLOBBER
 we use to indicate that something didn't match.  If we find such a
 thing, force rejection.   
 If it isn't, there is the possibility that we previously had an insn
 that clobbered some register as a side effect, but the combined
 insn doesn't need to do that.  So try once more without the clobbers
 unless this represents an ASM insn.   
 Recognize all noop sets, these will be killed by followup pass.   
 If we had any clobbers to add, make a new pattern than contains
 them.  Then check to make sure that all of them are dead.   
     Allow targets to reject combined insn.   
         Callers expect recog_for_combine to strip
         clobbers from the pattern on failure.   

References swap_condition(), and XEXP.

static void record_dead_and_set_regs ( rtx  )
static
static void record_dead_and_set_regs ( )
static

Update the records of when each REG was most recently set or killed for the things done by INSN. This is the last thing done in processing INSN in the combiner loop.

We update reg_stat[], in particular fields last_set, last_set_value, last_set_mode, last_set_nonzero_bits, last_set_sign_bit_copies, last_death, and also the similar information mem_last_set (which insn most recently modified memory) and last_call_luid (which insn was the most recent subroutine call).

We can't combine into a call pattern. Remember, though, that the return value register is set at this LUID. We could still replace a register with the return value from the wrong subroutine call!

static void record_dead_and_set_regs_1 ( rtx  ,
const_rtx  ,
void *   
)
static
static void record_dead_and_set_regs_1 ( )
static

Called via note_stores from record_dead_and_set_regs to handle one SET or CLOBBER in an insn. DATA is the instruction in which the set is occurring.

If we are setting the whole register, we know its value. Otherwise show that we don't know the value. We can handle SUBREG in some cases.

          Ignore pushes, they clobber nothing.   
static void record_promoted_value ( rtx  ,
rtx   
)
static
static void record_promoted_value ( )
static

If a SUBREG has the promoted bit set, it is in fact a property of the register present in the SUBREG, so for each such SUBREG go back and adjust nonzero and sign bit information of the registers that are known to have some zero/sign bits set.

This is needed because when combine blows the SUBREGs away, the information on zero/sign bits is lost and further combines can be missed because of that.

References find_reg_note(), find_regno_note(), REG_P, and REGNO.

static int record_truncated_value ( rtx ,
void *   
)
static
static int record_truncated_value ( )
static

Callback for for_each_rtx. If *P is a hard reg or a subreg record the mode that the register is accessed in. For non-TRULY_NOOP_TRUNCATION targets we might be able to turn a truncate into a subreg using this information. Return -1 if traversing *P is complete or 0 otherwise.

??? For hard-regs we now record everything. We might be able to optimize this using last_set_mode.

static void record_truncated_values ( rtx ,
void *   
)
static
static void record_truncated_values ( )
static

Callback for note_uses. Find hardregs and subregs of pseudos and the modes they are used in. This can help truning TRUNCATEs into SUBREGs.

References JUMP_LABEL, LABEL_NUSES, LABEL_P, and XEXP.

static void record_value_for_reg ( rtx  ,
rtx  ,
rtx   
)
static
static void record_value_for_reg ( )
static

Record that REG is set to VALUE in insn INSN. If VALUE is zero, we are saying that the register is clobbered and we no longer know its value. If INSN is zero, don't update reg_stat[].last_set; this is only permitted with VALUE also zero and is used to invalidate the register.

 If VALUE contains REG and we have a previous value for REG, substitute
 the previous value.   
     Set things up so get_last_value is allowed to see anything set up to
     our insn.   
     If TEM is simply a binary operation with two CLOBBERs as operands,
     it isn't going to be useful and will take a lot of time to process,
     so just use the CLOBBER.   
             If there are two or more occurrences of REG in VALUE,
             prevent the value from growing too much.   
 For each register modified, show we don't know its value, that
 we don't know about its bitwise content, that its value has been
 updated, and that we don't know the location of the death of the
 register.   
 Mark registers that are being referenced in this value.   
 Now update the status of each register being set.
 If someone is using this register in this block, set this register
 to invalid since we will get confused between the two lives in this
 basic block.  This makes using this register always invalid.  In cse, we
 scan the table to invalidate all entries using this register, but this
 is too much work for us.   
 The value being assigned might refer to X (like in "x++;").  In that
 case, we must replace it with (clobber (const_int 0)) to prevent
 infinite loops.   
 For the main register being modified, update the value, the mode, the
 nonzero bits, and the number of sign bit copies.   

References END_HARD_REGNO, GET_MODE, hard_regno_nregs, move_deaths(), offset, and regno_reg_rtx.

static int reg_bitfield_target_p ( rtx  ,
rtx   
)
static

Referenced by use_crosses_set_p().

static int reg_bitfield_target_p ( )
static

Return 1 if X is the target of a bit-field assignment in BODY, the pattern of an insn. X must be a REG.

static int reg_dead_at_p ( rtx  ,
rtx   
)
static
static int reg_dead_at_p ( )
static

Return nonzero if REG is known to be dead at INSN.

We scan backwards from INSN. If we hit a REG_DEAD note or a CLOBBER referencing REG, it is dead. If we hit a SET referencing REG, it is live. Otherwise, see if it is live or dead at the start of the basic block we are in. Hard regs marked as being live in NEWPAT_USED_REGS must be assumed to be always live.

 Set variables for reg_dead_at_p_1.   
 Check that reg isn't mentioned in NEWPAT_USED_REGS.  For fixed registers
 we allow the machine description to decide whether use-and-clobber
 patterns are OK.   
 Scan backwards until we find a REG_DEAD note, SET, CLOBBER, or
 beginning of basic block.   
 Look at live-in sets for the basic block that we were in.   
static void reg_dead_at_p_1 ( rtx  ,
const_rtx  ,
void *   
)
static
static void reg_dead_at_p_1 ( )
static

Function called via note_stores from reg_dead_at_p.

If DEST is within [reg_dead_regno, reg_dead_endregno), set reg_dead_flag to 1 if X is a CLOBBER and to -1 it is a SET.

static rtx reg_nonzero_bits_for_combine ( const_rtx  x,
enum machine_mode  mode,
const_rtx  known_x,
enum machine_mode  known_mode,
unsigned HOST_WIDE_INT  known_ret,
unsigned HOST_WIDE_INT nonzero 
)
static

Given a REG, X, compute which bits in X can be nonzero. We don't care about bits outside of those defined in MODE.

For most X this is simply GET_MODE_MASK (GET_MODE (MODE)), but if X is a shift, AND, or zero_extract, we can do better.

If X is a register whose nonzero bits value is current, use it. Otherwise, if X is a register whose value we can find, use that value. Otherwise, use the previously-computed global nonzero bits for this register.

       We don't know anything about the upper bits.   
static rtx reg_num_sign_bit_copies_for_combine ( const_rtx  x,
enum machine_mode  mode,
const_rtx  known_x,
enum machine_mode  known_mode,
unsigned int  known_ret,
unsigned int *  result 
)
static

Return the number of bits at the high-order end of X that are known to be equal to the sign bit. X will be used in mode MODE; if MODE is VOIDmode, X will be used in its own mode. The returned value will always be between 1 and the number of bits in MODE.

References const0_rtx.

static bool reg_subword_p ( )
static

Check whether X, the destination of a set, refers to part of the register specified by REG.

Check that reg is an integer mode register.

static bool reg_truncated_to_mode ( enum  machine_mode,
const_rtx   
)
static
static bool reg_truncated_to_mode ( )
static

Check if X, a register, is known to contain a value already truncated to MODE. In this case we can use a subreg to refer to the truncated value even though in the generic case we would need an explicit truncation.

References i2.

rtx remove_death ( )

Remove register number REGNO from the dead registers list of INSN.

Return the note used to record the death, if there was one.

References cleanup_cfg(), get_insns(), rebuild_jump_labels(), timevar_pop(), and timevar_push().

static unsigned int rest_of_handle_combine ( )
static

Try combining insns through substitution.

Combining insns may have turned an indirect jump into a direct jump. Rebuild the JUMP_LABEL fields of jumping instructions.

Referenced by move_deaths().

static int rtx_equal_for_field_assignment_p ( rtx  ,
rtx   
)
static
static int rtx_equal_for_field_assignment_p ( )
static

See if X and Y are equal for the purposes of seeing if we can rewrite an assignment as a field assignment.

Check for a paradoxical SUBREG of a MEM compared with the MEM. Note that all SUBREGs of MEM are paradoxical; otherwise they would have been rewritten.

 We used to see if get_last_value of X and Y were the same but that's
 not correct.  In one direction, we'll cause the assignment to have
 the wrong destination and in the case, we'll import a register into this
 insn that might have already have been dead.   So fail if none of the
 above cases are true.   

References reg_stat_struct::last_set_sign_bit_copies, and NULL.

static void set_nonzero_bits_and_sign_copies ( rtx  ,
const_rtx  ,
void *   
)
static
static void set_nonzero_bits_and_sign_copies ( )
static

Called via note_stores. If X is a pseudo that is narrower than HOST_BITS_PER_WIDE_INT and is being set, record what bits are known zero.

If we are setting only a portion of X and we can't figure out what portion, assume all bits will be used since we don't know what will be happening.

Similarly, set how many bits of X are known to be copies of the sign bit at all locations in the function. This is the smallest number implied by any set of X.

     If this register is undefined at the start of the file, we can't
     say what its contents were.   
     If this register is being initialized using itself, and the
     register is uninitialized in this basic block, and there are
     no LOG_LINKS which set the register, then part of the
     register is uninitialized.  In that case we can't assume
     anything about the number of nonzero bits.

     ??? We could do better if we checked this in
     reg_{nonzero_bits,num_sign_bit_copies}_for_combine.  Then we
     could avoid making assumptions about the insn which initially
     sets the register, while still using the information in other
     insns.  We would have to be careful to check every insn
     involved in the combination.   
     If this is a complex assignment, see if we can convert it into a
     simple assignment.   
     If this is a simple assignment, or we have a paradoxical SUBREG,
     set what we know about X.   
         Don't call nonzero_bits if it cannot change anything.   

References find_reg_note(), GET_CODE, insn_nothrow_p(), next_active_insn(), PATTERN, PREV_INSN, REG_P, reg_set_between_p(), REGNO, SET, SET_DEST, side_effects_p(), XEXP, XVECEXP, and XVECLEN.

static void setup_incoming_promotions ( rtx  )
static
static void setup_incoming_promotions ( )
static

Set up any promoted values for incoming argument registers.

     Only continue if the incoming argument is in a register.   
     Determine, if possible, whether all call sites of the current
     function lie within the current compilation unit.  (This does
     take into account the exporting of a function via taking its
     address, and so forth.)   
     The mode and signedness of the argument before any promotions happen
     (equal to the mode of the pseudo holding it at that stage).   
     The mode and signedness of the argument after any source language and
     TARGET_PROMOTE_PROTOTYPES-driven promotions.   
     The mode and signedness of the argument as it is actually passed,
     after any TARGET_PROMOTE_FUNCTION_ARGS-driven ABI promotions.   
     The mode of the register in which the argument is being passed.   
     Eliminate sign extensions in the callee when:
     (a) A mode promotion has occurred;   
     (b) The mode of the register is the same as the mode of
         the argument as it is passed;  
     (c) There's no language level extension;   
     (c.1) All callers are from the current compilation unit.  If that's
     the case we don't have to rely on an ABI, we only have to know
     what we're generating right now, and we know that we will do the
     mode1 to mode2 promotion with the given sign.   
     (c.2) The combination of the two promotions is useful.  This is
     true when the signs match, or if the first promotion is unsigned.
     In the later case, (sign_extend (zero_extend x)) is the same as
     (zero_extend (zero_extend x)), so make sure to force UNS3 true.   
     Record that the value was promoted from mode1 to mode3,
     so that any sign extension at the head of the current
     function may be eliminated.   

References GET_MODE, and GET_MODE_MASK.

static rtx simplify_and_const_int ( rtx  x,
enum machine_mode  mode,
rtx  varop,
unsigned HOST_WIDE_INT  constop 
)
static

We have X, a logical `and' of VAROP with the constant CONSTOP, to be done in MODE.

Return an equivalent form, if different from X. Otherwise, return X. If X is zero, we are to always construct the equivalent form.

Referenced by simplify_set().

static rtx simplify_and_const_int_1 ( enum machine_mode  mode,
rtx  varop,
unsigned HOST_WIDE_INT  constop 
)
static

Simplify a logical `and' of VAROP with the constant CONSTOP, to be done in MODE. Return an equivalent form, if different from (and VAROP (const_int CONSTOP)). Otherwise, return NULL_RTX.

 Simplify VAROP knowing that we will be only looking at some of the
 bits in it.

 Note by passing in CONSTOP, we guarantee that the bits not set in
 CONSTOP are not significant and will never be examined.  We must
 ensure that is the case by explicitly masking out those bits
 before returning.   
 If VAROP is a CLOBBER, we will fail so return it.   
 If VAROP is a CONST_INT, then we need to apply the mask in CONSTOP
 to VAROP and return the new constant.   
 See what bits may be nonzero in VAROP.  Unlike the general case of
 a call to nonzero_bits, here we don't care about bits outside
 MODE.   
 Turn off all bits in the constant that are known to already be zero.
 Thus, if the AND isn't needed at all, we will have CONSTOP == NONZERO_BITS
 which is tested below.   
 If we don't have any bits left, return zero.   
 If VAROP is a NEG of something known to be zero or 1 and CONSTOP is
 a power of two, we can replace this with an ASHIFT.   
 If VAROP is an IOR or XOR, apply the AND to both branches of the IOR
 or XOR, then try to apply the distributive law.  This may eliminate
 operations if either branch can be simplified because of the AND.
 It may also make some cases more complex, but those cases probably
 won't match a pattern either with or without this.   
 If VAROP is PLUS, and the constant is a mask of low bits, distribute
 the AND and see if one of the operands simplifies to zero.  If so, we
 may eliminate it.   
 Make a SUBREG if necessary.  If we can't make it, fail.   
 If we are only masking insignificant bits, return VAROP.   
 Otherwise, return an AND.   

References exact_log2(), GEN_INT, simplify_gen_binary(), and UINTVAL.

static enum rtx_code simplify_compare_const ( enum  rtx_code,
rtx  ,
rtx  
)
static
static enum rtx_code simplify_compare_const ( )
static

Try to simplify a comparison between OP0 and a constant OP1, where CODE is the comparison code that will be tested, into a (CODE OP0 const0_rtx) form.

The result is a possibly different comparison code to use. *POP1 may be updated.

 Get the constant we are comparing against and turn off all bits
 not on in our mode.   
 If we are comparing against a constant power of two and the value
 being compared can only have that single bit nonzero (e.g., it was
 `and'ed with that bit), we can replace this with a comparison
 with zero.   
 Similarly, if we are comparing a value known to be either -1 or
 0 with -1, change it to the opposite comparison against zero.   
 Do some canonicalizations based on the comparison code.  We prefer
 comparisons against zero and then prefer equality comparisons.
 If we can reduce the size of a constant, we will do that too.   
     < C is equivalent to <= (C - 1)  
         ... fall through to LE case below.   
     <= C is equivalent to < (C + 1); we do this for C < 0   
     If we are doing a <= 0 comparison on a value known to have
     a zero sign bit, we can replace this with == 0.   
     >= C is equivalent to > (C - 1).   
         ... fall through to GT below.   
     > C is equivalent to >= (C + 1); we do this for C < 0.   
     If we are doing a > 0 comparison on a value known to have
     a zero sign bit, we can replace this with != 0.   
     < C is equivalent to <= (C - 1).   
         ... fall through ...   
     (unsigned) < 0x80000000 is equivalent to >= 0.   
     unsigned <= 0 is equivalent to == 0  
     (unsigned) <= 0x7fffffff is equivalent to >= 0.   
     >= C is equivalent to > (C - 1).   
         ... fall through ...   
     (unsigned) >= 0x80000000 is equivalent to < 0.   
     unsigned > 0 is equivalent to != 0  
     (unsigned) > 0x7fffffff is equivalent to < 0.   
static enum rtx_code simplify_comparison ( enum  rtx_code,
rtx ,
rtx  
)
static
static enum rtx_code simplify_comparison ( )
static

Simplify a comparison between *POP0 and *POP1 where CODE is the comparison code that will be tested.

The result is a possibly different comparison code to use. *POP0 and *POP1 may be updated.

It is possible that we might detect that a comparison is either always true or always false. However, we do not perform general constant folding in combine, so this knowledge isn't useful. Such tautologies should have been detected earlier. Hence we ignore all such cases.

 Try a few ways of applying the same transformation to both operands.   
     The test below this one won't handle SIGN_EXTENDs on these machines,
     so check specially.   
     If both operands are the same constant shift, see if we can ignore the
     shift.  We can if the shift is a rotate or if the bits shifted out of
     this shift are known to be zero for both inputs and if the type of
     comparison is compatible with the shift.   
     If both operands are AND's of a paradoxical SUBREG by constant, the
     SUBREGs are of the same mode, and, in both cases, the AND would
     be redundant if the comparison was done in the narrower mode,
     do the comparison in the narrower mode (e.g., we are AND'ing with 1
     and the operand's possibly nonzero bits are 0xffffff01; in that case
     if we only care about QImode, we don't need the AND).  This case
     occurs if the output mode of an scc insn is not SImode and
     STORE_FLAG_VALUE == 1 (e.g., the 386).

     Similarly, check for a case where the AND's are ZERO_EXTEND
     operations from some narrower mode even though a SUBREG is not
     present.   
             The resulting comparison is always unsigned since we masked
             off the original sign bit.   
     If both operands are NOT, we can strip off the outer operation
     and adjust the comparison code for swapped operands; similarly for
     NEG, except that this must be an equality comparison.   
 If the first operand is a constant, swap the operands and adjust the
 comparison code appropriately, but don't do this if the second operand
 is already a constant integer.   
 We now enter a loop during which we will try to simplify the comparison.
 For the most part, we only are concerned with comparisons with zero,
 but some things may really be comparisons with zero but not start
 out looking that way.   
     We only want to handle integral modes.  This catches VOIDmode,
     CCmode, and the floating-point modes.  An exception is that we
     can handle VOIDmode if OP0 is a COMPARE or a comparison
     operation.   
     Try to simplify the compare to constant, possibly changing the
     comparison op, and/or changing op1 to zero.   
     Compute some predicates to simplify code below.   
     If this is a sign bit comparison and we can do arithmetic in
     MODE, say that we will only be needing the sign bit of OP0.   
     Now try cases based on the opcode of OP0.  If none of the cases
     does a "continue", we exit this loop immediately after the
     switch.   
         If we are extracting a single bit from a variable position in
         a constant that has only a single bit set and are comparing it
         with zero, we can convert this into an equality comparison
         between the position and the location of the single bit.   
         Except we can't if SHIFT_COUNT_TRUNCATED is set, since we might
         have already reduced the shift count modulo the word size.   
             Result is nonzero iff shift count is equal to I.   
         ... fall through ...   
         If testing for equality, we can take the NOT of the constant.   
         If just looking at the sign bit, reverse the sense of the
         comparison.   
         If testing for equality, we can take the NEG of the constant.   
         The remaining cases only apply to comparisons with zero.   
         When X is ABS or is known positive,
         (neg X) is < 0 if and only if X != 0.   
         If we have NEG of something whose two high-order bits are the
         same, we know that "(-a) < 0" is equivalent to "a > 0".   
         If we are testing equality and our count is a constant, we
         can perform the inverse operation on our RHS.   
         If we are doing a < 0 or >= 0 comparison, it means we are testing
         a particular bit.  Convert it to an AND of a constant of that
         bit.  This will be converted into a ZERO_EXTRACT.   
         Fall through.   
         ABS is ignorable inside an equality comparison with zero.   
         Can simplify (compare (zero/sign_extend FOO) CONST) to
         (compare FOO CONST) if CONST fits in FOO's mode and we
         are either testing inequality or have an unsigned
         comparison with ZERO_EXTEND or a signed comparison with
         SIGN_EXTEND.  But don't do it if we don't have a compare
         insn of the given mode, since we'd have to revert it
         later on, and then we wouldn't know whether to sign- or
         zero-extend.   
         Check for the case where we are comparing A - C1 with C2, that is

           (subreg:MODE (plus (A) (-C1))) op (C2)

         with C1 a constant, and try to lift the SUBREG, i.e. to do the
         comparison in the wider mode.  One of the following two conditions
         must be true in order for this to be valid:

           1. The mode extension results in the same bit pattern being added
              on both sides and the comparison is equality or unsigned.  As
              C2 has been truncated to fit in MODE, the pattern can only be
              all 0s or all 1s.

           2. The mode extension results in the sign bit being copied on
              each side.

         The difficulty here is that we have predicates for A but not for
         (A - C1) so we need to check that C1 is within proper bounds so
         as to perturbate A as little as possible.   
                  (A - C1) zero-extends if it is positive and sign-extends
                  if it is negative, C2 both zero- and sign-extends.   
                      (A - C1) sign-extends if it is positive and 1-extends
                      if it is negative, C2 both sign- and 1-extends.   
                     (A - C1) always sign-extends, like C2.   
         If the inner mode is narrower and we are extracting the low part,
         we can treat the SUBREG as if it were a ZERO_EXTEND.   
           Fall through  
         ... fall through ...   
         (eq (plus X A) B) -> (eq X (minus B A)).  We can only do
         this for equality comparisons due to pathological cases involving
         overflows.   
         (plus (abs X) (const_int -1)) is < 0 if and only if X == 0.   
         We used to optimize signed comparisons against zero, but that
         was incorrect.  Unsigned comparisons against zero (GTU, LEU)
         arrive here as equality comparisons, or (GEU, LTU) are
         optimized away.  No need to special-case them.   
         (eq (minus A B) C) -> (eq A (plus B C)) or
         (eq B (minus A C)), whichever simplifies.  We can only do
         this for equality comparisons due to pathological cases involving
         overflows.   
         The sign bit of (minus (ashiftrt X C) X), where C is the number
         of bits in X minus 1, is one iff X > 0.   
         (eq (xor A B) C) -> (eq A (xor B C)).  This is a simplification
         if C is zero or B is a constant.   
         We can't do anything if OP0 is a condition code value, rather
         than an actual data value.   
         Get the two operands being compared.   
         Check for the cases where we simply want the result of the
         earlier test or the opposite of that result.   
         The sign bit of (ior (plus X (const_int -1)) X) is nonzero
         iff X <= 0.   
         Convert (and (xshift 1 X) Y) to (and (lshiftrt Y X) 1).  This
         will be converted to a ZERO_EXTRACT later.   
         If we are comparing (and (lshiftrt X C1) C2) for equality with
         zero and X is a comparison and C1 and C2 describe only bits set
         in STORE_FLAG_VALUE, we can compare with X.   
         If we are doing an equality comparison of an AND of a bit equal
         to the sign bit, replace this with a LT or GE comparison of
         the underlying value.   
         If this AND operation is really a ZERO_EXTEND from a narrower
         mode, the constant fits within that mode, and this is either an
         equality or unsigned comparison, try to do this comparison in
         the narrower mode.

         Note that in:

         (ne:DI (and:DI (reg:DI 4) (const_int 0xffffffff)) (const_int 0))
         -> (ne:DI (reg:SI 4) (const_int 0))

         unless TRULY_NOOP_TRUNCATION allows it or the register is
         known to hold a value of the required mode the
         transformation is invalid.   
         If this is (and:M1 (subreg:M2 X 0) (const_int C1)) where C1
         fits in both M1 and M2 and the SUBREG is either paradoxical
         or represents the low part, permute the SUBREG and the AND
         and try again.   
             Require an integral mode, to avoid creating something like
             (AND:SF ...).   
                 It is unsafe to commute the AND into the SUBREG if the
                 SUBREG is paradoxical and WORD_REGISTER_OPERATIONS is
                 not defined.  As originally written the upper bits
                 have a defined value due to the AND operation.
                 However, if we commute the AND inside the SUBREG then
                 they no longer have defined values and the meaning of
                 the code has been changed.   
         Convert (ne (and (not X) 1) 0) to (eq (and X 1) 0).   
         Convert (ne (and (lshiftrt (not X)) 1) 0) to
         (eq (and (lshiftrt X) 1) 0).
         Also handle the case where (not X) is expressed using xor.   
         If we have (compare (ashift FOO N) (const_int C)) and
         the high order N bits of FOO (N+1 if an inequality comparison)
         are known to be zero, we can do this by comparing FOO with C
         shifted right N bits so long as the low-order N bits of C are
         zero.   
             We must perform a logical shift, not an arithmetic one,
             as we want the top N bits of C to be zero.   
         If we are doing a sign bit comparison, it means we are testing
         a particular bit.  Convert it to the appropriate AND.   
         If this an equality comparison with zero and we are shifting
         the low bit to the sign bit, we can convert this to an AND of the
         low-order bit.   
         If this is an equality comparison with zero, we can do this
         as a logical shift, which might be much simpler.   
         If OP0 is a sign extension and CODE is not an unsigned comparison,
         do the comparison in a narrower mode.   
         Likewise if OP0 is a PLUS of a sign extension with a
         constant, which is usually represented with the PLUS
         between the shifts.   
         ... fall through ...   
         If we have (compare (xshiftrt FOO N) (const_int C)) and
         the low order N bits of FOO are known to be zero, we can do this
         by comparing FOO with C shifted left N bits so long as no
         overflow occurs.  Even if the low order N bits of FOO aren't known
         to be zero, if the comparison is >= or < we can use the same
         optimization and for > or <= by setting all the low
         order N bits in the comparison constant.   
                 If the shift was logical, then we must make the condition
                 unsigned.   
         If we are using this shift to extract just the sign bit, we
         can replace this with an LT or GE comparison.   
 Now make any compound operations involved in this comparison.  Then,
 check for an outmost SUBREG on OP0 that is not doing anything or is
 paradoxical.  The latter transformation must only be performed when
 it is known that the "extra" bits will be the same in op0 and op1 or
 that they don't matter.  There are three cases to consider:

 1. SUBREG_REG (op0) is a register.  In this case the bits are don't
 care bits and we can assume they have any convenient value.  So
 making the transformation is safe.

 2. SUBREG_REG (op0) is a memory and LOAD_EXTEND_OP is not defined.
 In this case the upper bits of op0 are undefined.  We should not make
 the simplification in that case as we do not know the contents of
 those bits.

 3. SUBREG_REG (op0) is a memory and LOAD_EXTEND_OP is defined and not
 UNKNOWN.  In that case we know those bits are zeros or ones.  We must
 also be sure that they are the same as the upper bits of op1.

 We can never remove a SUBREG for a non-equality comparison because
 the sign bit is in a different place in the underlying object.   
         For paradoxical subregs, allow case 1 as above.  Case 3 isn't
         implemented.   
 We now do the opposite procedure: Some machines don't have compare
 insns in all modes.  If OP0's mode is an integer mode smaller than a
 word and we can't do a compare in that mode, see if there is a larger
 mode for which we can do the compare.  There are a number of cases in
 which we can use the wider mode.   
         If this is a test for negative, we can make an explicit
         test of the sign bit.  Test this first so we can use
         a paradoxical subreg to extend OP0.   
         If the only nonzero bits in OP0 and OP1 are those in the
         narrower mode and this is an equality or unsigned comparison,
         we can use the wider mode.  Similarly for sign-extended
         values, in which case it is true for all comparisons.   
             If OP0 is an AND and we don't have an AND in MODE either,
             make a new AND in the proper mode.   
 We may have changed the comparison operands.  Re-canonicalize.   
 If this machine only supports a subset of valid comparisons, see if we
 can convert an unsupported one into a supported one.   

References INTVAL, and simplify_shift_const().

static rtx simplify_if_then_else ( rtx  )
static
static rtx simplify_if_then_else ( )
static

Simplify X, an IF_THEN_ELSE expression. Return the new expression.

 Simplify storing of the truth value.   
 Also when the truth value has to be reversed.   
 Sometimes we can simplify the arm of an IF_THEN_ELSE if a register used
 in it is being compared against certain values.  Get the true and false
 comparisons and see if that says anything about the value of each arm.   
     If FALSE_CODE is EQ, swap the codes and arms.   
     If we are comparing against zero and the expression being tested has
     only a single bit that might be nonzero, that is its value when it is
     not equal to zero.  Similarly if it is known to be -1 or 0.   
     Now simplify an arm if we know the value of the register in the
     branch and it is used in the arm.  Be careful due to the potential
     of locally-shared RTL.   
 If we have (if_then_else FOO (pc) (label_ref BAR)) and FOO can be
 reversed, do so to avoid needing two sets of patterns for
 subtract-and-branch insns.  Similarly if we have a constant in the true
 arm, the false arm is the same as the first operand of the comparison, or
 the false arm is more complicated than the true arm.   
     It is possible that the conditional has been simplified out.   
 If the two arms are identical, we don't need the comparison.   
 Convert a == b ? b : a to "a".   
 Look for cases where we have (abs x) or (neg (abs X)).   
 Look for MIN or MAX.   
 If we have (if_then_else COND (OP Z C1) Z) and OP is an identity when its
 second operand is zero, this can be done as (OP Z (mult COND C2)) where
 C2 = C1 * STORE_FLAG_VALUE. Similarly if OP has an outer ZERO_EXTEND or
 SIGN_EXTEND as long as Z is already extended (so we don't destroy it).
 We can do this kind of thing in some cases when STORE_FLAG_VALUE is
 neither 1 or -1, but it isn't worth checking for.   
     If an identity-zero op is commutative, check whether there
     would be a match if we swapped the operands.   
 If we have (if_then_else (ne A 0) C1 0) and either A is known to be 0 or
 1 and C1 is a single bit or A is known to be 0 or -1 and C1 is the
 negation of a single bit, we can convert this operation to a shift.  We
 can actually do this more generally, but it doesn't seem worth it.   
 (IF_THEN_ELSE (NE REG 0) (0) (8)) is REG for nonzero_bits (REG) == 8.   

References SET_SRC, simplify_rtx(), and SUBST.

static rtx simplify_logical ( rtx  )
static
static rtx simplify_logical ( )
static

Simplify, X, and AND, IOR, or XOR operation, and return the simplified result.

     We can call simplify_and_const_int only if we don't lose
     any (sign) bits when converting INTVAL (op1) to
     "unsigned HOST_WIDE_INT".   
     If we have any of (and (ior A B) C) or (and (xor A B) C),
     apply the distributive law and then the inverse distributive
     law to see if things simplify.   
     If we have (ior (and A B) C), apply the distributive law and then
     the inverse distributive law to see if things simplify.   
static rtx simplify_set ( rtx  )
static
static rtx simplify_set ( )
static

Simplify X, a SET expression. Return the new expression.

 (set (pc) (return)) gets written as (return).   
 Now that we know for sure which bits of SRC we are using, see if we can
 simplify the expression for the object knowing that we only need the
 low-order bits.   
 If we are setting CC0 or if the source is a COMPARE, look for the use of
 the comparison result and try to simplify it unless we already have used
 undobuf.other_insn.   
         Attempt to simplify CC user.   
         Convert X into a no-op move.   
     Simplify our comparison, if possible.   
     If the code changed, we have to build a new comparison in
     undobuf.other_insn.   
         If the only change we made was to change an EQ into an NE or
         vice versa, OP0 has only one bit that might be nonzero, and OP1
         is zero, check if changing the user of the condition code will
         produce a valid insn.  If it won't, we can keep the original code
         in that insn by surrounding our operation with an XOR.   
     Otherwise, if we didn't previously have a COMPARE in the
     correct mode, we need one.   
     Otherwise, update the COMPARE if needed.   
     Get SET_SRC in a form where we have placed back any
     compound expressions.  Then do the checks below.   
 If we have (set x (subreg:m1 (op:m2 ...) 0)) with OP being some operation,
 and X being a REG or (subreg (reg)), we may be able to convert this to
 (set (subreg:m2 x) (op)).

 We can always do this if M1 is narrower than M2 because that means that
 we only care about the low bits of the result.

 However, on machines without WORD_REGISTER_OPERATIONS defined, we cannot
 perform a narrower operation than requested since the high-order bits will
 be undefined.  On machine where it is defined, this transformation is safe
 as long as M1 and M2 have the same number of words.   
 If we don't have a conditional move, SET_SRC is an IF_THEN_ELSE, and we
 are comparing an item known to be 0 or -1 against 0, use a logical
 operation instead. Check for one of the arms being an IOR of the other
 arm with some value.  We compute three terms to be IOR'ed together.  In
 practice, at most two will be nonzero.  Then we do the IOR's.   
 If either SRC or DEST is a CLOBBER of (const_int 0), make this
 whole thing fail.   
   Convert this into a field assignment operation, if possible.   

References COMPARISON_P, CONST_INT_P, expand_compound_operation(), gen_lowpart, GET_CODE, GET_MODE, GET_MODE_MASK, GET_MODE_PRECISION, GET_MODE_SIZE, HOST_BITS_PER_WIDE_INT, HWI_COMPUTABLE_MODE_P, INTVAL, nonzero_bits(), optimize_this_for_speed_p, SCALAR_INT_MODE_P, set_src_cost(), simplify_and_const_int(), simplify_shift_const(), STORE_FLAG_VALUE, subreg_lowpart_p(), SUBREG_REG, and XEXP.

static rtx simplify_shift_const ( rtx  x,
enum rtx_code  code,
enum machine_mode  result_mode,
rtx  varop,
int  count 
)
static

Simplify a shift of VAROP by COUNT bits. CODE says what kind of shift. The result of the shift is RESULT_MODE. If we cannot simplify it, return X or, if it is NULL, synthesize the expression with simplify_gen_binary. Otherwise, return a simplified value.

The shift is normally computed in the widest mode we find in VAROP, as long as it isn't a different number of words than RESULT_MODE. Exceptions are ASHIFTRT and ROTATE, which are always done in their original mode.

References XEXP.

Referenced by simplify_comparison(), and simplify_set().

static rtx simplify_shift_const_1 ( enum rtx_code  code,
enum machine_mode  result_mode,
rtx  varop,
int  orig_count 
)
static

Simplify a shift of VAROP by ORIG_COUNT bits. CODE says what kind of shift. The result of the shift is RESULT_MODE. Return NULL_RTX if we cannot simplify it. Otherwise, return a simplified value.

The shift is normally computed in the widest mode we find in VAROP, as long as it isn't a different number of words than RESULT_MODE. Exceptions are ASHIFTRT and ROTATE, which are always done in their original mode.

 We form (outer_op (code varop count) (outer_const)).   
 Make sure and truncate the "natural" shift on the way in.  We don't
 want to do this inside the loop as it makes it more difficult to
 combine shifts.   
 If we were given an invalid count, don't do anything except exactly
 what was requested.   
 Unless one of the branches of the `if' in this loop does a `continue',
 we will `break' the loop after the `if'.   
     If we have an operand of (clobber (const_int 0)), fail.   
     Convert ROTATERT to ROTATE.   
     Handle cases where the count is greater than the size of the mode
     minus 1.  For ASHIFT, use the size minus one as the count (this can
     occur when simplifying (lshiftrt (ashiftrt ..))).  For rotates,
     take the count modulo the size.  For other shifts, the result is
     zero.

     Since these shifts are being produced by the compiler by combining
     multiple operations, each of which are defined, we know what the
     result is supposed to be.   
             We can't simply return zero because there may be an
             outer op.   
     If we discovered we had to complement VAROP, leave.  Making a NOT
     here would cause an infinite loop.   
     An arithmetic right shift of a quantity known to be -1 or 0
     is a no-op.   
     If we are doing an arithmetic right shift and discarding all but
     the sign bit copies, this is equivalent to doing a shift by the
     bitsize minus one.  Convert it into that shift because it will often
     allow other simplifications.   
     We simplify the tests below and elsewhere by converting
     ASHIFTRT to LSHIFTRT if we know the sign bit is clear.
     `make_compound_operation' will convert it to an ASHIFTRT for
     those machines (such as VAX) that don't have an LSHIFTRT.   
         If we have (xshiftrt (mem ...) C) and C is MODE_WIDTH
         minus the width of a smaller mode, we can do this with a
         SIGN_EXTEND or ZERO_EXTEND from the narrower memory location.   
         If VAROP is a SUBREG, strip it as long as the inner operand has
         the same number of words as what we've seen so far.  Then store
         the widest mode in MODE.   
         Some machines use MULT instead of ASHIFT because MULT
         is cheaper.  But it is still better on those machines to
         merge two shifts into one.   
         Similar, for when divides are cheaper.   
         If we are extracting just the sign bit of an arithmetic
         right shift, that shift is not needed.  However, the sign
         bit of a wider mode may be different from what would be
         interpreted as the sign bit in a narrower mode, so, if
         the result is narrower, don't discard the shift.   
         ... fall through ...   
         Here we have two nested shifts.  The result is usually the
         AND of a new shift with a mask.  We compute the result below.   
             We have one common special case.  We can't do any merging if
             the inner code is an ASHIFTRT of a smaller mode.  However, if
             we have (ashift:M1 (subreg:M1 (ashiftrt:M2 FOO C1) 0) C2)
             with C2 == GET_MODE_BITSIZE (M1) - GET_MODE_BITSIZE (M2),
             we can convert it to
             (ashiftrt:M1 (ashift:M1 (and:M1 (subreg:M1 FOO 0) C3) C2) C1).
             This simplifies certain SIGN_EXTEND operations.   
                 C3 has the low-order C1 bits zero.   
             If this was (ashiftrt (ashift foo C1) C2) and FOO has more
             than C1 high-order bits equal to the sign bit, we can convert
             this to either an ASHIFT or an ASHIFTRT depending on the
             two counts.

             We cannot do this if VAROP's mode is not SHIFT_MODE.   
             There are some cases we can't do.  If CODE is ASHIFTRT,
             we can only do this if FIRST_CODE is also ASHIFTRT.

             We can't do the case when CODE is ROTATE and FIRST_CODE is
             ASHIFTRT.

             If the mode of this shift is not the mode of the outer shift,
             we can't do this if either shift is a right shift or ROTATE.

             Finally, we can't do any of these if the mode is too wide
             unless the codes are the same.

             Handle the case where the shift codes are the same
             first.   
             To compute the mask to apply after the shift, shift the
             nonzero bits of the inner shift the same way the
             outer shift will.   
             Give up if we can't compute an outer operation to use.   
             If the shifts are in the same direction, we add the
             counts.  Otherwise, we subtract them.   
             If COUNT is positive, the new shift is usually CODE,
             except for the two exceptions below, in which case it is
             FIRST_CODE.  If the count is negative, FIRST_CODE should
             always be used   
         If we have (A << B << C) for any shift, we can convert this to
         (A << C << B).  This wins if A is a constant.  Only try this if
         B is not a constant.   
         Make this fit the case below.   
         If we have (xshiftrt (ior (plus X (const_int -1)) X) C)
         with C the size of VAROP - 1 and the shift is logical if
         STORE_FLAG_VALUE is 1 and arithmetic if STORE_FLAG_VALUE is -1,
         we have an (le X 0) operation.   If we have an arithmetic shift
         and STORE_FLAG_VALUE is 1 or we have a logical shift with
         STORE_FLAG_VALUE of -1, we have a (neg (le X 0)) operation.   
         If we have (shift (logical)), move the logical to the outside
         to allow it to possibly combine with another logical and the
         shift to combine with another shift.  This also canonicalizes to
         what a ZERO_EXTRACT looks like.  Also, some machines have
         (and (shift)) insns.   
             We can't do this if we have (ashiftrt (xor))  and the
             constant has its sign bit set in shift_mode.   
         If we can't do that, try to simplify the shift in each arm of the
         logical expression, make a new logical expression, and apply
         the inverse distributive law.  This also can't be done
         for some (ashiftrt (xor)).   
         Convert (lshiftrt (eq FOO 0) C) to (xor FOO 1) if STORE_FLAG_VALUE
         says that the sign bit can be tested, FOO has mode MODE, C is
         GET_MODE_PRECISION (MODE) - 1, and FOO has only its low-order bit
         that may be nonzero.   
         (lshiftrt (neg A) C) where A is either 0 or 1 and C is one less
         than the number of bits in the mode is equivalent to A.   
         NEG commutes with ASHIFT since it is multiplication.  Move the
         NEG outside to allow shifts to combine.   
         (lshiftrt (plus A -1) C) where A is either 0 or 1 and C
         is one less than the number of bits in the mode is
         equivalent to (xor A 1).   
         If we have (xshiftrt (plus FOO BAR) C), and the only bits
         that might be nonzero in BAR are those being shifted out and those
         bits are known zero in FOO, we can replace the PLUS with FOO.
         Similarly in the other operand order.  This code occurs when
         we are computing the size of a variable-size array.   
         (ashift (plus foo C) N) is (plus (ashift foo N) C').   
         Check for 'PLUS signbit', which is the canonical form of 'XOR
         signbit', and attempt to change the PLUS to an XOR and move it to
         the outer operation as is done above in the AND/IOR/XOR case
         leg for shift(logical). See details in logical handling above
         for reasoning in doing so.   
         If we have (xshiftrt (minus (ashiftrt X C)) X) C)
         with C the size of VAROP - 1 and the shift is logical if
         STORE_FLAG_VALUE is 1 and arithmetic if STORE_FLAG_VALUE is -1,
         we have a (gt X 0) operation.  If the shift is arithmetic with
         STORE_FLAG_VALUE of 1 or logical with STORE_FLAG_VALUE == -1,
         we have a (neg (gt X 0)) operation.   
         Change (lshiftrt (truncate (lshiftrt))) to (truncate (lshiftrt))
         if the truncate does not affect the value.   
 We have now finished analyzing the shift.  The result should be
 a shift of type CODE with SHIFT_MODE shifting VAROP COUNT places.  If
 OUTER_OP is non-UNKNOWN, it is an operation that needs to be applied
 to the result of the shift.  OUTER_CONST is the relevant constant,
 but we must turn off all bits turned off in the shift.   
 Make a SUBREG if necessary.  If we can't make it, fail.   
 If we have an outer operation and we just made a shift, it is
 possible that we could have simplified the shift were it not
 for the outer operation.  So try to do the simplification
 recursively.   
 If we were doing an LSHIFTRT in a wider mode than it was originally,
 turn off all the bits that the shift would have turned off.   
 Do the remainder of the processing in RESULT_MODE.   
 If COMPLEMENT_P is set, we have to complement X before doing the outer
 operation.   
         This means that we have determined that the result is
         equivalent to a constant.  This should be rare.   
static rtx subst ( rtx  ,
rtx  ,
rtx  ,
int  ,
int  ,
int   
)
static
static rtx subst ( )
static

Throughout X, replace FROM with TO, and return the result. The result is TO if X is FROM; otherwise the result is X, but its contents may have been modified. If they were modified, a record was made in undobuf so that undo_all will (among other things) return X to its original state.

If the number of changes necessary is too much to record to undo, the excess changes are not made, so the result is invalid. The changes already made can still be undone. undobuf.num_undo is incremented for such changes, so by testing that the caller can tell whether the result is valid.

`n_occurrences' is incremented each time FROM is replaced.

IN_DEST is nonzero if we are processing the SET_DEST of a SET.

IN_COND is nonzero if we are at the top level of a condition.

UNIQUE_COPY is nonzero if each substitution must be unique. We do this by copying if `n_occurrences' is nonzero.

Two expressions are equal if they are identical copies of a shared RTX or if they are both registers with the same register number and mode.

 If X and FROM are the same register but different modes, they
 will not have been seen as equal above.  However, the log links code
 will make a LOG_LINKS entry for that case.  If we do nothing, we
 will try to rerecognize our original insn and, when it succeeds,
 we will delete the feeding insn, which is incorrect.

 So force this insn not to match in this (rare) case.   
 If this is an object, we are done unless it is a MEM or LO_SUM, both
 of which may contain things that can be combined.   
 It is possible to have a subexpression appear twice in the insn.
 Suppose that FROM is a register that appears within TO.
 Then, after that subexpression has been scanned once by `subst',
 the second time it is scanned, TO may be found.  If we were
 to scan TO here, we would find FROM within it and create a
 self-referent rtl structure which is completely wrong.   
 Parallel asm_operands need special attention because all of the
 inputs are shared across the arms.  Furthermore, unsharing the
 rtl results in recognition failures.  Failure to handle this case
 specially can result in circular rtl.

 Solve this by doing a normal pass across the first entry of the
 parallel, and only processing the SET_DESTs of the subsequent
 entries.  Ug.   
     If this substitution failed, this whole thing fails.   
             If this substitution failed, this whole thing fails.   
     We don't need to process a SET_DEST that is a register, CC0,
     or PC, so set up to skip this common case.  All other cases
     where we want to suppress replacing something inside a
     SET_SRC are handled via the IN_DEST operand.   
     Get the mode of operand 0 in case X is now a SIGN_EXTEND of a
     constant.   
                     If this substitution failed, this whole thing
                     fails.   
             If this is a register being set, ignore it.   
                 In general, don't install a subreg involving two
                 modes not tieable.  It can worsen register
                 allocation, and can even make invalid reload
                 insns, since the reg inside may need to be copied
                 from in the outside mode, and that may be invalid
                 if it is an fp reg copied in integer mode.

                 We allow two exceptions to this: It is valid if
                 it is inside another SUBREG and the mode of that
                 SUBREG and the mode of the inside of TO is
                 tieable and it is valid if X is a SET that copies
                 FROM to CC0.   
               If we are in a SET_DEST, suppress most cases unless we
               have gone inside a MEM, in which case we want to
               simplify the address.  We assume here that things that
               are actually part of the destination have their inner
               parts in the first expression.  This is true for SUBREG,
               STRICT_LOW_PART, and ZERO_EXTRACT, which are the only
               things aside from REG and MEM that should appear in a
               SET_DEST.   
             If we found that we will have to reject this combination,
             indicate that by returning the CLOBBER ourselves, rather than
             an expression containing it.  This will speed things up as
             well as prevent accidents where two CLOBBERs are considered
             to be equal, thus producing an incorrect simplification.   
 Check if we are loading something from the constant pool via float
 extension; in this case we would undo compress_float_constant
 optimization and degenerate constant load to an immediate value.   
 Try to simplify X.  If the simplification changed the code, it is likely
 that further simplification will help, so loop, but limit the number
 of repetitions that will be performed.   
     If X is sufficiently simple, don't bother trying to do anything
     with it.   
     We no longer know the original mode of operand 0 since we
     have changed the form of X)   

References const0_rtx, CONST_INT_P, const_true_rtx, GET_CODE, INTVAL, reversed_comparison_code_parts(), simplify_gen_relational(), simplify_gen_unary(), and STORE_FLAG_VALUE.

static void target_canonicalize_comparison ( enum rtx_code code,
rtx op0,
rtx op1,
bool  op0_preserve_value 
)
inlinestatic

Convenience wrapper for the canonicalize_comparison target hook. Target hooks cannot use enum rtx_code.

References CASE_CONST_ANY, GET_CODE, REG_P, SET, and SET_DEST.

static rtx try_combine ( rtx  i3,
rtx  i2,
rtx  i1,
rtx  i0,
int *  new_direct_jump_p,
rtx  last_combined_insn 
)
static

Try to combine the insns I0, I1 and I2 into I3. Here I0, I1 and I2 appear earlier than I3. I0 and I1 can be zero; then we combine just I2 into I3, or I1 and I2 into I3.

If we are combining more than two insns and the resulting insn is not recognized, try splitting it into two insns. If that happens, I2 and I3 are retained and I1/I0 are pseudo-deleted by turning them into a NOTE. Otherwise, I0, I1 and I2 are pseudo-deleted.

Return 0 if the combination does not work. Then nothing is changed. If we did the combination, return the insn at which combine should resume scanning.

Set NEW_DIRECT_JUMP_P to a nonzero value if try_combine creates a new direct jump instruction.

LAST_COMBINED_INSN is either I3, or some insn after I3 that has been I3 passed to an earlier try_combine within the same basic block.

 New patterns for I3 and I2, respectively.   
 Indicates need to preserve SET in I0, I1 or I2 in I3 if it is not
 dead.   
 Total number of SETs to put into I3.   
 Nonzero if I2's or I1's body now appears in I3.   
 INSN_CODEs for new I3, new I2, and user of condition code.   
 Contains I3 if the destination of I3 is used in its source, which means
 that the old life of I3 is being killed.  If that usage is placed into
 I2 and not in I3, a REG_DEAD note must be made.   
 SET_DEST and SET_SRC of I2, I1 and I0.   
 Copy of SET_SRC of I1 and I0, if needed.   
 Set if I2DEST was reused as a scratch register.   
 The PATTERNs of I0, I1, and I2, or a copy of them in certain cases.   
 Indicates if I2DEST or I1DEST is in I2SRC or I1_SRC.   
 Notes that must be added to REG_NOTES in I3 and I2.   
 Notes that we substituted I3 into I2 instead of the normal case.   
 Notes that I1, I2 or I3 is a MULT operation.   
 Only try four-insn combinations when there's high likelihood of
 success.  Look for simple insns, such as loads of constants or
 binary operations involving a constant.   
 Exit early if one of the insns involved can't be used for
 combinations.   
 Reset the hard register usage information.   
 If multiple insns feed into one of I2 or I3, they can be in any
 order.  To simplify the code below, reorder them in sequence.   
 First check for one important special case that the code below will
 not handle.  Namely, the case where I1 is zero, I2 is a PARALLEL
 and I3 is a SET whose SET_SRC is a SET_DEST in I2.  In that case,
 we may be able to replace that destination with the destination of I3.
 This occurs in the common code where we compute both a quotient and
 remainder into a structure, in which case we want to do the computation
 directly into the structure to avoid register-register copies.

 Note that this case handles both multiple sets in I2 and also cases
 where I2 has a number of CLOBBERs inside the PARALLEL.

 We make very conservative checks below and only try to handle the
 most common cases of this.  For example, we only handle the case
 where I2 and I3 are adjacent to avoid making difficult register
 usage tests.   
     If the dest of I3 is a ZERO_EXTRACT or STRICT_LOW_PART, the code
     below would need to check what is inside (and reg_overlap_mentioned_p
     doesn't support those codes anyway).  Don't allow those destinations;
     the resulting insn isn't likely to be recognized anyway.   
     Make sure that the destination of I3,
     which we are going to substitute into one output of I2,
     is not used within another output of I2.  We must avoid making this:
     (parallel [(set (mem (reg 69)) ...)
                (set (reg 69) ...)])
     which is not well-defined as to order of actions.
     (Besides, reload can't handle output reloads for this.)

     The problem can also happen if the dest of I3 is a memory ref,
     if another dest in I2 is an indirect memory ref.   
             Replace the dest in I2 with our dest and make the resulting
             insn the new pattern for I3.  Then skip to where we validate
             the pattern.  Everything was set up above.   
 If I2 is setting a pseudo to a constant and I3 is setting some
 sub-part of it to another constant, merge them by making a new
 constant.   
         If this is the low part, we're done.   
         Handle the case where inner is twice the size of outer.   
         Otherwise give up for now.   
         Replace the source in I2 with the new constant and make the
         resulting insn the new pattern for I3.  Then skip to where we
         validate the pattern.  Everything was set up above.   
         The dest of I3 has been replaced with the dest of I2.   
 If we have no I1 and I2 looks like:
    (parallel [(set (reg:CC X) (compare:CC OP (const_int 0)))
               (set Y OP)])
 make up a dummy I1 that is
    (set Y OP)
 and change I2 to be
    (set (reg:CC X) (compare:CC Y (const_int 0)))

 (We can ignore any trailing CLOBBERs.)

 This undoes a previous combination and allows us to match a branch-and-
 decrement insn.   
         We make I1 with the same INSN_UID as I2.  This gives it
         the same DF_INSN_LUID for value tracking.  Our fake I1 will
         never appear in the insn stream so giving it the same INSN_UID
         as I2 will not cause a problem.   
 Verify that I2 and I1 are valid for combining.   
 Record whether I2DEST is used in I2SRC and similarly for the other
 cases.  Knowing this will help in register status updating below.   
 For the earlier insns, determine which of the subsequent ones they
 feed.   
 Ensure that I3's pattern can be the destination of combines.   
 See if any of the insns is a MULT operation.  Unless one is, we will
 reject a combination that is, since it must be slower.  Be conservative
 here.   
 If I3 has an inc, then give up if I1 or I2 uses the reg that is inc'd.
 We used to do this EXCEPT in one case: I3 has a post-inc in an
 output operand.  However, that exception can give rise to insns like
    mov r3,(r3)+
 which is a famous insn on the PDP-11 where the value of r3 used as the
 source was model-dependent.  Avoid this sort of thing.   
 See if the SETs in I1 or I2 need to be kept around in the merged
 instruction: whenever the value set there is still needed past I3.
 For the SET in I2, this is easy: we see if I2DEST dies or is set in I3.

 For the SET in I1, we have two cases: if I1 and I2 independently feed
 into I3, the set in I1 needs to be kept around unless I1DEST dies
 or is set in I3.  Otherwise (if I1 feeds I2 which feeds I3), the set
 in I1 needs to be kept around unless I1DEST dies or is set in either
 I2 or I3.  The same considerations apply to I0.   
 We are about to copy insns for the case where they need to be kept
 around.  Check that they can be copied in the merged instruction.   
 If the set in I2 needs to be kept around, we must make a copy of
 PATTERN (I2), so that when we substitute I1SRC for I1DEST in
 PATTERN (I2), we are only substituting for the original I1DEST, not into
 an already-substituted copy.  This also prevents making self-referential
 rtx.  If I2 is a PARALLEL, we just need the piece that assigns I2SRC to
 I2DEST.   
 Substitute in the latest insn for the regs set by the earlier ones.   
 Many machines that don't use CC0 have insns that can both perform an
 arithmetic operation and set the condition code.  These operations will
 be represented as a PARALLEL with the first element of the vector
 being a COMPARE of an arithmetic operation with the constant zero.
 The second element of the vector will set some pseudo to the result
 of the same arithmetic operation.  If we simplify the COMPARE, we won't
 match such a pattern and so will generate an extra insn.   Here we test
 for this case, where both the comparison and the operation result are
 needed, and make the PARALLEL by just replacing I2DEST in I3SRC with
 I2SRC.  Later we will make the PARALLEL that contains I2.   
     Do the rest only if op1 is const0_rtx, which may be the
     result of simplification.   
         If a single use of the CC is found, prepare to modify it
         when SELECT_CC_MODE returns a new CC-class mode, or when
         the above simplify_compare_const() returned a new comparison
         operator.  undobuf.other_insn is assigned the CC use insn
         when modifying it.   
             Cases for modifying the CC-using comparison.   
                 ??? Do we need to verify the zero rtx?   
                 Replace cc_use_loc with entire new RTX.   
                 Just replace the CC reg with a new mode.   
         Now we modify the current newpat:
         First, SET_DEST(newpat) is updated if the CC mode has been
         altered. For targets without SELECT_CC_MODE, this should be
         optimized away.   
         This is always done to propagate i2src into newpat.   
         Create new version of i2pat if needed; the below PARALLEL
         creation needs this to work correctly.   
     It is possible that the source of I2 or I1 may be performing
     an unneeded operation, such as a ZERO_EXTEND of something
     that is known to have the high part zero.  Handle that case
     by letting subst look at the inner insns.

     Another way to do this would be to have a function that tries
     to simplify a single insn instead of merging two or more
     insns.  We don't do this because of the potential of infinite
     loops and because of the potential extra memory required.
     However, doing it the way we are is a bit of a kludge and
     doesn't catch all cases.

     But only do this if -fexpensive-optimizations since it slows
     things down and doesn't usually win.

     This is not done in the COMPARE case above because the
     unmodified I2PAT is used in the PARALLEL and so a pattern
     with a modified I2SRC would not match.   
         Pass pc_rtx so no substitutions are done, just
         simplifications.   
     If I1 feeds into I2 and I1DEST is in I1SRC, we need to make a unique
     copy of I2SRC each time we substitute it, in order to avoid creating
     self-referential RTL when we will be substituting I1SRC for I1DEST
     later.  Likewise if I0 feeds into I2, either directly or indirectly
     through I1, and I0DEST is in I0SRC.   
     Record whether I2's body now appears within I3's body.   
 If we already got a failure, don't try to do more.  Otherwise, try to
 substitute I1 if we have it.   
     Check that an autoincrement side-effect on I1 has not been lost.
     This happens if I1DEST is mentioned in I2 and dies there, and
     has disappeared from the new pattern.   
          Before we can do this substitution, we must redo the test done
          above (see detailed comments there) that ensures I1DEST isn't
          mentioned in any SETs in NEWPAT that are field assignments.   
     If the following substitution will modify I1SRC, make a copy of it
     for the case where it is substituted for I1DEST in I2PAT later.   
     If I0 feeds into I1 and I0DEST is in I0SRC, we need to make a unique
     copy of I1SRC each time we substitute it, in order to avoid creating
     self-referential RTL when we will be substituting I0SRC for I0DEST
     later.   
     Record whether I1's body now appears within I3's body.   
 Likewise for I0 if we have it.   
     If the following substitution will modify I0SRC, make a copy of it
     for the case where it is substituted for I0DEST in I1PAT later.   
     And a copy for I0DEST in I2PAT substitution.   
 Fail if an autoincrement side-effect has been duplicated.  Be careful
 to count all the ways that I2SRC and I1SRC can be used.   
     Fail if we tried to make a new register.   
     Fail if we couldn't do something and have a CLOBBER.   
     Fail if this new pattern is a MULT and we didn't have one before
     at the outer level.   
 If the actions of the earlier insns must be kept
 in addition to substituting them into the latest one,
 we must make a new PARALLEL for the latest insn
 to hold additional the SETs.   
 Note which hard regs this insn has as inputs.   
 If recog_for_combine fails, it strips existing clobbers.  If we'll
 consider splitting this pattern, we might need these clobbers.   
 Is the result of combination a valid instruction?   
 If the result isn't valid, see if it is a PARALLEL of two SETs where
 the second SET's destination is a register that is unused and isn't
 marked as an instruction that might trap in an EH region.  In that case,
 we just need the first SET.   This can occur when simplifying a divmod
 insn.  We *must* test for this case here because the code below that
 splits two independent SETs doesn't handle this case correctly when it
 updates the register status.

 It's pointless doing this if we originally had two sets, one from
 i3, and one from i2.  Combining then splitting the parallel results
 in the original i2 again plus an invalid insn (which we delete).
 The net effect is only to move instructions around, which makes
 debug info less accurate.

 Also check the case where the first SET's destination is unused.
 That would not cause incorrect code, but does cause an unneeded
 insn to remain.   
 If we were combining three insns and the result is a simple SET
 with no ASM_OPERANDS that wasn't recognized, try to split it into two
 insns.  There are two ways to do this.  It can be split using a
 machine-specific method (like when you have an addition of a large
 constant) or by combine in the function find_split_point.   
     See if the MD file can split NEWPAT.  If it can't, see if letting it
     use I2DEST as a scratch register will help.  In the latter case,
     convert I2DEST to the mode of the source of NEWPAT if we can.   
     We can only use I2DEST as a scratch reg if it doesn't overlap any
     inputs of NEWPAT.   
     ??? If I2DEST is not safe, and I1DEST exists, then it would be
     possible to try that as a scratch reg.  This would require adding
     more code to make it work though.   
         First try to split using the original register as a
         scratch register.   
         If that didn't work, try changing the mode of I2DEST if
         we can.   
     If recog_for_combine has discarded clobbers, try to use them
     again for the split.   
         If I2 or I3 has multiple SETs, we won't know how to track
         register status, so don't use these insns.  If I2's destination
         is used between I2 and I3, we also can't use these insns.   
         It is possible that both insns now set the destination of I3.
         If so, we must show an extra use of it.   
     If we can split it and use I2DEST, go ahead and see if that
     helps things be recognized.  Verify that none of the registers
     are set between I2 and I3.   
         We need I2DEST in the proper mode.  If it is a hard register
         or the only use of a pseudo, we can change its mode.
         Make sure we don't change a hard register to have a mode that
         isn't valid for it, or change the number of registers.   
         We can't overwrite I2DEST if its value is still used by
         NEWPAT.   
         *SPLIT may be part of I2SRC, so make sure we have the
         original expression around for later debug processing.
         We should not need I2SRC any more in other cases.   
         Get NEWDEST as a register in the proper mode.  We have already
         validated that we can do this.   
         If *SPLIT is a (mult FOO (const_int pow2)), convert it to
         an ASHIFT.  This can occur if it was inside a PLUS and hence
         appeared to be a memory address.  This is a kludge.   
             Update split_code because we may not have a multiply
             anymore.   
         Attempt to split binary operators using arithmetic identities.   
             Split "X = Y op Y" as "Z = Y; X = Z op Z".   
             Split "((P op Q) op R) op S" where op is PLUS or MULT.   
                 Split both "((X op Y) op X) op Y" and
                 "((X op Y) op Y) op X" as "T op T" where T is
                 "X op Y".   
                 Split "((X op X) op Y) op Y)" as "T op T" where
                 T is "X op Y".   
         recog_for_combine might have added CLOBBERs to newi2pat.
         Make sure NEWPAT does not depend on the clobbered regs.   
         If the split point was a MULT and we didn't have one before,
         don't use one now.   
 Check for a case where we loaded from memory in a narrow mode and
 then sign extended it, but we need both registers.  In that case,
 we have a PARALLEL with both loads from the same memory location.
 We can split this into a load from memory followed by a register-register
 copy.  This saves at least one insn, more if register allocation can
 eliminate the copy.

 We cannot do this if the destination of the first assignment is a
 condition code register or cc0.  We eliminate this case by making sure
 the SET_DEST and SET_SRC have the same mode.

 We cannot do this if the destination of the second assignment is
 a register that we have already assumed is zero-extended.  Similarly
 for a SUBREG of such a register.   
 Similarly, check for a case where we have a PARALLEL of two independent
 SETs but we started with three insns.  In this case, we can do the sets
 as two separate insns.  This case occurs when some SET allows two
 other insns to combine, but the destination of that SET is still live.   
     Normally, it doesn't matter which of the two is done first,
     but the one that references cc0 can't be the second, and
     one which uses any regs/memory set in between i2 and i3 can't
     be first.  The PARALLEL might also have been pre-existing in i3,
     so we need to make sure that we won't wrongly hoist a SET to i2
     that would conflict with a death note present in there.   
         recog_for_combine might have added CLOBBERs to newi2pat.
         Make sure NEWPAT does not depend on the clobbered regs.   
 If it still isn't recognized, fail and change things back the way they
 were.   
      Is the result a reasonable ASM_OPERANDS?   
 If we had to change another insn, make sure it is valid also.   
 Only allow this combination if insn_rtx_costs reports that the
 replacement instructions are cheaper than the originals.   
           Temporarily revert mode back.   
               If we used i2dest as a scratch register with a
               different mode, substitute it for the original
               i2src while its original mode is temporarily
               restored, and then clear i2scratch so that we don't
               do it again later.   
               Put back the new mode.   
               We're dealing with a reg that changed mode but not
               meaning, so we want to turn it into a subreg for
               the new mode.  However, because of REG sharing and
               because its mode had already changed, we have to do
               it in two steps.  First, replace any debug uses of
               reg, with its original mode temporarily restored,
               with this copy we have created; then, replace the
               copy with the SUBREG of the original shared reg,
               once again changed to the new mode.   
 If we will be able to accept this, we have made a
 change to the destination of I3.  This requires us to
 do a few adjustments.   
 We now know that we can do this combination.  Merge the insns and
 update the status of registers and LOG_LINKS.   
     If any of the notes in OTHER_INSN were REG_UNUSED, ensure that they
     are still valid.  Then add any non-duplicate notes added by
     recog_for_combine.   
     I3 now uses what used to be its destination and which is now
     I2's destination.  This requires us to do a few adjustments.   
     We need a LOG_LINK from I3 to I2.  But we used to have one,
     so we still will.

     However, some later insn might be using I2's dest and have
     a LOG_LINK pointing at I3.  We must remove this link.
     The simplest way to remove the link is to point it at I1,
     which we know will be a NOTE.   
     newi2pat is usually a SET here; however, recog_for_combine might
     have added some clobbers.   
   Compute which registers we expect to eliminate.  newi2pat may be setting
   either i3dest or i2dest, so we must check it.  Also, i1dest may be the
   same as i3dest, in which case newi2pat may be setting i1dest.   
   Get the old REG_NOTES and LOG_LINKS from all our insns and
   clear them.   
   Ensure that we do not have something that should not be shared but
   occurs multiple times in the new insns.  Check this by first
   resetting all the `used' flags and then copying anything is shared.   
           I2SRC must still be meaningful at this point.  Some splitting
           operations can invalidate I2SRC, but those operations do not
           apply to calls.   
   We had one special case above where I2 had more than one set and
   we replaced a destination of one of those sets with the destination
   of I3.  In that case, we have to update LOG_LINKS of insns later
   in this basic block.  Note that this (expensive) case is rare.

   Also, in this case, we must pretend that all REG_NOTEs for I2
   actually came from I3, so that REG_UNUSED notes from I2 will be
   properly handled.   
   Get death notes for everything that is now used in either I3 or
   I2 and used to die in a previous insn.  If we built two new
   patterns, move from I1 to I2 then I2 to I3 so that we get the
   proper movement on registers that I2 modifies.   
   Distribute all the LOG_LINKS and REG_NOTES from I1, I2, and I3.   
   Distribute any notes added to I2 or I3 by recog_for_combine.  We
   know these are REG_UNUSED and want them to go to the desired insn,
   so we always pass it as i3.   
   If I3DEST was used in I3SRC, it really died in I3.  We may need to
   put a REG_DEAD note for it somewhere.  If NEWI2PAT exists and sets
   I3DEST, the death must be somewhere before I2, not I3.  If we passed I3
   in that case, it might delete I2.  Similarly for I2 and I1.
   Show an additional death due to the REG_DEAD note we make here.  If
   we discard it in distribute_notes, we will decrement it again.   
       The insn that used to set this register doesn't exist, and
       this life of the register may not exist either.  See if one of
       I3's links points to an insn that sets I2DEST.  If it does,
       that is now the last known value for I2DEST. If we don't update
       this and I2 set the register to a value that depended on its old
       contents, we will get confused.  If this insn is used, thing
       will be set correctly in combine_instructions.   
       If the reg formerly set in I2 died only once and that was in I3,
       zero its use count so it won't make `reload' do any work.   
   Update reg_stat[].nonzero_bits et al for any changes that may have
   been made to this insn.  The order is important, because newi2pat
   can affect nonzero_bits of newpat.   
 Set new_direct_jump_p if a new return or simple jump instruction
 has been created.  Adjust the CFG accordingly.   
 A noop might also need cleaning up of CFG, if it comes from the
 simplification of a jump.   

References combine_merges, dead_or_set_p(), DF_INSN_LUID, PATTERN, SET_DEST, SET_SRC, SUBST, subst_insn, subst_low_luid, and XVECEXP.

static enum machine_mode try_widen_shift_mode ( enum rtx_code  code,
rtx  op,
int  count,
enum machine_mode  orig_mode,
enum machine_mode  mode,
enum rtx_code  outer_code,
HOST_WIDE_INT  outer_const 
)
static

A helper to simplify_shift_const_1 to determine the mode we can perform the shift in. The original shift operation CODE is performed on OP in ORIG_MODE. Return the wider mode MODE if we can perform the operation in that mode. Return ORIG_MODE otherwise. We can also assume that the result of the shift is subject to operation OUTER_CODE with operand OUTER_CONST.

 In general we can't perform in wider mode for right shift and rotate.   
     We can still widen if the bits brought in from the left are identical
     to the sign bit of ORIG_MODE.   
     Similarly here but with zero bits.   
     We can also widen if the bits brought in will be masked off.  This
     operation is performed in ORIG_MODE.   
     fall through  

References GEN_INT, INTVAL, and XEXP.

static void undo_all ( )
static

Undo all the modifications recorded in undobuf.

static void undo_commit ( )
static

We've committed to accepting the changes we made. Move all of the undos to the free list.

References find_split_point(), GEN_INT, gen_int_mode(), gen_lowpart, HOST_WIDE_INT, SET_SRC, and SUBST.

static bool unmentioned_reg_p ( rtx  ,
rtx   
)
static
static bool unmentioned_reg_p ( )
static

Check for any register or memory mentioned in EQUIV that is not mentioned in EXPR. This is used to restrict EQUIV to "specializations" of EXPR where some registers may have been replaced by constants.

static int unmentioned_reg_p_1 ( rtx ,
void *   
)
static
static int unmentioned_reg_p_1 ( )
static

Subroutine of unmentioned_reg_p and callback from for_each_rtx. Check whether the expression pointer to by LOC is a register or memory, and if so return 1 if it isn't mentioned in the rtx EXPR. Otherwise return zero.

static void update_cfg_for_uncondjump ( )
static

Delete the unconditional jump INSN and adjust the CFG correspondingly. Note that the INSN should be deleted after removing dead edges, so that the kept edge is the fallthrough edge for a (set (pc) (pc)) but not for a (set (pc) (label_ref FOO)).

Remove barriers from the footer if there are any.

References GET_CODE, PATTERN, reg_overlap_mentioned_p(), SET, SET_DEST, SET_SRC, XVECEXP, and XVECLEN.

static void update_table_tick ( rtx  )
static
static void update_table_tick ( )
static

Utility function for following routine. Called when X is part of a value being stored into last_set_value. Sets last_set_table_tick for each register mentioned. Similar to mention_regs in cse.c

       Check for identical subexpressions.  If x contains
       identical subexpression we only have to traverse one of
       them.   
           Note that at this point x1 has already been
           processed.   
           If x0 and x1 are identical then there is no need to
           process x0.   
           If x0 is identical to a subexpression of x1 then while
           processing x1, x0 has already been processed.  Thus we
           are done with x.   
           If x1 is identical to a subexpression of x0 then we
           still have to process the rest of x0.   

References find_regno_note(), and remove_note().

static int use_crosses_set_p ( const_rtx  ,
int   
)
static
static int use_crosses_set_p ( )
static

Return nonzero if expression X refers to a REG or to memory that is set in an instruction more recent than FROM_LUID.

References alloc_reg_note(), dead_or_set_p(), dead_or_set_regno_p(), distribute_notes(), END_HARD_REGNO, find_regno_fusage(), hard_regno_nregs, NONDEBUG_INSN_P, PATTERN, PREV_INSN, refers_to_regno_p(), reg_bitfield_target_p(), reg_raw_mode, regno_reg_rtx, and this_basic_block.


Variable Documentation

rtx added_links_insn
static

This is an insn to which a LOG_LINKS entry has been added. If this insn is the earlier than I2 or I3, combine should rescan starting at that location.

int combine_attempts
static

Optimize by combining instructions for GNU compiler. Copyright (C) 1987-2013 Free Software Foundation, Inc.

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 module is essentially the "combiner" phase of the U. of Arizona Portable Optimizer, but redone to work on our list-structured representation for RTL instead of their string representation.

The LOG_LINKS of each insn identify the most recent assignment to each REG used in the insn. It is a list of previous insns, each of which contains a SET for a REG that is used in this insn and not used or set in between. LOG_LINKs never cross basic blocks. They were set up by the preceding pass (lifetime analysis).

We try to combine each pair of insns joined by a logical link. We also try to combine triplets of insns A, B and C when C has a link back to B and B has a link back to A. Likewise for a small number of quadruplets of insns A, B, C and D for which there's high likelihood of of success.

LOG_LINKS does not have links for use of the CC0. They don't need to, because the insn that sets the CC0 is always immediately before the insn that tests it. So we always regard a branch insn as having a logical link to the preceding insn. The same is true for an insn explicitly using CC0.

We check (with use_crosses_set_p) to avoid combining in such a way as to move a computation to a place where its value would be different.

Combination is done by mathematically substituting the previous insn(s) values for the regs they set into the expressions in the later insns that refer to these regs. If the result is a valid insn for our target machine, according to the machine description, we install it, delete the earlier insns, and update the data flow information (LOG_LINKS and REG_NOTES) for what we did.

There are a few exceptions where the dataflow information isn't completely updated (however this is only a local issue since it is regenerated before the next pass that uses it):

  • reg_live_length is not updated
  • reg_n_refs is not adjusted in the rare case when a register is no longer required in a computation
  • there are extremely rare cases (see distribute_notes) when a REG_DEAD note is lost
  • a LOG_LINKS entry that refers to an insn with multiple SETs may be removed because there is no way to know which register it was linking

To simplify substitution, we combine only when the earlier insn(s) consist of only a single assignment. To simplify updating afterward, we never combine when a subroutine call appears in the middle.

Since we do not represent assignments to CC0 explicitly except when that is all an insn does, there is no LOG_LINKS entry in an insn that uses the condition code for the insn that set the condition code. Fortunately, these two insns must be consecutive. Therefore, every JUMP_INSN is taken to have an implicit logical link to the preceding insn. This is not quite right, since non-jumps can also use the condition code; but in practice such insns would not combine anyway. Include expr.h after insn-config.h so we get HAVE_conditional_move. Number of attempts to combine instructions in this function.

int combine_extras
static

Number of instructions combined with added SETs in this function.

int combine_merges
static

Number of attempts that got as far as substitution in this function.

Referenced by try_combine().

struct rtl_hooks combine_rtl_hooks = RTL_HOOKS_INITIALIZER
static
int combine_successes
static

Number of instructions combined in this function.

rtx i2mod
static

combine_instructions may try to replace the right hand side of the second instruction with the value of an associated REG_EQUAL note before throwing it at try_combine. That is problematic when there is a REG_DEAD note for a register used in the old right hand side and can cause distribute_notes to do wrong things. This is the second instruction if it has been so modified, null otherwise.

rtx i2mod_new_rhs
static

When I2MOD is nonnull, this is a copy of the new right hand side.

rtx i2mod_old_rhs
static

When I2MOD is nonnull, this is a copy of the old right hand side.

struct obstack insn_link_obstack
static

Links for LOG_LINKS are allocated from this obstack.

int label_tick
static

Incremented for each basic block.

int label_tick_ebb_start
static

Reset to label_tick for each extended basic block in scanning order.

int last_call_luid
static

Record the luid of the last CALL_INSN so we can tell whether a potential combination crosses any calls.

int max_uid_known
static

Length of the currently allocated uid_insn_cost array.

int mem_last_set
static

Record the luid of the last insn that invalidated memory (anything that writes memory, and subroutine calls, but not pushes).

int n_occurrences
static

Number of times the pseudo being substituted for was found and replaced.

HARD_REG_SET newpat_used_regs
static

This contains any hard registers that are used in newpat; reg_dead_at_p must consider all these registers to be always live.

enum machine_mode nonzero_bits_mode
static

Mode used to compute significance in reg_stat[].nonzero_bits. It is the largest integer mode that can fit in HOST_BITS_PER_WIDE_INT.

int nonzero_sign_valid
static

Nonzero when reg_stat[].nonzero_bits and reg_stat[].sign_bit_copies can be safely used. It is zero while computing them and after combine has completed. This former test prevents propagating values based on previously set values, which can be incorrect if a variable is modified in a loop.

bool optimize_this_for_speed_p
static

Referenced by simplify_set().

unsigned int reg_dead_endregno
static
int reg_dead_flag
static
unsigned int reg_dead_regno
static

Define three variables used for communication between the following routines.

vec<reg_stat_type> reg_stat
static

Referenced by init_reg_last().

rtx subst_insn
static

When `subst' is called, this is the insn that is being modified (by combining in a previous insn). The PATTERN of this insn is still the old pattern partially modified and it should not be looked at, but this may be used to examine the successors of the insn to judge whether a simplification is valid.

Referenced by try_combine().

int subst_low_luid
static

This is the lowest LUID that `subst' is currently dealing with. get_last_value will not return a value if the register was set at or after this LUID. If not for this mechanism, we could get confused if I2 or I1 in try_combine were an insn that used the old value of a register to obtain a new value. In that case, we might erroneously get the new value of the register when we wanted the old one.

Referenced by try_combine().

basic_block this_basic_block
static

Basic block in which we are performing combines.

Referenced by use_crosses_set_p().

int total_attempts
static

Totals over entire compilation.

int total_extras
static
int total_merges
static
int total_successes
static
int* uid_insn_cost
static

The following array records the insn_rtx_cost for every insn in the instruction stream.

struct insn_link** uid_log_links
static
struct undobuf undobuf
static