Annotation of GNUtools/cc/rtl.def, revision 1.1

1.1     ! root        1: /* This file contains the definitions and documentation for the
        !             2:    Register Transfer Expressions (rtx's) that make up the
        !             3:    Register Transfer Language (rtl) used in the Back End of the GNU compiler.
        !             4:    Copyright (C) 1987, 1988, 1992 Free Software Foundation, Inc.
        !             5: 
        !             6: This file is part of GNU CC.
        !             7: 
        !             8: GNU CC is free software; you can redistribute it and/or modify
        !             9: it under the terms of the GNU General Public License as published by
        !            10: the Free Software Foundation; either version 2, or (at your option)
        !            11: any later version.
        !            12: 
        !            13: GNU CC is distributed in the hope that it will be useful,
        !            14: but WITHOUT ANY WARRANTY; without even the implied warranty of
        !            15: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        !            16: GNU General Public License for more details.
        !            17: 
        !            18: You should have received a copy of the GNU General Public License
        !            19: along with GNU CC; see the file COPYING.  If not, write to
        !            20: the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
        !            21: 
        !            22: 
        !            23: /* Expression definitions and descriptions for all targets are in this file.
        !            24:    Some will not be used for some targets.
        !            25: 
        !            26:    The fields in the cpp macro call "DEF_RTL_EXPR()"
        !            27:    are used to create declarations in the C source of the compiler.
        !            28: 
        !            29:    The fields are:
        !            30: 
        !            31:    1.  The internal name of the rtx used in the C source.
        !            32:    It is a tag in the enumeration "enum rtx_code" defined in "rtl.h".
        !            33:    By convention these are in UPPER_CASE.
        !            34: 
        !            35:    2.  The name of the rtx in the external ASCII format read by
        !            36:    read_rtx(), and printed by print_rtx().
        !            37:    These names are stored in rtx_name[].
        !            38:    By convention these are the internal (field 1) names in lower_case.
        !            39: 
        !            40:    3.  The print format, and type of each rtx->fld[] (field) in this rtx.
        !            41:    These formats are stored in rtx_format[].
        !            42:    The meaning of the formats is documented in front of this array in rtl.c
        !            43:    
        !            44:    4.  The class of the rtx.  These are stored in rtx_class and are accessed
        !            45:    via the GET_RTX_CLASS macro.  They are defined as follows:
        !            46: 
        !            47:      "o" an rtx code that can be used to represent an object (e.g, REG, MEM)
        !            48:      "<" an rtx code for a comparison (e.g, EQ, NE, LT)
        !            49:      "1" an rtx code for a unary arithmetic expression (e.g, NEG, NOT)
        !            50:      "c" an rtx code for a commutative binary operation (e.g,, PLUS, MULT)
        !            51:      "3" an rtx code for a non-bitfield three input operation (IF_THEN_ELSE)
        !            52:      "2" an rtx code for a non-commutative binary operation (e.g., MINUS, DIV)
        !            53:      "b" an rtx code for a bit-field operation (ZERO_EXTRACT, SIGN_EXTRACT)
        !            54:      "i" an rtx code for a machine insn (INSN, JUMP_INSN, CALL_INSN)
        !            55:      "m" an rtx code for something that matches in insns (e.g, MATCH_DUP)
        !            56:      "x" everything else
        !            57:      
        !            58:    */
        !            59: 
        !            60: /* ---------------------------------------------------------------------
        !            61:    Expressions (and "meta" expressions) used for structuring the
        !            62:    rtl representation of a program.
        !            63:    --------------------------------------------------------------------- */
        !            64: 
        !            65: /* an expression code name unknown to the reader */
        !            66: DEF_RTL_EXPR(UNKNOWN, "UnKnown", "*", 'x')
        !            67: 
        !            68: /* (NIL) is used by rtl reader and printer to represent a null pointer.  */
        !            69: 
        !            70: DEF_RTL_EXPR(NIL, "nil", "*", 'x')
        !            71: 
        !            72: /* ---------------------------------------------------------------------
        !            73:    Expressions used in constructing lists.
        !            74:    --------------------------------------------------------------------- */
        !            75: 
        !            76: /* a linked list of expressions */
        !            77: DEF_RTL_EXPR(EXPR_LIST, "expr_list", "ee", 'x')
        !            78: 
        !            79: /* a linked list of instructions.
        !            80:    The insns are represented in print by their uids.  */
        !            81: DEF_RTL_EXPR(INSN_LIST, "insn_list", "ue", 'x')
        !            82: 
        !            83: /* ----------------------------------------------------------------------
        !            84:    Expression types for machine descriptions.
        !            85:    These do not appear in actual rtl code in the compiler.
        !            86:    ---------------------------------------------------------------------- */
        !            87: 
        !            88: /* Appears only in machine descriptions.
        !            89:    Means use the function named by the second arg (the string)
        !            90:    as a predicate; if matched, store the structure that was matched
        !            91:    in the operand table at index specified by the first arg (the integer).
        !            92:    If the second arg is the null string, the structure is just stored.
        !            93: 
        !            94:    A third string argument indicates to the register allocator restrictions
        !            95:    on where the operand can be allocated.
        !            96: 
        !            97:    If the target needs no restriction on any instruction this field should
        !            98:    be the null string.
        !            99: 
        !           100:    The string is prepended by:
        !           101:    '=' to indicate the operand is only written to.
        !           102:    '+' to indicate the operand is both read and written to.
        !           103: 
        !           104:    Each character in the string represents an allocatable class for an operand.
        !           105:    'g' indicates the operand can be any valid class.
        !           106:    'i' indicates the operand can be immediate (in the instruction) data.
        !           107:    'r' indicates the operand can be in a register.
        !           108:    'm' indicates the operand can be in memory.
        !           109:    'o' a subset of the 'm' class.  Those memory addressing modes that
        !           110:        can be offset at compile time (have a constant added to them).
        !           111: 
        !           112:    Other characters indicate target dependent operand classes and
        !           113:    are described in each target's machine description.
        !           114: 
        !           115:    For instructions with more than one operand, sets of classes can be
        !           116:    separated by a comma to indicate the appropriate multi-operand constraints.
        !           117:    There must be a 1 to 1 correspondence between these sets of classes in
        !           118:    all operands for an instruction.
        !           119:    */
        !           120: DEF_RTL_EXPR(MATCH_OPERAND, "match_operand", "iss", 'm')
        !           121: 
        !           122: /* Appears only in machine descriptions.
        !           123:    Means match a SCRATCH or a register.  When used to generate rtl, a
        !           124:    SCRATCH is generated.  As for MATCH_OPERAND, the mode specifies
        !           125:    the desired mode and the first argument is the operand number.
        !           126:    The second argument is the constraint.  */
        !           127: DEF_RTL_EXPR(MATCH_SCRATCH, "match_scratch", "is", 'm')
        !           128: 
        !           129: /* Appears only in machine descriptions.
        !           130:    Means match only something equal to what is stored in the operand table
        !           131:    at the index specified by the argument.  */
        !           132: DEF_RTL_EXPR(MATCH_DUP, "match_dup", "i", 'm')
        !           133: 
        !           134: /* Appears only in machine descriptions.
        !           135:    Means apply a predicate, AND match recursively the operands of the rtx.
        !           136:    Operand 0 is the operand-number, as in match_operand.
        !           137:    Operand 1 is a predicate to apply (as a string, a function name).
        !           138:    Operand 2 is a vector of expressions, each of which must match
        !           139:    one subexpression of the rtx this construct is matching.  */
        !           140: DEF_RTL_EXPR(MATCH_OPERATOR, "match_operator", "isE", 'm')
        !           141: 
        !           142: /* Appears only in machine descriptions.
        !           143:    Means to match a PARALLEL of arbitrary length.  The predicate is applied
        !           144:    to the PARALLEL and the initial expressions in the PARALLEL are matched.
        !           145:    Operand 0 is the operand-number, as in match_operand.
        !           146:    Operand 1 is a predicate to apply to the PARALLEL.
        !           147:    Operand 2 is a vector of expressions, each of which must match the 
        !           148:    corresponding element in the PARALLEL.  */
        !           149: DEF_RTL_EXPR(MATCH_PARALLEL, "match_parallel", "isE", 'm')
        !           150: 
        !           151: /* Appears only in machine descriptions.
        !           152:    Means match only something equal to what is stored in the operand table
        !           153:    at the index specified by the argument.  For MATCH_OPERATOR.  */
        !           154: DEF_RTL_EXPR(MATCH_OP_DUP, "match_op_dup", "iE", 'm')
        !           155: 
        !           156: /* Appears only in machine descriptions.
        !           157:    Means match only something equal to what is stored in the operand table
        !           158:    at the index specified by the argument.  For MATCH_PARALLEL.  */
        !           159: DEF_RTL_EXPR(MATCH_PAR_DUP, "match_par_dup", "iE", 'm')
        !           160: 
        !           161: /* Appears only in machine descriptions.
        !           162:    Defines the pattern for one kind of instruction.
        !           163:    Operand:
        !           164:    0: names this instruction.
        !           165:       If the name is the null string, the instruction is in the
        !           166:       machine description just to be recognized, and will never be emitted by
        !           167:       the tree to rtl expander.
        !           168:    1: is the pattern.
        !           169:    2: is a string which is a C expression
        !           170:       giving an additional condition for recognizing this pattern.
        !           171:       A null string means no extra condition.
        !           172:    3: is the action to execute if this pattern is matched.
        !           173:       If this assembler code template starts with a * then it is a fragment of
        !           174:       C code to run to decide on a template to use.  Otherwise, it is the
        !           175:       template to use.
        !           176:    4: optionally, a vector of attributes for this insn.
        !           177:      */
        !           178: DEF_RTL_EXPR(DEFINE_INSN, "define_insn", "sEssV", 'x')
        !           179: 
        !           180: /* Definition of a peephole optimization.
        !           181:    1st operand: vector of insn patterns to match
        !           182:    2nd operand: C expression that must be true
        !           183:    3rd operand: template or C code to produce assembler output.
        !           184:    4: optionally, a vector of attributes for this insn.
        !           185:      */
        !           186: DEF_RTL_EXPR(DEFINE_PEEPHOLE, "define_peephole", "EssV", 'x')
        !           187: 
        !           188: /* Definition of a split operation.
        !           189:    1st operand: insn pattern to match
        !           190:    2nd operand: C expression that must be true
        !           191:    3rd operand: vector of insn patterns to place into a SEQUENCE
        !           192:    4th operand: optionally, some C code to execute before generating the
        !           193:        insns.  This might, for example, create some RTX's and store them in
        !           194:        elements of `recog_operand' for use by the vector of insn-patterns.
        !           195:        (`operands' is an alias here for `recog_operand').   */
        !           196: DEF_RTL_EXPR(DEFINE_SPLIT, "define_split", "EsES", 'x')
        !           197: 
        !           198: /* Definition of a combiner pattern.
        !           199:    Operands not defined yet.  */
        !           200: DEF_RTL_EXPR(DEFINE_COMBINE, "define_combine", "Ess", 'x')
        !           201: 
        !           202: /* Define how to generate multiple insns for a standard insn name.
        !           203:    1st operand: the insn name.
        !           204:    2nd operand: vector of insn-patterns.
        !           205:        Use match_operand to substitute an element of `recog_operand'.
        !           206:    3rd operand: C expression that must be true for this to be available.
        !           207:        This may not test any operands.
        !           208:    4th operand: Extra C code to execute before generating the insns.
        !           209:        This might, for example, create some RTX's and store them in
        !           210:        elements of `recog_operand' for use by the vector of insn-patterns.
        !           211:        (`operands' is an alias here for `recog_operand').  */
        !           212: DEF_RTL_EXPR(DEFINE_EXPAND, "define_expand", "sEss", 'x')
        !           213:    
        !           214: /* Define a requirement for delay slots.
        !           215:    1st operand: Condition involving insn attributes that, if true,
        !           216:                indicates that the insn requires the number of delay slots
        !           217:                shown.
        !           218:    2nd operand: Vector whose length is the three times the number of delay
        !           219:                slots required.
        !           220:                Each entry gives three conditions, each involving attributes.
        !           221:                The first must be true for an insn to occupy that delay slot
        !           222:                location.  The second is true for all insns that can be
        !           223:                annulled if the branch is true and the third is true for all
        !           224:                insns that can be annulled if the branch is false. 
        !           225: 
        !           226:    Multiple DEFINE_DELAYs may be present.  They indicate differing
        !           227:    requirements for delay slots.  */
        !           228: DEF_RTL_EXPR(DEFINE_DELAY, "define_delay", "eE", 'x')
        !           229: 
        !           230: /* Define a set of insns that requires a function unit.  This means that
        !           231:    these insns produce their result after a delay and that there may be
        !           232:    restrictions on the number of insns of this type that can be scheduled
        !           233:    simultaneously.
        !           234: 
        !           235:    More than one DEFINE_FUNCTION_UNIT can be specified for a function unit.
        !           236:    Each gives a set of operations and associated delays.  The first three
        !           237:    operands must be the same for each operation for the same function unit.
        !           238: 
        !           239:    All delays are specified in cycles.
        !           240: 
        !           241:    1st operand: Name of function unit (mostly for documentation)
        !           242:    2nd operand: Number of identical function units in CPU
        !           243:    3rd operand: Total number of simultaneous insns that can execute on this
        !           244:                function unit; 0 if unlimited.
        !           245:    4th operand: Condition involving insn attribute, that, if true, specifies
        !           246:                those insns that this expression applies to.
        !           247:    5th operand: Constant delay after which insn result will be
        !           248:                available.
        !           249:    6th operand: Delay until next insn can be scheduled on the function unit
        !           250:                executing this operation.  The meaning depends on whether or
        !           251:                not the next operand is supplied.
        !           252:    7th operand: If this operand is not specified, the 6th operand gives the
        !           253:                number of cycles after the instruction matching the 4th
        !           254:                operand begins using the function unit until a subsequent
        !           255:                insn can begin.  A value of zero should be used for a
        !           256:                unit with no issue constraints.  If only one operation can
        !           257:                be executed a time and the unit is busy for the entire time,
        !           258:                the 3rd operand should be specified as 1, the 6th operand
        !           259:                sould be specified as 0, and the 7th operand should not
        !           260:                be specified.
        !           261: 
        !           262:                If this operand is specified, it is a list of attribute
        !           263:                expressions.  If an insn for which any of these expressions
        !           264:                is true is currently executing on the function unit, the
        !           265:                issue delay will be given by the 6th operand.  Otherwise,
        !           266:                the insn can be immediately scheduled (subject to the limit
        !           267:                on the number of simultaneous operations executing on the
        !           268:                unit.)  */
        !           269: DEF_RTL_EXPR(DEFINE_FUNCTION_UNIT, "define_function_unit", "siieiiV", 'x')
        !           270: 
        !           271: /* Define attribute computation for `asm' instructions.  */
        !           272: DEF_RTL_EXPR(DEFINE_ASM_ATTRIBUTES, "define_asm_attributes", "V", 'x' )
        !           273: 
        !           274: /* SEQUENCE appears in the result of a `gen_...' function
        !           275:    for a DEFINE_EXPAND that wants to make several insns.
        !           276:    Its elements are the bodies of the insns that should be made.
        !           277:    `emit_insn' takes the SEQUENCE apart and makes separate insns.  */
        !           278: DEF_RTL_EXPR(SEQUENCE, "sequence", "E", 'x')
        !           279: 
        !           280: /* Refers to the address of its argument.
        !           281:    This appears only in machine descriptions, indicating that
        !           282:    any expression that would be acceptable as the operand of MEM
        !           283:    should be matched.  */
        !           284: DEF_RTL_EXPR(ADDRESS, "address", "e", 'm')
        !           285: 
        !           286: /* ----------------------------------------------------------------------
        !           287:    Expressions used for insn attributes.  These also do not appear in
        !           288:    actual rtl code in the compiler.
        !           289:    ---------------------------------------------------------------------- */
        !           290: 
        !           291: /* Definition of an insn attribute.
        !           292:    1st operand: name of the attribute
        !           293:    2nd operand: comma-separated list of possible attribute values
        !           294:    3rd operand: expression for the default value of the attribute. */
        !           295: DEF_RTL_EXPR(DEFINE_ATTR, "define_attr", "sse", 'x')
        !           296: 
        !           297: /* Marker for the name of an attribute. */
        !           298: DEF_RTL_EXPR(ATTR, "attr", "s", 'x')
        !           299: 
        !           300: /* For use in the last (optional) operand of DEFINE_INSN or DEFINE_PEEPHOLE and
        !           301:    in DEFINE_ASM_INSN to specify an attribute to assign to insns matching that
        !           302:    pattern.
        !           303: 
        !           304:    (set_attr "name" "value") is equivalent to
        !           305:    (set (attr "name") (const_string "value"))  */
        !           306: DEF_RTL_EXPR(SET_ATTR, "set_attr", "ss", 'x')
        !           307: 
        !           308: /* In the last operand of DEFINE_INSN and DEFINE_PEEPHOLE, this can be used to
        !           309:    specify that attribute values are to be assigned according to the
        !           310:    alternative matched.
        !           311: 
        !           312:    The following three expressions are equivalent:
        !           313: 
        !           314:    (set (attr "att") (cond [(eq_attrq "alternative" "1") (const_string "a1")
        !           315:                            (eq_attrq "alternative" "2") (const_string "a2")]
        !           316:                           (const_string "a3")))
        !           317:    (set_attr_alternative "att" [(const_string "a1") (const_string "a2")
        !           318:                                 (const_string "a3")])
        !           319:    (set_attr "att" "a1,a2,a3")
        !           320:  */
        !           321: DEF_RTL_EXPR(SET_ATTR_ALTERNATIVE, "set_attr_alternative", "sE", 'x')
        !           322: 
        !           323: /* A conditional expression true if the value of the specified attribute of
        !           324:    the current insn equals the specified value.  The first operand is the
        !           325:    attribute name and the second is the comparison value.  */
        !           326: DEF_RTL_EXPR(EQ_ATTR, "eq_attr", "ss", 'x')
        !           327: 
        !           328: /* A conditional expression which is true if the specified flag is
        !           329:    true for the insn being scheduled in reorg.
        !           330: 
        !           331:    genattr.c defines the following flags which can be tested by
        !           332:    (attr_flag "foo") expressions in eligible_for_delay.
        !           333: 
        !           334:    forward, backward, very_likely, likely, very_unlikely, and unlikely.  */
        !           335: 
        !           336: DEF_RTL_EXPR (ATTR_FLAG, "attr_flag", "s", 'x')
        !           337: 
        !           338: /* ----------------------------------------------------------------------
        !           339:    Expression types used for things in the instruction chain.
        !           340: 
        !           341:    All formats must start with "iuu" to handle the chain.
        !           342:    Each insn expression holds an rtl instruction and its semantics
        !           343:    during back-end processing.
        !           344:    See macros's in "rtl.h" for the meaning of each rtx->fld[].
        !           345: 
        !           346:    ---------------------------------------------------------------------- */
        !           347: 
        !           348: /* An instruction that cannot jump.  */
        !           349: DEF_RTL_EXPR(INSN, "insn", "iuueiee", 'i')
        !           350: 
        !           351: /* An instruction that can possibly jump.
        !           352:    Fields ( rtx->fld[] ) have exact same meaning as INSN's.  */
        !           353: DEF_RTL_EXPR(JUMP_INSN, "jump_insn", "iuueiee0", 'i')
        !           354: 
        !           355: /* An instruction that can possibly call a subroutine
        !           356:    but which will not change which instruction comes next
        !           357:    in the current function.
        !           358:    Fields ( rtx->fld[] ) have exact same meaning as INSN's.  */
        !           359: DEF_RTL_EXPR(CALL_INSN, "call_insn", "iuueiee", 'i')
        !           360: 
        !           361: /* A marker that indicates that control will not flow through.  */
        !           362: DEF_RTL_EXPR(BARRIER, "barrier", "iuu", 'x')
        !           363: 
        !           364: /* Holds a label that is followed by instructions.
        !           365:    Operand:
        !           366:    3: is a number that is unique in the entire compilation.
        !           367:    4: is the user-given name of the label, if any.
        !           368:    5: is used in jump.c for the use-count of the label.
        !           369:    and in flow.c to point to the chain of label_ref's to this label.  */
        !           370: DEF_RTL_EXPR(CODE_LABEL, "code_label", "iuuis0", 'x')
        !           371:      
        !           372: /* Say where in the code a source line starts, for symbol table's sake.
        !           373:    Contains a filename and a line number.  Line numbers <= 0 are special:
        !           374:    0 is used in a dummy placed at the front of every function
        !           375:       just so there will never be a need to delete the first insn;
        !           376:    -1 indicates a dummy; insns to be deleted by flow analysis and combining
        !           377:       are really changed to NOTEs with a number of -1.
        !           378:    -2 means beginning of a name binding contour; output N_LBRAC.
        !           379:    -3 means end of a contour; output N_RBRAC.  */
        !           380: DEF_RTL_EXPR(NOTE, "note", "iuusn", 'x')
        !           381: 
        !           382: /* INLINE_HEADER is use by inline function machinery.  The information
        !           383:    it contains helps to build the mapping function between the rtx's of
        !           384:    the function to be inlined and the current function being expanded.  */
        !           385: 
        !           386: DEF_RTL_EXPR(INLINE_HEADER, "inline_header", "iuuuiiiiiieiiEe", 'x')
        !           387: 
        !           388: /* ----------------------------------------------------------------------
        !           389:    Top level constituents of INSN, JUMP_INSN and CALL_INSN.
        !           390:    ---------------------------------------------------------------------- */
        !           391:    
        !           392: /* Several operations to be done in parallel.  */
        !           393: DEF_RTL_EXPR(PARALLEL, "parallel", "E", 'x')
        !           394: 
        !           395: /* A string that is passed through to the assembler as input.
        !           396:      One can obviously pass comments through by using the
        !           397:      assembler comment syntax.
        !           398:      These occur in an insn all by themselves as the PATTERN.
        !           399:      They also appear inside an ASM_OPERANDS
        !           400:      as a convenient way to hold a string.  */
        !           401: DEF_RTL_EXPR(ASM_INPUT, "asm_input", "s", 'x')
        !           402: 
        !           403: /* An assembler instruction with operands.
        !           404:    1st operand is the instruction template.
        !           405:    2nd operand is the constraint for the output.
        !           406:    3rd operand is the number of the output this expression refers to.
        !           407:      When an insn stores more than one value, a separate ASM_OPERANDS
        !           408:      is made for each output; this integer distinguishes them.
        !           409:    4th is a vector of values of input operands.
        !           410:    5th is a vector of modes and constraints for the input operands.
        !           411:      Each element is an ASM_INPUT containing a constraint string
        !           412:      and whose mode indicates the mode of the input operand.
        !           413:    6th is the name of the containing source file.
        !           414:    7th is the source line number.  */
        !           415: DEF_RTL_EXPR(ASM_OPERANDS, "asm_operands", "ssiEEsi", 'x')
        !           416: 
        !           417: /* A machine-specific operation.
        !           418:    1st operand is a vector of operands being used by the operation so that
        !           419:      any needed reloads can be done.
        !           420:    2nd operand is a unique value saying which of a number of machine-specific
        !           421:      operations is to be performed.
        !           422:    (Note that the vector must be the first operand because of the way that
        !           423:    genrecog.c record positions within an insn.)
        !           424:    This can occur all by itself in a PATTERN, as a component of a PARALLEL,
        !           425:    or inside an expression.  */
        !           426: DEF_RTL_EXPR(UNSPEC, "unspec", "Ei", 'x')
        !           427: 
        !           428: /* Similar, but a volatile operation and one which may trap.  */
        !           429: DEF_RTL_EXPR(UNSPEC_VOLATILE, "unspec_volatile", "Ei", 'x')
        !           430: 
        !           431: /* Vector of addresses, stored as full words.  */
        !           432: /* Each element is a LABEL_REF to a CODE_LABEL whose address we want.  */
        !           433: DEF_RTL_EXPR(ADDR_VEC, "addr_vec", "E", 'x')
        !           434: 
        !           435: /* Vector of address differences X0 - BASE, X1 - BASE, ...
        !           436:    First operand is BASE; the vector contains the X's.
        !           437:    The machine mode of this rtx says how much space to leave
        !           438:    for each difference.  */
        !           439: DEF_RTL_EXPR(ADDR_DIFF_VEC, "addr_diff_vec", "eE", 'x')
        !           440: 
        !           441: /* ----------------------------------------------------------------------
        !           442:    At the top level of an instruction (perhaps under PARALLEL).
        !           443:    ---------------------------------------------------------------------- */
        !           444: 
        !           445: /* Assignment.
        !           446:    Operand 1 is the location (REG, MEM, PC, CC0 or whatever) assigned to.
        !           447:    Operand 2 is the value stored there.
        !           448:    ALL assignment must use SET.
        !           449:    Instructions that do multiple assignments must use multiple SET,
        !           450:    under PARALLEL.  */
        !           451: DEF_RTL_EXPR(SET, "set", "ee", 'x')
        !           452: 
        !           453: /* Indicate something is used in a way that we don't want to explain.
        !           454:    For example, subroutine calls will use the register
        !           455:    in which the static chain is passed.  */
        !           456: DEF_RTL_EXPR(USE, "use", "e", 'x')
        !           457: 
        !           458: /* Indicate something is clobbered in a way that we don't want to explain.
        !           459:    For example, subroutine calls will clobber some physical registers
        !           460:    (the ones that are by convention not saved).  */
        !           461: DEF_RTL_EXPR(CLOBBER, "clobber", "e", 'x')
        !           462: 
        !           463: /* Call a subroutine.
        !           464:    Operand 1 is the address to call.
        !           465:    Operand 2 is the number of arguments.  */
        !           466: 
        !           467: DEF_RTL_EXPR(CALL, "call", "ee", 'x')
        !           468: 
        !           469: /* Return from a subroutine.  */
        !           470: 
        !           471: DEF_RTL_EXPR(RETURN, "return", "", 'x')
        !           472: 
        !           473: /* Conditional trap.
        !           474:    Operand 1 is the condition.
        !           475:    Operand 2 is the trap code.
        !           476:    For an unconditional trap, make the condition (const_int 1).  */
        !           477: DEF_RTL_EXPR(TRAP_IF, "trap_if", "ei", 'x')
        !           478: 
        !           479: /* ----------------------------------------------------------------------
        !           480:    Primitive values for use in expressions.
        !           481:    ---------------------------------------------------------------------- */
        !           482: 
        !           483: /* numeric integer constant */
        !           484: DEF_RTL_EXPR(CONST_INT, "const_int", "w", 'o')
        !           485: 
        !           486: /* numeric double constant.
        !           487:    Operand 0 is the MEM that stores this constant in memory,
        !           488:    or various other things (see comments at immed_double_const in varasm.c).
        !           489:    Operand 1 is a chain of all CONST_DOUBLEs in use in the current function.
        !           490:    Remaining operands hold the actual value.
        !           491:    The number of operands may be more than 2 if cross-compiling;
        !           492:    see init_rtl.  */
        !           493: DEF_RTL_EXPR(CONST_DOUBLE, "const_double", "e0ww", 'o')
        !           494: 
        !           495: /* String constant.  Used only for attributes right now.  */
        !           496: DEF_RTL_EXPR(CONST_STRING, "const_string", "s", 'o')
        !           497: 
        !           498: /* This is used to encapsulate an expression whose value is constant
        !           499:    (such as the sum of a SYMBOL_REF and a CONST_INT) so that it will be
        !           500:    recognized as a constant operand rather than by arithmetic instructions.  */
        !           501: 
        !           502: DEF_RTL_EXPR(CONST, "const", "e", 'o')
        !           503: 
        !           504: /* program counter.  Ordinary jumps are represented
        !           505:    by a SET whose first operand is (PC).  */
        !           506: DEF_RTL_EXPR(PC, "pc", "", 'o')
        !           507: 
        !           508: /* A register.  The "operand" is the register number, accessed
        !           509:    with the REGNO macro.  If this number is less than FIRST_PSEUDO_REGISTER
        !           510:    than a hardware register is being referred to.  */
        !           511: DEF_RTL_EXPR(REG, "reg", "i", 'o')
        !           512: 
        !           513: /* A scratch register.  This represents a register used only within a
        !           514:    single insn.  It will be turned into a REG during register allocation
        !           515:    or reload unless the constraint indicates that the register won't be
        !           516:    needed, in which case it can remain a SCRATCH.  This code is
        !           517:    marked as having one operand so it can be turned into a REG.  */
        !           518: DEF_RTL_EXPR(SCRATCH, "scratch", "0", 'o')
        !           519: 
        !           520: /* One word of a multi-word value.
        !           521:    The first operand is the complete value; the second says which word.
        !           522:    The WORDS_BIG_ENDIAN flag controls whether word number 0
        !           523:    (as numbered in a SUBREG) is the most or least significant word.
        !           524: 
        !           525:    This is also used to refer to a value in a different machine mode.
        !           526:    For example, it can be used to refer to a SImode value as if it were
        !           527:    Qimode, or vice versa.  Then the word number is always 0.  */
        !           528: DEF_RTL_EXPR(SUBREG, "subreg", "ei", 'x')
        !           529: 
        !           530: /* This one-argument rtx is used for move instructions
        !           531:    that are guaranteed to alter only the low part of a destination.
        !           532:    Thus, (SET (SUBREG:HI (REG...)) (MEM:HI ...))
        !           533:    has an unspecified effect on the high part of REG,
        !           534:    but (SET (STRICT_LOW_PART (SUBREG:HI (REG...))) (MEM:HI ...))
        !           535:    is guaranteed to alter only the bits of REG that are in HImode.
        !           536: 
        !           537:    The actual instruction used is probably the same in both cases,
        !           538:    but the register constraints may be tighter when STRICT_LOW_PART
        !           539:    is in use.  */
        !           540: 
        !           541: DEF_RTL_EXPR(STRICT_LOW_PART, "strict_low_part", "e", 'x')
        !           542: 
        !           543: /* (CONCAT a b) represents the virtual concatenation of a and b
        !           544:    to make a value that has as many bits as a and b put together.
        !           545:    This is used for complex values.  Normally it appears only
        !           546:    in DECL_RTLs and during RTL generation, but not in the insn chain.  */
        !           547: DEF_RTL_EXPR(CONCAT, "concat", "ee", 'o')
        !           548: 
        !           549: /* A memory location; operand is the address.
        !           550:    Can be nested inside a VOLATILE.  */
        !           551: DEF_RTL_EXPR(MEM, "mem", "e", 'o')
        !           552: 
        !           553: /* Reference to an assembler label in the code for this function.
        !           554:    The operand is a CODE_LABEL found in the insn chain.
        !           555:    The unprinted fields 1 and 2 are used in flow.c for the
        !           556:    LABEL_NEXTREF and CONTAINING_INSN.  */
        !           557: DEF_RTL_EXPR(LABEL_REF, "label_ref", "u00", 'o')
        !           558: 
        !           559: /* Reference to a named label: the string that is the first operand,
        !           560:    with `_' added implicitly in front.
        !           561:    Exception: if the first character explicitly given is `*',
        !           562:    to give it to the assembler, remove the `*' and do not add `_'.  */
        !           563: DEF_RTL_EXPR(SYMBOL_REF, "symbol_ref", "s", 'o')
        !           564: 
        !           565: /* The condition code register is represented, in our imagination,
        !           566:    as a register holding a value that can be compared to zero.
        !           567:    In fact, the machine has already compared them and recorded the
        !           568:    results; but instructions that look at the condition code
        !           569:    pretend to be looking at the entire value and comparing it.  */
        !           570: DEF_RTL_EXPR(CC0, "cc0", "", 'o')
        !           571: 
        !           572: /* =====================================================================
        !           573:    A QUEUED expression really points to a member of the queue of instructions
        !           574:    to be output later for postincrement/postdecrement.
        !           575:    QUEUED expressions never become part of instructions.
        !           576:    When a QUEUED expression would be put into an instruction,
        !           577:    instead either the incremented variable or a copy of its previous
        !           578:    value is used.
        !           579:    
        !           580:    Operands are:
        !           581:    0. the variable to be incremented (a REG rtx).
        !           582:    1. the incrementing instruction, or 0 if it hasn't been output yet.
        !           583:    2. A REG rtx for a copy of the old value of the variable, or 0 if none yet.
        !           584:    3. the body to use for the incrementing instruction
        !           585:    4. the next QUEUED expression in the queue.
        !           586:    ====================================================================== */
        !           587: 
        !           588: DEF_RTL_EXPR(QUEUED, "queued", "eeeee", 'x')
        !           589: 
        !           590: /* ----------------------------------------------------------------------
        !           591:    Expressions for operators in an rtl pattern
        !           592:    ---------------------------------------------------------------------- */
        !           593: 
        !           594: /* if_then_else.  This is used in representing ordinary
        !           595:    conditional jump instructions.
        !           596:      Operand:
        !           597:      0:  condition
        !           598:      1:  then expr
        !           599:      2:  else expr */
        !           600: DEF_RTL_EXPR(IF_THEN_ELSE, "if_then_else", "eee", '3')
        !           601: 
        !           602: /* General conditional. The first operand is a vector composed of pairs of
        !           603:    expressions.  The first element of each pair is evaluated, in turn.
        !           604:    The value of the conditional is the second expression of the first pair
        !           605:    whose first expression evaluates non-zero.  If none of the expressions is
        !           606:    true, the second operand will be used as the value of the conditional.
        !           607: 
        !           608:    This should be replaced with use of IF_THEN_ELSE.  */
        !           609: DEF_RTL_EXPR(COND, "cond", "Ee", 'x')
        !           610: 
        !           611: /* Comparison, produces a condition code result.  */
        !           612: DEF_RTL_EXPR(COMPARE, "compare", "ee", '2')
        !           613: 
        !           614: /* plus */
        !           615: DEF_RTL_EXPR(PLUS, "plus", "ee", 'c')
        !           616: 
        !           617: /* Operand 0 minus operand 1.  */
        !           618: DEF_RTL_EXPR(MINUS, "minus", "ee", '2')
        !           619: 
        !           620: /* Minus operand 0.  */
        !           621: DEF_RTL_EXPR(NEG, "neg", "e", '1')
        !           622: 
        !           623: DEF_RTL_EXPR(MULT, "mult", "ee", 'c')
        !           624: 
        !           625: /* Operand 0 divided by operand 1.  */
        !           626: DEF_RTL_EXPR(DIV, "div", "ee", '2')
        !           627: /* Remainder of operand 0 divided by operand 1.  */
        !           628: DEF_RTL_EXPR(MOD, "mod", "ee", '2')
        !           629: 
        !           630: /* Unsigned divide and remainder.  */
        !           631: DEF_RTL_EXPR(UDIV, "udiv", "ee", '2')
        !           632: DEF_RTL_EXPR(UMOD, "umod", "ee", '2')
        !           633: 
        !           634: /* Bitwise operations.  */
        !           635: DEF_RTL_EXPR(AND, "and", "ee", 'c')
        !           636: 
        !           637: DEF_RTL_EXPR(IOR, "ior", "ee", 'c')
        !           638: 
        !           639: DEF_RTL_EXPR(XOR, "xor", "ee", 'c')
        !           640: 
        !           641: DEF_RTL_EXPR(NOT, "not", "e", '1')
        !           642: 
        !           643: /* Operand:
        !           644:      0:  value to be shifted.
        !           645:      1:  number of bits.
        !           646:    ASHIFT and LSHIFT are distinguished because on some machines
        !           647:    these allow a negative operand and shift right in that case.  */
        !           648: DEF_RTL_EXPR(LSHIFT, "lshift", "ee", '2')
        !           649: DEF_RTL_EXPR(ASHIFT, "ashift", "ee", '2')
        !           650: DEF_RTL_EXPR(ROTATE, "rotate", "ee", '2')
        !           651: 
        !           652: /* Right shift operations, for machines where these are not the same
        !           653:    as left shifting with a negative argument.  */
        !           654: 
        !           655: DEF_RTL_EXPR(ASHIFTRT, "ashiftrt", "ee", '2')
        !           656: DEF_RTL_EXPR(LSHIFTRT, "lshiftrt", "ee", '2')
        !           657: DEF_RTL_EXPR(ROTATERT, "rotatert", "ee", '2')
        !           658: 
        !           659: /* Minimum and maximum values of two operands.  We need both signed and
        !           660:    unsigned forms.  (We cannot use MIN for SMIN because it conflicts
        !           661:    with a macro of the same name.) */
        !           662: 
        !           663: DEF_RTL_EXPR(SMIN, "smin", "ee", 'c')
        !           664: DEF_RTL_EXPR(SMAX, "smax", "ee", 'c')
        !           665: DEF_RTL_EXPR(UMIN, "umin", "ee", 'c')
        !           666: DEF_RTL_EXPR(UMAX, "umax", "ee", 'c')
        !           667: 
        !           668: /* These unary operations are used to represent incrementation
        !           669:    and decrementation as they occur in memory addresses.
        !           670:    The amount of increment or decrement are not represented
        !           671:    because they can be understood from the machine-mode of the
        !           672:    containing MEM.  These operations exist in only two cases:
        !           673:    1. pushes onto the stack.
        !           674:    2. created automatically by the life_analysis pass in flow.c.  */
        !           675: DEF_RTL_EXPR(PRE_DEC, "pre_dec", "e", 'x')
        !           676: DEF_RTL_EXPR(PRE_INC, "pre_inc", "e", 'x')
        !           677: DEF_RTL_EXPR(POST_DEC, "post_dec", "e", 'x')
        !           678: DEF_RTL_EXPR(POST_INC, "post_inc", "e", 'x')
        !           679: 
        !           680: /* Comparison operations.  The ordered comparisons exist in two
        !           681:    flavors, signed and unsigned.  */
        !           682: DEF_RTL_EXPR(NE, "ne", "ee", '<')
        !           683: DEF_RTL_EXPR(EQ, "eq", "ee", '<')
        !           684: DEF_RTL_EXPR(GE, "ge", "ee", '<')
        !           685: DEF_RTL_EXPR(GT, "gt", "ee", '<')
        !           686: DEF_RTL_EXPR(LE, "le", "ee", '<')
        !           687: DEF_RTL_EXPR(LT, "lt", "ee", '<')
        !           688: DEF_RTL_EXPR(GEU, "geu", "ee", '<')
        !           689: DEF_RTL_EXPR(GTU, "gtu", "ee", '<')
        !           690: DEF_RTL_EXPR(LEU, "leu", "ee", '<')
        !           691: DEF_RTL_EXPR(LTU, "ltu", "ee", '<')
        !           692: 
        !           693: /* Represents the result of sign-extending the sole operand.
        !           694:    The machine modes of the operand and of the SIGN_EXTEND expression
        !           695:    determine how much sign-extension is going on.  */
        !           696: DEF_RTL_EXPR(SIGN_EXTEND, "sign_extend", "e", '1')
        !           697: 
        !           698: /* Similar for zero-extension (such as unsigned short to int).  */
        !           699: DEF_RTL_EXPR(ZERO_EXTEND, "zero_extend", "e", '1')
        !           700: 
        !           701: /* Similar but here the operand has a wider mode.  */
        !           702: DEF_RTL_EXPR(TRUNCATE, "truncate", "e", '1')
        !           703: 
        !           704: /* Similar for extending floating-point values (such as SFmode to DFmode).  */
        !           705: DEF_RTL_EXPR(FLOAT_EXTEND, "float_extend", "e", '1')
        !           706: DEF_RTL_EXPR(FLOAT_TRUNCATE, "float_truncate", "e", '1')
        !           707: 
        !           708: /* Conversion of fixed point operand to floating point value.  */
        !           709: DEF_RTL_EXPR(FLOAT, "float", "e", '1')
        !           710: 
        !           711: /* With fixed-point machine mode:
        !           712:    Conversion of floating point operand to fixed point value.
        !           713:    Value is defined only when the operand's value is an integer.
        !           714:    With floating-point machine mode (and operand with same mode):
        !           715:    Operand is rounded toward zero to produce an integer value
        !           716:    represented in floating point.  */
        !           717: DEF_RTL_EXPR(FIX, "fix", "e", '1')
        !           718: 
        !           719: /* Conversion of unsigned fixed point operand to floating point value.  */
        !           720: DEF_RTL_EXPR(UNSIGNED_FLOAT, "unsigned_float", "e", '1')
        !           721: 
        !           722: /* With fixed-point machine mode:
        !           723:    Conversion of floating point operand to *unsigned* fixed point value.
        !           724:    Value is defined only when the operand's value is an integer.  */
        !           725: DEF_RTL_EXPR(UNSIGNED_FIX, "unsigned_fix", "e", '1')
        !           726: 
        !           727: /* Absolute value */
        !           728: DEF_RTL_EXPR(ABS, "abs", "e", '1')
        !           729: 
        !           730: /* Square root */
        !           731: DEF_RTL_EXPR(SQRT, "sqrt", "e", '1')
        !           732: 
        !           733: /* Find first bit that is set.
        !           734:    Value is 1 + number of trailing zeros in the arg.,
        !           735:    or 0 if arg is 0.  */
        !           736: DEF_RTL_EXPR(FFS, "ffs", "e", '1')
        !           737: 
        !           738: /* Reference to a signed bit-field of specified size and position.
        !           739:    Operand 0 is the memory unit (usually SImode or QImode) which
        !           740:    contains the field's first bit.  Operand 1 is the width, in bits.
        !           741:    Operand 2 is the number of bits in the memory unit before the
        !           742:    first bit of this field.
        !           743:    If BITS_BIG_ENDIAN is defined, the first bit is the msb and
        !           744:    operand 2 counts from the msb of the memory unit.
        !           745:    Otherwise, the first bit is the lsb and operand 2 counts from
        !           746:    the lsb of the memory unit.  */
        !           747: DEF_RTL_EXPR(SIGN_EXTRACT, "sign_extract", "eee", 'b')
        !           748: 
        !           749: /* Similar for unsigned bit-field.  */
        !           750: DEF_RTL_EXPR(ZERO_EXTRACT, "zero_extract", "eee", 'b')
        !           751: 
        !           752: /* For RISC machines.  These save memory when splitting insns.  */
        !           753: 
        !           754: /* HIGH are the high-order bits of a constant expression.  */
        !           755: DEF_RTL_EXPR(HIGH, "high", "e", 'o')
        !           756: 
        !           757: /* LO_SUM is the sum of a register and the low-order bits
        !           758:    of a constant expression.  */
        !           759: DEF_RTL_EXPR(LO_SUM, "lo_sum", "ee", 'o')
        !           760: 
        !           761: /*
        !           762: Local variables:
        !           763: mode:c
        !           764: version-control: t
        !           765: End:
        !           766: */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.